virt-v2v-output-ovirt(1)

НАЗВА
virt-v2v-output-ovirt - Using virt-v2v to convert guests to oVirt

КОРОТКИЙ ОПИС
 virt-v2v [-i* options] -o ovirt-upload [-oc ENGINE_URL] -os STORAGE
                        [-op PASSWORD] [-of raw]
                        [-oo ovirt-cafile=FILE]
                        [-oo ovirt-cluster=CLUSTER]
                        [-oo ovirt-proxy]
                        [-oo ovirt-disk-uuid=UUID ...]
                        [-oo ovirt-verifypeer]

 virt-v2v [-i* options] -o ovirt -os [esd:/path|/path]

 virt-v2v [параметри -i*] -o vdsm
                        [-oo vdsm-image-uuid=UUID]
                        [-oo vdsm-vol-uuid=UUID]
                        [-oo vdsm-vm-uuid=UUID]
                        [-oo vdsm-ovf-output=КАТАЛОГ]

ОПИС
This page documents how to use virt-v2v(1) to convert guests to an oVirt management instance. There are three output modes that you can select, but only -o ovirt-upload should be used normally, the other two are deprecated:

-o ovirt-upload -os STORAGE
    Full description: "OUTPUT TO OVIRT"

    This is the modern method for uploading to oVirt via the REST API. It requires oVirt ≥ 4.2.

-o ovirt -os esd:/path
-o ovirt -os /path
    Повний опис: "ВИВЕДЕННЯ ДО ДОМЕНУ СХОВИЩА ЕКСПОРТУВАННЯ"

    This is the old method for uploading to oVirt via the Export Storage Domain (ESD). The ESD can either be accessed over NFS (using the -os esd:/path form) or if you have already NFS-mounted it somewhere specify the path to the mountpoint as -os /path.

    Домен сховища експортування вважається застарілим з часу oVirt 4, тому у певний момент у майбутньому цей спосіб вже не працюватиме.

-o vdsm
    This is the old method used internally by the oVirt user interface. It is never intended to be used directly by end users.

OUTPUT TO OVIRT
This new method to upload guests to oVirt directly via the REST API requires oVirt ≥ 4.2.

You need to specify -o ovirt-upload as well as the following extra parameters:

-oc "https://ovirt-engine.example.com/ovirt-engine/api"
    Адреса програмного інтерфейсу REST, яка, зазвичай, складається із назви сервера із дописуванням рядка "/ovirt-engine/api", але може бути іншою, якщо ви вибрали інший каталог для встановлення рушія oVirt.

    Крім того, ви можете додати до адреси ім'я користувача і порт. Якщо ім'я користувача не вказано, virt-v2v типово використовуватиме комбінацію "admin@internal", яка задає типові параметри облікового запису суперкористувача для екземплярів систем oVirt.

-of raw
    У поточній версії, вам слід використовувати -of raw, і ви не можете використовувати -oa preallocated.

    Ці обмеження буде знято у майбутніх версіях.

-op файл-пароля
    Файл, який містить пароль, яким слід скористатися для з'єднання із рушієм oVirt. Зауважте, що файл має містити увесь пароль, без завершального символу нового рядка, і, з міркувань безпеки, для файла має бути встановлено режим доступу 0600, щоб інші користувачі не змогли його читати.

-os "дані-ovirt"
    Домен сховища.

-oo ovirt-cafile=ca.pem
    Файл ca.pem (служби сертифікації), скопійований з /etc/pki/ovirt-engine/ca.pem у рушії oVirt.

    If -oo ovirt-verifypeer is enabled then this option can be used to control which CA is used to verify the client’s identity. If this option is not used then the system’s global trust store is used.

-oo ovirt-cluster="CLUSTERNAME"
    Set the oVirt Cluster Name. If not given it uses "Default".

-oo ovirt-disk-uuid="UUID"
    Цим параметром можна скористатися для визначення UUID вручну для дисків при створенні віртуальної машини. Якщо не вказано, рушій oVirt створить випадкові UUID для дисків. Будь ласка, зауважте, що:

    •   you must pass as many -oo ovirt-disk-uuid=UUID options as the amount of disks in the guest

    •   вказані UUID не повинні суперечити UUID наявних дисків

-oo ovirt-proxy
    Пропустити вивантажені дані крізь рушій oVirt. Процес буде повільнішим за вивантаження безпосередньо на вузол oVirt, але може бути потрібним, якщо у вас немає безпосереднього доступу з мережі до вузлів.

-oo ovirt-verifypeer
    Verify the oVirt server’s identity by checking the server‘s certificate against the Certificate Authority.

ВИВЕДЕННЯ ДО ДОМЕНУ СХОВИЩА ЕКСПОРТУВАННЯ
This section only applies to the -o ovirt output mode. If you use virt-v2v from the oVirt user interface, then behind the scenes the import is managed by VDSM using the -o vdsm output mode (which end users should not try to use directly).

You have to specify -o ovirt and an -os option that points to the oVirt Export Storage Domain. You can either specify the NFS server and mountpoint, eg. "-os ovirt-storage:/ovirt/export", or you can mount that first and point to the directory where it is mounted, eg. "-os /tmp/mnt". Be careful not to point to the Data Storage Domain by accident as that will not work.

On successful completion virt-v2v will have written the new guest to the Export Storage Domain, but it will not yet be ready to run. It must be imported into oVirt using the UI before it can be used.

In oVirt ≥ 2.2 this is done from the Storage tab. Select the export domain the guest was written to. A pane will appear underneath the storage domain list displaying several tabs, one of which is "VM Import". The converted guest will be listed here. Select the appropriate guest an click "Import". See the oVirt documentation for additional details.

Якщо ви експортуєте декілька гостьових систем, потім ви зможете усі їх імпортувати одночасно за допомогою інтерфейсу користувача.

  Testing oVirt conversions
If you do not have an oVirt instance to test against, then you can test conversions by creating a directory structure which looks enough like a oVirt Export Storage Domain to trick virt-v2v:

 uuid=`uuidgen`
 mkdir /tmp/ovirt
 mkdir /tmp/ovirt/$uuid
 mkdir /tmp/ovirt/$uuid/images
 mkdir /tmp/ovirt/$uuid/master
 mkdir /tmp/ovirt/$uuid/master/vms
 touch /tmp/ovirt/$uuid/dom_md
 virt-v2v [...] -o ovirt -os /tmp/ovirt

  Debugging oVirt import failures
When you export to the oVirt Export Storage Domain, and then import that guest through the oVirt UI, you may encounter an import failure. Diagnosing these failures is infuriatingly difficult as the UI generally hides the true reason for the failure.

Цікавими з цієї точки зору є такі файли журналів:

/var/log/vdsm/import/
    У oVirt ≥ 4.1.0 VDSM зберігає файл журналу virt-v2v у цьому каталозі протягом 30 днів.

    Цей каталог розташовано на вузлі, де виконується перетворення. Цей вузол можна вибрати за допомогою діалогового вікна імпортування або може бути знайдено за допомогою вкладки "Events" в адміністративному інтерфейсі oVirt.

/var/log/vdsm/vdsm.log
    Як і вище, цей файл зберігається на вузлі, де виконується перетворення. У ньому містяться докладні повідомлення про помилки, пов'язані із низькорівневими операціями, які виконує VDSM. Він корисний, якщо помилку було пов'язано не з virt-v2v, а з VDSM.

/var/log/ovirt-engine/engine.log
    This log file is stored on the oVirt server. It contains more detail for any errors caused by the oVirt GUI.

ТАКОЖ ПЕРЕГЛЯНЬТЕ
virt-v2v(1).

АВТОР
Richard W.M. Jones

АВТОРСЬКІ ПРАВА
Copyright (C) 2009-2025 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.