For the complete documentation index, see llms.txt. This page is also available as Markdown.

Resolve Live Migration Failures for Legacy Boot-from-Volume Hotplug VMs

Overview

Live migration can fail for virtual machines that combine two specific characteristics:

This is a pre-existing issue and is not caused by upgrading. The PCD 2025.10 (October 2025) release corrected how the Compute Service generates the resource-request record for VMs of this type, but that correction only applies going forward — it is applied when the VM is created or when a hotplug operation is performed on it. VMs that were created with this combination of flavor and boot configuration before the 2025.10 release still hold the older, incorrect resource-request record, and live migration continues to fail for them until that record is corrected.

In this guide, you will identify whether a VM is affected and apply a one-time corrective step to unblock live migration for it.

Symptoms

  • A VM that uses a hot-add-capable flavor and boots from a persistent volume fails to live migrate, even though other VMs in the same virtualized cluster migrate successfully.

  • The VM was created before the cluster was upgraded to the PCD 2025.10 release or later.

  • The VM has not had a hotplug (hot-add CPU or memory) operation performed on it since being created.

Identify Affected VMs

Check whether the VM uses a hot-add-capable flavor and a persistent-volume root disk:

pcdctl server show <VM_UUID>
  • Confirm the VM's flavor has zero vCPU and zero RAM configured at the flavor level (hot-add-capable), and that the VM currently reports non-zero vCPU/RAM values.

  • Confirm the VM's root disk is a persistent volume rather than an ephemeral disk. See Boot VM from New Volume / Boot VM from Existing Volume for the boot configurations that use a volume-backed root disk.

If the VM meets both criteria and was created before the cluster's upgrade to PCD 2025.10 or later, it is a candidate for the workaround below.

Workaround: Trigger a No-Op Hotplug

Triggering a hotplug operation on the affected VM — without changing its current CPU or memory values — regenerates the VM's resource-request record using the corrected logic. This is a one-time step per affected VM; once applied, live migration works normally for that VM going forward.

NOTE

Re-submitting the VM's current CPU and memory values causes no actual change to the VM's resources. The VM does not need to be power-cycled for this step.

  1. Select the affected VM in the VM grid view.

  2. Navigate to ▷ Other Actions ▷ Hotplug.

  3. Leave the vCPU and memory fields set to the VM's current values — do not change them.

  4. Click Hotplug VM.

After this step completes, retry the live migration.

Next Steps

Repeat this workaround for each affected VM in your virtualized cluster. VMs created after the cluster's upgrade to PCD 2025.10 or later, and any VM that already had a hotplug operation performed on it, are not affected and do not require this step. For general live migration behavior and prerequisites, see Virtual Machine Migration.

Last updated

Was this helpful?