Previous Contents Index Next |
iPlanet Web Server, Enterprise Edition Administrator's Guide |
Chapter 6 Managing Server Clusters
This chapter describes the concept of clustering iPlanet Web server s and explains how you can use them to share configurations among servers.This chapter includes the following sections:
About Clusters
A cluster is a group of iPlanet 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 iPlanet Web Servers installed in their respective clusters.Here are some of the tasks you can accomplish by organizing your servers into clusters:
Create a central place for administering all iPlanet Web Servers
By clustering your iPlanet Web Servers, you're able to specify a master Administration Server for administering all of your clusters.Share one or more configuration files between servers
Start and stop all servers from one "master" Administration Server
Guidelines for Using Server Clusters
When 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 iPlanet 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.
The following list provides some guidelines for configuring groups of servers into clusters:Configure one of the iPlanet 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.
Clusters can only be homogeneous. All servers in the cluster must be either Unix or NT. Combining Unix and NT servers in the same cluster may cause the server to hang or crash.
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.0 iPlanet 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 NT 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 iPlanet Web Servers.
Make sure all Administration Servers are iPlanet Web Server version 6.0 and use the same protocol, HTTP or HTTPS. Only iPlanet Web Server 6.0 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 Cluster
To set up a iPlanet Web Server cluster, perform the following steps:
Install the iPlanet Web Servers on the computers you want to include in the cluster.
Install the server that will contain the master Administration Server, making sure the username and password matches the one set in Step 1.
- 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.
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.
Note After changing the configuration for a remote server, restart the remote server.
Adding a Server to a Cluster
When 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.
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.
Enter the port number for the remote Administration Server.
- For example: jodib.iplanet.com
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.
Modifying Server Information
Use 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:
Go to the master Administration Server and choose the Cluster Mgmt tab.
Select the server or server to modify by:
- All servers appear listed by their unique server identifier.
Enter the new port number.
- Click Reset to undo all selections.
Removing Servers from a Cluster
To remove a server from the cluster, perform the following steps:
Go to the master Administration Server and choose the Cluster Mgmt tab.
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.Select the remote server or servers to modify by:
Click OK.
- Click Reset Selection to undo all selections.
Controlling Server Clusters
iPlanet Web Server 6.0 allows you to control the remote servers in your cluster by:
Starting and stopping them
To control servers within your cluster, perform the following steps:Viewing their access and error logs
Transferring configuration files to them.
Clusters must be homogeneous. All servers in the cluster must be either Unix or NT. Transferring configuration files from a different platform may cause the server to hang or crash.
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.
- Click Reset Selection to undo all selections.
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 Variables
Variables 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.
The variable must also be added to the server's configuration file you are transferring to the slave. For example:Check the specific server you wish to add variables for.
In the Name field enter the type of variable you are adding.
In the Value field enter the value you are adding.
- For example: `Port'.
Click OK.
- 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.
SERVERPORT $Port if port was the variable added.
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.
Previous Contents Index Next
Copyright © 2001 Sun Microsystems, Inc. Some preexisting portions Copyright © 2001 Netscape Communications Corp. All rights reserved.
Last Updated May 09, 2002