IT40000: ERROR CAN OCCUR WHEN ATTEMPTING TO ONLINE DISK ON HYPER-V HOST DURING BACKUP

APAR status

• Closed as program error.

Error description

• An error can occur when attempting to online a recently attached
  disk to the Hyper-V host during IBM Spectrum Protect Plus backup
  operation.
  
  The backup job for Hyper-V Virtual Machines could fail with the
  following messages in job log:
  An exception occurred during target volume mapping.  Failed to
  create hypervisor clustered volume. Reason: null
  Backup of virtual machine (VM) <name> has failed. Error: Failed
  to create hypervisor clustered volume. Reason: null
  
  Virgo logs contain the following exception:
  [2021-12-05T12:25:07.757Z] INFO  Thread-62
  c.c.ecx.serviceprovider.common.hypervisor.hyperv.HypervScsiDisk
  1638707048205 Disk is offline, making it online
  [2021-12-05T12:25:08.473Z] INFO  Thread-62
  c.c.e.s.protection.hypervisor.cbt.CbtTargetVolumeHandlerBase
  1638707048205 Error
  com.catalogic.ecx.serviceprovider.common.hypervisor.exception.Hy
  pervisorDiskOfflineException: null
           at
  com.catalogic.ecx.serviceprovider.common.hypervisor.hyperv.Hyper
  vScsiDisk.online(HypervScsiDisk.java:131)
           at
  com.catalogic.ecx.serviceprovider.protection.hypervisor.cbt.CbtT
  argetVolumeHandlerSan.rescanClusterHbas(CbtTargetVolumeHandlerSa
  n.java:765)
           at
  com.catalogic.ecx.serviceprovider.protection.hypervisor.cbt.CbtT
  argetVolumeHandlerSan.getClusteredHypervisorVolume(CbtTargetVolu
  meHandlerSan.java:195)
           at
  com.catalogic.ecx.serviceprovider.protection.hypervisor.cbt.CbtT
  argetVolumeHandlerSan.createHypervisorVolumeFromExistingStorageV
  olume(CbtTargetVolumeHandlerSan.java:419)
  
  Affected versions: IBM Spectrum Protect Plus 10.1.0 - 10.1.9
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect Plus level 10.1.x                       *
  ****************************************************************
  * 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.9.3 and 10.1.10. Note that this is subject to     *
  * change at the discretion of IBM.                             *
  ****************************************************************
  

Problem conclusion

• A code change was made to wait and retry making the backup disk
  online during Hyper-V backup if initial attempt fails.
  

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 Hyper-V
  

Fix information

• Fixed component name

  SP PLUS

• Fixed component ID

  5737SPLUS

Applicable component levels