НАЗВА

       virt-v2v-output-rhv - Using virt-v2v to convert guests to oVirt or RHV

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

        virt-v2v [-i* options] -o rhv-upload [-oc ENGINE_URL] -os STORAGE
                               [-op PASSWORD] [-of raw]
                               [-oo rhv-cafile=FILE]
                               [-oo rhv-cluster=CLUSTER]
                               [-oo rhv-direct]
                               [-oo rhv-verifypeer]

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

        virt-v2v [-i* options] -o vdsm
                               [-oo vdsm-image-uuid=UUID]
                               [-oo vdsm-vol-uuid=UUID]
                               [-oo vdsm-vm-uuid=UUID]
                               [-oo vdsm-ovf-output=DIR]

ОПИС

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

       -o rhv-upload -os STORAGE
           Full description: "OUTPUT TO RHV"

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

       -o rhv -os esd:/path
       -o rhv -os /path
           Full description: "OUTPUT TO EXPORT STORAGE DOMAIN"

           This is the old method for uploading to oVirt/RHV 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.

           The Export Storage Domain was deprecated in oVirt 4, and so we expect that this method
           will stop working at some point in the future.

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

ВИВЕДЕННЯ ДО RHV

       This new method to upload guests to oVirt or RHV directly via the REST API requires
       oVirt/RHV ≥ 4.2.

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

       -oc "https://ovirt-engine.example.com/ovirt-engine/api"
           The URL of the REST API which is usually the server name with "/ovirt-engine/api"
           appended, but might be different if you installed oVirt Engine on a different path.

           You can optionally add a username and port number to the URL.  If the username is not
           specified then virt-v2v defaults to using "admin@internal" which is the typical
           superuser account for oVirt instances.

       -of raw
           Currently you must use -of raw and you cannot use -oa preallocated.

           These restrictions will be loosened in a future version.

       -op password-file
           A file containing a password to be used when connecting to the oVirt engine.  Note the
           file should contain the whole password, without any trailing newline, and for security
           the file should have mode 0600 so that others cannot read it.

       -os "ovirt-data"
           The storage domain.

       -oo rhv-cafile=ca.pem
           The ca.pem file (Certificate Authority), copied from /etc/pki/ovirt-engine/ca.pem on
           the oVirt engine.

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

       -oo rhv-direct
           If this option is given then virt-v2v will attempt to directly upload the disk to the
           oVirt node, otherwise it will proxy the upload through the oVirt engine.  Direct
           upload requires that you have network access to the oVirt nodes.  Non-direct upload is
           slightly slower but should work in all situations.

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

OUTPUT TO EXPORT STORAGE DOMAIN

       Вміст цього розділу стосується лише режиму виведення -o rhv. Якщо ви використовуєте
       virt-v2v з інтерфейсу користувача RHV-M, за сценою імпортування керується VDSM з
       використанням режиму виведення -o vdsm (режиму, яким кінцеві користувачі не повинні
       користуватися безпосередньо).

       Вам слід вказати -o rhv і параметр -os, який вказує на домен сховища експортування RHV-M.
       Ви можете або вказати сервер NFS і точку монтування, наприклад
       "-os rhv-storage:/rhv/export", або можете спочатку змонтувати домен і вказати каталог, до
       якого його змонтовано, наприклад "-os /tmp/mnt". Будьте обережні: не слід вказувати домен
       сховища даних (Data Storage Domain), оскільки це не спрацює.

       Якщо усі дії вдасться виконати успішно, virt-v2v запише нову гостьову систему до домену
       сховища експортування, але ця система ще не буде готова до запуску. Перш ніж нею можна
       буде скористатися, її слід імпортувати до RHV за допомогою інтерфейсу користувача.

       У RHV ≥ 2.2 зробити це можна за допомогою вкладки «Storage» («Сховище»). Виберіть домен
       експортування, до якого було записано гостьову систему. У відповідь під списком доменів
       збереження буде показано панель із декількома вкладками, одна з яких називатиметься «VM
       Import». У списку буде пункт перетвореної гостьової системи. Позначте його і натисніть
       кнопку «Import». Докладніший опис можна знайти у документації з RHV.

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

   Testing RHV conversions
       Якщо у вас немає екземпляра oVirt або RHV для тестування, ви можете виконати тестування
       перетворення, створивши структуру каталогів, яка подібна до структури каталогів домену
       сховища експортування RHV-M, щоб «надурити» virt-v2v:

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

   Debugging RHV-M import failures
       Коли ви експортуєте дані до домену сховища експортування RHV-M, а потім імпортуєте
       гостьову систему за допомогою інтерфейсу користувача RHV-M, ви можете зіткнутися із
       помилками при імпортуванні. Діагностування причини цих помилок — справа дуже складна,
       оскільки, зазвичай, інтерфейс користувача приховує справжню причину помилки.

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

       /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
           Цей файл журналу зберігається на сервері RHV-M. У цьому містяться докладніші дані щодо
           усіх помилок, які було пов'язано із графічним інтерфейсом користувача oVirt.

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

       virt-v2v(1).

АВТОР

       Richard W.M. Jones

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

       Copyright (C) 2009-2019 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.