You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: support/windows-server/virtualization/hyper-v-virtual-machine-live-migration.md
+8-33Lines changed: 8 additions & 33 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,7 +12,7 @@ ms.custom:
12
12
---
13
13
# Troubleshooting guide: Hyper-V virtual machine live migration
14
14
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.
16
16
17
17
## Troubleshooting checklist
18
18
@@ -56,8 +56,6 @@ Here are common issues and their respective resolutions:
56
56
57
57
## Hardware or CPU incompatibility
58
58
59
-
Symptoms:
60
-
61
59
- Error message:
62
60
63
61
> The virtual machine uses processor-specific features not supported on the physical computer
@@ -73,8 +71,6 @@ Symptoms:
73
71
74
72
## VM configuration version mismatch
75
73
76
-
Symptoms:
77
-
78
74
- Migration works one way but not in reverse (especially after moving to a newer OS).
79
75
- Error message:
80
76
@@ -92,8 +88,6 @@ Symptoms:
92
88
93
89
## Network connectivity or configuration issues
94
90
95
-
Symptoms:
96
-
97
91
- Live migration fails before/during transfer.
98
92
- Migration fails with: "The client cannot connect to the destination specified in the request" or "WinRM protocol errors."
- Migration fails for VMs with shared VHDX/shared disks
128
118
- Error: Shared disk missing in migration options.
129
119
@@ -134,24 +124,16 @@ Symptoms:
134
124
135
125
## VTPM or shielded VM certificate issues
136
126
137
-
Symptoms:
138
-
139
127
- Error: "The key protector for the virtual machine could not be unwrapped."
140
128
- Migration only fails for vTPM-protected VMs.
141
129
142
130
### Resolution
143
131
144
132
- Export shielding or key protector certificates from source host and import on destination.
145
133
- 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`.
153
135
154
-
Symptoms:
136
+
## State file or checkpoint issues
155
137
156
138
- Error message:
157
139
@@ -166,8 +148,6 @@ Symptoms:
166
148
167
149
## Cluster or migration limit issues
168
150
169
-
Symptoms:
170
-
171
151
- Error message:
172
152
173
153
> Virtual machine migration limit 1 was reached, please wait for completion of an ongoing migration operation.
@@ -186,10 +166,7 @@ Symptoms:
186
166
187
167
## Code defects or bugs
188
168
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.
193
170
194
171
### Resolution
195
172
@@ -226,12 +203,10 @@ Standard data collection checklist:
226
203
| Live migration events show failures post-update | Patch/Firmware/Speculation setting | Ensure all nodes are updated/patched; check speculation control settings |
227
204
| 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 |
228
205
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
+
229
208
## References
230
209
231
210
- WinRM and `TrustedHosts` configuration: [Installation and configuration for Windows Remote Management](/windows/win32/winrm/installation-and-configuration-for-windows-remote-management)
- 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