Create Clusters
Creates an active/active cluster of Universal Messaging servers.
Syntax
sagcc create configuration data nodeAlias Universal-Messaging-instanceName
COMMON-CLUSTER {--input|-i} filename.xml
Arguments and Options
nodeAlias
Required. The alias name of the installation in which the Universal Messaging server instance is installed.
Universal-Messaging-instanceName
Required. The ID of the Universal Messaging server instance running in the specified installation.
COMMON-CLUSTER
Required. The ID of the configuration type of which you want to create an instance.
--input|-i filename.xml
Required. The XML file that contains the cluster configuration data.
Usage Notes
The XML input file must contain the following cluster configuration properties:
Cluster name (required). A cluster name that is unique to the installation.
Server instances (required). The name, URL, and port of each server node in the cluster.
Sites (optional). The name of the site to which each server node belongs.
siteName is a server-level property.
Primary site (optional). The name of the primary site, if you have configured sites in the cluster.
primeSite is a cluster-level property that holds the name of the site that is flagged as
isPrime.
A
Universal Messaging server instance can be part of only one cluster.
If you remove all the server instances from a site, the site will be deleted. Server instance deletion is not allowed if the deletion operation leaves fewer than two server instances in the cluster.
Examples
The example creates a cluster with the following configuration properties specified in the umSalesClusterConfig.xml file:
Cluster name: umSales
Cluster sites: site1 and site2
Primary site: site1
Server instances in site1: um9000, um9001
Server instances in site2: um9002, um9003
To create the cluster "umSales" on the server instance with ID "Universal-Messaging-um9001", installed in the installation with alias name "sag01", using the file "umSalesClusterConfig.xml":
sagcc create configuration data sag01 Universal-Messaging-um9001
COMMON-CLUSTER --input C:\inputxmls\umSalesClusterConfig.xml
The umSalesClusterConfig.xml file has the following format:
<?xml version="1.0" encoding="UTF-8"?>
<ClusterSettings>
<Name>umSales</Name>
<Servers>
<Server name="um9000">
<URL>nsp://127.0.0.1:9000</URL>
<ExtendedProperties>
<Property name="siteName">site1</Property>
</ExtendedProperties>
</Server>
<Server name="um9001">
<URL>nsp://127.0.0.1:9001</URL>
<ExtendedProperties>
<Property name="siteName">site1</Property>
</ExtendedProperties>
</Server>
<Server name="um9002">
<URL>nsp://127.0.0.1:9002</URL>
<ExtendedProperties>
<Property name="siteName">site2</Property>
</ExtendedProperties>
</Server>
<Server name="um9003">
<URL>nsp://127.0.0.1:9003</URL>
<ExtendedProperties>
<Property name="siteName">site2</Property>
</ExtendedProperties>
</Server>
</Servers>
<ExtendedProperties>
<Property name="primeSite">site1</Property>
</ExtendedProperties>
</ClusterSettings>