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.