Red Hat Training

A Red Hat training course is available for Red Hat Enterprise Linux

4.4.2. Additional Options for the virsh migrate Command

In addition to --live, virsh migrate accepts the following options:
  • --direct - used for direct migration
  • --p2p - used for peer-to-peer migration
  • --tunnelled - used for tunneled migration
  • --persistent - leaves the domain in a persistent state on the destination host physical machine
  • --undefinesource - removes the guest virtual machine on the source host physical machine
  • --suspend - leaves the domain in a paused state on the destination host physical machine
  • --change-protection - enforces that no incompatible configuration changes will be made to the domain while the migration is underway; this option is implicitly enabled when supported by the hypervisor, but can be explicitly used to reject the migration if the hypervisor lacks change protection support.
  • --unsafe - forces the migration to occur, ignoring all safety procedures.
  • --verbose - displays the progress of migration as it is occurring
  • --abort-on-error - cancels the migration if a soft error (such as an I/O error) happens during the migration process.
  • --migrateuri - the migration URI which is usually omitted.
  • --domain [string]- domain name, id or uuid
  • --desturi [string]- connection URI of the destination host physical machine as seen from the client(normal migration) or source(p2p migration)
  • --migrateuri - migration URI, usually can be omitted
  • --timeout [seconds]- forces a guest virtual machine to suspend when the live migration counter exceeds N seconds. It can only be used with a live migration. Once the timeout is initiated, the migration continues on the suspended guest virtual machine.
  • --dname [string] - changes the name of the guest virtual machine to a new name during migration (if supported)
  • --xml - the filename indicated can be used to supply an alternative XML file for use on the destination to supply a larger set of changes to any host-specific portions of the domain XML, such as accounting for naming differences between source and destination in accessing underlying storage. This option is usually omitted.
Refer to the virsh man page for more information.