Chapter 4 Using a Serial Terminal to Configure a Netra Proxy Cache Server

• "Invoking the Command-line Program"

• "Proxy Cache Service Configuration"

• "Install Configuration on Host"

This chapter describes the command-line program you can use to configure a Netra Proxy Cache Server. This program is alternative to the configuration web pages described in Chapter 3, Proxy Cache Service Configuration.

Please fill out the tables in Chapter 1, Preparing for Installation and Configuration,," before starting the procedures in this chapter.

Following initial host configuration, described in Chapter 2, Initial Host Configuration," a Netra Proxy Cache Server is fully functional as a proxy cache machine with the following settings:

• An email alias for proxy cache trouble reports of root

• An HTTP port number of 8080, for listening to HTTP requests

• An Inter Cache Protocol (ICP) port number of 3031, for listening to ICP requests

• Configuration for being outside of a firewall; that is, no parent or sibling proxies

If these settings meet your needs, you can skip this chapter and consult the Netra Proxy Cache Server User's Manual, to read about the advanced configuration properties available for fine-tuning your proxy cache service.

For invoking the command-line configuration program, it is assumed that you have connected a terminal, workstation, or PC to your Netra Proxy Cache Server. See Appendix A, Establishing a tip Connection," for instructions.

Invoking the Command-line Program

To Invoke the Command-line Program

1. As root, invoke the command-line program as follows:

   ---

   # cd /opt/SUNWoam/bin
   # ./quickconfig
   

   ---

   The main menu is displayed:

   ---

    Proxy Cache Quick Configuration and Installation Tool
   
   This tool is used to define the following information for
   the Proxy Cache Server:
   
           email address for the Webmaster
           HTTP port number
           parent proxies
   
   This tool allows only basic Proxy Cache configuration.
   For advance configuration, please use the Netra Proxy Cache GUI tool.
   
   -----------------------------------------------------------------------
   
   Obtaining information from configuration database. Please wait...
   
   -------------------------------------------
   Main Menu
   -------------------------------------------
   
   Please select one of the following options:
   
   1. Configure Proxy Cache Service
   2. Configure SNMP
   3. Install Configuration on Host
   4. Display Proxy Cache Service Configuration
   5. Display SNMP configuration
   0. Quit
   
   Select a number (from 0 to 5):

   ---

Proxy Cache Service Configuration

To Configure the Proxy Cache Service

To perform basic proxy cache configuration, use the data you gathered in Table 1-3 and Table 1-4.

1. In the main menu, enter 1 (Configure Proxy Cache Service).

2. In the Configuring Proxy Cache Service Menu, enter 1 (Configure Proxy Cache Service [via Genie]).

3. Enter an email address that will receive reports of abnormal conditions on the Netra Proxy Cache Server or accept the default of root.

4. Enter a port number for receiving HTTP requests or accept the default of 8080.

5. Specify (y or n) whether the Proxy Cache Server is inside a firewall.

   If it the server is not inside a firewall, skip to Step 10. If the server is inside a firewall, proceed to the next step.

6. In the Add/Delete Domains Firewall Menu, enter 0 to create a domain.

7. Enter the name of a domain inside the firewall.

   For URLs containing domains not in this list, the Netra Proxy Cache Server always tries to fetch the object from a parent or sibling cache, if it does not have the object in its local cache. Domains added to this list are also added to the Local Domains property, described in the Netra Proxy Cache Array User's Manual.

8. Repeat Step 6 and Step 7 for each domain you want to add. When you are finished adding domains, enter the number for the option to return to the Proxy Cache Service Menu.

9. In the Proxy Cache Service Menu, enter 2 to create a new parent proxy.

10. In the Add/Delete/Edit Parent Proxy Menu, enter 0 to create a new parent proxy or 1 to return to the Proxy Cache Service Menu.

    If you do not have a parent proxy, skip to Step 15. Otherwise, proceed to the next step.

11. Enter 0 to create a new parent proxy.

12. For a given parent proxy, enter:

    • host name

    • HTTP port number

    • ICP port number

    • whether the proxy supports tunneling of the Secure Sockets Layer (SSL) protocol

    • whether the proxy supports persistent connections (keep alive feature)

13. Repeat Step 11 and Step 12 for each parent you want to add.

14. When you are finished adding parents, in the Add/Delete/Edit Parent Proxy Menu, enter the number for the option to return to the Proxy Cache Service Menu.

15. In the Configuration Proxy Cache Service Menu, enter 6 to return to the main menu.

    Your proxy cache configuration is displayed.

16. Enter y to confirm your proxy cache configuration or press Return to change one or more entries.

After you confirm your proxy cache configuration, your entries are saved to a configuration database and you return the quickconfig main menu.

Install Configuration on Host

Perform this procedure after you have completed proxy cache service configuration.

To Install Your Software Configuration

At this point, your configuration selections are recorded in a database. You need to install the configuration on your Netra Proxy Cache Server for your choices to take effect.

1. In the main menu, enter 3 (Install Configuration on Host).

2. Enter y to confirm installation on your Netra Proxy Cache Server.

   Upon successful installation, you are returned to the main menu.

3. In the main menu, enter 0 to exit quickconfig.

At this point, your Netra Proxy Cache Server is fully operational. See the Netra Proxy Cache Server User's Manual for instructions on performing advanced configuration of your machine.