Sun Java System Web Server 6.1 SP11 Administrator's Configuration File Reference

VS

Defines a virtual server. A virtual server, also called a virtual host, is a virtual web server that serves content targeted for a specific URL. Multiple virtual servers may serve content using the same or different host names, port numbers, or IP addresses. The HTTP service can direct incoming web requests to different virtual servers based on the URL.

Subelements

The following table describes subelements for the VS element.

Table 2–14 VS Subelements

Element  

Required  

Description  

DESCRIPTION

zero or one 

Contains a text description of this element. 

VARS

zero or one 

Specifies a property or a variable of the VS.

PROPERTY

zero or more 

Specifies a property or a variable of the VS.

QOSPARAMS

zero or one 

Defines quality of service parameters. 

USERDB

zero or more 

Defines the user database for the virtual server. 

DAV

zero or one 

Defines the WebDAV configuration for the virtual server. 

SEARCH

zero or one 

Defines the search configuration for the virtual server. 

WEBAPP

zero or more 

Specifies a web application. 

Attributes

The following table describes attributes for the VS element.

Table 2–15 VS Attributes

Attribute  

Default  

Description  

id

none 

Virtual server ID. This is a unique ID that allows lookup of a specific virtual server. Can also be referred to as the variable $id in an obj.conf file. A virtual server ID cannot begin with a number.

connections

none 

(optional) A space-separated list of LS ids that specify the connection(s) the virtual server uses. Required only for a VS that is not the defaultvs of a listen socket.

urlhosts

none 

A space-separated list of values allowed in the Host request header to select the current virtual server. Each VS that is configured to the same listen socket must have a unique urlhosts value for that group.

objectfile

objectfile of the enclosing VSCLASS

(optional) The file name of the obj.conf file for this virtual server.

rootobject

default

(optional) Tells the server which object loaded from an obj.conf file is the default.

Tells the server which object loaded from an obj.conf file is the default. The default object is expected to have all the name translation (NameTrans) directives for the virtual server; any server behavior that is configured in the default object affects the entire server.

If you specify an object that doesn't exist, the server doesn't report an error until a client tries to retrieve a document. 

mime

none 

The id of the MIME element used by the virtual server.

aclids

none 

(optional) One or more id attributes of ACLFILE elements, separated by commas. Specifies the ACL file(s) used by the virtual server.

errorlog

none 

(optional) Specifies a log file for virtual-server-specific error messages. See the LOG description for details about logs.

acceptlanguage

off

(optional) If true, the server parses the Accept-Language header and sends an appropriate language version based on which language the client can accept. You should set this value to on only if the server supports multiple languages.

Legal values are on, off, yes, no, 1, 0, true, false.

state

on

(optional) Determines whether a virtual-server is active (on) or inactive (off, disabled). The default is on (active). When inactive, a virtual server does not service requests.

If a virtual server is disabled, only the global server administrator can turn it on.