Skip to navigationSkip to content
libvirtd docs
InteractiveCommands

Manual nav

Search `/` · tty `~` · g top · G bottom

Portal

  • Manual index
  • Interactive lab
  • Command explorer
Foundations5 sections
  • libvirtd Overview1
  • Host & Installation2
  • Architecture & Concepts6
  • Domains2
  • Domain XML2
Subsystems6 sections
  • Daemons3
  • virsh3
  • Virtual Networking5
  • Virtual Storage4
  • Virtualization Security3
  • Remote libvirt1
Operations5 sections
  • Migration2
  • Snapshots & Backup2
  • Performance3
  • Troubleshooting2
  • Reference2
manmigrationReviewed July 15, 2026

Migration preflight and compatibility contract

Migration is a compatibility contract between source, destination, storage, network, firmware, CPU model, and libvirt/QEMU versions. Prove each boundary before moving memory. Host checks Required decisions Is storage sha

migrationpreflightcpustorage

Migration is a compatibility contract between source, destination, storage, network, firmware, CPU model, and libvirt/QEMU versions. Prove each boundary before moving memory.

Host checks

BASH
virsh -c qemu+ssh://target/system version
virsh -c qemu+ssh://target/system domcapabilities
virsh dumpxml guest01 --migratable > /root/guest01.migratable.xml
virsh domblklist guest01 --details
virsh domiflist guest01

Required decisions

  • Is storage shared, copied, or replicated separately?
  • Does the destination expose compatible CPU features and machine types?
  • Are every network, secret, firmware, TPM, and host device dependency available?
  • What is the abort threshold for downtime, dirty rate, and remaining data?
  • Which host owns the guest if the management session fails?

Dry-run mindset

There is no substitute for testing the exact path with a representative workload. A successful empty-guest migration does not prove a write-heavy production guest will converge.

Related

  • CPU, memory, and device model
  • qcow2, raw, and allocation behavior
  • Live migration operator runbook

On this page

  • Host checks
  • Required decisions
  • Dry-run mindset