Accessing the Configuration and Administration forms

To access the Configuration and Administration forms:

  1. Ensure that the proxy server is running. For instructions on starting the proxy server, refer to Starting and stopping Caching Proxy.
  2. Direct an HTTP browser to request your proxy server's home page (Frntpage.html) or the Configuration and Administration start page (wte.html).
    Note:
    This page depends on your proxy server's actual mapping rules and can vary from the default pages shown in parentheses.
    http://your.server.name[:port][/directory][/page.html]
    
    where
  3. Click Configuration and Administration forms to get to the server configuration forms. You are prompted for the administrator user name and password. Type an authorized user name and password. The Caching Proxy configuration client window opens.
    Notes:
    1. The contents of the navigation frame on the left can take several seconds to load after the main page is displayed.
    2. On Windows 2003 systems, connections that request administration forms (CGI scripts) might receive a reset before the connection is complete. As a result, browsers might report no data received or display page not available messages. To avoid this problem, increase MaxActiveThreads to a value greater than 200, or increase ConnThreads to a value greater than 50 to resolve the reset connections. See MaxActiveThreads -- Specify the maximum number of active threads and ConnThreads -- Specify the number of connection threads to be used for connection management for more information on these directives.
  4. The navigation frame on the left shows the five major categories of configuration forms: Click the triangular pointer at the left of a heading to expand the list of configuration forms in that category. Click a form to open it. The form shows the current configuration values (if any) in the input fields; if you have not changed the configuration since installation, these are default values.
  5. On any form, enter configuration information for that particular function. Each form provides instructions to assist you in deciding what changes to make. For further information, click the help icon, the question mark (?) at the top of each form. It provides the following links:
  6. After filling in a form, click Submit to update the server configuration with the changes you made. The Submit button is located below the input fields on each form. If you do not want to make the changes you indicated on the form, click Reset, and the fields on the form return to their original values.
  7. If you click Submit and your input is accepted, the following message is displayed in the upper frame:
    The requested configuration changes have been completed successfully
    If the input is not accepted, an error message is displayed in the upper frame, indicating which settings are not acceptable.
  8. To restart the proxy server, click the server restart icon (|) in the upper frame. When the proxy server receives the restart command, it stops accepting requests from clients but completes any requests that are already in process. After reloading the changed configuration file, the proxy starts accepting client requests again.
    Note:
    Changing certain directives either by using the Configuration and Administration forms or by editing the ibmproxy.conf file requires that instead of a restart, you stop the server completely and then start it again before the changes can take effect. Those directives are listed in Table 6.