Resetting the password for the Operations Center truststore file

To set up SSL communication between the Operations Center and the hub server, you must know the password for the truststore file of the Operations Center. You create this password during the installation of the Operations Center. If you do not know the password, you can reset it.

1. Stop the Operations Center web server.
2. Go to the following directory, where installation_dir represents the directory in which the Operations Center is installed:
   • installation_dir/ui/Liberty/usr/servers/guiServer
   • installation_dir\ui\Liberty\usr\servers\guiServer
3. Open the bootstrap.properties file, which contains the password for the truststore file. If the password is unencrypted, you can use it to open the truststore file without having to reset it.
   The following examples indicate the difference between an encrypted and an unencrypted password:

   Encrypted password example

   Encrypted passwords begin with the text string {xor}.

   The following example shows the encrypted password as the value of the tsm.truststore.pswd parameter:

   tsm.truststore.pswd={xor}MiYPPiwsKDAtOw== 

   Unencrypted password example

   The following example shows the unencrypted password as the value of the tsm.truststore.pswd parameter:

   tsm.truststore.pswd=J8b%^B

4. Reset the password by replacing the password in the bootstrap.properties file with a new password. You can replace the password with an encrypted or unencrypted password. Remember the unencrypted password for future use.
   To create an encrypted password, complete the following steps:

   1. Create an unencrypted password.
      The password for the truststore file must meet the following criteria:

      • The password must contain a minimum of 6 characters and a maximum of 64 characters.
      • The password must contain at least the following characters:
        • One uppercase letter (A – Z)
        • One lowercase letter (a – z)
        • One digit (0 – 9)
        • Two of the following non-alphanumeric characters:

          ~ ! @ # $ % ^ & * _ - + = ` |  

          ( ) { } [ ] : ; < > , . ? /

   2. From the command line of the operating system, go to the following directory:
      • installation_dir/ui/Liberty/bin
      • installation_dir\ui\Liberty\bin
   3. To encrypt the password, issue the following command, where myPassword represents the unencrypted password:
      • securityUtility encode myPassword
      • securityUtility.bat encode myPassword
      The following message might be shown:

      ! "java"' is not recognized as an internal or external command,
      operable program or batch file.

      If this message is shown, complete the following steps:

      1. Issue the following command, where installation_dir represents the directory where the Operations Center is installed:

         set JAVA_HOME="installation_dir\ui\jre"

      2. Reissue the following command to encrypt the password:

         securityUtility.bat encode myPassword

5. Close the bootstrap.properties file.
6. Go to the following directory:
   • installation_dir/ui/Liberty/usr/servers/guiServer
   • installation_dir\ui\Liberty\usr\servers\guiServer
7. Delete the gui-truststore.jks file, which is the truststore file of the Operations Center.
8. Start the Operations Center web server.