Universal Messaging 10.3 | Administration Guide | Using Command Central to Manage Universal Messaging | Universal Messaging and the Command Line Interface | Cluster Configuration Commands | Creating a Universal Messaging Cluster
 
Creating a Universal Messaging Cluster
To create an active/active cluster of Universal Messaging server instances, specify the cluster configuration details in an XML input file and supply the input file as an argument of the sagcc create configuration data command. Specify the following settings in the XML file:
*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, which is flagged as isPrime.
Examples
To create a new cluster with the following configurations 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
sagcc create configuration data sag01 Universal-Messaging-um9001   
COMMON-CLUSTER --input C:\inputxmls\umSalesClusterConfig.xml
where sag01 is the alias name of the installation in which the Universal-Messaging-um9001 server instance is running. The cluster configurations are specified in the umSalesClusterConfig.xml file as follows:
<?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>
Usage Notes
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.