IBM Support

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

Subscribe

You can track all active APARs for this component.

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 number

    IT19497

  • Reported component name

    TSM CLIENT

  • Reported component ID

    5698ISMCL

  • Reported release

    71L

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-03-09

  • Closed date

    2017-05-10

  • Last modified date

    2017-05-10

  • 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



Document information

More support for: Tivoli Storage Manager

Software version: 71L

Reference #: IT19497

Modified date: 10 May 2017