Adding a data center with the data center configuration utility script

To establish a connection with another data center, you must first add the data center to the Cassandra table. To add a data center, you can use the dcConfigUtility script.

Before you begin

You must run the command line utility after you install the Global Mailbox server. The command line utility is a shell script, which calls a Java™ program, which in turn calls the Mailbox Datacenter Service API.

About this task

To add a data center configuration to the Cassandra table by using the dcConfigUtility script:

Procedure

  1. Open the /<install_dir>/MailboxUtilities/admin/bin (UNIX/Linux) or \<install_dir>\MailboxUtilities\admin\bin (Windows) directory.
    Tip: Replace <install_dir> with the directory where the Global Mailbox is installed.
  2. From the command line, type ./dcConfigUtility.sh (UNIX/Linux) or dcConfigUtility.bat (Windows), and specify the Global Mailbox administrator user name and password when prompted.
  3. Type ./dcConfigUtility.sh add (UNIX/Linux) or dcConfigUtility.bat add (Windows).
  4. Specify appropriate values for the parameters in the following format, --parameter='value':
    dcName
    The name of the data center you are adding. Required. A data center name is case-sensitive. Ensure that you specify the correct case when you add or remove a data center.
    propName
    Specify any additional properties that you want to configure for the data center in the format, propName=value.
    output
    Enter the path to an output file. After the data center is added, the ID of the data center is updated in the output file.

Example

Following is an example code snippet:
dcConfigUtility add
  --dcName=<datacenter name>
  --P<property name>=<property value>
  --output=<path to file>