Updating the System Console administrator password

To secure your IBM® Sametime® deployment, you may want to periodically change the administrator password on the Sametime System Console. The password is stored in the IBM DB2® database used by the System Console; if you want to use a deployment plan that was created under the old password, you must update the database to register the new password first.

About this task

The Sametime System Console uses the administrator password created for the IBM WebSphere® Application Server on which it is hosted. After you change the password in WebSphere Application Server, you will register the System Console manually with the registerProduct utility to store the updated password in the DB2 database. Although you normally do not need to register the System Console with itself, this is the only way to update its password in the database.

For additional information about default paths, see Directory conventions.

Procedure

Update the password in WebSphere Application Server:
1. Log in to the Integrated Solutions Console on the Sametime System Console.
2. Click Users and Groups > Manage Users.
3. In the "Search for Users" section, select User ID in the Search by field, and then type the WebSphere Application Server administrator user name in the Search for field; then click Search.
4. In the results dialog box, click the user name to select it.
5. Type a new password in the Password and Confirm Password fields.
6. Click OK.
7. Save the change to the master configuration by clicking the Save link in the "Messages" box at the beginning of the page.
Unregister the Sametime System Console:
1. Obtain a copy of the unregisterWASProduct.sh (IBM AIX®, Linux™) or unregisterWASProduct.bat (Microsoft™ Windows™) utility by copying it from any WebSphere-based Sametime server.
  The utility is stored in the following location:
  - Sametime Proxy Server: was_install_root/profiles/STPServerCell/console
  - Sametime Media Manager: was_install_root/profiles/STMSServerCell/console
  - Sametime Meeting Server: was_install_root/profiles/STMAServerCell/console
  - Sametime Gateway: stgw_server_root/console
2. Move to the Sametime System Console, open a command window, and place the utility in the following directory:
```
was_install rootSTSCServerCell/console
```
3. Run the unregistration utility:
  - AIX, Linux: unregisterWASProduct.sh
  - Windows: unregisterWASProduct.bat
The utility generates a log file called ConsoleUtility.log and storing it in the console/logs directory. If the unregistration is successful, a console.pid will also be generated.
Now register the System Console:
1. Still working in the same directory on the Sametime System Console, edit the console.properties file and type the new administrator password at the SSCPassword setting, and then save the file.
2. Now edit the productConfig.properties file and type the new administrator password at the WASPassword setting, and then save the file.
3. Run the registration utility with the following command:
  - AIX, Linux: registerProduct.sh
  - Windows: registerProduct.sh
The utility registers the Sametime System Console and records the updated administrator password into the database, 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.