Unregistering a Sametime Community Server cluster on IBM i

If you will uninstall an entire cluster of IBM Sametime® Community Servers, you must unregister the cluster from the Sametime System Console before you uninstall Sametime on the individual servers.

Before you begin

Complete this task only if you want to remove the entire cluster of Sametime Community Servers from the Sametime System Console.

Procedure

  1. Navigate to the Community Server's sametime_server_data_directory/console directory.
  2. Update the following values in the console.properties file before saving and closing the file:
    Table 1. console.properties settings
    Property Value
    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
  3. Run the removeClusterRegistration 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 unregister the cluster: removeClusterRegistration.sh.
    4. When the utility prompts for the cluster's name, type the name and press Enter.
    5. When the utility finishes, press F3 to exit QSH.

      The utility unregisters the cluster from the console, and then registers each of the individual servers instead, generating a log file called ConsoleUtility.log and storing it in the console/logs directory. If the cluster unregistration is successful, the console.pid will be removed.