Sun ONE Web Server 6.1 Administrator's Guide |
Chapter 7
Managing Server ClustersThis chapter describes the concept of clustering Sun ONE Web servers and explains how you can use them to share configurations among servers.
This chapter includes the following sections:
About ClustersA cluster is a group of Sun ONE Web Servers that can be administered from a single Administration Server. Each cluster must include one server designated as the administration server. If you have more than one cluster, you can administer all clusters from a single “master” Administration Server. The master administration server retrieves the information about all the clusters and provides the interface for managing the Sun ONE Web Servers installed in their respective clusters.
Here are some of the tasks you can accomplish by organizing your servers into clusters:
By clustering your Sun ONE Web Servers, you’re able to specify a master Administration Server for administering all of your clusters.
Guidelines for Using Server ClustersWhen you configure a cluster, the master Administration Server containing the information about all clusters communicates with each individual cluster’s Administration Server. The administration server for each cluster must be given the same administration user name and password that the master Administration Server will have.
Before you can create a cluster, all of the servers you want to include in the cluster must be installed. For example, if you want three clusters of five Sun ONE Web Servers per cluster, you would need to:
- Install all of the servers on the computers where they’ll run using the same administration user name and password as the master Administration Server.
- Configure one of the Sun ONE Web Servers in each cluster as the Administration Server.
- Configure one single cluster’s administration server as the master Administration Server for all clusters. It doesn’t matter which server you choose as the master administration server.
The following list provides some guidelines for configuring groups of servers into clusters:
- Install all of the servers you want to include in a particular cluster prior to creating any clusters.
- Make sure all servers in a cluster must be version 6.1 Sun ONE Web Servers.
- Make sure all cluster-specific Administration Servers have the same userid and password as the master administration server. You can use distributed administration to set up multiple administrators on each Administration Server.
- Install servers on any computer in a network, as long as all computers in the cluster are Windows or UNIX.
- You can designate any cluster-specific Administration Server as the master administration server.
- Make sure the master Administration Server has access to each cluster-specific Administration Server. The master Administration Server retrieves information about all installed Sun ONE Web Servers.
- Make sure all Administration Servers are Sun ONE Web Server version 6.0 or 6.1 and use the same protocol, HTTP or HTTPS. Only Sun ONE Web Server 6.0 or 6.1 servers are supported for addition to clusters.
- If you change the protocol of one Administration Server in a cluster, you must change the protocols for all Administration Servers. Then use the Modify Server interface to modify the individual servers in the cluster.
Setting Up a ClusterTo set up a Sun ONE Web Server cluster, perform the following steps:
- Install the Sun ONE Web Servers on the computers you want to include in the cluster.
Make sure the Administration Server for the cluster has a username and password that the master Administration Server can use for authentication. You can do this either by using the default username and password or by setting up distributed administration.
- Install the server that will contain the master Administration Server, making sure the username and password matches the one set in Step 1.
- Add a server to the cluster list.
- Administer a remote server by accessing its Server Manager forms from the cluster form or by copying a configuration file from one server in the cluster to another.
Adding a Server to a ClusterWhen you add a server to a cluster, you specify its Administration Server and port number. If that Administration Server contains information about more than one server, all of its servers are added to the cluster. You can remove individual servers later.
To add a remote server to a cluster, perform the following steps:
- Make sure the master Administration Server is tuned on.
- Access the Administration Server and choose the Cluster Mgmt tab.
- Click the Add Server link.
- Choose the protocol that the remote Administration Server uses.
- Enter the fully qualified domain name as it appears in the magnus.conf file of the remote server in the Admin Server Hostname field.
For example: plaza.sun.com
- Enter the port number for the remote Administration Server.
- Click OK.
Your master Administration Server now attempts to contact the remote server. This can take a few minutes. You will receive a message confirming the server is added to the cluster.
- Click OK.
Modifying Server InformationUse the Modify Server option 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 also need to modify the information about that Administration Server stored in the cluster. Any other changes to the slave administration server require you to delete the server, and then add it back into the cluster after the changes have been made.
The remote administration servers will not be affected by modification to the master cluster database, unless their files have been transferred through Cluster Control.
To modify information about a server in a cluster, perform the following steps:
Removing Servers from a ClusterTo remove a server from the cluster, perform the following steps:
A message appears confirming that the server is removed from the cluster. You can no longer access the removed server through the cluster; you can only access it now through it’s own Administration Server.
Controlling Server ClustersSun ONE Web Server 6.1 allows you to control the remote servers in your cluster by:
To control servers within your cluster, perform the following steps:
- Go to the Server Manager for the master Administration Server, and choose the Cluster Mgmt tab.
- Click the Cluster Control link.
- Select the server or servers to control by:
- Select Start or Stop remote servers from the drop down menu.
- Select View Access or View Error log records from the drop down menu and enter the number of lines you wish to view.
- To transfer configuration files:
Adding VariablesVariables are used when servers in a cluster need to be configured with different values. These values might be macros to define slaves using different port numbers, or plug-ins to define different shlib paths.
Adding variables affects only the master cluster database. The remote administration servers will not be affected unless their files have been transferred through Cluster Control. When variables are defined, the Administration Server can no longer run independently.
To add variables for a remote server within your cluster, perform the following steps:
- From the master Administration Server, and choose the Cluster Mgmt tab.
- Click the Add Variables link.
- Check the specific server you wish to add variables for.
- In the Name field enter the type of variable you are adding.
For example: ‘Port’.
- In the Value field enter the value you are adding.
For example: if ‘Port’ is entered in the name field, the value would be the port number.
- Click OK.
A message appears confirming that the server variable has been added.
- Click OK.
The variable must also be added to the server's configuration file you are transferring to the slave. For example, if you are transferring the variable port, the variable should be declared in a server configuration file, say server.xml, as shown below:
<SERVER legacyls="ls1" qosactive="no" qosmetricsinterval="30" qosrecomputeinterval="100">
...
<LS id="ls1" ip="0.0.0.0" port="$port" security="off" acceptorthreads="1" blocking="no">
...
</SERVER>
You can set variables with different values for each slave in the configuration file. Once added, variables can also be edited and deleted using the drop-down Option list in the Add Variables page.