Virtual Host List
This page lists all defined virtual hosts. From here you can change, add or delete a virtual host. When you add or edit a virtual host, you only specify important attributes here, and should go to individual virtual host menu for details. When you add a new virtual host, make sure the directory is preexisted.
 
Table of Contents
Virtual Host Virtual Host Name   Virtual Host Root   Config File   Follow Symbolic Link   Enable Script   Restrained   CGI Set UID Mode   CGI Chroot Mode   CGI Chroot Path   
 
Virtual Host NameGo to top
Description: A unique name for a virtual host. It is recommended to use a domain name of this virtual host.
Apply: On the fly with reload.
Virtual Host RootGo to top
Description: Specifies the root directory of the virtual host. Note: This is NOT the document root. It is recommended to place all files related to the virtual host under this directory, like virtual host configuration, log files, Html files, CGI scripts, etc. Virtual Host Root can be referred as $VH_ROOT.
Syntax: An absolute path or a relative path to $SERVER_ROOT.
Apply: On the fly with reload.
Tips: [Performance] place different virtual hosts on different hard drives.
Config FileGo to top
Description: Specifies the configuration file name for this virtual host. If the configuration file is placed under the virtual host root, $VH_ROOT/conf/vhconf.xml is recommended; if it is placed under the server root, $SERVER_ROOT/conf/{VirtualHostName}.xml is recommended.
Syntax: File name which can be absolute, or relative to $SERVER_ROOT, or relative to $VH_ROOT.
Apply: On the fly with reload.
Follow Symbolic LinkGo to top
Description: Specifies whether to follow symbolic links in this virtual host. IF OWNER MATCH option will follow a symbolic link only if it has same ownership. This setting overrides the default server level setting.
Syntax: Select from drop down list
Apply: On the fly with reload.
Tips: [Performance & security] For better security, disable it; for better performance, enable it.
Enable ScriptGo to top
Description: Specifies whether scripting (non-static pages) is allowed in this virtual host. If disabled, CGI, Servlet and other scripting language are not allowed in this virtual host. Therefore if you want to use script handler, you need to enable it here as well.
Syntax: Select from radio box
Apply: On the fly with reload.
RestrainedGo to top
Description: Specifies whether files beyond this virtual host root($VH_ROOT) can be accessed though this web site. If set to Yes, only files under $VH_ROOT can be accessed. And access to symbolic link or context pointing to files or directories beyond $VH_ROOT will be denied. However, it does not limit the accessibility of CGI scripts. This is useful in shared hosting environment. Follow Symbolic Link can be set to Yes to allow users using symbolic links under $VH_ROOT, but not anything beyond $VH_ROOT with this option turned on.
Syntax: Select from radio box
Apply: On the fly with reload.
Tips: [Security] Turn it on in shared hosting environment.
CGI Set UID ModeGo to top
Description: Specifies how user id is set for a CGI process. Three choices are available: "Server UID", set user/group id of CGI process same as server's user/group id; "CGI file UID", set user/group id of CGI process based on the user/group id of the CGI executable; "Doc Root UID", set user/group id of CGI process based on the user/group id of the document root of current virtual host.
Syntax: Select from drop down list
Apply: On the fly with reload.
Tips: [Security] In shared hosting environment, it is recommended to use "CGI file UID" or "Doc Root UID" mode to prevent files owned by one virtual host from being accessed by CGI script of another virtual host.
CGI Chroot ModeGo to top
Description: Specifies how the root directory is set for a CGI process. In order to protect confidental system data file from being accessed by a vulnerable CGI script, an alternative root path can be set for the CGI process, files beyond the new root directory become inaccessible. It usually being called "chroot jail".
Three choices are available: "Same as Server", if server is in a chroot jail, CGI process will be in the same chroot jail, if server is not, CGI process neither; "Virtual host root", set chroot jail to the root directory of the virtual host, CGI script can only access files inside the virtual host root; "Cutomized chroot path", chroot path is specified by "CGI chroot path" below.
Syntax: Select from drop down list
Apply: On the fly with reload.
Tips: If being used properly, chroot will greatly enhance the security of CGI script, however, you have to make sure the CGI script function properly in the chroot jail.
CGI Chroot PathGo to top
Description: Specifies a new root directory for CGI scirpts of current virtual host when "CGI chroot Mode" is set to "Cutomized chroot path".
Syntax: Absolute path.
Apply: On the fly with reload.