IT36494: INCORRECT DOCUMENTATION ON HOW TO CONFIGURE THE DATA MOVER ON LINUX USING SYSTEMD

APAR status

• Closed as documentation error.

Error description

• When starting a data mover CAD with the 'systemctl start'
  command, the operation fails with the message:
  
  Failed to start dsmcad@PREFIX_DATACENTER_DM.service: Unit
  dsmcad@PREFIX_DATACENTER_DM.service has a bad unit file setting.
  
  Reference:
  "Setting up Linux data mover nodes"
  (https://www.ibm.com/support/knowledgecenter/SSERB6_8.1.8/ve.ins
  t/t_ve_cfg_setdmnodes_manually_linux.html)
  
  
  =======================
  Diagnosing the issue:
  
  Running the command 'systemctl status' returns the inactive
  (dead) state of the service, for example:
  
  systemctl status dsmcad@PREFIX_DATACENTER_DM.service
  dsmcad@PREFIX_DATACENTER_DM.service
  Loaded: bad-setting (Reason: Unit
  dsmcad@PREFIX_DATACENTER_DM.service has a bad unit file
  setting.)
  Active: inactive (dead)
  
  
  =======================
  Affected product versions:
  IBM Spectrum Protect for Virtual Environments
  - Data Protection for VMware version 8.1.8.0 or later versions
  on Linux
  
  =======================
  Initial Impact: Low
  
  
  =======================
  Additional Keywords:
  tsm tsmve TS004763102
  

Local fix

• Replace the description under the heading
  "To configure the data mover on Linux using systemd, complete
  the following steps:" in the article
  "Setting up Linux data mover nodes"
  (https://www.ibm.com/support/knowledgecenter/SSERB6_8.1.8/ve.ins
  t/t_ve_cfg_setdmnodes_manually_linux.html)
  with the following procedure:
  
  1)
  Copy the updated file /etc/systemd/system/dsmcad.service to
  /etc/systemd/system/dsmcad@PREFIX_DATACENTER_DM.service with
  file permissions 664.
  
  2)
  In the file
  "/etc/system/system/dsmcad@PREFIX_DATACENTER_DM.service"
  change the line:
  -------------------------
  ExecStart=/usr/bin/dsmcad
  -------------------------
  .... to read (as one line):
  ----------------------------------------
  ExecStart=/usr/bin/dsmcad -servername=%i
   -optfile=/opt/tivoli/tsm/client/ba/bin/dsm.%i.opt
  --------------------------------------------------
  
  The %i is a special variable which will be set when running
  systemctl with "pre-at" part of the unit file name, the "at"
  character, and the desired value.
  
  3)
  Make sure that you have the PREFIX_DATACENTER_DM stanza in your
  /opt/tivoli/tsm/client/ba/bin/dsm.sys file and that it contains
  an ERRORLOGNAME and SCHEDLOGNAME specific for node
  PREFIX_DATACENTER_DM.
  
  4)
  Make sure you have the file
  /opt/tivoli/tsm/client/ba/bin/dsm.PREFIX_DATACENTER_DM.opt
  referencing the SERVERName PREFIX_DATACENTER_DM.
  
  5)
  Make sure that no dsmcad is running which uses the NODEName
  PREFIX_DATACENTER_DM.
  
  6)
  Run the following commands to configure and enable the service
  to automatically start on boot:
  systemctl start dsmcad@PREFIX_DATACENTER_DM
  systemctl status dsmcad@PREFIX_DATACENTER_DM
  systemctl enable dsmcad@PREFIX_DATACENTER_DM
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  *  IBM Spectrum Protect for Virtual Environments - Data        *
  * Protection for VMware version 8.1.8.0 -8.1.12 versions on    *
  * Linux.                                                       *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR Description                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  *  This issue is projected to be fixed in the IBM              *
  * Documentation for IBM Spectrum Protect for Virtual           *
  * Environment 8.1.13                                           *
  ****************************************************************
  

Problem conclusion

• In the IBM Documentation
  (https://ibmdocs-test.mybluemix.net/docs/en/spfve/8.1.13?topic=e
  nvironment-setting-up-linux-data-mover-nodes), the section "To
  configure the data mover on Linux using systemd" is updated.
  

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