IT24661: ANS5056E SYSTEMSTATE BACKUP FAILURE ON PASSIVE CLUSTER NODE WITH CLIENTS V7.1.8+ AND V8.1.4+

IBM Spectrum Protect client 7.1.8.x interim fix downloads
IBM Spectrum Protectâ„¢ Client 8.1.6 Downloads and READMEs

APAR status

• Closed as program error.

Error description

• After an upgrade of the client to versions 7.1.8 or 8.1.4, or
  higher, the systemstate backup fails on the passive node of a
  Microsoft Windows cluster.
  This problem happens because a VSS writer points to some files
  which are located on a cluster disk, which is not available on
  the passive node.
  With pre-7.1.8/8.1.4 client levels, the client option
  SKIPMISSINGSYSWFILE YES allowed to skip those missing objects
  and let the systemstate backup run to completion.
  The missed files were then reported in the dsmerror.log with a
  message like this:
   "ANS4199W  File 'file name' is not backed up as part of the
  system state because cluster disk 'volume name' is not
  accessible."
  
  Now, after the upgrade to client version 7.1.8 or 8.1.4, or
  higher - the errors below are reported and the systemstate
  backup fails even in case the SKIPMISSINGSYSWFILE YES option is
  being used.
  
  Customer/L2 Diagnostics:
   Errors reported in the dsmerror.log file:
  
   ANS5250E An unexpected error was encountered.
     TSM function name : AddFileToRequest
     TSM function      : FindVolumeToSnap() for drive 'x:\'
  returned 109
     TSM return code  : 109
     TSM file         : ..\..\common\winnt\vssreq.cpp (5851)
   ANS5250E An unexpected error was encountered.
     TSM function name : objEnumAuditFileSub
     TSM function      : GetBestVolumeMatch() for file
  '\\xxxxx\x$\ibm\itm\ihs\bin\xxxx.xxx' failed.
     TSM return code  : 105
     TSM file         : ..\..\common\ba\objenum.cpp (1581)
   ANS5250E An unexpected error was encountered.
     TSM function name : BaHandleSystemPostSnapshotCmd
     TSM function      : objEnumAuditFileSub() failed
     TSM return code  : 105
     TSM file         : ..\..\common\ba\backsnap.cpp (3725)
   ANS5250E An unexpected error was encountered..
     TSM function name : baHandleSnapshot
     TSM function      : BaHandleSystemPostSnapshotCmd() failed.
     TSM return code  : 105
     TSM file         : ..\..\common\ba\backsnap.cpp (4729)
   ANS1327W The snapshot operation for
  'XXXXX\SystemState\NULL\System State\SystemState' failed with
  error code: 105.
   ANS0361I DIAG: GetRootAttrib(): Root directory
  \\?\GLOBALROOT\Device\HarddiskVolumeShadowCopy13\ not found
   ANS1228E Sending of object '' failed
   ANS5056E  The specified directory path could not be found.
   ANS1999E Backup processing of '\\xxxxx\c$' stopped.
  
  IBM Spectrum Protect Versions Affected: Clients 7.1.8 or 8.1.4,
  or higher, in a Windows cluster environment
  
  | MDVREGR 7.1.8.0-TIV_5698MCL |
  | MDVREGR 8.1.4.0-TIV_5698MCL |
  
  Initial Impact: Medium
  
  Additional Keywords: TSM defect 138020 IC98505
  

Local fix

• Roll-back to a previews client level, for example 7.1.6 or
  8.1.2, and if a backup took place with the 7.1.8 / 8.1.4 level,
  restart a backup from scratch ( by deleting or renaming the
  filespaces at the IBM Spectrum Protect server side ) or use a
  new nodename.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect backup-archive client versions 7.1.8    *
  * and 8.1.4 running on Microsoft Windows Server platforms with *
  * Failover Cluster installed.                                  *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is currently *
  * projected to be fixed in level 8.1.6.                        *
  * Note that this is subject to change at the discretion of     *
  * IBM.                                                         *
  ****************************************************************
  

Problem conclusion

• The system state backup can fail when a cluster disk (that
  contains some system files) is not available on the passive node
  of a MS Windows cluster. The code has been changed so that
  system state backup will skip the missing files from unavailable
  cluster disk and let the bacukp run to completion.
  

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

• DSMC     DSM      DSMCSVC
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels

• R81W PSY

     UP