IBM Support

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

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

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 number

    IT24616

  • Reported component name

    TSM CLIENT

  • Reported component ID

    5698ISMCL

  • Reported release

    71W

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2018-04-04

  • Closed date

    2018-06-22

  • Last modified date

    2018-06-22

  • 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



Document information

More support for: Tivoli Storage Manager

Software version: 71W

Reference #: IT24616

Modified date: 22 June 2018


Translate this page: