BusinessObjects Enterprise Administrator's Guide

Changing the name of a CMS cluster

By default, a CMS cluster name reflects the name of the first CMS that you install, but the cluster name is prefixed by the @ symbol. For instance, if your existing CMS is called BUSINESSOBJECTSCMS, then the default cluster name is @BUSINESSOBJECTSCMS.

This procedure allows you to change the name of a cluster that is already installed and running. To change the cluster name, you need only stop one of the CMS cluster members. The remaining CMS cluster members are dynamically notified of the change.

For optimal performance, after changing the name of the CMS cluster reconfigure each Business Objects server so that it registers with the CMS cluster, rather than with an individual CMS.

To change the cluster name on Windows

1. Use the CCM to stop any Central Management Server that is a member of the cluster.
2.  With the CMS selected, click Properties on the toolbar.
3. Click the Configuration tab.
4. Select the Change Cluster Name to check box.
5. Type the new name for the cluster.
6. Click OK and then start the Central Management Server.

The CMS cluster name is now changed. All other CMS cluster members are dynamically notified of the new cluster name (although it may take several minutes for your changes to propagate across cluster members).

7. Go to the Servers management area of the CMC and check that all of your servers remain enabled. If necessary, enable any servers that have been disabled by your changes.

To change the cluster name on UNIX

Use the cmsdbsetup.sh script. For reference, see the BusinessObjects Enterprise Administrator's Reference Guide.

To register servers with the CMS cluster on Windows

1. Use the CCM to stop a Business Objects server.
2.  Select the server from the list, and then click Properties.
3. Click the Configuration tab.
4. In the CMS Name box, type the name of the cluster.

The name of the cluster begins with the @ symbol. For example, if the cluster name was changed to ENTERPRISE, type @ENTERPRISE in the box.

5. Click OK, and then start the server. Repeat for each Business Objects server in your installation.

To registers servers with the CMS cluster on UNIX

1. Use ccm.sh to stop each server.
2. Use a text editor such as vi to open the ccm.config file found in the root directory of your BusinessObjects Enterprise installation.
3. Find the -ns command in the launch string for each server, and change the name of the CMS to the name of the CMS cluster.

The name of the cluster begins with the @ symbol. For example, if the cluster name was changed to ENTERPRISE, type @ENTERPRISE. Do not include a port number with the cluster name.

4. Save the file, and then use ccm.sh to restart the servers.