| Sun ONE Web Server 6.1 Administrator's Guide |
The Preferences Tab
The Preferences tab allows you to view information about a virtual server and edit its settings. The Preferences tab contains the following pages:
The Status PageThe Status page lists information about a virtual server. To edit settings, you must go to the Settings page on the Preferences tab.
The following elements are displayed:
Server Name. Name of the virtual server.
Belongs To. Virtual server class to which the virtual server belongs.
Urlhosts. URL hosts for the virtual server. If blank, the virtual server is accessed using an IP address.
State. Indicates whether a virtual server is on (responding to requests), off, or disabled. Disabled indicates that the server is turned off for more serious reasons than simple maintenance.
MIME File. Name of the MIME file for the virtual server.
ACL File. Name of the ACL file for the virtual server.
Access Log. Access log used by the virtual server. Click the link to view the log.
Error Log. Error log used by the virtual server. Click the link to view the log.
Help. Displays online help.
The View Access Log PageIf you are accessing this page from the Administration Server, see The View Access Log Page in the Administration Server section.
If you are accessing this page from the Server Manager, see The View Access Log Page in the Server Manager section.
The View Access Log page allows you to configure a customized view of information about requests to the server instance and responses from the server.
For more information, see the following sections:
The following elements are displayed:
Number of entries. Specify the number of entries to retrieve (starting with the most recent).
Only show entries with. Specify a string or character to filter the log entries. Case is important; the case of the string or character specified in this field must match the case of the entry in the access log. For example, if you want to see only access log entries that contain POST, type “POST.” If all virtual servers are logged to one main log file, and you have configured the log file to log the virtual server ID ($vsid$), enter the virtual server ID in this field to get just the entries for a single virtual server.
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.
Last number accesses to access. Displays the access log entries with the parameters specified in the upper section of this page.
The View Error Log PageIf you are accessing this page from the Administration Server, see The View Error Log Page in the Administration Server section.
If you are accessing this page from the Server Manager, see The View Error Log Page in the Server Manager section.
The View Error Log page allows you to configure a customized view of errors the server has encountered and informational messages about the server, such as when the server was started and who has tried to access the server.
For more information, see the following sections:
The following elements are displayed:
Number of errors to view? Specifies the number of entries to retrieve (starting with the most recent).
Only show entries with. Specify a string or character to filter the log entries. Case is important; the case of the string or character specified in this field must match the case of the entry in the error log. For example, if you want to see only those error messages that contain warning, type “warning.” If all virtual servers are logged to one main log file, and you have configured the log file to log the virtual server ID ($vsid$), enter the virtual server ID in this field to get just the entries for a single virtual server.
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.
Last number errors with. Displays the error log entries with the parameters specified in the upper section of this page.
The Settings PageThe Settings page allows you to edit the settings for a virtual server. The following elements are displayed:
State. Specifies whether a virtual server is on (responding to requests), off, or disabled. Disabled indicates that the server is turned off for more serious reasons than simple maintenance. You cannot turn off or disable the default virtual server for the server instance.
Document Root. Specify the primary document directory (document root) for the virtual server.
Access Log. Specify the access log used by the virtual server.
Error Log. Specify the error log used by the virtual server.
Directory Services. Click the Edit link to display the Pick Directory Services for Virtual Server page, which lists all directory services for the specified server instance. For more information about the elements on this page, see The Pick Directory Services for Virtual Server Page.
ACL Files. 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.
MIME File. Specify the name of the MIME file for the virtual server.
CGI User. Specify the name of the user to execute CGI programs as. This setting is used on UNIX/Linux.
CGI Group. Specify the name of the group to execute CGI programs as. This setting is used on UNIX/Linux.
CGI Directory. Specify the directory to chdir to after chroot but before execution begins. This setting is used on UNIX/Linux.
CGI 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. This setting is used on UNIX/Linux.
Chroot Directory. Specify the directory to chroot to before execution begins. This setting is used on UNIX/Linux.
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 Pick Directory Services for Virtual Server PageThe Pick Directory Services for Virtual Server page lists all directory services for the specified server instance. The page allows you to select the directory services to use with a specific virtual server.
For more information, see Configuring a Directory Service.
The following elements are displayed:
Directory Services. Lists the directory services for the specified server instance. Select a directory service by highlighting it in the list.
OK. Saves your changes. Click Apply after saving your changes to allow the changes to take effect.
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 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 Pick ACL Files for Virtual Server 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 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.
