НАЗВА¶

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 json -os DIRECTORY
                        [-oo json-disks-pattern=PATTERN]
 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 json -os "DIRECTORY"

This converts the guest to files in "DIRECTORY". The metadata produced is a JSON file containing the majority of the data virt-v2v gathers during the conversion. See "OUTPUT TO JSON" below.

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

OUTPUT TO JSON¶

The -o json option produces the following files by default:

 NAME.json                     JSON metadata.
 NAME-sda, NAME-sdb, etc.      Guest disk(s).

where "NAME" is the guest name.

It is possible to change the pattern of the disks using the -oo json-disks-pattern=... option: it allows parameters in form of "%{...}" variables, for example:

 -oo json-disks-pattern=disk%{DiskNo}.img

Recognized variables are:

"%{DiskNo}"

The index of the disk, starting from 1.

"%{DiskDeviceName}"

The destination device of the disk, e.g. "sda", "sdb", etc.

"%{GuestName}"

The name of the guest.

Using a pattern it is possible use subdirectories for the disks, even with names depending on variables; for example:

 -oo json-disks-pattern=%{GuestName}-%{DiskNo}/disk.img

The default pattern is "%{GuestName}-%{DiskDeviceName}".

If the literal "%{...}" text is needed, it is possible to avoid the escape it with a leading "%"; for example, "%%{GuestName}-%{DiskNo}.img" will create file names for the disks like "%%{GuestName}-1.img", "%%{GuestName}-2.img", etc.

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

virt-v2v(1).

АВТОР¶

Richard W.M. Jones

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

Copyright (C) 2009-2020 Red Hat Inc.

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.