IT37038: VM RESTORE IS FAILING WITH ERROR CTGGA0939 AND 'HTTP STATUS: 400' WHEN USING TAGS WITH THE SAME NAME ON VMWARE

APAR status

• Closed as program error.

Error description

• When tags having same names are used for different resources in
  a VMware environment protected by IBM Spectrum Protect Plus, an
  'on-demand' restore job can fail to create the VM.
  This failure happens when the IBM Spectrum Protect Plus
  Inventory Service collected information about the VMware tags
  associated to the restored VM and about tags with the same name
  associated to other unrelated VMware objects
  (ESXi hosts, folders,...).
  
  Example of VMware tags with teh same name used in a simple
  vSphere environment:
  
  vCenter
     datacenter
         ESXi host 1 -> tag_1
            folder 1
                VM_1
         ESXi host 2 -> tag_2
            folder 2
                VM_2 -> tag_1
  
  When trying to restore VM_2 and associated tags, which would be
  the 'tag_1' associated to the original VM_2 but not wanting the
  same-named 'tag_1' that is associated to 'ESXi host 1'.
  
  The restore job log shows messages similar to:
  
    INFO,...,CTGGA1018 Creating VM <VM_Name> (VM 1 of 1)
  DETAIL,...,CTGGA1019 Configuring VM (<VM_Name>) (VM 1 of 1)
   ERROR,...,CTGGA1020,Failed to create VM (<VM_Name>). Error =
                       (HypervisorException).
   ERROR,...,CTGGA0939 Failed to reconfigure VM (<VM_Name>).
                       Exception (com.catalogic.ecx.
                      serviceprovider.common.hypervisor.exception
                       .HypervisorException) reports:
                       (HTTP Status: 400. null)
   ERROR,...,CTGGA1110,No selected item is recoverable.
  
  The VIRGO log indicates that the REST API call to the vCenter
  server is failing:
  
   INFO ... Rest call made to cis vcenter server https://
            <vCenter-Web-Address>:443/rest/com/vmware/cis/tagging
            /tag-association/id:urn:vmomi:InventoryServiceTag:
            01234567-1234-1a2b-3c4d-f85000x01yy2:GLOBAL?~action=
            attach result is <400 Bad Request,...
   INFO ... Rest call status 400
  ...
  ERROR ... Failed to create VM (<VM_Name>).
            Error = (HypervisorException).
  
  Initial Impact: Medium
  
  IBM Spectrum Protect Plus Versions Affected:
  IBM Spectrum Protect Plus 10.1.x
  
  Additional Keywords: SPP, SPPLUS, TS005415741, tag, Hypervisor,
                       restore
  

Local fix

• Run the restore without restoring the tags, selected at the
  restore job option's.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect Plus level 10.1.0, 10.1.1, 10.1.2,      *
  * 10.1.3, 10.1.4, 10.1.5, 10.1.6, 10.1.7, 10.1.8               *
  ****************************************************************
  * 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.8 *
  * patch1 and 10.1.9. Note that this is subject to change at    *
  * the discretion of IBM.                                       *
  ****************************************************************
  

Problem conclusion

• A change was made to ensure tags attached during restore are
  matched by ID when possible, instead of always matching by name.
  

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