Before You Create or Update a Cluster
![*](chapterTOC_bullet.png)
Make sure the server instances that you want to add to the cluster are running.
![*](chapterTOC_bullet.png)
Verify that the permissions on the server machines allow connections to the other servers in the cluster.
![*](chapterTOC_bullet.png)
Make sure the /naming/defaultContext channel exists only on one or none of the nodes that will form the cluster. The
Universal Messaging server instance used as a JNDI provider uses the /naming/defaultContext channel to store JMS references and JNDI objects. If the channel exists on multiple nodes, you cannot create the cluster.
![*](chapterTOC_bullet.png)
If you have a custom composite template for
Command Central 9.9 or earlier, you must remove the
Universal Messaging server
instance.name suffix from the
COMMON-CLUSTER configuration type in the template when you apply the composite template in
Command Central 9.10 or later.
In the following example, you have a composite template created in Command Central 9.9 and earlier, and then the same template in Command Central 9.10 and later.
In Command Central 9.9 and earlier:
um-cluster:
description: Cluster configuration for two UM instances
products:
NUMRealmServer:
${node.host}:
instance.port: ${um.instance.port}
instance.ip: ${um.host}
runtimeComponentId: Universal-Messaging-${instance.name}
configuration:
Universal-Messaging-${instance.name}:
COMMON-CLUSTER:
COMMON-CLUSTER-${instance.name}: &umClusterConfig
Name: ${um.cluster}
Servers: # two UM instances cluster
Server:
-
"@name": ${um.host}
URL: "nsp://${um.host}:${um.instance.port}"
-
"@name": ${um.host2}
URL: "nsp://${um.host2}:${um.instance.port2}"
In Command Central 9.10 and later:
um-cluster:
description: Cluster configuration for two UM instances
products:
NUMRealmServer:
${node.host}:
instance.port: ${um.instance.port}
instance.ip: ${um.host}
runtimeComponentId: Universal-Messaging-${instance.name}
configuration:
Universal-Messaging-${instance.name}:
COMMON-CLUSTER:
COMMON-CLUSTER: &umClusterConfig
Name: ${um.cluster}
Servers: # two UM instances cluster
Server:
-
"@name": ${um.host}
URL: "nsp://${um.host}:${um.instance.port}"
-
"@name": ${um.host2}
URL: "nsp://${um.host2}:${um.instance.port2}"