Fixes are available
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
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGSG7","label":"Tivoli Storage Manager"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"71L","Line of Business":{"code":"LOB26","label":"Storage"}}]
Document Information
Modified date:
07 January 2022