Sun Java logo     Previous      Main      Next     

Sun logo
Sun Java System Web Proxy Server User Interface 

The Preferences Tab


The Preferences tab is used to shut down the Administration Server, edit listen sockets, configure superuser access, allow multiple administrators, and customize and view access and error logs.

The tab contains the following pages:


The Shutdown Server Page

The Shutdown Server page is used to stop the Administration Server.

The following element is displayed:

Shutdown administration Server. Click OK to shut down the Administration Server.

To restart the Administration Server on UNIX and Linux, type ./start from the server_root/proxy-admserv directory. To restart the Administration Server on Windows, restart the service or use the icon in the Program Manager.

For more information about starting and stopping the Administration Server, see the "Administering Sun Java System Web Proxy Server" chapter in the Proxy Server Administration Guide.


The Edit Listen Sockets Page

The Edit Listen Sockets page is used to edit listen socket settings. For more information about listen sockets, see "Creating and Managing Listen Sockets" in the Proxy Server Administration Guide.

The following elements are displayed when you first click the Preferences tab, and then the Edit Listen Sockets link:

Create a new Listening Socket. Click the New button to create a new listen socket. The Add Listen Socket Page displays.

Configured Sockets. This table displays information about existing listen sockets.

If you are editing listen socket settings, after clicking the listen socket ID you will be presented with another Edit Listen Sockets page. The following elements are displayed:


The Add Listen Socket Page

The Add Listen Socket page is used to add listen sockets. The following elements are displayed:

Listen Socket ID. Specify the internal name for the listen socket. You cannot change this name after the listen socket has been created.

IP Address. Specify the IP address of the listen socket. This can be in dotted-pair or IPv6 notation. This can also be 0.0.0.0, any, or ANY for INADDR_ANY (all IP addresses).

Port. Specify the port number on which to create the listen socket. Legal values are 1-65535. On UNIX, creating sockets that listen on ports 1-1024 requires superuser privileges. Configure an SSL listen socket to listen on port 443.

Server Name. Specify the default server for this listen socket.

Security. From the drop-down list, specify whether security should be enabled or disabled for the listen socket. If a server certificate has not been installed, your only choice will be Disabled.

OK. Saves your entries.

Reset. Erases your changes and resets the elements in the page to the values that they contained before your changes.


The Control Superuser Access Page

The Control Superuser Access page is used to configure superuser access for the Administration Server. These settings affect only the superuser account. If the Administration Server uses distributed administration, you must set access control for administrators using the Administer Access Control link under the Global Settings tab.

For more information, see "Changing Superuser Settings" in the Proxy Server Administration Guide.

The following elements are displayed:

Hostnames to allow. Specify the host name allowed to access the Administration Server. You can use wildcard patterns to match multiple systems in a domain. For example, *example.com matches a.example.com and a.corp.example.com. You can list multiple hosts by separating them with commas. Using host names is flexible. If a system’s IP address changes, you do not need to update the server.

IP addresses to allow. Specify the IP address to match any host not explicitly defined. The access control for the most complete match will be used. You can also use wildcard patterns. For example, 198.95.* matches 198.95.11.6 and 198.95.11.2. You can separate IP addresses by using commas. Using IP addresses is reliable. If a DNS lookup fails for the connected client, host name restriction cannot be used.

Authentication user name. Specify the user name of the superuser server administrator (this is the user name entered during installation). Only this user name can be used to log in to the Administration Server. This information is stored in the admpw file in the server-root/proxy-admserv/config directory. For more information, see "Changing Superuser Settings" in the Proxy Server Administration Guide.

Authentication Password. Specify the administrator password. If you leave the password field blank, the password remains unchanged.

Authentication Password (again). Confirm the password specified in the Authentication Password field. If what you enter is different from what you previously entered, you will be prompted to try again.


Caution

If you use Sun Java System Directory Server to manage users and groups, you must update the superuser entry in the directory before you change the user name or password in this page. If you do not update the directory first, you will not be able to access the Users and Groups pages in the Administration Server. To fix this, you must either access the Administration Server with an administrator account that does have access to the directory, or update the directory using the Directory Server’s administration server or configuration files.


OK. Saves your entries.

Reset. Erases your changes and resets the elements in the page to the values that they contained before your changes.


The Configure Distributed Administration Page

The Configure Distributed Administration page is used to allow multiple administrators to configure specific parts of the server. For distributed administration to work, the default directory service should be LDAP. For more information, see "Allowing Multiple Administrators" in the Proxy Server Administration Guide.

The following elements are displayed:

Activate distributed administration. Select Yes or No to enable or disable distributed administration.

Administrator group. Specify the group of administrators allowed to bypass the Administration Server and go directly to the Server Manager for a specific server (this group should already exist in the directory server). Users in the administrator group have full access to the Administration Server, but this access can be limited using access control. A user in the administrator group can make changes that affect other users, such as adding users or changing access control.


Caution

Once you create an access control list, the distributed administration group is added to that list. If you change the name of the administrator group, you must manually edit the access control list to change the group that it references.


OK. Saves your entries.

Reset. Erases your changes and resets the elements in the page to the values that they contained before your changes.


The Set Access Log Preferences Page

The Set Access Log Preferences page is used to specify information you want recorded in your server’s logs. Server log files are helpful for monitoring server activity and troubleshooting problems.

For more information, see "Setting Access Log Preferences" in the Proxy Server Administration Guide.


Note

Do not change the log format of a log that is already in use.


The following elements are displayed:

From the drop-down list, specify a resource to which custom logging should be applied.

Select. Click this button to load data for the selected resource.

Regular Expression. Click this button to specify a regular expression wildcard pattern to be used to identify resources. For more information about regular expressions, see "Understanding Regular Expressions" in the Proxy Server Administration Guide.

Log Client Accesses. Specify whether to include client accesses in your log files.

Log File. Specify the absolute path for the access log file. As a default, the log files are kept in the logs directory in the server root. If you specify a partial path, the server assumes the path is relative to the logs directory in the server root.

Record. Specify whether domain names or IP addresses of the systems accessing the server should be recorded in the access log.

Format. Specify which type of log file format to use in the access log. The following options are available:

Custom Format. Creates a customized format for your access log. For more information about the parameters you should use for your custom format, see "Setting Access Log Preferences" in the Proxy Server Administration Guide.

OK. Saves your entries.

Reset. Erases your changes and resets the elements in the page to the values that they contained before your changes.


The Set Error Log Preferences Page

The Set Error Log Preferences page is used to configure the information you want recorded in your server’s error logs. Server log files are helpful for monitoring server activity and troubleshooting problems.

For more information, see "Setting Access Log Preferences" in the Proxy Server Administration Guide.

The following elements are displayed:

Error Log File Name. Specify the file that stores messages from the server.

Log Level. From the drop-down list, specify the amount of information that should be logged in the errors log. The following options are available:

Log Stdout. Redirects stdout output to the errors log.

Log Stderr. Redirects stderr output to the errors log.

Log To Console. (UNIX only) Redirects log messages to the console.

Use System Logging. Specifies that the UNIX syslog service or Windows Event Logging should be used to produce and manage logs.

OK. Saves your entries.

Reset. Erases your changes and resets the elements in the page to the values that they contained before your changes.


The View Access Log Page

The View Access Log page is used to configure a customized view of information about the requests and responses to and from the server.

For more information, see "About Log Files" and "Viewing Access Log Files" in the Proxy Server Administration Guide.

The following elements are displayed:

Number Of Entries. Specify the number of entries to retrieve (the list will start with the most recent). It is recommended that this number be set to less than 1000. The default is 25. The maximum number of entries is 2147483647.

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, to see only access log entries that contain POST, type POST.

OK. Displays the log entries.

Reset. Erases your changes and resets the elements in the page to the values that they contained before your changes.

Last (number access logs). Displays the access log entries with the parameters specified in the upper section of this page.


The View Error Log Page

The View Error Log page is used to configure a customized view of the errors the server has encountered and informational messages about the server, such as when the server was started and who tried to log in.

For more information, see "About Log Files" and "Viewing Error Log Files" in the Proxy Server Administration Guide.

The following elements are displayed:

Number Of Errors To View. Specify the number of entries to retrieve (the list will start with the most recent). The default is 25.

Only Show Entries With. Specify a string or a 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, to see only those error messages that contain warning, type warning.

OK. Displays the log entries in the lower section of this page

Reset. Erases your changes and resets the elements in the page to the values that they contained before your changes.

Last (number errors). Displays the error log entries with the parameters specified in the upper section of this page.



Previous      Main      Next     


  Copyright 2006 Sun Microsystems, Inc. All rights reserved.