IT34428: ANS2745E ON 'BACKUP VM' ON WINDOWS 2012 HYPER-V CLUSTER

APAR status

• Closed as program error.

Error description

• In a Windows 2012 Hyper-V Cluster, the Hyper-V guest 'BACKUP
  VM' using IBM Spectrum Protect for Virtual Environments - Data
  Protection for Hyper-V can stop with:
  ANS1228E Sending of
  object 'vm-name' failed.
  ANS2745E An assigned virtual disk to
  Hyper-V Virtual Machine 'vm-name' cannot be found.
  
  This issue
  is caused as with Windows Server 2012 in a cluster environment
  a UNC path that contains a cluster name is not valid (for
  example \\cluster_name\c$ - is not valid).
  
  
  Customer/L2
  Diagnostics:
  Example for a backup of guest 'VM_1':
  - Cluster
  name: HYPER-V_CLU
  - Computer Name: HYPER-V_NODE_A
  - 'R:' is a
  cluster disk and so UNC name for this disk will be
  \\HYPER-V_CLU\r$
  
  A data mover client HYPERV trace will show
  the following:
  The guest disk is selected :
  
  <timestamp> [PID]
  [TID] :
  ..\..\common\winnt\psfssub.cpp(3901):
  psIsClusterVolume(): use
  new way - check list of clulster volumes
  <timestamp> [PID]
  [TID] : ..\..\common\winnt\psfssub.cpp(3943):
  psIsClusterVolume(
  R:\VM_1\VM_1-NEW.vhdx) returns 1 (bool)
  <timestamp> [PID] [TID]
  : ..\..\common\winnt\psfsinfo.cpp(3927): psGetUncName():
  Use
  cluster name <HYPER-V_CLU>
  <timestamp> [PID] [TID] :
  ..\..\common\winnt\psfsinfo.cpp(3998): psGetUncName():
  returns
  UNC name <\\HYPER-V_CLU\r$\VM_1\VM_1-NEW.vhdx>
  
  Then the client
  attempts to open the virtual machine disk VM_1-NEW.vhdx.
  The
  first attempt using the UNC name fails with :
  
  <timestamp>
  [PID] [TID] : ..\..\common\winnt\psfsinfo.cpp(5947):
  GetVirtualDisk():
  First attempt to open disk
  \\HYPER-V_CLU\r$\VM_1\VM_1-NEW.vhdx failed
  with
  winerror=67
  
  ('winerror=67' means the 'The network name
  cannot be found')
  
  The second attempt using just the cluster
  driver letter R: succeeds:
  
  <timestamp> [PID] [TID] :
  ..\..\common\winnt\psfsinfo.cpp(4265):
  psGetNonUncName():
  leaving vol = \\HYPER-V_CLU\r$\VM_1\VM_1-NEW.vhdx, name
  =
  r:\VM_1\VM_1-NEW.vhdx
  <timestamp> [PID] [TID] :
  ..\..\common\winnt\psfsinfo.cpp(6011): GetVirtualDisk():
  First
  open of disk failed, second or third succeeded.
  
  Validation
  however ends with an error :
  
  <timestamp> [PID] [TID] :
  ..\..\common\winnt\vmVhdx.cpp(2413): OpenFilIfNeeded():
  Error
  opening file '\\HYPER-V_CLU\r$\VM_1\VM_1-NEW.vhdx'.
  <timestamp>
  [PID] [TID] : ..\..\common\winnt\vmVhdx.cpp(2415):
  OpenFilIfNeeded():
  errno=2, error string='No such file or
  directory'
  [...]
  <timestamp> [PID] [TID] : ..\..\common\vm\Hyper
  V\hypervcommon.cpp(2861):
  HyperVVM::ValidateVM(): Unable to
  open disk to check disk IDs rc=7136
  
  
  IBM Spectrum Protect
  Versions Affected:
  IBM Spectrum Protect for Virtual
  Environments - Data Protection for Hyper-V v7.1.x - v8.1.x on
  Windows Server 2012 with Failover Cluster.
  
  
  Initial Impact:
  Medium
  
  Additional Keywords: TS003876139, backup, hyper-v,
  ANS2745E, cluster
  

Local fix

• Add the option "CLUSTERDISKSONLY NO" to the node's dsm.opt file
  and re-run the backup of the 'VM_1' guest.
  When this option is
  set to NO, the UNC path will contain the local machine name and
  allow the backup to complete successfully.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Spectrum Protect for Virtual Environments Data Protection    *
  * for Microsoft Hyper-V versions v716, v718, v814, v816, v818, *
  * v819, v8110 and v8111 on the Windows Server platform.        *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is projected to be fixed in the Data Protection   *
  * for Microsoft Hyper-V 8.1.12 version on Windows platform.    *
  ****************************************************************
  

Problem conclusion

• The Spectrum Protect client code has been modified to correctly
  process the virtual machine that has volumes on the cluster
  disks (not cluster shared volume aka CSV).
  

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     DPHV
  

Fix information

• Fixed component name

  TSM VE DP MS HY

• Fixed component ID

  5725TVEHV

Applicable component levels