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>