|
| 1 | +--- |
| 2 | +title: Can't Restore VM From Checkpoint in Hyper-V on Windows Server 2016 |
| 3 | +description: Resolves issues that occur during a planned cluster node drain operation if Cluster Shared Volumes stop responding. |
| 4 | +ms.date: 10/06/2025 |
| 5 | +author: kaushika-msft |
| 6 | +ms.author: kaushika |
| 7 | +manager: dcscontentpm |
| 8 | +audience: itpro |
| 9 | +ms.topic: troubleshooting |
| 10 | +ms.reviewer: kaushika |
| 11 | +ms.custom: |
| 12 | +- sap: virtualization and hyper-v\snapshots, checkpoints, and differencing disks |
| 13 | +- pcy: Virtualization\snapshots, checkpoints, and differencing disks |
| 14 | +appliesto: |
| 15 | + - <a href=https://learn.microsoft.com/windows/release-health/windows-server-release-info target=_blank>Supported versions of Windows Server</a> |
| 16 | +--- |
| 17 | + |
| 18 | +# Can't restore a VM from a checkpoint in Hyper-V on Windows Server 2016 |
| 19 | + |
| 20 | +## Summary |
| 21 | + |
| 22 | +This article discusses an issue in which you can't restore a virtual machine (VM) from a checkpoint in a Hyper-V environment that runs on Windows Server 2016. The issue typically occurs after an operating system (OS) upgrade, and it often involves checkpoint corruption or misalignment. |
| 23 | + |
| 24 | +## Symptoms |
| 25 | + |
| 26 | +- Error message: "An error occurred while attempting to export the data from checkpoint." |
| 27 | +- The VM can't be restored from the latest checkpoint. |
| 28 | +- Multiple checkpoints are present, but none can be used to successfully restore the VM. |
| 29 | +- Data loss is reported, requiring urgent recovery. |
| 30 | +- The issue begins immediately after an OS upgrade, such as from Windows 10 to Windows 11. |
| 31 | +- Hyper-V VM Management Service (VMMS) admin logs and checkpoint chain integrity are analyzed, revealing irregularities. |
| 32 | +- Attempts to merge checkpoints fail, causing concerns about possible data loss. |
| 33 | + |
| 34 | +## Cause |
| 35 | + |
| 36 | +The issue occurs because of one or more of the following reasons: |
| 37 | + |
| 38 | +- The checkpoint wasn't merged correctly before you ran the OS upgrade, or the upgrade was run without using the latest checkpoint in the VM. |
| 39 | +- Changes were made directly to the original virtual hard disk (VHDX) file after creating a checkpoint, causing a misalignment in the checkpoint chain. |
| 40 | +- The VM became inconsistent with the checkpoint structure and caused corruption or breakage in the chain. |
| 41 | +- A corrupted or missing VM configuration file further contributed to the inability to restore the VM from the checkpoint. |
| 42 | + |
| 43 | +## Resolution |
| 44 | + |
| 45 | +To resolve the issue, follow these steps: |
| 46 | + |
| 47 | +1. Back up VM files: |
| 48 | + |
| 49 | + - Before you try any recovery steps, back up all checkpoints and VHD files to a secure location. This step minimizes the risk of permanent data loss. |
| 50 | +1. Inspect the checkpoint chain: |
| 51 | + |
| 52 | + - Run the following PowerShell script to verify the chain of differencing disks: |
| 53 | + |
| 54 | + ```powershell |
| 55 | + Get-VHDChain -Path <path to vhd file></path> |
| 56 | + ``` |
| 57 | +
|
| 58 | + - Analyze the output to identify any inconsistencies or corruption in the chain. |
| 59 | +
|
| 60 | +1. Manually merge checkpoints: |
| 61 | +
|
| 62 | + - Try to manually merge the checkpoints by using PowerShell commands. For example: |
| 63 | +
|
| 64 | + ```powershell |
| 65 | + Merge-VHD -Path <Path to AVHDX file> -DestinationPath <Path to merged VHDX file> |
| 66 | + ``` |
| 67 | + - Notify the customer of potential risks, including data loss, before you proceed to merge. |
| 68 | +1. Re-create the VM: |
| 69 | +
|
| 70 | + - If merging checkpoints fails, re-create the VM by using the backed-up files. Make sure that you configure the new VM to point to the merged VHDX file. |
| 71 | +
|
| 72 | +1. Follow proper checkpoint management practices: |
| 73 | + - Always merge checkpoints before you perform OS upgrades. |
| 74 | + - Avoid direct changes to the original VHDX file if checkpoints exist. |
| 75 | + - Regularly maintain and verify checkpoints to make sure of integrity. |
| 76 | +1. Confirm resolution: |
| 77 | +
|
| 78 | + - After the recovery steps are completed, verify with the customer that the VM is operational and data was restored. |
| 79 | +
|
| 80 | +By following these steps and recommendations, you can resolve the checkpoint restoration issue and prevent similar problems in the future. |
| 81 | +
|
| 82 | +## Data collection |
| 83 | +
|
| 84 | +Before you contact Microsoft Support, you can gather the following information about your issue. |
| 85 | +
|
| 86 | +- Hyper-V VMMS admin logs. These logs can be collected from the Event Viewer under Applications and Services Logs > Microsoft > Windows > Hyper-V-VMMS. |
| 87 | +- Results from running the Get-VHDChain PowerShell command to inspect the integrity of the VHD chain. |
| 88 | +- Any additional error messages or logs that provide insight into the checkpoint issue. |
| 89 | +
|
| 90 | +## References |
| 91 | +
|
| 92 | +- [Using checkpoints to revert virtual machines to a previous state](/windows-server/virtualization/hyper-v/checkpoints?tabs=hyper-v-manager) |
| 93 | +- [Windows Server 2012 Hyper-V Best Practices](https://techcommunity.microsoft.com/blog/coreinfrastructureandsecurityblog/windows-server-2012-hyper-v-best-practices-in-easy-checklist-form/256060) |
0 commit comments