Oracle iPlanet Web Server 7.0.9 Administrator's Configuration File Reference

Understanding server.xml

To edit server.xml for your environment, you must know which elements contain the relevant settings. The following sections contain brief descriptions of the elements that configure the functional areas:

In addition, Chapter 3, Elements in server.xml contains an alphabetical list of all the server.xml elements and their subelements.

Access Control

The acl-file element references an ACL file. ACL files define the authorization rules. The auth-realm and default-auth-realm-name elements configure authentication realms for Java Servlet container authentication. For more information, see acl-file, auth-realm, and default-auth-realm-name.

The auth-db and default-auth-db-name elements configure the authentication databases for server authentication. Authentication databases are used with ACL files. For more information, see auth-db, and default-auth-db-name.

For more information on ACL files, see Chapter 9, ACL Files.


The cluster element defines a cluster of servers to which an individual server instance belongs. The instance element defines an individual member of a cluster. The session-replication element configures how Java Servlet sessions are shared between instances in a cluster. For more information, see cluster, instance, and session-replication.

HTTP Protocol

The http element configures the general HTTP protocol options. The keep-alive element configures HTTP keep-alive connection management. The http–listener element configures the ports and IP addresses on which the server listens for new HTTP connections. The virtual-server element configures how the server processes the HTTP requests. For more information, see http, keep-alive, http-listener, and virtual-server.


The following elements configure the Java Servlet container:

The following elements configure the Java Naming and Directory Interface (JNDI) resources:

The lifecycle-module element loads the custom Java plug-ins that are triggered by one or more events in the server's lifecycle. For more information lifecycle-module.

The soap-auth-provider element configures message-level authentication for Java web services. For more information, see soap-auth-provider.

The jvm element configures the Java Virtual Machine (JVM). For more information, see jvm.

Logging and Monitoring

The access-log element configures the file name and formats of access logs. The access-log-buffer element configures the frequency of access log updates and ordering of the access log entries. For more information, see access-log and access-log-buffer.

The log element configures the file name and contents of the server log. The event element configures the access log and server log rotation. For more information, see log and event.

The snmp element configures SNMP, and the stats element configures statistics collection. For more information, see snmp and stats.

Performance Tuning

The thread-pool element configures the number of threads used to process requests and the maximum number of HTTP connections that the server queues. For more information, see thread-pool.

The keep-alive element configures the HTTP keep-alive connection management. For more information, see keep-alive.

WebDAV ACL, lock, and property caching are controlled by the acl-db, lock-db, and property-db elements, respectively. For more information, see acl-db, lock-db, and property-db.

The file-cache element configures file caching. The dns-cache element configures the DNS caching. The acl-cache element configures the authentication credential caching. For more information, see file-cache, dns-cache, and acl-cache.


The search-collection element defines the set of documents that the server should index. The search-app element configures the server's built-in search web application. For more information, see search-collection and search-app.

SSL, TLS, and PKCS #11

The ssl element configures SSL and TLS. SSL and TLS can be configured separately for each HTTP listener. For more information, see ssl and http-listener.

The pkcs11 element configures the PKCS #11 subsystem, including Certificate Revocation Lists (CRLs) and third-party cryptographic modules. For more information, see pkcs11.


The variable element defines a variable for use in expressions, log formats, and obj.conf parameters. For more information on the variable element, see variable. For more information on variable and expression use, see Appendix A, Using Variables, Expressions, and String Interpolation. For more information on the log file format, see Appendix C, Using the Custom Log File Format.

Virtual Servers

The virtual-server element configures the virtual servers. Each virtual server accepts HTTP connections from one or more HTTP listeners. The http-listener element configures the HTTP listeners. For more information, see virtual-server, and http-listener.

You can define variables within a virtual server using the variable element, as described in the previous section, Variables.


The dav element configures WebDAV. The dav-collection element defines the set of files that are accessible through WebDAV. For more information, see dav and dav-collection.