IT25555: RESTORE VM TO A NEW NAME FAILS WHEN ITS TARGET VM IS USING MANUALLY ASSIGNED MAC ADDRESS.

Download Information: Version 8.1.6.x Data Protection for VMware

APAR status

• Closed as program error.

Error description

• A restore vm command using -vmname=<new_vm_name> option fails
  with ANS9365E RC=2329 vmvisdk.cpp (6766), when the target VMware
  VM is using manually assigned MAC address, as below:
  
  ------
  Protect> restore vm <vm_name> -vmname=<new_vm_name> ......
  .........
  ANS9365E VMware vStorrage API error for virtual machine
  '<vm_name>'.
  IBM Spectrum Protect Function name : CreateVM_USCORETask
  IBM Spectrum Protect File : ..\..\common\vm\vmvisdk.cpp (6766)
  API Return code : 2329
  API Error message :
  ANS2523E  The virtual machine named <new_vm_name> cannot not be
  restored to the same configuration it had when it was backed up.
  IBM Spectrum Protect will reconfigure the virtual machine to
  include only the most essential configuration information and
  retry the restore operation.
  ------
  
  When IBM Spectrum Protect for Virtual Environments Data
  Protection for VMware tries to restore a VM to a new name, it
  automatically clears MAC addresses for all NICs.   But it does
  not change addressType (manual or automatic).   As result, in
  this case, the addressType is manual and VMware rejects creating
  VM with manual address type and no MAC address specified.
  
  
  
  Tivoli Storage Manager Versions affected:
  IBM Spectrum Protect for Virtual Environments Data Protection
  for VMware version 8.1.4 or higher on Windows and Linux.
  
  
  
  Initial Impact:
  Middle
  
  
  
  Additional Keywords:
  TSM, TS001057108
  

Local fix

• Use testflag VMRESTORE_SKIP_CLEAR_NIC_MAC_ADDRESS to skip
  clearing MAC address.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect for Virtual Environments Data           *
  * Protection for VMware versions 8.1.4 and 8.1.6 running on    *
  * all Microsoft Windows x64 and Linux x86 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.7 on Windows x64 and Linux *
  * x86 platforms.                                               *
  * Note 1: This is subject to change at the discretion of IBM.  *
  ****************************************************************
  

Problem conclusion

• Manually assigned MAC address is now correctly handled during
  restore.
  

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:

Fix information

• Fixed component name

  TSM FOR VE DP V

• Fixed component ID

  5725TVEVM

Applicable component levels

• R81W PSY

     UP

• R81L PSY

     UP