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

Subelements

The virtual-server element can contain the following subelements:

Table 3–60 List of virtual-server Subelements

Element 

Occurrences 

Description 

enabled

0 or 1 

Determines whether the virtual server is enabled at runtime. The default value is true.

name

A name that uniquely identifies the virtual server. 

http-listener-name

0 or more 

The name of an HTTP listener associated with one or more of the virtual server's host names. The value is the name from an http-listener element. For more details, see http-listener.

host

0 or more 

The host name that the virtual server services. Host comparisons are not case sensitive. The value can be a host name or a wildcard pattern. For more information on wildcards, see Appendix B, Using Wildcard Patterns

canonical-server-name

0 or 1 

The canonical name of the virtual server. Requests using a different name will be redirected to the canonical name. The value is a host name or URL prefix. 

acl-file

0 or more 

The name of the ACL file that controls access to the virtual server. 

mime-file

0 or more 

The mime.types file that configures MIME mappings for the virtual server.

object-file

The obj.conf file that controls request processing for the virtual server.

default-object-name

0 or 1 

The name of the root obj.conf object. The default value is default.

document-root

The document root for the virtual server. 

localization

0 or 1 

Configures localization. For more details, see localization.

qos-limits

0 or 1 

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

search-app

0 or 1 

Configures the built-in search web application for the virtual server. For more details, see search-app.

access-log

0 or more 

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

auth-db

0 or more 

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

search-collection

0 or more 

Configures a collection of searchable documents for the virtual server. For more details, see search-collection.

dav-collection

0 or more 

Configures a WebDAV collection for the virtual server. For more details, see dav-collection.

web-app

0 or more 

Configures the Java web application mappings for the virtual server. For more details, see web-app.

log-file

0 or 1 

The log file for the virtual server. The value is the log file name, for example, ../logs/errors.

variable

0 or more 

Defines an obj.conf variable for the virtual server. For more details, see variable.

description

0 or 1 

The description of the virtual server. 

single-sign-on

0 or 1 

Configures single sign-on for Java web applications within the virtual server. For more details, see single-sign-on.