IT37850: "ANS9427E" AND "ANS9447E" DURING VMWARE VM GUEST RESTORE

APAR status

• Closed as change to accomodate OEM Vendor's code.

Error description

• When restoring a VM guest using IBM Spectrum Protect for Virtual
  Environments - Data protection for VMware, the restore attempt
  fails with the following messages:
  
  ANS9427E The virtual machine 'vm_name'  disk 'Hard Disk 1' could
  not be opened because none of the allowed transports
  ('transport_mode') is available.
  ANS0361I DIAG: ..\..\common\vm\vmcommonrestvddk.cpp(10672):
  vmVMwareRestoreDiskDispatcher(): one or more disk restore
  session threads of vmname='vm_name' failed: highest rc=7336 .
  ANS9447E The virtual machine 'vm_name'  disk could not be opened
  because none of the allowed transports is available.
  
  The cause is due to a limitation of the VMware Virtual Disk
  Development Kit (VDDK) 7.0 and higher on windows base systems:
  https://vdc-download.vmware.com/vmwb-repository/dcr-public/ee65
  cc8c-0701-4b39-a8d3-7025818a02ea/dfaaa64d-f1fc-4722-9b21-cf10fb
  030eeb/VDDK-700-ReleaseNotes.html
  
  "New: I/O threads possibly not initialized on Windows.
  The diskLibPlugin module is dynamically loaded into vixDiskLib
  when programs call VixDiskLib_InitEx. On Windows, dynamic
  loading may result in the static thread for local storage not
  getting initialized. Some operations, such as fetch block map,
  can fail if I/O threads are created before calling
  VixDiskLib_InitEx. The workaround is to wait for completion of
  VixDiskLib_InitEx before creating any I/O threads. "
  
  VDDK version 7.0 is used with IBM Spectrum Protect for Virtual
  Environments - Data Protection for VMware starting version
  8.1.10.
  
  
  IBM Spectrum Protect Versions Affected:
  IBM Spectrum Protect for Virtual Environments - Data Protection
  for VMware version 8.1.10 and later on Windows
  
  
  Additional Keywords: TS004783631, ANS9427E, ANS9447E
  

Local fix

• Alternate possible restore methods depending on the required
  restore needs:
  - Use Instant Access/Instant Restore
  or
  - Use file-level restore
  or
  - As only Windows systems are affected, when possible, use a IBM
  Spectrum Protect for Virtual Environments - Data protection for
  VMware data mover running on Linux
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect for Virtual Environments Data           *
  * Protection for VMware versions 8.1.10, 8.1.11 and 8.1.12     *
  * running on all Microsoft Windows x64 platforms.              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is projected to be fixed in the Data Protection   *
  * for VMware Data Mover version 8.1.13 on Windows x64 and      *
  * Linux x86 platforms.                                         *
  * Note 1: This is subject to change at the discretion of IBM.  *
  ****************************************************************
  

Problem conclusion

• The code has been updated to initialize VDDK libs before
  starting IO threads.
  

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

• dsmagent
  

Fix information

Applicable component levels