After upgrading an IBM® Sametime® Gateway server on IBM AIX®, Linux™, Oracle Solaris, or Microsoft™ Windows™, you must register it again with the Sametime System Console, so you can manage all of the Sametime servers from a central location.

After upgrading an IBM® Sametime® Gateway server on IBMAIX®, Linux™, Oracle Solaris, or Microsoft™ Windows™, you must register it again with the Sametime System Console, so you can manage all of the Sametime servers from a central location.

The LDAP server must be connected to the System Console and must be started.

The Gateway database must be connected to the System Console and must be started.

The Community Server that the Gateway server connects to must already be registered with the Console and must be started.

About this task

Working from the server that you want to connect to the console, follow these steps to update properties files and run the registration utility.

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

Procedure

On the Sametime Gateway server, navigate to the stgw_server_root/IBM/WebSphere/STgateway/console directory.

In the console directory, make backup copies (using different names) of the console.properties and productConfig.properties files.

Update the console.properties file with the following values, and then save and close the file.

Table 1. console.properties settings

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 path is: C:/IBM/WebSphere/AppServer/profiles/AppServerProfile/logs/AboutThisProfile.txt

SSCUserName

Enter the IBMWebSphere 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."

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

InstallType

Specify "Cell" as the installation type since this is a non-clustered server.

DepName

Provide a descriptive name for your deployment. It must be a unique deployment name on the Sametime System Console.

NodeIP

Specify the IP address of the server being registered.

WASAdminPassword

Specify the password associated with the WASUserID

LDAPBindPassword

Specify the password associated with the LDAPBindDN.

DB2AdminPassword

Specify the password associated with the database ID.

CommunityServerHost

Specify the fully qualified host name (not the IP address) of the Community Server registered with the Sametime System Console.

CommunityServerPort

Specify the port for the Community Server.

LDAPHost

Specify the fully qualified host name (not the IP address) of the LDAP server that was registered with the Sametime System Console.

LDAPPort

Specify the port of the LDAP server that was registered with the Sametime System Console.

LDAPBindDN

Specify the Bind Distinguished Name of the LDAP server that was registered with the Sametime System Console.

LDAPBindPwd

Specify the password associated with the LDAPBindDN value.

LDAPBaseDN

Specify the search base of the LDAP server that was registered with the Sametime System Console.

isFederated

Set the value to true for a primary or secondary node. The registration utility cannot run without this value.

Set the application server path in the registration utility:

Navigate to the stgw_server_root/IBM/WebSphere/STgateway/console directory and open a command window.

Open the registration utility file for editing.

AIX, Linux, Solaris

registerProduct.sh

Windows

registerProduct.bat

Locate the following statement:

SET PATH=../../WebSphere/AppServer/java/bin

Change it to reflect IBMWebSphere Application Server version 7:

SET PATH=../../WebSphere/AppServer7/java/bin

Save and close the file.

Run the registration utility.

AIX, Linux, Solaris

Already registered

registerProduct.sh -upgrade

First-time registration

registerProduct.sh

Windows

Already registered

registerProduct.bat -upgrade

First-time registration

registerProduct.bat

The utility registers the server, generating a log file called ConsoleUtility.log and storing it in the console/logs directory. If the registration is successful, a console.pid will also be generated.