IBM Support

Unrecoverable TSM for VE Hyper-V data mover backups

Flashes (Alerts)


TSM for VE: DP for Hyper-V 7.1.1 data mover backups of Hyper-V guests can be incomplete and unrecoverable, even though the backup operations show no errors. Fix is available.


Incremental forever backup for Microsoft Hyper-V virtual machines was introduced with IBM Tivoli Storage Manager (TSM) for Virtual Environments (VE): Data Protection for Microsoft Hyper-V (DP for Hyper-V) Version The TSM version backup-archive client is used as the data mover to perform these incremental forever backups. Due to logic errors in TSM versions and, those backups can be incomplete and unrecoverable, even though no error messages are logged during the affected backup operations.

In addition, if you restore the potentially corrupted backup data, the restored data also may be incomplete and unrecoverable, even though the restore operations are reported as successful without any error messages. Note that portions of corrupted Hyper-V backups might be recoverable.

These problems are documented in APARs IT04831 and IT05734.

IBM instructs customers not to run incremental forever backups of Microsoft Hyper-V virtual machines with the TSM or data movers. Instead, use or higher.

Releases affected
Tivoli Storage Manager for Virtual Environments: Data Protection for Microsoft Hyper-V version 7.1.1 when used with Tivoli Storage Manager Backup-Archive Client (data mover) version or

How to determine if your backups are affected
It is not possible to determine if all or part of a specific backup is affected. If you used the affected data mover to perform any incremental forever backup of Hyper-V virtual machines (either -mode=iffull or -mode=ifincr), then those backups should be considered affected.

Revert to the full backup method used before the incremental forever functionality was available, using the Backup-Archive client.

1. Rename the Hyper-V license file to another name (if installed)
Default location is C:\Program Files\Tivoli\TSM\TDPHyperV, file name is tdp4hyperv.lic

2. Run a full VM backup with the Backup-Archive client
For example, on the command line, issue "dsmc backup vm <myvm> -mode=full"
where <myvm> is the name of the Hyper-V virtual machine

Fix and Instructions
The fixes for IT04831 and IT05780 are available in data mover (TSM Backup-Archive Client) version or higher. The version of the data mover is available as part of DP for Hyper-V version, which can be obtained from IBM Passport Advantage. If you have already installed DP for Hyper-V version, you can obtain version from Passport Advantage or the FTP site. If you are installing DP for Hyper-V for the first time, you must obtain version from Passport Advantage.

The version of the data mover is not available as a stand-alone TSM Backup-Archive client download. However, because maintenance is cumulative, new versions (higher than of the data mover that are made available for stand-alone download will also include the fixes for the problems described in this flash.

DP for Hyper-V media with the fixes will be available starting 12 December 2014, subject to change at the discretion of IBM.

Flash update history:
24 October 2014 - Original version published

31 October 2014 - Updated to indicate that customers are instructed to not use incremental forever backups for Microsoft Hyper-V virtual machines until a newly discovered issue is addressed.

12 November 2014 - Clarified that workaround uses the Backup-Archive client.

10 December 2014 - Updated the flash to indicate that a solution is available with DP for Hyper-V and higher.

[{"Product":{"code":"SSGSG7","label":"Tivoli Storage Manager"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"Client","Platform":[{"code":"PF033","label":"Windows"}],"Version":"7.1.1","Edition":"","Line of Business":{"code":"LOB26","label":"Storage"}},{"Product":{"code":"SSSQWC","label":"Tivoli Storage Manager Extended Edition"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"Client","Platform":[{"code":"PF033","label":"Windows"}],"Version":"7.1.1","Edition":"","Line of Business":{"code":"LOB26","label":"Storage"}},{"Product":{"code":"SS8TDQ","label":"Tivoli Storage Manager for Virtual Environments"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"Data Protection for Microsoft Hyper-V","Platform":[{"code":"PF033","label":"Windows"}],"Version":"7.1.1","Edition":"","Line of Business":{"code":"LOB26","label":"Storage"}}]

Document Information

Modified date:
25 September 2022