IT24616: DSMAGENT CRASHES DURING A VSS BACKUP WHEN FAILING OVER TO THE REPLICATION TARGET SERVER

IBM Spectrum Protectâ„¢ Client 8.1.6 Downloads and READMEs

APAR status

• Closed as program error.

Error description

• A VSS backup operation by an IBM Spectrum Protect
  Backup-Archive Client or any API Client and Data Protection
  Client on the Microsoft Windows platform fails with the
  following error in the output and the application log file
  (e.g. dsmsched.log for the Backup-Archive Client,
  tdpexc.log for Data Protection for Microsoft Exchange Server,
  tdpsql.log for Data Protection for Microsoft SQL Server):
  ANS1017E (RC-50)  Session rejected: TCP/IP connection failure.
  The error indicates that the dsmagent component has become
  unresponsive and has crashed.
  
  Diagnosing the issue:
  ---------------------
  In the dsmagent's Client option file (dsm.opt)
  the Client option USEREPLICATIONFailover is set to Yes either
  explicitly, or implicitly as this is the default value.
  
  The Microsoft Windows application event log shows messages
  concerning the dsmagent crash and also the location of a crash
  dump if the dsmcrash.dmp and dsmcrash.log was not created.
  
  The dsmagent's error log may not show any hints concerning the
  issue.
  
  The API error log file for a Data Protection Client shows:
  
  03/06/2018 06:51:38 ANS1017E Session rejected:
   TCP/IP connection failure.
  
  A dsmagent service trace running at the time may show that the
  stream was interrupted by an additional connection from a
  dsmcad process, for example:
  
           CAD TCP v4 Acceptor thread CAD     1================>
  03/06/2018 06:51:48.419 [022148] [15596] :
   ..\..\common\com\acceptor.cpp( 642):
   Incoming connection accepted
                       unknown thread CAD    -1================>
  03/06/2018 06:51:48.419 [022148] [23408] :
   ..\..\common\thrd\thrdmgr.cpp(1604):
   Starting thread Session Function
  03/06/2018 06:51:48.419 [022148] [23408] :
   ..\..\common\opt\optservices.cpp(1090):
  optOpenUserOptionFile():
   Opening user options file
   'C:\Program Files\Tivoli\TSM\baclient\dsm.opt'
  
  
  Affected versions:
  ===================
  IBM Tivoli Storage Manager and IBM Spectrum Protect Client
  versions 7.1 and 8.1 on Microsoft Windows.
  
  Initial Impact: Medium
  
  Additional Keywords:
  tsm baclient crash vss dsmagent
  

Local fix

• In the dsmagent's Client option file (dsm.opt) set
  the Client option USEREPLICATIONFailover to No.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Users of:                                                    *
  * IBM Spectrum Protect VSS Requestor, which is a part of the   *
  * following products:                                          *
  * Spectrum Protect for Databases: Data Protection for          *
  * Microsoft SQL Server,                                        *
  * Spectrum Protect Snapshot for Microsoft SQL Server,          *
  * Spectrum Protect for Mail: Data Protection for Microsoft     *
  * Exchange Server,                                             *
  * Spectrum Protect Snapshot for Microsoft Exchange Server,     *
  * Spectrum Protect Snapshot for Windows.                       *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This fix is currently     *
  * scheduled to be in the IBM Spectrum Protect VSS Requestor    *
  * (IBM Spectrum Protect Client) 8.1.6.0 on Windows x64         *
  * platform                                                     *
  * Note: This information is subject to change at the           *
  * discretion of IBM.                                           *
  ****************************************************************
  

Problem conclusion

• IBM Spectrum Protect VSS Requestor has been updated to
  correctly disable backup operations when the session with the
  IBM Spectrum Protect Server is in a failover mode.
  

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

• dsmagent
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels

• R71W PSN

     UP

• R81W PSY

     UP