Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java System Web Proxy Server 4.0.1 Administration Guide 

Chapter 6
Managing Server Clusters

This chapter describes the concept of clustering Sun Java System Web Proxy Servers, and describes how clusters can be used to share configurations among servers.

This chapter contains the following sections:

About Server Clusters

A cluster is a group of Sun Java System Web Proxy Servers that can be administered from a single Administration Server. Each cluster must include one server designated as the master Administration Server.

By organizing servers into clusters you can:

Guidelines for Using Clusters

The following list provides guidelines for configuring groups of Proxy Servers into clusters:

Setting Up Clusters

Following are the general steps you will take to set up Proxy Server clusters.

To set up Proxy Server clusters
  1. Install the Proxy Servers you want included in the cluster. Make sure the Administration Server for the cluster has a user name and password that the master Administration Server can use for authentication. You can do this by using the default user name and password, or by configuring distributed administration.
  2. Install the Proxy Server that will contain the master Administration Server, making sure the user name and password matches the one set in Step 1.
  3. Add a server to the cluster list. For more information, see Adding Servers to a Cluster.
  4. Administer a remote server by accessing its Server Manager interface from the Control Cluster page, or by copying a configuration file from one server in the cluster to another.

Adding Servers to a Cluster

When a Proxy Server is added to a cluster, its Administration Server and port number are specified. If that Administration Server contains information about more than one server, all of its servers are added to the cluster. Individual servers can be removed at a later time.


If a remote Administration Server contains information about a cluster, the servers in the remote cluster are not added. The master Administration Server adds only those servers that are physically installed on the remote computer.

To add remote servers to a cluster
  1. Make sure that the master Administration Server is turned on.
  2. Access the master Administration Server and click the Cluster tab.
  3. Click the Add Server link.
  4. Choose the protocol used by the remote Administration Server:
    • HTTP for a typical Administration Server
    • HTTPS for a secure Administration Server
  5. Enter the fully qualified host name of the remote Administration Server as it appears in the magnus.conf file (for example,
  6. Enter the port number for the remote Administration Server.
  7. Enter the administrator user name and password for the remote Administration Server and click OK. The master Administration Server attempts to contact the remote server. If successful, you are prompted to confirm the addition of the server to the cluster.

  8. Note

    When cluster control is enabled, the master of the cluster creates a number of files in the proxy-serverid/config/cluster/server_name/proxy-serverid directory for each slave in the cluster. These files are not configurable.

Modifying Server Information

Use the Modify Server option on the Cluster tab of the Administration Server only to update slave administration port information after it has been changed on the slave server. If you change the port number of a remote Administration Server in your cluster, you must also modify the information about that Administration Server stored in the cluster. Any other changes to the slave Administration Server require you to remove the server, and then add it back into the cluster after the changes have been made.

To modify information about servers in a cluster
  1. Access the master Administration Server and click the Cluster tab.
  2. Click the Modify Server link. Servers display, listed by unique server identifiers.
  3. Select the server to be modified, make the desired changes, and then click OK.

Removing Servers from a Cluster

To remove servers from a cluster
  1. Access the master Administration Server and click the Cluster tab.
  2. Click the Remove Server link.
  3. Select the remote server(s) to remove from the cluster and click OK. The removed server can no longer be accessed through the cluster. It can only be accessed through its own Administration Server.

Controlling Server Clusters

Proxy Server enables you to control the remote servers in your cluster by:

To control servers in a cluster
  1. Access the master Administration Server and click the Cluster tab.
  2. Click the Control Cluster link.
  3. Select the server(s) to control and make your desired selections. Click the Reset button at any time to reset elements to the values they contained before any changes were made.
    • Select Start, Stop, or Restart from the drop-down list and click Go. You will be prompted to confirm the action.
    • Select View Access or View Error from the drop-down list and enter the last number of lines you want to view in the log file. Click Go to display the information (click the View button in the Cluster Execution Report that displays).
    • Transfer configuration files:
      • Select the configuration file you want to transfer
      • Select the server on which the file resides
      • Click Go to transfer the information

Previous      Contents      Index      Next     

Part No: 819-3650-10.   Copyright 2005 Sun Microsystems, Inc. All rights reserved.