Skip to content

Commit f9e2617

Browse files
committed
Update hyper-v-virtual-machine-live-migration.md
1 parent 30cd9b2 commit f9e2617

1 file changed

Lines changed: 8 additions & 33 deletions

File tree

support/windows-server/virtualization/hyper-v-virtual-machine-live-migration.md

Lines changed: 8 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ ms.custom:
1212
---
1313
# Troubleshooting guide: Hyper-V virtual machine live migration
1414

15-
Live migration in Hyper-V allows virtual machines (VMs) to be moved between hosts with minimal downtime—a critical feature for high availability and maintenance in Windows Server environments. Despite its capabilities, live migration can fail due to a wide array of factors—hardware incompatibility, authentication, network configuration, VM settings, and storage problems. Properly diagnosing and resolving live migration failures is vital for business continuity, especially in clustered and production settings. This guide provides a comprehensive troubleshooting process, detailed solutions for common migration issues, structured data collection procedures, and quick reference resources.
15+
Live migration in Hyper-V allows virtual machines (VMs) to be moved between hosts with minimal downtime—a critical feature for high availability and maintenance in Windows Server environments. Despite its capabilities, live migration can fail due to a wide array of factors—hardware incompatibility, authentication, network configuration, VM settings, and storage issues. Properly diagnosing and resolving live migration failures is vital for business continuity, especially in clustered and production settings. This guide provides a comprehensive troubleshooting process, detailed solutions for common migration issues, structured data collection procedures, and quick reference resources.
1616

1717
## Troubleshooting checklist
1818

@@ -56,8 +56,6 @@ Here are common issues and their respective resolutions:
5656

5757
## Hardware or CPU incompatibility
5858

59-
Symptoms:
60-
6159
- Error message:
6260

6361
> The virtual machine uses processor-specific features not supported on the physical computer
@@ -73,8 +71,6 @@ Symptoms:
7371
7472
## VM configuration version mismatch
7573

76-
Symptoms:
77-
7874
- Migration works one way but not in reverse (especially after moving to a newer OS).
7975
- Error message:
8076

@@ -92,8 +88,6 @@ Symptoms:
9288

9389
## Network connectivity or configuration issues
9490

95-
Symptoms:
96-
9791
- Live migration fails before/during transfer.
9892
- Migration fails with: "The client cannot connect to the destination specified in the request" or "WinRM protocol errors."
9993
- Event IDs: 20406, 280
@@ -106,12 +100,10 @@ Symptoms:
106100
- Verify firewall allows necessary ports (default SMB, WinRM, and clustering ports).
107101
- Match network configurations (switch names/types, teaming) across hosts.
108102

109-
## Authentication or delegation problems
110-
111-
Symptoms:
103+
## Authentication or delegation issues
112104

113105
- Error code: "General access denied error (0x80070005)"
114-
- Errors 0x8009030E, 0x8009030D (delegation/Kerberos/SPN problems)
106+
- Errors 0x8009030E, 0x8009030D (delegation/Kerberos/SPN issues)
115107

116108
### Resolution
117109

@@ -122,8 +114,6 @@ Symptoms:
122114

123115
## Storage or shared disk issues
124116

125-
Symptoms:
126-
127117
- Migration fails for VMs with shared VHDX/shared disks
128118
- Error: Shared disk missing in migration options.
129119

@@ -134,24 +124,16 @@ Symptoms:
134124

135125
## VTPM or shielded VM certificate issues
136126

137-
Symptoms:
138-
139127
- Error: "The key protector for the virtual machine could not be unwrapped."
140128
- Migration only fails for vTPM-protected VMs.
141129

142130
### Resolution
143131

144132
- Export shielding or key protector certificates from source host and import on destination.
145133
- Windows certificates snap-in (**certmgr.msc**) can be used.
146-
- PowerShell cmdlet:
147-
148-
```powershell
149-
Export-PfxCertificate and Import-PfxCertificate
150-
```
151-
152-
## State file or checkpoint problems
134+
- PowerShell cmdlets: `Export-PfxCertificate` and `Import-PfxCertificate`.
153135

154-
Symptoms:
136+
## State file or checkpoint issues
155137

156138
- Error message:
157139

@@ -166,8 +148,6 @@ Symptoms:
166148

167149
## Cluster or migration limit issues
168150

169-
Symptoms:
170-
171151
- Error message:
172152

173153
> Virtual machine migration limit 1 was reached, please wait for completion of an ongoing migration operation.
@@ -186,10 +166,7 @@ Symptoms:
186166

187167
## Code defects or bugs
188168

189-
Symptoms:
190-
191-
- VMs stuck in "Stopping" state after migration; orphaned vport reported in live dump analysis.
192-
- Case number: 2502260050001354003
169+
VMs stuck in "Stopping" state after migration; orphaned vport reported in live dump analysis.
193170

194171
### Resolution
195172

@@ -226,12 +203,10 @@ Standard data collection checklist:
226203
| Live migration events show failures post-update | Patch/Firmware/Speculation setting | Ensure all nodes are updated/patched; check speculation control settings |
227204
| VM backs up forever, can't move/out/in "Backing up" state | Backup software lock | Restart backup service, VMMS service, or power on VM to merge checkpoints |
228205

206+
Ensuring successful Hyper-V live migration requires diligent configuration management—including CPU, firmware, network, authentication, storage, and permissions—across all participating hosts. By following the troubleshooting checklist, addressing known root causes as outlined in the solutions section, and using targeted data collection, most migration failures can be swiftly resolved or appropriately escalated. Staying current with patches, standardizing cluster configurations, and understanding log outputs minimize downtime and operational risk for mission-critical virtual machine workloads.
207+
229208
## References
230209

231210
- WinRM and `TrustedHosts` configuration: [Installation and configuration for Windows Remote Management](/windows/win32/winrm/installation-and-configuration-for-windows-remote-management)
232211
- Cluster Shared Volumes and migration limits: [Cluster Shared Volumes overview](/windows-server/failover-clustering/failover-cluster-csvs)
233212
- SCVMM VMware-to-Hyper-V conversion: [Convert a VMware VM to Hyper-V in the VMM fabric](/system-center/vmm/vm-convert-vmware)
234-
235-
## Summary
236-
237-
Ensuring successful Hyper-V live migration requires diligent configuration management—including CPU, firmware, network, authentication, storage, and permissions—across all participating hosts. By following the troubleshooting checklist, addressing known root causes as outlined in the solutions section, and using targeted data collection, most migration failures can be swiftly resolved or appropriately escalated. Staying current with patches, standardizing cluster configurations, and understanding log outputs minimize downtime and operational risk for mission-critical virtual machine workloads.

0 commit comments

Comments
 (0)