Directory Structure

                                                                                                                                                                                                                                                                                                                                      Back to [Book]     [Topic]

Directory Structure

This section describes the directory structure that is created when you first install Sun Java System Web Server. In a stand-alone Web Server installation, all these directories are in the install_dir by default. In Web Servers installed as part of Java Enterprise System, the instance directories (which in this case includes both admin-sever and https-sever_id) are in a different location. For more information on the default locations for these directories on different platforms, see the information on instance_dir in Default Paths and File Names.

• admin-server
• bin
• https-server_id
• include
• jdk
• lib
• plugins
• samples
• setup

admin-server

The admin-server directory has the following subdirectories:

• bin – Contains the binary files that are required to start, stop, and restart Web Server. On UNIX systems, this directory also contains the file required for rotating logs.
• config – Contains the private configuration files for the Administration Server. These files are for internal use.
• config-store – Contains files used by the Administration Server to track server configuration information.

  Note - The files in this directory are created by Web Server for internal use. Do not edit, run scripts on, or otherwise access any files in the config-store directory.

• generated – Contains files generated by the instance, such as Java class files corresponding to JavaServer Pages (JSP).
• logs – Contains any error or access log files that are generated by a server instance.
• sessions – Contains session data files.

bin

The bin directory contains the binary files for administering Web Server. These files include wadm, the administration command-line interface (CLI).

https-server_id

An https-server_id directory is created for every instance you create. This directory has the following subdirectories and files:

• bin – Contains the binary files for starting, stopping, restarting, and reconfiguring the server. On UNIX, it also contains the binary file for rotating the log files.
• collections – Contains the search collection data.
• config – Contains the following instance-specific configuration files:
  • cert8.db – NSS certificate database
  • certmap.conf – Certificate to LDAP DN mapping configuration
  • default.acl – Default ACL file for the server instance named server_id
  • default-web.xml – Default values for all web applications
  • key3.db – NSS private key database
  • keyfile – The usernames and hashed passwords for flat file authentication
  • login.conf – Information for file authentication used by the Java Authentication and Authorization Service (JAAS)
  • magnus.conf – Information for NSAPI plug-in initialization and operation
  • mime.types – Map of file extensions to MIME types that enables the server to determine the content type of a requested resource
  • obj.conf – Instructions for Web Server for handling HTTP requests from clients
  • secmod.db – NSS PKCS #11 module database
  • server.policy – Policy controlling the access that applications have to resources
  • server.xml – Most of the server configuration settings
• docs – Contains the files in the default document root for an instance.
• generated – Contains files generated by the instance.
• lock-db – The default directory for WebDAV lock database files.
• logs – Contains log files generated by a server instance.
• sessions – Contains session data files.
• web-app – The default directory for deployed web applications.

include

The include directory contains the various include files, for example, NSAPI and SHTML include files.

jdk

The jdk directory contains the bundled Java development kit (JDK ^TM). For stand-alone installations only.

lib

The lib directory contains internal binaries, scripts, libraries, and bundled plug-ins. These files are private files, for internal use only.

plugins

The plugins directory contains the plug-in subdirectories.

• digest contains the digest authentication plug-in for Sun Java Directory Server, as well as information about the plug-in.
• fastcgi contains the files for the FastCGI plug-in.
• htaccess contains server plug-in for .htaccess access control and htconvert, which is an .nsconfig to .htaccess converter.
• loadbal contains the required files for the third–party load-balancer integration plug-in.

For more information on these plug-ins, see [Sun Java System Web Server Administrator's Guide|Administrator's Guide.

samples

The samples directory 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 environment.

setup

The setup directory contains the various Web Server setup files, including the installation logs.