Software AG Products 10.7 | Integrating On-Premises and Cloud Applications | Universal Messaging | Using Command Central to Manage Universal Messaging | Using the Command Line to Manage Universal Messaging | Cluster Configuration | Update Clusters
 
Update Clusters
Updates an existing Universal Messaging cluster.
You can make the following changes in the input configuration XML file for the cluster:
*To add one or more server instances to the cluster, include the name, URL, and port of the server instances.
*To remove one or more server instances from the cluster, remove the configurations of the server instances.
*To create sites and assign server instances to sites, set the siteName extended property of the server instances.
*To make a site the prime site of the cluster, specify the name of the prime site as a value of the primeSite cluster-level property.
*To remove one or more server instances from a cluster site, remove the siteName extended property of the server instances.
*To remove sites from the cluster, remove the site definitions of all the server instances in the cluster.
Syntax
sagcc update 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 that runs in the specified installation and is part of the cluster you want to update.
COMMON-CLUSTER
Required. The ID of the configuration type of which you want to update 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.
*When you update a cluster, you edit only the parameters that specify the change. Other parameters in the cluster configuration file must not be changed.
*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
To update the cluster "umSales" for the server instance with ID "Universal-Messaging-um9001", installed in the installation with alias name "sag01", using the file "umSalesClusterConfig.xml":
sagcc update 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>