If you added a node to a cluster of IBM® Sametime® servers
using a guided activity, delete that node's information from the Sametime System Console
before you remove the node from the underlying IBM WebSphere® cluster.
About this task
These instructions apply to the following
Sametime servers, but only
if they were clustered using the guided activity:
- Sametime Proxy Server
- Sametime Conference
Manager
- Sametime SIP Proxy/Registrar
- Sametime Meeting
Server
- Sametime Gateway
- Sametime Advanced
Server
The Sametime clustering
guided activity created settings on the System Console so it can manage
the cluster. Before you uninstall a server that belongs to a cluster,
you must update the cluster settings on the System Console to remove
references to the node where the server application is installed.
This process removes the node from the cluster in Sametime, but does not affect
the WebSphere Application Server settings. You will update WebSphere
settings in subsequent tasks.
Run the updateWASCluster utility
to delete the node's information from the Sametime System Console.
This utility does not remove the node from the WebSphere cluster, it merely removes the
reference to the node from the Sametime cluster information
that was created when you the clustering guided activity. The purpose
of this utility is to ensure that the Sametime information remains
up-to-date when you modify the WebSphere cluster.
Procedure
Complete this procedure for every node that you want
to remove from the cluster.
-
On every node that you want to remove from the cluster, update the
console.properties file on by completing the following steps:
-
Navigate to the
install_root/IBM/WebSphere/cell_name/console
directory.
-
Open the
console.properties
file for editing.
-
Fill in values for the following settings so that they are correct for the node you are
currently removing from the cluster:
Table 1. console.properties settings
Property |
Value |
SSCHostName |
Type the fully qualified host name of the Sametime System Console server. |
SSCHTTPPort |
Type 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. |
SSCUserName |
Type the IBM
WebSphere Application Server User ID that you created
when you installed Sametime System Console. The default is
wasadmin. |
SSCPassword |
Type the IBM
WebSphere Application Server password associated with
the SSCUserName. |
-
Save and close the file.
-
Remember to repeat this process for each node that will be removed from the cluster.
- Now open the
productConfig.properties
file
(in the same folder) and verify that all of the settings are correct,
changing settings as needed before you save and close the file.
Note: Make sure you provide the password for your DB2® database in the DBAppPassword
setting,
as well as theSametime System
Console administrator password in the WASPassword
setting.
- Verify that the Sametime System Console
has been started.
- Open a command window and run the utility with the following
command:
Important: You must include the -remove
parameter.
Otherwise, you will unregister the entire cluster rather than remove
the one node.
- IBM
AIX®, or Linux™:
./updateWASCluster.sh -remove
- Microsoft™ Windows™:
updateWASCluster.bat
-remove
- When prompted, type the name of the cluster from which
you are removing the node, and press Enter.
When the
utility has successfully removed the node information, it displays
the following confirmation message: The node is successfully
removed from the cluster deployment.
Results
This utility removes the node from the specified cluster's
settings and generates a log file called ConsoleUtility.log
,
which is stored in the console/log
directory.