Skip to navigationSkip to content
libvirtd docs
Commands

Manual nav

Search `/` or jump with `g` / `G`.

Portal

  • Home manual
  • Command explorer
Foundations6 sections
  • Overview1
  • Installation2
  • Platform1
  • Concepts5
  • Domains2
  • Domain XML2
Subsystems9 sections
  • Identity1
  • Automation2
  • Daemons3
  • virsh3
  • Networking5
  • Storage4
  • Security3
  • Observability2
  • Remote Access1
Operations6 sections
  • Migration2
  • Backup2
  • Performance3
  • Recovery1
  • Troubleshooting2
  • References2

/ search · g top · G quickstart

guidemigrationReviewed July 15, 2026

Live migration operator runbook

Run live migration as a gated change. Keep source ownership until destination state and application health are proven. Start and watch In a second session: Choose flags based on the preflight. copy storage all changes ba

live-migrationvirsh-migraterollbackrunbook

Run live migration as a gated change. Keep source ownership until destination state and application health are proven.

Start and watch

BASH
virsh migrate --live --persistent --undefinesource \
  guest01 qemu+ssh://target.example/system

In a second session:

BASH
virsh domjobinfo guest01
virsh domjobabort guest01

Choose flags based on the preflight. --copy-storage-all changes bandwidth, duration, and recovery characteristics and must not be added casually.

Completion proof

BASH
virsh -c qemu+ssh://target.example/system domstate guest01 --reason
virsh -c qemu+ssh://target.example/system domiflist guest01
virsh list --all

Then validate application health, monitoring, backup ownership, and the absence of a running source copy.

Abort boundary

Abort while source remains authoritative if convergence stalls or destination prerequisites fail. Once switchover completes, recovery is a new incident state, not simply a command reversal.

Related

  • Logs, events, and long-running job state
  • Migration preflight and compatibility contract
  • SSH, IPMI, and ZFS Recovery Order

On this page

  • Start and watch
  • Completion proof
  • Abort boundary