IT18678: MICROSOFT HYPER-V BACKUP FAILS WITH ANS4169E AND ANS1228E

IBM Spectrum Protect client 7.1.6.x interim fix downloads
IBM Spectrum Protect client 8.1.x.y interim fix downloads
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 error:
  
  ANS0361I DIAG: vmHypervBackup::ProcessExtent(): Read failed
  with rc=1117
  ANS0361I DIAG: vmHypervBackup::ProcessExtent(): Read failed
  with rc=122
  ANS4169E A write failure occurred on the local disk proxy used
  to temporarily store the virtual machine virtual disk
  information. The write failure can be caused by the lack of
  available disk space on the drive used to store this
  information. The VMBACKDIR option can be used to assign a
  different disk location for this purpose.  Check the drive
  being used and ensure that there is enough space available for
  this operation.
  [...]
  ANS1228E Sending of object 'VMguest' failed.
  
  The failure is caused by the VHDX size of the Hyper-V guest not
  being a multiple of 16 KB (16384 bytes).
  
  IBM Spectrum Protect Versions Affected:
  IBM spectrum Protect for Virtual Environments - Data Protection
  for Microsoft Hyper-V 7.1.6
  IBM spectrum Protect for Virtual Environments - Data Protection
  for Microsoft Hyper-V 8.1
  
  | MDVPARTL 7.1.6.0-TIV_5698ISMCL | IT11599
  
  Customer/L2 Diagnostics:
  Verify the VHDX size using PowerShell Cmdlet:
   Get-VHD 'diskname'
  Where diskname is the fully qualified path to the .vhdx
  Look for the 'Size' field. If this value is not a multiple of
  16384 bytes, this APAR applies.
  
  Initial Impact: Medium
  
  Additional Keywords: TSM, Tivoli, Storage, Manager, Hyperv, MS,
  VM, IT11599
  

Local fix

• Resize the VHDX file to a multiple of 16384 bytes using
  Microsoft PowerShell Cmdlet:
   Resize-VHD -path 'diskname.vhdx' -SizeBytes <Size in bytes>
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Data Protection for Microsoft Hyper-V versions 7.1.3, 7.1.4, *
  * 7.1.6 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.6.5, 7.1.8, 8.1.0.2, 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

• Algorithm that calculates amount of data to sent during backup
  was updated to correctly handle cases when VHDX size is not
  multiply of 16834 bytes.
  

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
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels

• R71W PSY

     UP

• R81W PSY

     UP