Provided by: libvirt-bin_1.2.2-0ubuntu13_amd64 bug

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 determine 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 definitions  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:

           <disk type='file' device='disk'>
             <source file='/var/lib/libvirt/images/vm1.qcow2'/>
             <target dev='hda' bus='ide'/>
             <address type='drive' controller='0' bus='0' unit='0'/>
           </disk>

       will be updated to have:

           <disk type='file' device='disk'>
             <driver name='qemu' type='qcow2'/>
             <source file='/var/lib/libvirt/images/vm1.qcow2'/>
             <target dev='hda' bus='ide'/>
             <address type='drive' controller='0' bus='0' unit='0'/>
           </disk>

USAGE

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

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

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 supported.

       -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 <path to your disk>
         $ virsh dumpxml <domain-id> > 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 information.

SEE ALSO

       virsh(1)

AUTHOR

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

       libvirt-migrate-qemu-disks and this manual page was originally written by Jamie Strandboge
       <jamie@canonical.com>