Active Cluster Guide > Working with Active Cluster > Renaming an Active Cluster
 
Renaming an Active Cluster
The name of an Active Cluster appears in the Manager on the CLUSTER MANAGEMENT page. You can rename an Active Cluster at any time. The new name is automatically propagated to all other cluster members.
You can rename an Active Cluster using the Manager Web interface or the command-line interface.
To rename an Active Cluster using Manager
1. Run TDV Server on one of the servers that belongs to the cluster you want to rename.
2. Log in to Studio and choose Launch Manager (Web) from the Administration menu.
Manager opens in your web browser.
3. Log in to Manager.
4. From the CONFIGURATION tab, choose Cluster.
The members of the Active Cluster are displayed along with their status.
5. Click Rename Cluster.
Manager opens a dialog box for you to specify a new name.
6. Enter a new cluster name and click OK.
Manager displays the new cluster name of the cluster status table and propagates the name to all other members of the cluster.
To rename an Active Cluster using the command-line interface
1. Run TDV Server on one of the servers that belongs to the cluster you want to rename.
2. Open a DOS window or UNIX terminal and navigate to the bin directory of the TDV installation directory, which by default is:
<TDV_install_dir>\bin
3. Enter the command:
cluster_util.bat (Windows) | cluster_util.sh (UNIX) -server <cluster server hostname>
[-port <cluster server port>]
-user <username> -password <password> [-domain <domain>]
-
setClusterName
-clusterName <clustername>
[-debug]
 
Replace the information in the angle brackets with the appropriate information for a TDV Server in the cluster. Information in the square brackets is optional.
At a minimum, you must specify the name of a cluster server node, its username and password, and the new name for the cluster. For example:
$ ./cluster_util.sh -server localhost -user admin -password admin
-setClusterName -clusterName ProdCluster
 
This command assigns the new name ProdCluster to the cluster that the server localhost belongs to.
The cluster_util subcommand for renaming a cluster are described in The -setClusterName Subcommand.