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 number
IT37038
Reported component name
SP PLUS
Reported component ID
5737SPLUS
Reported release
A17
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2021-05-27
Closed date
2021-05-27
Last modified date
2021-05-27
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
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSNQFQ","label":"IBM Spectrum Protect Plus"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"A17","Line of Business":{"code":"LOB26","label":"Storage"}}]
Document Information
Modified date:
31 January 2024