IT25299: RESTORE OF A SINGLE DISK INSIDE A VM FAILS WHEN SAN TRANSPORT METHOD IS USED

APAR status

• Closed as program error.

Error description

• When a VM with multiple disks has been backed up using IBM
  Spectrum Protect for Virtual Environments - Data Protection for
  VMware and a restore is done from one or more disks to the
  existing VM using SAN transport method, this restore will fail
  if Change Block Tracking (CBT) is enabled for this VM.
  
  IBM Spectrum Protect Versions Affected:
  IBM Spectrum Protect for Virtual Environments - Data Protection
  for VMware - All support versions.
  
  Customer/L2 Diagnostics:
  
  The restore will fail with following messages:
  
  ANS0361I DIAG: ..\..\common\vm\vmcommonrestvddk.cpp(2310):
  vmVMwareWriteToVMDKDisk(): vddk Write failed (rc=4398):
  startSector=xxxxxx, numberOfSectors=512, startByteOffset=yyyyyy
  ANS9365E VMware vStorage API error for virtual machine
  'VM_NAME'.
     TSM function name : VixDiskLib_Write
     TSM file          : ..\..\common\vm\vmvddksdk.cpp (3119)
     API return code   : 1
     API error message : Unknown error
  
  Documentation needs to be updated with this behavior.
  
  Initial Impact: Low
  
  Additional Keywords: TSM, Tivoli, Storage, Manager, TDP, TDP4VE
  

Local fix

• Change the transport method to NBD, NBDSSL or HotAdd when
  restoring a single disk in an existing VM.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All users of versions of IBM Spectrum Protect - Data         *
  * Protection for Virtual Environments 8.1 - restore CLI.       *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * The documentation needs to specify that if a VM with         *
  * multiple disks has been backed up using IBM Spectrum Protect *
  * for Virtual Environments - Data Protection for VMware and a  *
  * restore is done from one or more disks to the existing VM    *
  * using SAN transport method, this restore will fail if Change *
  * Block Tracking (CBT) is enabled for this VM.                 *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This issue is projected   *
  * to be fixed in the 8.1.6 update to the Spectrum Protect for  *
  * Virtual Environments User's Guide.                           *
  *                                                              *
  * Until this information is published, the associated          *
  * information updates are documented in the V8.1 Documentation *
  * Updates tech note located here:                              *
  * http://www.ibm.com/support/docview.wss?uid=swg27048968       *
  *                                                              *
  * You can locate the entry associated with this APAR by using  *
  * the APAR number as a keyword to search the document.         *
  ****************************************************************
  

Problem conclusion

• The corrected information will be published with the next
  release of the Spectrum Protect for Virtual Environments
  documentation and included in the V8.1 Documentation Updates
  tech note. The updates will be located in the Topic titled as:
  Restore, which describes how to use the vmcli command to restore
  backups of VMs or VM templates.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

  IT24884

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  TSM FOR VE DP V

• Fixed component ID

  5725TVEVM

Applicable component levels