Directory Structure

The following section describes the directory structure created when you first install Sun Java System Web Server 6.1. The information is organized in two parts:

• All Platforms

• UNIX and Linux Platforms

All Platforms

For all platforms, the following directories are created under the server root directory:

• alias contains the key and certificate files for all Sun Java System servers (for example, https-admserv-server_id-cert8.db and secmod.db).

• bin contains the binary files for the server, such as the actual server, the Administration Server forms, and so on. In addition, this directory includes the https/install folder that contains files needed for migrating server settings and default configuration files needed for backward compatibility.

• docs is the server’s default primary document directory, where your server’s content files are usually kept. If you are migrating settings from an existing server, this directory doesn’t appear until you finish the migration process.

• extras contains the log analyzer and log analysis tools.

  • The flexanlg directory contains a command-line log analyzer. This log analyzer analyzes files in flexlog format.

  • The log_anly directory contains the log analysis tool that runs through the Server Manager. This log analyzer analyzes files in common log format only.

  httpacl contains the files that store access control configuration information in the generated.server-id.acl and genwork.server-id.acl files. The file generated.server-id.acl contains changes you make using the Server Manager access control forms after saving your changes; genwork.server-id.acl contains your changes before you save your changes.

• https-admserv contains the directories for the Administration Server. This directory has the following subdirectories and files:

  • For UNIX/Linux platforms, this directory contains shell scripts to start, stop, and restart the server and a script to rotate log files.

  • ClassCache contains classes and Java files, generated as a result of the compilation of JavaServer pages.

  • conf_bk contains backup copies of the administration server’s configuration files.

  • config contains the server’s configuration files.

  • logs contains any error or access log files.

  • SessionData contains session database data from MMapSessionManager.

  • startsvr.bat is the script that starts the Server Manager on Windows machines. The Server Manager lets you configure all servers installed in the server root directory.

  • stopsvr.bat is the script that stops the Server Manager on Windows machines.

  https-server_id are the directories for each server you have installed on the machine. Each server directory has the following subdirectories and files:

  • ClassCache contains classes and Java files, generated as result of the compilation of JavaServer pages.

  • conf_bk contains backup copies of the server’s configuration files.

  • config contains the server instance configuration files.

  • logs contains the server instance log files.

  • reconfig is the script used to reconfigure the server dynamically. If you make non-global changes to the server, you can use this script to reconfigure the server without stopping and starting it. Note that changes to ACL files and magnus.conf require you to stop and restart the server.

  • restart is the script that restarts the server.

  • rotate rotates server log files without affecting users who may be connected to the server.

  • search contains the following directories: admin and collections

  • SessionData contains session database data from MMapSessionManager.

  • startsvr.bat is the script that starts the Server Manager. The Server Manager lets you configure all servers installed in the server root directory.

  • stopsvr.bat is the script that stops the Server Manager.

  manual contains the online manuals for the product.

• plug-ins contains directories for Java, search, and other plug-ins. This directory has the following subdirectories:

  • htaccess contains server plug-in for .htaccess access control and htconvert, an .nsconfig to .htaccess converter.

  • digest contains the Digest Authentication Plug-in for Sun Java System Directory Server 5.0, as well as information about the plug-in.

  • samples contains samples and example components, plug-ins and technologies supported by the Sun Java System Web Server servlet engine. This includes binaries, all code, and a build enviroment.

  • servlets contains information about and examples of web-apps applications.

  • include contains various include files.

  • lib contains shared libraries.

  • nsacl contains information for your server’s access control lists.

  • loadbal contains the required files for the Resonate load-balancer integration plug-in.

  • nsapi contains header files and example code for creating your own functions using NSAPI. For more information, see the Sun Java System documentation web site at:

    http://docs.sun.com/app/docs/coll/1308.5

  • search contains information for your server’s search plug-ins.

  • snmp contains information for your server’s SNMP plug-ins.

  setup contains the various Sun Java System Web Server setup files, including setup.log and uninstall.inf.

• userdb contains user databases and related information.

• LICENSE.txt is the license file.

• README.txt is the readme file that contains a link to the Sun Java System Web Server Release Notes.

UNIX and Linux Platforms

In addition to the files and directories described in All Platforms the following files are created at the server-root directory for UNIX and Linux platforms:

• startconsole launches a browser to the Administration Server page.

  The following files are created under the server-root/https-admserv directory for UNIX and Linux platforms:

  • ClassCache contains classes and Java files, generated as result of the compilation of JavaServer pages.

  • conf_bk contains backup copies of the server’s configuration files.

  • config contains the Administration Server configuration files.

  • logs contains the Administration Server log files.

  • SessionData contains session database data from MMapSessionManager.

  • restart is the script that restarts the Server Manager.

  • start is the script that starts the Server Manager. The Server Manager lets you configure all servers installed in the server root directory.

  • stop is the script that stops the Server Manager.