Registering the Sametime Community Server with the Sametime System Console on AIX, Linux, or Windows

Register a new IBM® Sametime® Community Server with the Sametime System Console so that you can administer the Community Server from the System Console's administration pages. Even if you will cluster Sametime Community Servers, you must register the individual servers first.

Before you begin

The Sametime System Console must be running when you register a Sametime Community Server. The IBM Domino® server and Sametime Community Server must also be running.

Procedure

  1. Back up the console.properties and productConfig.properties files:
    1. Navigate to the Community Server's Sametime console directory:
      • IBM AIX® or Linux: The console directory is under the Community Server data directory; for example: /opt/IBM/domino85/notesdata/console
      • Microsoft Windows: The console directory is under the Domino directory; for example: C:\Lotus\Domino\console
    2. Make backup copies of the console.properties and productConfig.properties files.
  2. Update the following values in the console.properties file, and then save and close the file:
    Table 1. console.properties settings
    Setting Description
    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's Application Server Profile and use the setting specified for the "HTTP transport port." The default profile name is STSCAppProfile. For example, on Windows the file is stored in the following location:
    C:/IBM/WebSphere/AppServer/profiles/AppServerProfile/logs/AboutThisProfile.txt
    SSCUserName Provide the IBM WebSphere® Application Server User administrator user name that you created when you installed Sametime System Console. The default is wasadmin.
    SSCPassword Provide the password associated with the SSCUserName.
    SSCSSLEnabled Change this value to trueto connect to the Sametime System Console using a secure connection.
    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.

    Only the required values in this file are listed here.

    Table 2. productConfig.properties settings
    Setting Description
    DepName Provide a descriptive name for your deployment. This name will be stored on the Sametime System Console, so you must ensure it is unique.
    NodeHostName Provide the fully qualified host name for the Sametime Community Server that is being registered.
  4. Now register the server:
    1. Run the registration utility with the following command:
      • AIX or Linux: registerSTServerNode.sh
      • Windows: registerSTServerNode.bat
    2. As the registration utility runs, you will be prompted to enter the following information:
      Table 3. Information to supply when the registration utility runs
      Prompt Description
      Location of notes.ini file Type the full path to the directory containing the notes.ini file, and press Enter. For example, on Windows: C:\Lotus\Domino
      Domino administrator user name 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.

    The utility registers the server. If the registration is successful, a console.pid is 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