IT34321: CLIENT NEEDS TO BE CONNECTED TO A SERVER BEFORE INSTALLING CLIENT MANAGEMENT SERVICES

IBM Spectrum Protect Operations Center V8.1.11 Download

APAR status

• Closed as documentation error.

Error description

• Clients needs to be connected to a server before installing
  Client Management Services. This is not described on the
  manuals explicitly.
  Otherwise the Client Management Services
  configuration fails.
  
  The Client Management Services assumes
  the truststore used by the Backup-Archive client has the server
  certificate, however the certificate is not there till the
  client connects to a server.
  
  reference: Link to the
  publication for 8.1.10
  Installing the client management service
  
  https://www.ibm.com/support/knowledgecenter/SSEQVQ_8.1.10/srv.so
  lutions/t_msdisk_cms_install.html
  
  
  Customer/Support
  Diagnostics (If Applicable):
  
  
  Spectrum Protect Versions
  Affected:
  Spectrum Protect Client Management Services all
  versions on all supported platforms
  
  
  Initial
  Impact:
  low
  
  
  Additional Keywords:
  Spectrum Protect,
  TS004024884, client management services
  

Local fix

• Refer the technote, "Procedure to create server truststore"
  section.
  
  Configuring for SSL communication between client
  management service and the Tivoli Storage Manager
  server
  https://www.ibm.com/support/pages/node/249987
  
  The steps
  create a svr-truststore.jks file under
  <cmsInstallDir>/cms/Liberty/usr/servers/cmsServer directory and
  add server certificate to the svr-truststore.jks. Restart the
  Client Management Services to take effect.
  
  service
  information:
  Windows - Restart "IBM Spectrum Protect Client
  Management Service".
  Redhat Linux - Execute the command,
  "systemctl restart cms.service"
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All IBM Spectrum Protect server users.                       *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See error description.                                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Update documentation as needed.                              *
  ****************************************************************
  

Problem conclusion

• The following paragraph will be added to the client management
  service documentation in the Installation guide and Solutions
  guides in the next version of IBM Spectrum Protect:
  
  "Before you install the client management service, ensure that a
  successful connection was established between the backup-archive
  client and the server. The server truststore file that the
  client uses does not have the server Secure Sockets Layer (SSL)
  certificate until the client system has connected to the
  server."
  
  The parargraph will be added to the following topics in the
  Installation guide:
  1.  "Requirements and limitations for IBM Spectrum Protect
  client management services"
  2.  "Configuring the client management service for custom client
  installations"
  3. "Collecting diagnostic information with IBM Spectrum Protect
  client management services"
  
  The parargraph will be added to the following topic in the
  Single-site disk solution guide and the Multisite disk solution
  guide:
  1. "Installing the client management service"
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels