Registering a Sametime Community Server on IBM i with the Sametime System Console

After installing an IBM® Sametime® Community Server on IBM i, register it with the Sametime System Console, so you can manage all of the Sametime servers from a central location.

Before you begin

Make sure the following servers are ready for the registration task:

  • The Sametime Community Server must be configured to use an LDAP directory, 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.

About this task

During this task you will edit the following files; click the topic titles to see details on each file. You may want to open each topic in a new browser tab or window so you can keep it open for reference:

Procedure

  1. Back up the console.properties and productConfig.properties files:
    1. Navigate to the Community Server's sametime_server_data_directory/console directory.
    2. Make back-up copies (using different names) of the console.properties and productConfig.properties files.
  2. Update the following settings in the console.properties file and save the file.
    Table 1. console.properties file settings
    console.properties settings Values
    SSCHostName Provide the fully qualified host name of the Sametime System Console server.
    SSCHTTPPort Specify the HTTP port used for the Sametime System Console server if SSL is not enabled and the value for SSCSSLEnabled is "false."

    To determine the correct HTTP port, open the AboutThisProfile.txt file for the Sametime System Console Application Server Profile and use the setting specified for the "HTTP transport port." The default profile name is STSCAppProfile.

    On IBM i, look for the AboutThisProfile.txt file in the following location: /QIBM/UserData/Websphere/AppServer/version_number/SametimeWAS/profiles/STSCAppProfile/logs/AboutThisProfile.txt
    SSCUserName Enter the IBM WebSphere® Application Server User ID that you created when you installed Sametime System Console. The default is wasadmin.
    SSCPassword Enter the WebSphere Application Server password associated with the SSCUserName.
    SSCSSLEnabled Change this value to "true" to connect to the Sametime System Console using a secure connection.
    Note: If the Sametime System Console was installed using a host name that is different from the system host name, make sure this value is set to "false." Otherwise the registration will fail.
    SSCHTTPSPort Specify the HTTPS port used by the Sametime System Console server if SSCSSLEnabled is set to "true."
  3. Verify that the settings in the productConfig.properties file are correct, modifying them as needed before saving and closing the file.

    The only required value in this file is

    DepName: Provide a descriptive name for your deployment; it must be a unique deployment name on the Sametime System Console.

  4. Run the registerSTServerNode.sh registration utility:
    1. From an IBM i command line, run the following command to start the QShell Interpreter: QSH
    2. Navigate to the server's console directory; for example: cd /stserver/data/console.
    3. Run the shell script to register the server: registerSTServerNode.sh
    4. As the registration utility runs, you will be prompted to enter the following information:
      Table 2. Input for registration utility prompts
      Registration utility prompts Input
      Location of notes.ini file Type the full path to the directory containing the 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 server and generates a log file called ConsoleUtility.log, storing it in the consoles/logs directory. If the registration is successful, a console.pid will also be generated.

  5. Restart the Sametime Community Server.

    After you restart the server, the SSCUserName and SSCPassword settings will be removed from the console.properties file and replaced with a new SSCEncodedAuthorization setting; for example:

    SSCEncodedAuthorization=d2FzYWRtaW46MTIz