Registering a Community Server cluster on IBM i

After configuring a cluster of IBM® Sametime® servers on IBM i, register the cluster with the Sametime System Console so you can manage all of the Sametime servers from a central location.

Before you begin

Make sure each of these servers is ready for the cluster registration task:

  • Each of the Sametime Community Servers in the cluster must be registered with the Sametime System Console, and must be started.
  • The Sametime System Console must be started.
  • The LDAP server must be started, and must be connected to the Sametime System Console.

Procedure

  1. Verify that each of the servers in the cluster has been registered with the Sametime System Console.
  2. If you just configured cluster settings for a group of Sametime Community Servers, restart all of the cluster members now so the cluster goes into effect before you continue.
  3. Complete the following steps for each server in the cluster to verify each server document's Net Address field:
    1. From a Notes® client, open the Server document for the Sametime Community Server you are working on.
    2. Click the Ports tab.
    3. Click the Notes Network Ports tab and check the Net Address field:

      This field should contain the fully qualified host name of the current Sametime Community Server. If the field contains an IP address change it now.

    4. Click Save if you made a change, and then click Close to close the Server document.
    5. If you changed the Server document, restart the server.
    6. Remember to repeat this task for every server in the cluster.
  4. Now run the registerSTCluster.sh registration utility from one of the servers in the cluster:
    Attention: Run this utility only once for the cluster; you can run it from any member of the cluster.
    1. From an IBM i command line, run the following command to start the QShell Interpreter: QSH
    2. Navigate to the server's sametime_server_data_directory/console console directory; for example: cd /stserver/data/console.
    3. Run the shell script:
      registerSTCluster.sh
    4. As the registration utility runs, you will be prompted to enter the following information:
      Table 1. Registration information
      Field Value
      Cluster name Type the name you created when you configured the cluster, and press Enter.
      Location of notes.ini file Type the full path to the Sametime Community Server data directory containing notes.ini file (for example, /stserver/data), and press Enter.
      Domino® administrator user name This is the account that you created for managing the Sametime Community Server from the Community Server Administration Tool. Type the Domino administrator's user name, and press Enter.
      Domino administrator password Type the password associated with the Domino administrator user account, and press Enter.
    5. When the registration script completes, press F3 to exit QSH.

      The utility registers the cluster, generating a log file called ConsoleUtility.log and storing it in the consoles/logs directory.

  5. Restart the Sametime Community Server where you ran the registration utility.