Troubleshooting

Solutions to Data Protection for Microsoft Hyper-V issues are provided.

The following topics are available:

Locating log files

For information about Data Protection for Microsoft Hyper-V log files, see the following topics:

Troubleshooting with PowerShell cmdlets

You can troubleshoot Data Protection for Microsoft Hyper-V operations with PowerShell cmdlets. For more information, see Troubleshooting Data Protection for Microsoft Hyper-V operations.

Virtual machine backup fails with the 0x800705B4 error in the Hyper-V event log

During VM backup operations on Windows Server 2016, this error can occur if you run a resilient change tracking (RCT) full backup of a virtual machine (VM) with many VM disks. The snapshot operation either times out or runs out of space on the file space on the server.

If the VM backup operation fails, search the Hyper-V event log for the 0x800705B4 error. If this error is present, complete the following steps to help improve the performance of the snapshot operation:
  1. Ensure that the Hyper-V VM is a generation 2 VM.
  2. Ensure that only SCSI disks are attached to the generation 2 VM (instead of a mix of SCSI and IDE disks).
  3. Move the Hyper-V snapshot folder from the default location (C:\ProgramData\Microsoft\Windows\Hyper-V\Snapshots) to a faster drive that is not the Windows system drive (for example, the D: drive).

Unsupported characters in virtual machine and Hyper-V host or cluster names

Data Protection for Microsoft Hyper-V does not support backing up virtual machines and Hyper-V hosts or clusters that contain any of the following characters in their name:

"
Double quotation mark
'
Single quotation mark
:
Colon
;
Semicolon
*
Asterisk
?
Question mark
,
Comma
<
Less than sign
>
Greater than sign
/
Forward slash
\
Backward slash
|
Vertical bar

The file restore interface shows the wrong drive letter assignments and the system reserved disk

Ensure that the automount feature on Windows is not enabled.

By default, the Data Protection for Microsoft Hyper-V installer automatically disables the automount feature with the diskpart command. This action is required to show correct drive letter assignments and to hide the system reserved disk in the IBM Spectrum Protect file restore interface.

The automount feature was most likely enabled after the installation of Data Protection for Microsoft Hyper-V. Use the diskpart command to disable the automount feature.

An SSL connection cannot be made

The following message might appear in the Data Protection for Microsoft Hyper-V Management Console if the SSL certificate is invalid in any way, such as if you reinstalled Data Protection for Microsoft Hyper-V and the old SSL certificate was not deleted.

GVM6065E The SSL Connection could not be made. The IBM Spectrum Protect SSL certificate is missing. Check for valid IBM Spectrum Protect certficate in the TSM-ve-trustore.jks RC=215

Delete all the files in the C:\IBM\SpectrumProtect\webserver\usr\servers\veProfile\tsmVmGUI\truststores folder. Then, and restart the Data Protection for Microsoft Hyper-V Management Console and run the configuration wizard. Accept the security certificate when prompted.

The SSL certificate for the agent is not valid

You might receive an SSL connection error if the security certificate for the remote client agent is not valid or not up-to-date.

For example, if the certificate files (dsmcert.sth, dsmcert.idx, and dsmcert.kdb) in the C:\Program Files\Tivoli\TSM\baclient directory were deleted or are corrupted, the following message appears in the data mover error log (dsmerror.hostname_HV_DM.log):
ANS1592E Failed to initialize SSL protocol.
The method that you use to resolve this problem depends on the level of the IBM Spectrum Protect server that you are connecting to:
  • If you are connecting to an IBM Spectrum Protect Version 8.1.2 or later server, or a V7.1.8 or later V7 server, complete one of the following steps:
    • Stop the client acceptor service on the data mover node and mount proxy node (if file restore is enabled) and re-run the Data Protection for Microsoft Hyper-V configuration wizard on the stand-alone host or on any host in a cluster.

      For more information, see Configuring Data Protection for Microsoft Hyper-V with the wizard.

    • Update the node definition on the IBM Spectrum Protect server by specifying the SESSIONSECURITY=TRANSITIONAL parameter. The security certificate is re-created when you sign on to the IBM Spectrum Protect server from the Data Protection for Microsoft Hyper-V Management Console.

      For more information, see UPDATE NODE.

  • If you are connecting to an IBM Spectrum Protect V8.1.1 or earlier V8 server, or a V7.1.7 or earlier server, see Dsmcutil commands: Required options and examples.

A VM backup or restore operation cannot start when another VM operation is in progress

The following message is displayed if a backup or restore operation is started while another VM operation is in progress:

ANS5176W The requested virtual machine operation cannot be performed because a virtual machine backup or restore operation is already in progress. Please retry the operation after the first operation completes.

This message appears in the following situations:
  • You started a backup or restore operation of a VM and another backup or restore operation is already in progress on the same host.
  • You started a backup or restore operation of a VM and another scheduled backup of any VM on the same host is running, or if someone else interactively started the operation from another location.

If you encounter this message, wait for the running operation to finish, then restart your backup or restore operation.