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.
About this task
Typically you install a Sametime Community Server from
the Sametime System Console using a guided activity, and
the new server is registered with the System Console automatically. If you cannot access the
Community Server from the System Console, it is possible that registration failed and you must
register the server manually.
Procedure
-
Back up the
console.properties
and productConfig.properties
files:
-
Navigate to the Community Server's Sametime
console
directory:
- 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:\IBM\Domino\console
-
Make backup copies of the
console.properties
and
productConfig.properties
files.
-
Update the following values in the
console.properties
file, and then save and
close the file:
Table 1. console.properties
settings
Column 1 lists the settings that you must provide in the
console.properties
file and column 2 explains the information you should provide
for each setting.
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 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
Column 1 lists the settings that you must provide in the
productConfig.properties
file and column 2 explains the information you should
provide for each setting.
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. |
-
Now register the server:
-
Run the registration utility with the following command:
- Linux:
registerSTServerNode.sh
- Windows:
registerSTServerNode.bat
-
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:\IBM\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.
-
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