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.
The following table describes subelements for the VS element.
Table 2–14 VS Subelements
Element |
Required |
Description |
---|---|---|
zero or one |
Contains a text description of this element. |
|
zero or one |
Specifies a property or a variable of the VS. |
|
zero or more |
Specifies a property or a variable of the VS. |
|
zero or one |
Defines quality of service parameters. |
|
zero or more |
Defines the user database for the virtual server. |
|
zero or one |
Defines the WebDAV configuration for the virtual server. |
|
zero or one |
Defines the search configuration for the virtual server. |
|
zero or more |
Specifies a web application. |
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. |