IT30351: ERROR ANS4311E WITH RC=7130 ON HYPER-V GUEST RESTORE TO ORIGINAL LOCATION

APAR status

• Closed as program error.

Error description

• The restore of a Hyper-V guest to the original name and location
  might stop with the message :
  "ANS4311E Full VM restore of 'Hyper-V' Virtual Machine
  '<vmname>' failed with RC=7130 target node name='<target node>',
  data mover node name='<data mover node>'"
  
  in the data mover node server,vm trace the following will be
  seen :
  
  <timestamp> [PID] [TID] :
  ..\..\common\vm\vmoptrestvddk.cpp(2012):
  vmHyperVCreateNewVmMachine(): Creating planned VM: config file =
  'C:\mnt\tsmvmbackup\fullvm\<vmname>\0AE3CFC4-5E19-4297-BEF3-8693
  BAB8C75F.vmcx' VM Name = '<vmname>' guid =
  '0AE3CFC4-5E19-4297-BEF3-8693BAB8C75F'
  ...
  <timestamp> [PID] [TID] :
  ..\..\common\vm\vmoptrestvddk.cpp(1383):
  vmHyperVCreateVhdDisks(): deleting file
  'C:\ClusterStorage\Volume1\<vmname>\<vmname>_disk_1.vhdx' .
  <timestamp> [PID] [TID] : ..\..\common\winnt\psfile.cpp(2172):
  psFileRemove(): enter with file name
  <C:\ClusterStorage\Volume1\<vmname>\<vmname>_disk_1.vhdx>
  <timestamp> [PID] [TID] : ..\..\common\winnt\psfile.cpp(2243):
  psFileRemove: error 32
  <timestamp> [PID] [TID] : ..\..\common\winnt\ntrc.cpp( 740):
  TransWin32RC(): Translated Win32 RC 32 (0x00000020) from
  psFileRemove:
  C:\ClusterStorage\Volume1\<vmname>\<vmname>_disk_1.vhdx to TSM
  RC 933
  <timestamp> [PID] [TID] : ..\..\common\winnt\ntrc.cpp( 802):
  TransWin32RC(): SnapshotErrMode = 0; dwWin32RC = 32
  <timestamp> [PID] [TID] :
  ..\..\common\vm\vmoptrestvddk.cpp(1386):
  vmHyperVCreateVhdDisks(): Error deleting file
  'C:\ClusterStorage\Volume1\<vmname>\<vmname>_disk_1.vhdx' .
  <timestamp> [PID] [TID] :
  ..\..\common\vm\vmoptrestvddk.cpp(2184):
  vmHyperVRestoreConfigAndCreateVM(): returning 7130.
  <timestamp> [PID] [TID] :
  ..\..\common\vm\vmoptrestvddk.cpp(2927):
  vmHyperVVddkOptRestoreVM(): Error creating new virtual
  machine:vmHyperVRestoreConfigAndCreateVM: rc=7130.
  
  This issue might happen when disk file handles are not opened
  and closed in a ordered manner which can lead to a handle
  'leak'.
  
  Spectrum Protect Versions Affected:
  Spectrum Protect for Virtual Environments - Data protection for
  Hyper-V 8.1.4 and higher on Windows
  
  Initial Impact: Medium
  
  Additional Keywords: TS002666901 TSM TDP4VE Hyper-V restore
  handle 177039
  

Local fix

• Restore the guest to an alternate name then rename it to the
  original name.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Spectrum Protect for Virtual Environments Data Protection    *
  * for Microsoft Hyper-V versions 7.1.6, 7.1.8, 8.1.2, 8.1.4,   *
  * 8.1.6, 8.1.7, 8.1.8 and 8.1.9 running on                     *
  * - Windows Server 2012;                                       *
  * - Windows Server 2012 R2;                                    *
  * - Windows Server 2016;                                       *
  * - Windows Server 2019;                                       *
  * - Windows 10.                                                *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is projected to be fixed in the Data Protection   *
  * for Microsoft Hyper-V 8.1.10 version on                      *
  * - Windows Server 2016;                                       *
  * - Windows Server 2019;                                       *
  * - Windows 10;                                                *
  * - Windows Server 2012;                                       *
  * - Windows Server 2012 R2.                                    *
  ****************************************************************
  

Problem conclusion

• The Data Protection for Microsoft Hyper-V has been changed to
  correctly close all handles to VHDX files.
  

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 VE DP MS HY

• Fixed component ID

  5725TVEHV

Applicable component levels