IT19497: DSMCAD IS NOT PICKING UP THE SPECIFIED PORTS AFTER A RESTART OF THE SERVICE.

IBM Spectrum Protectâ„¢ Client 8.1.2 Downloads and READMEs
IBM Spectrum Protectâ„¢ Client 7.1.8 Downloads and READMEs

APAR status

• Closed as program error.

Error description

• When the parameters 'HTTPPort' and/or 'WEBPort' are specified in
  dsm.sys, the dsmcad service is not picking up these ports after
   a restart.
  This happens because the dsmcad.service startup script misses a
  wait for the previous running process to fully stop.
  
  IBM Spectrum Protect Versions Affected:
  All supported Tivoli Storage Manager Client / IBM Spectrum
  Protect Client versions on Linux when using systemd
  
  Customer/L2 Diagnostics:
  Compare the configured ports in dsm.sys with the port currently
  in use by the dsmcad service.
  
  The following ports were configured in the example below:
  HTTPPort 1581
  WEBPorts 1503 1504
  
  Verify the 'netstat' output before / during / after a service
  restart:
  
  Before the restart of the dsmcad service:
  Thu Sep 15 15:39:09 CEST 2016
  tcp  0   0 0.0.0.0:1581  0.0.0.0:*    LISTEN      17330/dsmcad
  tcp  0   0 0.0.0.0:1503  0.0.0.0:*    LISTEN      17330/dsmcad
  --> The configured ports 1503 & 1581 are seen.
  
  During the restart of the dsmcad service:
  Thu Sep 15 15:39:09 CEST 2016
  tcp  0  0 0.0.0.0:1837  0.0.0.0:*     LISTEN      9945/dsmcad
  tcp  0  0 0.0.0.0:1581  0.0.0.0:*     LISTEN      17330/dsmcad
  tcp  0  0 0.0.0.0:1759  0.0.0.0:*     LISTEN      9945/dsmcad
  tcp  0  0 0.0.0.0:1503  0.0.0.0:*     LISTEN      17330/dsmcad
  --> Additional ports 1759 & 1837 are in use.
      See also two different PID's for dsmcad.
  
  After the restart of the dsmcad service:
  Thu Sep 15 15:39:10 CEST 2016
  tcp  0  0 0.0.0.0:1837  0.0.0.0:*     LISTEN      9945/dsmcad
  tcp  0  0 0.0.0.0:1759  0.0.0.0:*     LISTEN      9945/dsmcad
  --> The incorrect ports are in use.
  
  
  
  Initial Impact: Medium
  
  Additional Keywords: TSM, CAD, RHEL, RedHat, SUSE, Ubuntu
  

Local fix

• Edit dsmcad.service file and add following line in the [Service]
   stanza after ExecStart:
  ExecStopPost=/bin/bash -c 'while [[ -n $(pidof dsmcad) ]]; do
  /usr/bin/sleep 1; done'
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Spectrum Protect client versions 7.1, 8.1 running on Linux   *
  * platform (RHEL 7.1 and more recent, SLES v12 and more        *
  * recent, Ubuntu 15.04 and more recent).                       *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is currently *
  * projected to be fixed in levels 7.1.8 and 8.1.2 on all Linux *
  * platforms. Note that this is subject to change at the        *
  * discretion of IBM.                                           *
  ****************************************************************
  

Problem conclusion

• Background: newer Linux distributions are using systemd
  initialization service. It uses service description files to get
  parameters of the particular service. There is a service file
  for dsmcad daemon provided.
  
  Problem: systemd is not able to track if the daemon has stopped
  or not for the forking daemons without pid files (like the
  dsmcad). This can lead to the situation when at restart the
  previous process has not been stopped by the time the new one
  has been started. Dsmcad is designed to be able to start
  multiple copies, it just seeks for the unoccupied ports to use.
  Due to this the new dsmcad process uses ports that are different
  than the ports specified in the option file.
  
  Fix: service file for dsmcad has been changed to give the time
  for the previous process to finish.
  

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:

Modules/Macros

• dsmcad
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels

• R71L PSY

     UP

• R81L PSY

     UP