IT41645: 'CTGGA0939 FAILED TO RECONFIGURE VM' AT VMWARE GUEST RESTORE WITH 'THE OBJECT OR ITEM REFERRED TO COULD NOT BE FOUND'

APAR status

• Closed as program error.

Error description

• The IBM Spectrum Protect Plus VMware guest restore can stop with
  the following job log messages :
  
  SUMMARY,<TimeStamp>,CTGGA2398,Starting job for policy
                                onDemandRestore_<Id>
                                (ID:<SLAId>). id -> <JobId>.
                                IBM Spectrum Protect Plus version
                                10.1.10-2709.
  ...
   DETAIL,<TimeStamp>,CTGGA2674,Recovery policy options:
                    {sourceType=VMware
                 selectedSource=[<SourceVMName>]
                 sourceSnapshot=[<SourceVMName> -
                                 <RestorePointTimeStamp>]
                    restoreType=ondemand
              restoreSourceType=tape
                  restoreSource=<RestoreSourceName>
                    destination=Original Host or Cluster
                ipConfiguration=Use original IP configuration.
                  restoreMethod=Test
                       renameVM=[<SourceVMName> ->
                                 <TargetSourceVMName>]
        autocleanupOnJobFailure=true
                    overwriteVM=false
     continueWithRestoreOnError=true
                enableStreaming=false
           powerOnAfterRecovery=false
                   restoreVmTag=true
         continueScriptsOnError=false}
  ...
   DETAIL,<TimeStamp>,CTGGA2179,Create VMs: In progress
     INFO,<TimeStamp>,CTGGA2618,Creating VM <TargetSourceVMName>
                                (VM 1 of 1)
   DETAIL,<TimeStamp>,CTGGA1019,Configuring VM
                                (<TargetSourceVMName>) (VM 1 of 1)
   DETAIL,<TimeStamp>,CTGGA1022,VM (<TargetSourceVMName>) does not
                                need to be reverted to a VM
                                snapshot.
    ERROR,<TimeStamp>,CTGGA1020,Failed to create VM
                                (<TargetSourceVMName>).
                                Error =
                                (HypervisorVMReconfException).
    ERROR,<TimeStamp>,CTGGA0939,Failed to reconfigure VM
                                (<TargetSourceVMName>).
          Exception (com.catalogic.ecx.serviceprovider.common.
                     hypervisor.exception.
                     HypervisorVMReconfException)
          reports: (The object or item referred to could not be
                    found.)
  
  This does not indicate to the administrator which item is not
  found.
  Only in the vCenter event log, when looking for the events for
  the new restore target VMware guest, the cause of the error is
  seen at the 'Reconfigure Virtual Machine' step.
  In the above example, the error detail says :
  'The object or item referred to could not be found. DVS <DVS Id>
   cannot be found'
  
  This means the Dynamic Virtual Switch (DVS) recorded at the time
  of backup does not exist anymore in the current vSphere
  environment.
  The job log messaging should include information about the
  missing item to help the administrator to correct the problem.
  
  IBM Spectrum Protect Plus Versions Affected:
  IBM Spectrum Protect Plus 10.1.x
  
  Additional Keywords: SPP, SPPLUS, TS009989618, reconfigure,
                       missing
  

Local fix

• Local Fix:
  Review the vCenter event log to identify the missing item.
  Depending on the desired outcome :
  Recreate the missing item in the vSphere environment
  or
  Restore the guest with alternate parameters
  (different ESXi, Datastore, Network,..) to values existing in
  the current vSphere environment.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect Plus level 10.1.3, 10.1.4, 10.1.5,      *
  * 10.1.6, 10.1.7, 10.1.8, 10.1.9, 10.1.10, 10.1.11 and 10.1.12 *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See error description                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply the fixing level when available. This problem is       *
  * currently projected to be fixed in IBM Spectrum Protect Plus *
  * level 10.1.13. Note that this is subject to change at the    *
  * discretion of IBM.                                           *
  ****************************************************************
  

Problem conclusion

• Additional error message content from VMWare was added to the
  job log message.
  

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:

Modules/Macros

• Hypervis VMWare
  

Fix information

• Fixed component name

  SP PLUS

• Fixed component ID

  5737SPLUS

Applicable component levels