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 Meeting
Server
- Sametime Gateway
The clustering guided activity created settings on the Sametime 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 by completing the following steps:
-
Navigate to the
/QIBM/UserData/InstallLocation/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 step for each node that you want to remove 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.
- Verify that the Sametime System Console
has been started.
- Run the utility to remove the node information from the
cluster:
- From an IBM i
command line, run the following command to start the QShell Interpreter:
QSH
- Run the
cd shell
command, specifying
the fully qualified path to the directory you used in Step 2.
- Run the following shell command:
updateWASCluster.sh
-remove
Important: You must include
the -remove
parameter. Otherwise, you will unregister
the entire cluster rather than remove the one node.
- When prompted by the utility, type the name of the cluster
from which you are removing the node, and press Enter.
The
utility removes the node from the specified cluster's settings
and generates a log file called ConsoleUtility.log
,
which it stores in the console/log
directory.
- Press F3 to exit QSH