IT18856: MICROSOFT HYPER-V BACKUP FAILS WITH ANS5250E AND VSS_E_SNAPSHOT_SET_IN_PROGRESS

IBM Spectrum Protectâ„¢ Client 8.1.2 Downloads and READMEs
IBM Spectrum Protectâ„¢ Client 7.1.8 Downloads and READMEs

APAR status

• Closed as program error.

Error description

• The backup of a Microsoft Hyper-V guest might fail with
  following symptoms:
  
  dd/mm/yyyy hh:mm:ss ANS5250E An unexpected error was
  encountered.
     TSM function name : StartSnapshotSet()
     TSM function      : 'StartSnapshotSet() failed with error
  VSS_E_SNAPSHOT_SET_IN_PROGRESS. 0X80042316'
     TSM return code   : -2147212522
     TSM file          : ..\..\common\vm\HyperV\vsssnap.cpp (1132)
  dd/mm/yyyy hh:mm:ss ANS1950E Backup using Microsoft volume
  shadow copy failed.
  
  The IBM Spectrum Protect client doesn't free
  'IVssBackupComponents' object when 'backup vm' fails. So the
  subsequent attempts to back up this VM, and any other VMs on
  the same Hypver-V host will fail with *snapshot in progress*
  error.
  
  IBM Spectrum Protect Versions Affected:
  IBM spectrum Protect for Virtual Environments - Data Protection
  for Microsoft Hyper-V 7.1
  IBM spectrum Protect for Virtual Environments - Data Protection
  for Microsoft Hyper-V 8.1
  
  
  Customer/L2 Diagnostics:
  
  Review the IBM Spectrum Protect client schedlog and errorlog
  for any previous failed backups.
  If a previous backup failure occured, e.g. during the
  simultanious backup of two VM's residing on the same CSV
  (Cluster Shared Volume), this APAR aplies.
  
  Initial Impact: Medium
  
  Additional Keywords: TSM, Tivoli, Storage, Manager,
  

Local fix

• Restart the Volume Shadow Copy service on all Hyper-V cluster
  nodes.
  To do this, open an elevated command prompt window and run the
  following commands:
     net stop vss
     net start vss
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect for Virtual Environments Data           *
  * Protection for HyperV version 7.1 and 8.1.0 running on all   *
  * Microsoft Windows x64 platforms.                             *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is projected to be fixed in the Backup-Archive    *
  * Client version 7.1.8 and 8.1.2 on all Microsoft Windows x64  *
  * platforms                                                    *
  * Note 1: The Backup-Archive Client is a part of the Data      *
  * Protection for Microsoft Hyper-V. In Data Protection for     *
  * Microsoft Hyper-V environments, the Backup-Archive Client is *
  * also known as the data mover.                                *
  * Note 2: This is subject to change at the discretion of IBM.  *
  ****************************************************************
  

Problem conclusion

• The problem is that when Microsoft HyperV writer returns an
  error the Spectrum Protect client doesn't release the
  IVssBackupComponents object and as result all subsequent backup
  can fail with VSS error. The code has been modified to free
  IVssBackupComponents in case of error.
  

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

• DSM      DSMC     DSMCSVC
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels

• R81W PSY

     UP