Skip to content

Commit 13f1fac

Browse files
AB#7251: Create cannot-restore-vm-from-checkpoint-in-hyper-v.md (#10071)
* Create cannot-restore-vm-from-checkpoint-in-hyper-v.md * Update cannot-restore-vm-from-checkpoint-in-hyper-v.md * Fix broken links in Hyper-V checkpoint article Updated hyperlinks in the Hyper-V checkpoint documentation. * Removed dead link * Revert "Removed dead link" This reverts commit 96ff02161fd372227c19e2476f9026511559f74a. * Update cannot-restore-vm-from-checkpoint-in-hyper-v.md --------- Co-authored-by: Teresa Appelgate <[email protected]>
1 parent 5ac87f1 commit 13f1fac

1 file changed

Lines changed: 93 additions & 0 deletions

File tree

Lines changed: 93 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,93 @@
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

Comments
 (0)