| Sun ONE Web Server 6.1 Administrator's Guide |
The Virtual Servers Tab
The Virtual Servers tab allows you to manage and create virtual servers and to edit basic virtual server properties. The Virtual Servers tab contains the following pages:
The Manage Virtual Servers PageThe Manage Virtual Servers page allows you to access the Virtual Server Manager and manage an individual virtual server. It provides a tree view of all virtual servers for the class.
The following elements are displayed:
Select a Virtual Server. Lists all virtual servers in the class. To access the Virtual Server Manager and manage an individual virtual server, select a virtual server from the drop-down list and then click Manage.
Tree View of the Class. This portion of the page lists every virtual server within the class. Note the following:
- Clicking the Homepage link displays the home page for that virtual server, and allows you to access the virtual server as a client.
- The status of the virtual server is also displayed (on or off). Note that while a virtual server might be on, it cannot service requests unless the server instance is also on.
Help. Displays online help.
The Add Virtual Server PageThe Create a Virtual Server page allows you to create a virtual server. For more information about virtual servers, see Virtual Servers.
The following elements are displayed:
Name. Specify a unique name for the virtual server. The name must be alphanumeric, but can also include the period (.), dash (-), and underscore (_) characters.
Connections. Select a connection to associate with a virtual server. You can choose more than one. The connection governs the listen socket, the IP address, and the port the virtual server listens on.
Urlhosts. Specify the URL hosts for the virtual server. You can enter more than one URL host, separated by spaces.
OK. Saves your entries.
Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
Help. Displays online help.
The Edit Virtual Servers PageThe Virtual Servers page allows you to view all virtual servers and edit their properties. For more information about virtual servers, see Virtual Servers.
The following elements are displayed:
Option. Use the drop-down list to edit or delete a virtual server. You cannot delete the default virtual server for the server instance.
ID. Lists all virtual servers in the class.
State. Determines whether a virtual server is on (responding to requests), off, or disabled. Make your choice from the drop-down list. Selecting Disabled indicates that the server is turned off for more serious reasons than simple maintenance.
This state is the virtual server’s state and is independent of whether the server instance is on or off. If a virtual server’s state displayed on this page is set to on, the virtual server can accept requests only if the server instance is on as well. This is also true of the default virtual server for the default server instance. If your server instance is turned off, your default virtual server may still be set to on, but it will not accept connections.
You cannot turn off or disable the default virtual server for the server instance.
Connections. Displays the connections available for selection on each virtual server of this instance.
Urlhosts. Edit the URL hosts for the virtual server.
OK. Saves your changes.
Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
Help. Displays online help.
The MIME Settings PageThe Select MIME Types for the Virtual Servers page allows you to select a MIME types file for a virtual server. For more information about MIME types, see Choosing MIME Types.
The following elements are displayed:
ID. Lists all virtual servers in the class.
MIME Type. Use the drop-down list to select a MIME types file for the virtual server. The MIME types file maps file extensions to file types. The drop-down list displays the MIME types files available on your server. For information about adding new ones, see The Mime Types Page.
OK. Saves your changes.
Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
Help. Displays online help.
The ACL Settings PageThe ACL Settings for Virtual Servers page allows you to associate one or more ACL files with a virtual server. For more information about controlling access, see Controlling Access for Virtual Servers.
The following elements are displayed:
Option. Use the drop-down list to edit or delete the association between the web server and the ACL file.
ID. Lists all virtual servers in the class.
ACL File. Click the Edit link to display the Pick ACL Files for Virtual Server page, which lists all Access Control files for the specified server instance. For more information about the elements on this page, see The Pick ACL Files for Virtual Server Page.
Database. Use the drop-down list to select the database for the virtual server.
Base DN. The entry here overrides the base DN lookup in the dbswitch.conf file. Note that the base DN value is still relative to the base DN value from the dbswitch.conf entry.
OK. Saves your changes.
Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
Help. Displays online help.
The Pick ACL Files for Virtual Server PageThe Pick ACL Files for Virtual Server page lists all Access Control files created for the specified server instance.
The page displays a space-separated list of ACL files. Each ACL file must have a unique name. The name of the default ACL file is generated.https-server_id.acl, and the file resides in the server_root/server_id/httpacl directory. To use this file, you must reference it in server.xml. You can select more than one ACL file with which to associate your virtual server. You can associate a virtual server with a newly created ACL file on this page.
For more information about controlling access, see Controlling Access for Virtual Servers.
The following elements are displayed:
Access Control File. Lists all Access Control files created for the specified server instance. Select the ACL file for the virtual server by highlighting it in the list.
OK. Saves your changes.
Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
Help. Displays online help.
Quit. Allows you to exit this page without saving any changes.
The Quality of Service PageThe Quality of Service for Virtual Servers (QOS) page includes settings for the performance limits for a virtual server. You can control two areas: the amount of bandwidth, and the number of connections.
For more information, see Using Quality of Service.
The following elements are displayed:
Action. Use the drop-down list to enable or disable quality of service features for the virtual server listed in the “Apply to” column. If you select Enable, quality of service must also be enabled for the server instance.
Apply to. Specifies the virtual server to which to apply the quality of service limits.
Bytes per Sec. Specify the maximum bandwidth limit for the virtual server in bytes per second.
Enforce B/W. Specify whether the bandwidth limit should be enforced by selecting On (yes) or Off (no) from the drop-down list. If the limit is enforced (On is selected), the virtual server refuses connections after reaching the limit.
Max Connection. Specify the maximum number of concurrent connections for the virtual server.
Enforce Cnxs. Specify whether the connection limit should be enforced by selecting On (yes) or Off (no) from the drop-down list. If the limit is enforced (On is selected), the virtual server refuses connections after reaching the limit.
OK. Saves your changes.
Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
Help. Displays online help.
The Logging Settings PageThe Logging Settings for Virtual Servers page is used to change the virtual server’s access and error log locations from the default values. For best results, each virtual server should have its own access and error logs.
For more information about log files, see About Log Files and Configuring Virtual Server Log Settings.
The following elements are displayed:
ID. Lists all virtual servers in the class.
Access Log. Specify the location of the access log for the virtual server. Enter an absolute path to the location.
Error Log. Specify the location of the error log for the virtual server. Enter an absolute path to the location.
Default. Click the Default link to reset your log paths to the default log path. The default is the path to your server instance’s access and error logs.
OK. Saves your changes.
Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
Help. Displays online help.
The CGI Settings PageThe Virtual Servers CGI Setting page (UNIX/Linux) allows you to set properties that determine how CGI programs run in an individual virtual server. These settings override those set at the class level, as described in The Edit Classes Page.
The following elements are displayed:
Class Name. The virtual server name.
User. Specify the name of the user to execute CGI programs as.
Group. Specify the name of the group to execute CGI programs as.
Chroot. Specify the directory to chroot to before execution begins.
Directory. Specify the directory to chdir to after chroot but before execution begins.
Nice. Specify a nice value, an increment that determines the CGI program's priority relative to the server. Typically, the server is run with a nice value of 0 and the nice increment would be between 0 (the CGI program runs at the same priority as the server) and 19 (the CGI program runs at a much lower priority than the server). While it is possible to increase the priority of the CGI program above that of the server by specifying a nice increment of -1, this is not recommended.
OK. Saves your changes.
Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
Help. Displays online help.
