test

Netra Proxy Cache Array Configuration Guide

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

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

It is strongly recommended that you read Chapter 1, Preparing for Installation and Configuration," and fill out the tables in that chapter before starting the procedures described here.

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:

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

You invoke the command-line configuration program on the machine you specified in "Choosing an Administrative Host". You make all configuration changes for the proxy cache service, for the array software, and for the array members on a single machine, referred to as the administrative host. You then install those changes on all hosts in the array.

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

For configuration of the Netra Proxy Cache Array, it is required that the proxy cache administration server be started. (You can start this server in the Proxy Cache Administration page, as described in "Starting the Proxy Cache Administration Server".) If the server is not started, the quickconfig program starts it: 

Starting OamServer... Done.

After quickconfig starts the proxy cache administration server, the main menu is displayed: 

-------------------------------------------
Main Menu
-------------------------------------------
 
Please select one of the following options:
 
1. Configure Array Network
2. Configure Proxy Cache Service
3. Configure SNMP
4. Install Configuration
5. Display Proxy Cache Service Configuration
6. Display SNMP configuration
0. Quit
 
Select a number (from 0 to 6):

Array Network Configuration

To Perform Array Network Configuration

To enter values for the array configuration properties, use the data you gathered in Table 1-6.

  1. In the quickconfig main menu, enter 1 to select Configure Array Network.

  2. Enter the subnet address of your control network.

    For example, 192.168.89.0.

  3. Enter the netmask for your control network or accept the default of 255.255.255.0.

  4. Enter the subnet address of your service network.

    For example, 129.144.91.0.

  5. Enter the netmask for your service network or accept the default of 255.255.255.0.

  6. Enter the domain name of the proxy cache service provided by your Netra Proxy Cache Array.

    For example, if you are in the domain acme.com, you might use cache.acme.com.

  7. Enter the host name of the host in the array that will act as DNS server for the array.

    It is recommended you use your administrative host.

  8. Enter the service address for the DNS on the host you specified in Step 7.

    For example, 129.144.91.1.

    After you enter a DNS service address, quickconfig displays your array network entries.

  9. Enter y to confirm your array network entries or press Return to change one or more entries.

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

When you return to the main menu following first-time configuration of the array network, additional options are displayed for the first time: 

-------------------------------------------
Main Menu
-------------------------------------------

Please select one of the following options:

1. Configure Array Network
2. Configure Proxy Cache Service
3. Add, Delete, Modify Hosts in Array (new)
4. Configure SNMP
5. Install Configuration on Hosts in Array (changed)
6. Display Array Network (new)
7. Display Proxy Cache Service Configuration
8. Display list of Hosts in Array (new)
9. Display SNMP configuration
0. Quit

Select a number (from 0 to 9):

Unless you unconfigure your proxy cache service, from this point on, the main menu is displayed as shown above.

Proxy Cache Service Configuration

The order of the basic proxy cache configuration and basic array configuration sequences is not significant. However, for these instructions, it is assumed you have completed the basic array configuration, as described in the preceding section.

To Configure the Proxy Cache Service

For the following procedure, use the data you gathered in Table 1-4 and Table 1-5.

  1. In the main menu, enter 2 (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 Chapter 4 of 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.

Add Hosts in Array

You must have completed array network and proxy cache configuration before starting the procedure described here. You must perform this procedure for each host in your Netra Proxy Cache Array, including the administrative host.

To Add Hosts to Your Array

To fill in values for array host configuration, you need the data you gathered in Table 1-7.

  1. In the main menu, enter 3 (Add, Delete, Modify Hosts in Array).

  2. In the Add, Delete, Modify Hosts in Array Menu, enter 0 (Add a new host member to the array).

  3. For a given array host enter:

    • host name

    • host address (the fixed IP address of the host; for example, 129.144.91.100).

    • control address (for example, 192.168.89.1)

    • proxy cache service address (for example, 129.144.91.18.1).

    After you enter a proxy cache service address, the Add, Delete, Modify Hosts in Array Menu is redisplayed.

  4. Enter 0 to add an additional host to the array. Repeat Step 2 and Step 3 for each host you want to add to the array.

  5. When you are finished adding hosts, enter the number for the option to return to the main menu.

  6. Enter y to confirm your host configuration or press Return to change one or more entries.

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

Install Configuration on Hosts in Array

Perform this procedure after you have completed the procedures described in the preceding sections.

To Install Configuration on Hosts in Array

At this point, your array network, proxy cache, and host selections are recorded in a configuration database. You need to install the configuration on all of the hosts in the array (including the administrative host) for your choices to take effect.

  1. In the main menu, enter 5 (Install Configuration on Hosts in Array).

  2. In the Install Configuration on Hosts Menu, enter 0 to select all hosts.

  3. Enter y to confirm installation on all hosts in the array.

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

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

    Upon exiting, the proxy cache administration server is terminated: 

    Stopping OamServer... Done.

At this point, the only task remaining to make your Netra Proxy Cache Array fully operational is to configure the DNS to delegate the domain of the Netra Proxy Cache Array to the array DNS server (by that server's DNS service address). This task is described in "Updating the DNS".