libvirt-migrate-qemu-disks Man page

LIBVIRT-MIGRATE-QEMU-DISKS:(1) August 2010 LIBVIRT-MIGRATE-QEMU-DISKS:(1)

NAME

libvirt-migrate-qemu-disks – program for migrating pre-0.8.3 domain
definitions

DESCRIPTION

Libvirt versions earlier that 0.8.3 would probe a qemu disk to deter‐
mine its format and did not require that the format be declared in the
XML. Newer versions of libvirt will default to the ‘raw’ format when
the format is not specified in the XML. As a result, non-raw disks
without unspecified disk format will no longer be available in virtual
machines.

libvirt-migrate-qemu-disks aids in transitioning virtual machine defi‐
nitions to the new required format. In essence, it will check all
domains for affected virtual machines, probe the affected disks and
update the domain definition accordingly. For example, a domain with:

will be updated to have:


USAGE
libvirt-migrate-qemu-disks [-c URI] [-d] -a

libvirt-migrate-qemu-disks [-c URI] [-d] -t TYPE

OPTIONS

-h, –help
show help message and exit

-a probe all domains and migrate if necessary

-c URI connection URI to use. If one is not specified, will use
qemu:///system. Only qemu:///system and qemu:///session is sup‐
ported.

-t TYPE
migrate specified domains from raw to disk format TYPE

-d debug output

EXAMPLES
To probe and migrate all exisiting domains (root may be needed to probe
the disk):

# libvirt-migrate-qemu-disks -a

To migrate the ‘vm1’ and ‘vm2’ domains:

# libvirt-migrate-qemu-disks -t qcow2 vm1 vm2

BUGS

In the event that libvirt-migrate-qemu-disks is unable to migrate your
disks, virsh can be used directly. For example:

$ qemu-img info $ virsh dumpxml > domain.xml
… edit domain.xml to use the file format seen with qemu-img …
$ virsh define domain.xml

See http://libvirt.org/formatdomain.html#elementsDisks for more infor‐
mation.

SEE ALSO

virsh

AUTHOR

libvirt-migrate-qemu-disks is Copyright 2010, Canonical Ltd.

libvirt-migrate-qemu-disks and this manual page was originally written
by Jamie Strandboge

August 2010 LIBVIRT-MIGRATE-QEMU-DISKS:(1)