IT20088: CRASH DURING RESTORE OF HYPER-V GUEST TO WINDOWS SERVER 2016 IF THE GUEST WAS BACKED UP FROM WINDOWS SERVER 2012 OR 2012 R2

IBM Spectrum Protectâ„¢ Client 8.1.2 Downloads and READMEs
IBM Spectrum Protectâ„¢ Client 7.1.8 Downloads and READMEs

APAR status

• Closed as program error.

Error description

• The IBM Spectrum Protect Backup-Archive client crashes during
  restore of a virtual machine to a Microsoft Windows Server 2016
  Hyper-V host if the guest was backed up from a Microsoft Windows
  Server 2012 or Microsoft Windows Server 2012 R2 Hyper-V host.
  
  The crash stack trace will look like the following:
  ****************
  Stack Trace:
  ... dsmc.exe, std::_Hash<std::_Uset_traits...
  ... dsmc.exe, vmHyperVCreateNewVmMachine()+3550 bytes,
  ... dsmc.exe, vmHyperVRestoreConfigAndCreateVM()+313 bytes
  ... dsmc.exe, vmHyperVVddkOptRestoreVM()+2950 bytes
  ... dsmc.exe, vmHyperVVddkRestoreVM()+824 bytes
  ... dsmc.exe, vmHyperVRestoreVM()+442 bytes
  ... dsmc.exe, DoVMRestore()+165 bytes
  ... dsmc.exe, DccRestoreConsumer::ProcessRequest()+7746 bytes
  ... dsmc.exe, DccRestoreConsumer::HandleQueue()+3770 bytes
  ... dsmc.exe, DccRestoreConsumer::Run()+626 bytes
  ... dsmc.exe, DccRestoreConsumer::DoThread()+228 bytes
  ... dsmc.exe, callStartRestoreConsumer()+48 bytes
  ... dsmc.exe, startThread2()+210 bytes
  ... dsmc.exe, startThread()+40 bytes
  ... MSVCR110D.dll, beginthreadex()+517 bytes
  ... MSVCR110D.dll, endthreadex()+471 bytes
  ... KERNEL32.DLL, BaseThreadInitThunk()+20 bytes
  ... ntdll.dll, RtlUserThreadStart()+33 bytes
  
  ****************
  
  
  IBM Spectrum Protect versions affected:
  Client 8.1.x on supported platforms
  
  
  Initial Impact:
  High
  
  
  Additional Keywords:
  TSM "spectrum protect" MS Hyper-V restore windows 2012 2016
  virtual machine xml format configuration file changed
  "MSVCR110.dll, beginthreadex" dsmc.exe crash
  dsmagent.exe caused exception C0000005
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect for Virtual Environments Data           *
  * Protection for Hyper-V version 8.1 running on all            *
  * Microsoft Windows x64 platforms.                             *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is projected to be fixed in the Backup-Archive    *
  * Client version 7.1.8 and 8.1.2 on all Microsoft Windows x64  *
  * platforms                                                    *
  * Note 1: The Backup-Archive Client is a part of the Data      *
  * Protection for Microsoft Hyper-V. In Data Protection for     *
  * Microsoft Hyper-V environments, the Backup-Archive Client is *
  * also known as the data mover.                                *
  * Note 2: This is subject to change at the discretion of IBM.  *
  ****************************************************************
  

Problem conclusion

• Windows Server 2012 Hyper-V: VM configuration files has the xml
  file format. VM version is 5.0.
  Windows Server 2016 Hyper-V: format of VM configuration files
  has been changed from the xml file to a binary file format. VM
  version became 7.
  The problem was that in mixed-OS Failover Windows Cluster
  (Windows 2012 + Windows 2016) with Hyper-V role the VM version
  is 5 but data mover treated it as v7 and it leaded to the crash
  during restore vm on Windows Server 2016 node.
  The code has been modified to correctly restore virtual machine
  v5.0 in mixed-OS environment on Windows Server 2016 node.
  

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

• DSMC     DSM      DSMCSVC
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels

• R81W PSY

     UP