AIX operating systemsLinux operating systemsWindows operating systems

Securing communication between the Operations Center and the hub server

To secure communications between the Operations Center and the hub server, you must add the Transport Layer Security (TLS) certificate of the hub server to the truststore file of the Operations Center.

Before you begin

The truststore file of the Operations Center is a container for certificates that the Operations Center can access. The truststore file contains the certificate that the Operations Center uses for HTTPS communication with web browsers.

During the installation of the Operations Center, you create a password for the truststore file. To secure communication between the Operations Center and the hub server, you must use the same password to add the certificate of the hub server to the truststore file. If you do not remember this password, you can reset it. See Resetting the password for the Operations Center truststore file.

Procedure

  1. Specify the cert256.arm certificate as the default certificate in the key database file of the hub server.

    To specify cert256.arm as the default certificate, complete the following steps:

    1. Issue the following command from the hub server instance directory:
      gsk8capicmd_64 -cert -setdefault -db cert.kdb -stashed
       -label "TSM Server SelfSigned SHA Key"	
    2. Restart the hub server so that it can receive the changes to the key database file.
  2. To verify that the cert256.arm certificate is set as the default certificate in the key database file of the hub server, issue the following command:
    gsk8capicmd_64 -cert -list -db cert.kdb -stashed 
  3. Stop the Operations Center web server.
  4. Go to the command line of the operating system on which the Operations Center is installed.
  5. Add the certificate to the truststore file of the Operations Center by using the iKeycmd command or the iKeyman command. The iKeyman command opens the IBM® Key Management graphical user interface, and iKeycmd is a command line interface.
    To add the SSL certificate by using the command line interface, issue the iKeycmd command to add the cert256.arm certificate as the default certificate in the key database file of the hub server:
    ikeycmd -cert -add 
    -db /installation_dir/Liberty/usr/servers/guiServer/gui-truststore.jks 
    -file /fvt/comfrey/srv/cert256.arm 
    -label 'label description' 
    -pw 'password' -type jks -format ascii -trust enable 
    where:
    installation_dir
    The directory in which the Operations Center is installed.
    label description
    The description that you assign to the label.
    password
    The password that you created when you installed the Operations Center. To reset the password, uninstall the Operations Center, delete the .jks file, and reinstall the Operations Center.

    To add the certificate by using the IBM Key Management window, complete the following steps:

    1. Go to the following directory, where installation_dir represents the directory in which the Operations Center is installed:
      • AIX operating systemsLinux operating systemsinstallation_dir/ui/jre/bin
      • Windows operating systemsinstallation_dir\ui\jre\bin
    2. Open the IBM Key Management window by issuing the following command:
       ikeyman
    3. Click Key Database File > Open.
    4. In the Open window, click Browse, and go to the following directory, where installation_dir represents the directory in which the Operations Center is installed:
      • AIX operating systemsLinux operating systemsinstallation_dir/ui/Liberty/usr/servers/guiServer
      • Windows operating systemsinstallation_dir\ui\Liberty\usr\servers\guiServer
    5. In the guiServer directory, select the gui-truststore.jks file.
    6. Click Open, and click OK.
    7. Enter the password for the truststore file, and click OK.
    8. In the Key database content area of the IBM Key Management window, click the arrow, and select Signer Certificates from the list.
    9. Click Add.
    10. In the Open window, click Browse, and go to the hub server instance directory, as shown in the following example:
      • AIX operating systemsLinux operating systems/opt/tivoli/tsm/server/bin
      • Windows operating systemsc:\Program Files\Tivoli\TSM\server1

      The directory contains the cert256.arm certificate.

      If you cannot access the hub server instance directory from the Open window, complete the following steps:
      1. Use FTP or another file-transfer method to copy the cert256.arm files from the hub server to the following directory on the computer where the Operations Center is installed:
        • AIX operating systemsLinux operating systemsinstallation_dir/ui/Liberty/usr/servers/guiServer
        • Windows operating systemsinstallation_dir\ui\Liberty\usr\servers\guiServer
      2. In the Open window, go to the guiServer directory.
    11. Select the cert256.arm certificate as the certificate.
      Tip: The certificate that you choose must be set as the default certificate in the key database file of the hub server. For more information, see step 1 and 2.
    12. Click Open, and click OK.
    13. Enter a label for the certificate. For example, enter the name of the hub server.
    14. Click OK. The SSL certificate of the hub server is added to the truststore file, and the label is displayed in the Key database content area of the IBM Key Management window.
    15. Close the IBM Key Management window.
  6. Start the Operations Center web server.
  7. When you connect to the Operations Center for the first time, you are prompted to identify the IP address or network name of the hub server, and the port number for communicating with the hub server. If the ADMINONCLIENTPORT server option is enabled for the IBM Spectrum Protect™ server, enter the port number that is specified by the TCPADMINPORT server option. If the ADMINONCLIENTPORT server option is not enabled, enter the port number that is specified by the TCPPORT server option.
    If the Operations Center was previously configured, you can review the contents of the serverConnection.properties file to verify the connection information. The serverConnection.properties file is in the following directory on the computer where the Operations Center is installed:
    • AIX operating systemsLinux operating systemsinstallation_dir/ui/Liberty/usr/servers/guiServer
    • Windows operating systemsinstallation_dir\ui\Liberty\usr\servers\guiServer

What to do next

To set up SSL communication between the hub server and a spoke server, see Securing communication between the hub server and a spoke server.