| Sun ONE Web Server 6.1 Administrator's Guide |
The Virtual Server Class Tab
The Virtual Server Class tab allows you to add and edit virtual server classes. It also gives you access to the Class Manager, and displays a tree view of all classes and their virtual servers for the server instance.
The Manage Classes PageThe Manage Classes Page allows you to move to the Class Manager to manage an individual class. It also gives you a tree view of all the classes and virtual servers for your servers instance.
The following elements are displayed:
Select a Class. Lists all the classes.
Tree View of the Server. The Tree View of the Server portion of the page lists every class and 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.
Help. Displays online help.
The Add Class PageThe Add a Class page allows you to create a class of virtual servers. All virtual servers in a class by default have the same settings, though you can edit some settings for an individual virtual server.
For more information, see Virtual Server Classes.
The following elements are displayed:
Name. A unique name for the virtual server class.
Class Docroot. The default document root directory for the class. This directory must be an absolute path. If you want each virtual server within the class to have its own unique document root by default, use a variable in this path. For example, if your path is server_root/docs/$id, each virtual server by default has a directory named with it’s virtual server ID within the docs directory, for example, virtual server vs1 document root would be server_root/docs/vs1.
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 Edit Classes PageThe Edit a Class page allows you to view all classes in a table and edit their properties.
For more information, see Virtual Server Classes.
The following elements are displayed:
Option. Determines whether a class is being edited or deleted. You cannot delete the default class created when you installed the server.
Note
If the Virtual Server class contains a Virtual Server which is the default Virtual Server ID for a Listen Socket, that Virtual Server Class also cannot be deleted.
Class Name. The names of all the virtual server classes.
Document Root. Allows you to change the default document root for a class. If you want each virtual server within the class to have its own unique document root by default, use a variable in this path. For example, if your path is server_root/docs/$id, each virtual server by default has a directory named with it’s virtual server ID within the docs directory, for example, virtual server vs1 document root would be server_root/docs/vs1.
Accept Language. Allows you to turn accept language header parsing on or off for this class of virtual servers. The default is off.
Accept language headers are headers sent by clients using HTTP 1.1. These headers contain information describing the languages the clients accept.
For example, if you store documents in Japanese and English, you could choose to parse the accept language header. When clients that have Japanese as the accept language header contact the server, they receive the Japanese version of the page. When clients that have English as the accept language header contact the server, they receive the English version.
If you do not support multiple languages, you should not parse the accept language header. For more information, see Configuring the Server to Serve Localized Content.
Advanced. Allows you to change the class’ CGI settings. These settings are used for UNIX/Linux.
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.
Virtual Servers CGI SettingsThe Virtual Servers CGI Setting page allows you to set the default CGI settings for a class of virtual servers. These settings are used for UNIX/Linux.
For more information, see the SUN ONE Web Server 6.1 Programmer’s Guide and the SUN ONE Web Server 6.1 NSAPI Programmer’s Guide.
The following elements are displayed:
Class Name. The names of all the virtual server classes.
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 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.
Note
If values are deleted at the Virtual Server level by blanking out the fields, it will inherit these values from the Class/Server level.
Reset. Erases your changes and resets the elements in the page to the values they contained before changes were made.
Help. Displays online help.
Quit. Quits the page without saving changes.
