Universal Messaging 10.7 | Administration Guide | Command Line Administration Tools | Tools for Removing and Modifying Offline Cluster Members
 
Tools for Removing and Modifying Offline Cluster Members
You can use the nClusterTool and nRealmTool tools to remove offline cluster members, In addition, you can use nRealmTool to modify the host or port of an offline cluster member.
You use the Universal Messaging admin API to modify cluster realms that are online. However, if a cluster has members that cannot be brought online because they are permanently deleted, you can run nClusterTool or nRealmTool to remove those realms from the cluster. The tools are located in InstallDir\UniversalMessaging\lib\nServer.jar.
nClusterTool
Removes offline cluster members.
To run the tool, open a command prompt in the InstallDir\UniversalMessaging\lib directory and execute the following commands:
1. Start the tool and obtain usage information:
java -cp nServer.jar com.pcbsys.nirvana.server.apps.nClusterTool
2. List the members of a cluster:
java -DDATADIR=<realm_data_dir> -cp nServer.jar
com.pcbsys.nirvana.server.apps.nClusterTool -print
3. Remove a cluster member:
java -DDATADIR=<realm_data_dir> -cp nServer.jar
com.pcbsys.nirvana.server.apps.nClusterTool -id=<object_id> -remove
where <object_id> is the id of the server instance that you want to remove.
For example, to remove a server instance with id "2":
java -DDATADIR=C:\test\UniversalMessaging\server\umserver\data
-cp nServer.jar com.pcbsys.nirvana.server.apps.nClusterTool -id=2 -remove
nRealmTool
Removes offline realms and modifies the host and port of such realms.
To run the tool, open a command prompt in the InstallDir\UniversalMessaging\lib directory and execute the following commands:
1. Start the tool and obtain usage information:
java -cp nServer.jar com.pcbsys.nirvana.server.apps.nRealmTool
2. List all realms:
java -DDATADIR=<realm_data_dir> -cp nServer.jar
com.pcbsys.nirvana.server.apps.nRealmTool -print
3. Do any of the following as required:
*Remove a realm:
java -DDATADIR=<realm_data_dir> -cp nServer.jar
com.pcbsys.nirvana.server.apps.nRealmTool -id=<object_id> -remove
where <object_id> is the id of the server instance that you want to remove.
For example, to remove a server instance with id "2":
java -DDATADIR=C:\test\UniversalMessaging\server\umserver\data
-cp nServer.jar com.pcbsys.nirvana.server.apps.nRealmTool -id=2 -remove
*Modify the host or port of a realm:
java -DDATADIR=<realm_data_dir> -cp nServer.jar
com.pcbsys.nirvana.server.apps.nRealmTool -id=<object_id>
[-host=<modified_hostname>] [-port=<modified_port>]
where <object_id> is the id of the server instance that you want to modify.
For example, to modify the host and port of a server instance with id "2":
java -DDATADIR=<realm_data_dir> -cp nServer.jar
com.pcbsys.nirvana.server.apps.nRealmTool -id=2
-host=test -port=8100