НАЗВА

virt-v2v-output-local - Using virt-v2v to convert guests to local files or libvirt

КОРОТКИЙ ОПИС

 virt-v2v [-i* options] [-o libvirt] -os POOL
 virt-v2v [-i* options] -o local -os DIRECTORY
 virt-v2v [-i* options] -o qemu -os DIRECTORY [--qemu-boot]
 virt-v2v [-i* options] -o null

ОПИС

This page documents how to use virt-v2v(1) to convert guests to local files or to a locally running libvirt instance. There are four output modes you can select on the virt-v2v command line:

-o libvirt -os "POOL"

-os "POOL"

This converts the guest to a libvirt directory pool call "POOL", and instantiates the guest in libvirt (but does not start it running). See "OUTPUT TO LIBVIRT" below.

-o libvirt is the default if no -o option is given, so you can omit it.

-o local -os "DIRECTORY"

This converts the guest to files in "DIRECTORY". A libvirt XML file is also created, but unlike -o libvirt the guest is not instantiated in libvirt, only files are created.

The files will be called:

 NAME-sda, NAME-sdb, etc.      Guest disk(s).
 NAME.xml                      Libvirt XML.

where "NAME" is the guest name.

-o qemu -os "DIRECTORY"

-o qemu -os "DIRECTORY" --qemu-boot

This converts the guest to files in "DIRECTORY". Unlike -o local above, a shell script is created which contains the raw qemu command you would need to boot the guest. However the shell script is not run, unless you also add the --qemu-boot option.

-o null

The guest is converted, but the final result is thrown away and no metadata is created. This is mainly useful for testing.

ВИВЕДЕННЯ ДО LIBVIRT

За допомогою параметра -o libvirt ви можете вивантажувати перетворені гостьові системи на основу систему під керуванням libvirt. Існує декілька обмежень:

Ви можете використовувати лише локальне з'єднання libvirt [див. нижче способи обійти це обмеження].
Параметр -os pool має вказувати на буфер-каталог, а не щось екзотичніше, наприклад iSCSI [втім, див. нижче].
Вивантаження можливе лише до гіпервізору KVM.

Workaround for output to a remote libvirt instance and/or a non-directory storage pool

1.

Скористайтеся virt-v2v у режимі -o local для перетворення дисків і метаданих гостьової системи до локального тимчасового каталогу:

 virt-v2v [...] -o local -os /var/tmp

Ця команда створює два (або більше) файли у /var/tmp із такими назвами:

 /var/tmp/НАЗВА.xml     # XML libvirt (метадані)
 /var/tmp/НАЗВА-sda     # перший диск гостьової системи

(замість слова "НАЗВА" має бути назва гостьової системи).

2.

Вивантаження перетворених дисків до буфера сховища із назвою "POOL":

 size=$(stat -c%s /var/tmp/НАЗВА-sda)
 virsh vol-create-as POOL НАЗВА-sda $size --format raw
 virsh vol-upload --pool POOL НАЗВА-sda /var/tmp/НАЗВА-sda

3.

Внесіть зміни до /var/tmp/НАЗВА.xml, щоб замінити /var/tmp/НАЗВА-sda на назву буфера. Іншими словами, знайдіть такий фрагмент у XML:

 <disk type='file' device='disk'>
   <driver name='qemu' type='raw' cache='none' />
   <source file='/var/tmp/NAME-sda' />
   <target dev='hda' bus='ide' />
 </disk>

і змініть дві речі: атрибут "type='file'" слід замінити на "type='volume'", а елемент "<source>" слід змінити так, щоб у ньому були атрибути "pool" і "volume":

 <disk type='volume' device='disk'>
   ...
   <source pool='POOL' volume='NAME-sda' />
   ...
 </disk>

4.

Визначте остаточну гостьову систему у libvirt:

 virsh define /var/tmp/NAME.xml

ТАКОЖ ПЕРЕГЛЯНЬТЕ

virt-v2v(1).

АВТОР

Richard W.M. Jones

АВТОРСЬКІ ПРАВА

LICENSE

BUGS

To get a list of bugs against libguestfs, use this link: https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools

To report a new bug against libguestfs, use this link: https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

When reporting a bug, please supply:

The version of libguestfs.
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
Describe the bug accurately and give a way to reproduce it.
Run libguestfs-test-tool(1) and paste the complete, unedited output into the bug report.