IT32231: VM BACKUPS CAN FAIL WITH "TARGET STORAGE VOLUME NAME PROPERTY 'VIRTUALHW.VERSION' IS NOT PRESENT IN VMX FILE"

APAR status

• Closed as program error.

Error description

• A VM backup can fail with the following error message reported
  in the joblog:
  ERROR,timestamp,CET,2,CTGGA2403,Backup of vm VMNAME failed
  target storage volume name Property 'virtualHW.version' is not
  present in VMX file. Error: spp_volume_name
  This error occurs due to the case sensitivity of the key
  "virtualHW.version" while the .vmx file for the vm VMNAME
  contains the entry for the virtual machine hardware version as
  below:
  virtualhw.version = "x"
  Initial impact: Medium
  Versions Affected: 10.1.*
  

Local fix

• 1. Power off the affected VM
  2. Locate the entry virtualhw.version = "x" in VM's .vmx file
  3. Change the above entry to:
  virtualHW.version = "x"
  4. Save and close the .vmx file
  5. Power on the VM and perform vm backup via SPP
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect Plus level 10.1.5                       *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is currently *
  * projected to be fixed IBM Spectrum Protect Plus level 10.1.5 *
  * 2199 and 10.1.6. Note that this is subject to change at the  *
  * discretion of IBM.                                           *
  ****************************************************************
  

Problem conclusion

• A code change was made to ignore case when checking for the
  hardware version key in the VMX file. It was previously expected
  the key follow case formatting of "virtualHW.version"
  

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

  SP PLUS

• Fixed component ID

  5737SPLUS

Applicable component levels