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
![*](chapterTOC_bullet.png)
The XML input file must contain the following cluster configuration properties:
![*](chapterTOC_bullet.png)
Cluster name (required). A cluster name that is unique to the installation.
![*](chapterTOC_bullet.png)
Server instances (required). The name, URL, and port of each server node in the cluster.
![*](chapterTOC_bullet.png)
Sites (optional). The name of the site to which each server node belongs.
siteName is a server-level property.
![*](chapterTOC_bullet.png)
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.
![*](chapterTOC_bullet.png)
A
Universal Messaging server instance can be part of only one cluster.
![*](chapterTOC_bullet.png)
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:
![*](chapterTOC_bullet.png)
Cluster name: umSales
![*](chapterTOC_bullet.png)
Cluster sites: site1 and site2
![*](chapterTOC_bullet.png)
Primary site: site1
![*](chapterTOC_bullet.png)
Server instances in site1: um9000, um9001
![*](chapterTOC_bullet.png)
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>