Sun Java System Web Server 7.0 Update 7 Administrator's Configuration File Reference

server

The server element defines a server. This is the root element, and there can be only one server element in the server.xml file.

Subelements

The server element has the following subelements:

Table 3–45 List of server Subelements

Element 

Occurrences 

Description 

cluster

0 or 1 

The server cluster to which the server belongs. For more details, see cluster.

log

0 or 1 

Configures the logging subsystem. For more details, see log.

user

0 or 1 

The account the server runs as (UNIX only). The value is the user account. If the server is started as root, any UNIX account can be specified. If the server is started by a non-root account, only that non-root account should be specified.

platform

0 or 1 

Determines whether the server runs as a 32-bit or 64-bit process. The value can be 32 or 64. 

temp-path

0 or 1 

The directory where the server stores its temporary files. If a relative path is used, it is relative to the server's config directory. The directory must be owned by the account that the server runs as.

variable

0 or more 

Defines a variable for use in expressions, log formats, and obj.conf parameters. For more details, see variable.

localization

0 or 1 

Configures localization. For more details, see localization.

http

0 or 1 

Configures the HTTP protocol options. For more details, see http.

keep-alive

0 or 1 

Configures the HTTP keep-alive subsystem. For more details, see keep-alive.

thread-pool

0 or 1 

Configures the HTTP request processing threads. For more details, see thread-pool.

pkcs11

0 or 1 

Configures the PKCS #11 subsystem. For more details, see pkcs11.

stats

0 or 1 

Configures the statistics collection subsystem. For more details, see stats.

cgi

0 or 1  

Configures the CGI subsystem. For more details, see cgi.

qos

0 or 1 

Configures the QOS subsystem. For more details, see qos.

dns

0 or 1 

Configures the server's use of DNS. For more details, see dns.

dns-cache

0 or 1 

Configures the DNS cache. For more details, see dns-cache.

file-cache

0 or 1 

Configures the file cache. For more details, see file-cache.

acl-cache

0 or 1 

Configures the ACL cache. For more details, see acl-cache.

ssl-session-cache

0 or 1 

Configures the SSL/TLS session cache. For more details, see ssl-session-cache.

access-log-buffer

0 or 1 

Configures the access log buffering subsystem. For more details, see access-log-buffer.

dav

0 or 1 

Configures WebDAV. For more details, see dav.

snmp

0 or 1 

Configures SNMP. For more details, see snmp.

qos-limits

0 or 1 

Configures the QOS limits for the server. For more details, see qos-limits.

audit-accesses

0 or 1 

Specifies whether authentication and authorization events are logged. The default value is false.

jvm

0 or 1 

Configures JVM. For more details, see jvm.

servlet-container

0 or 1 

Configures the Servlet container. For more details, see servlet-container.

lifecycle-module

0 or more 

Configures a Java server lifecycle module. For more details, see lifecycle-module.

custom-resource

0 or more 

Configures a resource implemented by a custom class. For more details, see custom-resource.

external-jndi-resource

0 or more 

Configures a resource provided by an external JNDI repository. For more details, see external-jndi-resource.

jdbc-resource

0 or more  

Configures a JDBC resource. For more details, see jdbc-resource.

mail-resource

0 or more  

Configures a mail store. For more details, see mail-resource.

default-soap-auth-provider-name

0 or 1 

The name of the default SOAP message-level authentication provider. The value is the name value from a soap-auth-provider element. For more details, see default-soap-auth-provider-name

soap-auth-provider

0 or more 

Configures a SOAP message-level authentication provider. For more details, see soap-auth-provider.

default-auth-realm-name

0 or 1 

The name of the default Servlet container authentication realm. The value is the name value from an auth-realm element. For more details, see auth-realm.

auth-realm

0 or more 

Configures a Servlet container authentication realm. For more details, see auth-realm.

default-auth-db-name

0 or 1 

The name of the default ACL authentication database. The value is the name value from an auth-db element, and the default value is default. For more details, see auth-db.

auth-db

0 or more 

Configures an ACL authentication database for the server. For more details, see auth-db.

acl-file

0 or more 

The ACL file that controls access to the server. The value is the name of an ACL file. For more details, see acl-file.

mime-file

0 or more 

The mime.types file that configures MIME mappings for the server as a whole. The value is the name of a mime.types file. For more details, seemime-file.

access-log

0 or more 

Configures an HTTP access log for the server. For more details, see access-log.

http-listener

0 or more 

Configures an HTTP listener. For more details, see http-listener.

virtual-server

0 or more 

Configures a virtual server. For more details, see virtual-server.

event

0 or more 

Configures a recurring event. For more details, see event.