Unregistering a Sametime Proxy Server, Media Manager, Meeting Server, or Sametime Advanced Server

To unregister an IBM® Sametime® server from the list of the Sametime System Console's managed servers, run the unregister utility on the server. You do not normally need to unregister a Sametime server. This step is needed only if there was a problem with the uninstallation or you are performing some other activity that requires removal of the product from the console.

About this task

This procedure works for the following Sametime servers:
  • Sametime Proxy Server
  • Sametime Media Manager
  • Sametime Meeting Server
  • Sametime Advanced Server

Skip this task if you are uninstalling the Sametime System Console.

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. On the server to be unregistered, navigate to the InstallLocation/console directory.
    2. Make backup copies (using different names) of the console.properties and productConfig.properties files.
  2. Update the following values in the console.properties file and save 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.

    For example, on Windows™ the file is stored at: C:/IBM/WebSphere/AppServer/profiles/AppServerProfile/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.
    SSCHTTPSPort Specify the HTTPS port used by the Sametime System Console server if SSCSSLEnabled is set to "true."
  3. Verify that the following settings in the productConfig.properties file are correct. Modify them as needed before saving and closing the file. You will need to add the passwords.
    Table 2. productConfig.properties for Sametime Proxy Server
    Property Value
    WASPassword Specify the password associated with the WASUserID.
    DepName The unique descriptive name of the deployment as it was registered with the Sametime System Console.
    NodeHostName The fully qualified host name of the server.
    Table 3. productConfig.properties for Sametime Media Manager
    Property Value
    WASPassword Specify the password associated with the WASUserID.
    DepName The unique descriptive name of the deployment as it was registered with the Sametime System Console.
    NodeHostName The fully qualified host name of the server.
    Table 4. productConfig.properties for Sametime Meeting Server
    Property Value
    DBAppPassword Specify the password associated with the database ID.
    WASPassword Specify the password associated with the WASUserID.
    LDAPBindPwd Specify the password associated with the LDAPBindDN.
    DepName The unique descriptive name of the deployment as it was registered with the Sametime System Console.
    NodeHostName The fully qualified host name of the server.
    Table 5. productConfig.properties for Sametime Advanced
    Property Value
    DBAppPassword Specify the password associated with the database ID.
    WASPassword Specify the password associated with the WASUserID.
    LDAPBindPwd Specify the password associated with the LDAPBindDN.
    DepName The unique descriptive name of the deployment as it was registered with the Sametime System Console.
    NodeHostName The fully qualified host name of the server.
  4. If you are unregistering a Sametime Meeting Server, start the server. Otherwise, proceed to the next step.
  5. Now unregister the server:
    1. Run the unregisterWASProduct.sh unregistration utility from the /console directory.
      • AIX®, Linux™: ./unregisterWASProduct.sh
      • Windows: unregisterWASProduct.bat

    The utility unregisters the server, generating a log file called ConsoleUtility.log and storing it in the console/logs directory. If the unregistration is successful, theconsole.pid will be removed.