| Previous Contents Index DocHome Next |
| iPlanet Web Server, Enterprise Edition Administrator's Guide |
The Virtual Servers Tab
The Virtual Servers Tab allows you to manage and create virtual servers and edit basic virtual server properties. The Virtual Servers Tab contains the following pages:
The Manage Virtual Servers Page
The ACL Settings for Virtual Servers Page
The Manage Virtual Servers Page
The Manage Virtual Servers page allows you to select a virtual server and access the Virtual Server Manager to manage an individual virtual server. It also gives you a tree view of all the virtual servers for the class.The following elements are displayed:
Select a Virtual Server. Lists all the virtual servers in the class.
Note To display the Virtual Server Manager tabs, choose a server from the drop-down list and click Manage.
Tree View of the Class. The Tree View of the Class portion of the page lists every virtual server within the class.
The HomePage link takes you to the home page for that virtual server. It lets you access that virtual server as a client.
The On/Off displayed next to the virtual server indicates the virtual server's status, whether it is on or off. Please note that a virtual server can be on, but it will not be able to service requests unless the server instance is also on.
The Add Virtual Server Page
The Add Virtual Server page allows you to create a virtual server.For more information, see Virtual Servers.
Name. A unique name for the virtual server. The name must be alphanumeric, though you can also include the period (.), dash (-), and underscore (_) characters.
Connections. A list of the connections to associate to a virtual server. You can choose more than one. The connection governs the listen socket, IP address, and port the virtual server listens on.
Urlhosts. A space-separated list of values allowed in the Host request header to select the current virtual server.
Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
The Edit Virtual Servers Page
The Virtual Servers page allows you to view all virtual servers in a table and edit their properties.For more information, see Virtual Servers.
The following elements are displayed:
Option. Allows you to edit or delete a virtual server. You cannot delete the default virtual server for the server instance, or a virtual server which is the default server for a connection group.
ID. The names of all the virtual servers in the class.
State. Determines whether a virtual server is On (responding to requests) Off, or Disabled. If you choose Disable, you are indicating that the server is turned off for more serious reasons than simple maintenance.
This state is the virtual server's state, which is independent of whether the server instance is on or off. If a virtual server's state displayed on this page is On, the virtual server can only accept requests if the server instance is on as well.
This is true of the default virtual server for the default server instance as well. If you turn off your server instance, your default virtual server may still be set to On, but will not accept connections.
You cannot turn off or disable the default virtual server for the server instance.
Connections. Click Edit to change the connection settings for a virtual server using The Edit Connections Page.
Urlhosts. A space-separated list of values allowed in the Host request header to select the current virtual server.
Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
The Edit Connections Page
The Edit Connections Page allows you to choose the connections (combination of listen socket, IP address, and port) that the virtual server listens on.For more information, see Connection Groups.
Connections. A list of all connections available for this virtual server. You can choose more than one.
Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
Quit. Quits the page without saving changes.
The Mime Settings Page
The Pick MIME Types for Virtual Servers Page allows you to select a MIME types file for a virtual server.For more information on MIME types, see Choosing MIME Types.
ID. The names of all the virtual servers.
MIME Type. Allows you to select a MIME types file for the virtual server. The MIME types file maps file extensions to file types. This list shows the MIME types files available on your server. To add a new one, see The Mime Types Page.
Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
The ACL Settings for Virtual Servers Page
The ACL Settings for Virtual Servers page allows you to configure one or more ACL files to a virtual server.For more information, see the Controlling Access for Virtual Servers.
Option. Allows you to select Edit or Delete from the drop-down list.
ID. Lists the virtual server IDs. The default virtual server is listed first.
ACL File. Allows you to bring up the The Pick ACL Files for Virtual Server Page page by clicking the Edit link.
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 to associate your virtual server with. You can associate a virtual server with a newly created ACL file here.
Database. Allows you to select the database for the virtual server from the drop-down list.
Base DN. Overrides the base DN lookup in the dbswitch.conf file. However, the base DN value is still relative to the base DN value from the dbswitch.conf entry.
Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
The Pick ACL Files for Virtual Server Page
The Pick ACL Files for Virtual Server Page lists all the Access Control files created for the specified server instance. You can select the ACL file for the virtual server by highlighting it in the list. For more information, see Controlling Access for Virtual Servers.Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
Quit. Allows you to exit this page without saving any changes.
The Quality of Service Page
Quality of Service for Virtual Servers page includes settings for the performance limits you set for a virtual server.You can limit 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. Enables or disables quality of service features for the virtual server listed in the Apply to column. Quality of service must also be enabled for the server instance in order for it to work for the virtual server.
Apply to. The virtual server ID to apply the quality of service limits to.
Bytes per second. The maximum bandwidth limit for the virtual server in bytes per second.
Enforce B/W. Specifies whether the bandwidth limit should be enforced. If the limit is enforced the virtual server refuses connections after reaching the limit.
Max Connection. The maximum number of concurrent connections for the virtual server.
Enforce Connections. Specifies whether the connection limit should be enforced. If the limit is enforced the virtual server refuses connections after reaching the limit.
Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
The Logging Settings Page
Use this page to change the virtual server's access log and error log locations from the default value. For best results, each virtual server should have its own access and error logs.For more information on log files, see Using Log Files. For more information on log files with virtual servers, see Configuring Virtual Server Log Settings.
The following elements are displayed:
ID. The names of all the virtual servers.
Access Log. The location of the access log. Enter an absolute path to the location.
Error Log. The location of the error log. Enter an absolute path to the location.
Default. Resets your log paths back to the default log path. The default is the path to your server instance's error and access logs.
Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
The Java Web-Apps Settings Page
The Java Web Apps Manipulation Page allows you to assign a web applications file to a virtual server. The web applications file contains settings for all the web applications in the virtual server.For more information, see the Programmer's Guide to Servlets.
ID. The names of all the virtual servers.
Web Apps File. The web application file of the virtual server in the ID column.
Web Apps State. Determines whether the web applications referenced in the file are active (on).
Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
The CGI Settings Page
The Virtual Servers CGI Setting page 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 in the The Edit Classes Page. These settings are used for Unix/Linux.For more information, see the Programmer's Guide and the NSAPI Programmer's Guide.
The following elements are displayed:
Option. Allows you to choose the Default settings, Overwrite settings, or Delete settings for the virtual server in the ID column.
ID. The names of all the virtual servers.
User. The name of the user to execute CGI programs as.
Group. The name of the group to execute CGI programs as.
Chroot. The directory to chroot to before execution begins.
Directory. The directory to chdir to after chroot but before execution begins.
Nice. 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 same priority as server) and 19 (the CGI program runs at much lower priority than 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.
Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
Previous Contents Index DocHome Next
Copyright © 2001 Sun Microsystems, Inc. Some preexisting portions Copyright © 2001 Netscape Communications Corp. All rights reserved.
Last Updated May 10, 2001