
=head1 НАЗВА

virt-v2v-output-rhv — використання virt-v2v для перетворення гостьових систем із виведенням даних до oVirt або RHV

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

 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-proxy]
                        [-oo rhv-disk-uuid=UUID ...]
                        [-oo rhv-verifypeer]

 virt-v2v [параметри -i*] -o rhv -os [esd:/шлях|/шлях]

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

=head1 ОПИС

На цій сторінці наведено документацію щодо використання L<virt-v2v(1)> для перетворення гостьових систем на керований екземпляр системи oVirt або RHV. Передбачено три режими виведення даних, одним з яких ви можете скористатися, але, зазвичай, слід користуватися лише I<-o rhv-upload>. Два інших режими вважаються застарілими:

=over 4

=item B<-o rhv-upload> B<-os> СХОВИЩЕ

Повний опис: L</ВИВЕДЕННЯ ДО RHV>

Це сучасний метод вивантаження до oVirt/RHV за допомогою програмного інтерфейсу REST. Потребує oVirt/RHV E<ge> 4.2.

=item B<-o rhv> B<-os> esd:/шлях

=item B<-o rhv> B<-os> /шлях

Повний опис: L</ВИВЕДЕННЯ ДО ДОМЕНУ СХОВИЩА ЕКСПОРТУВАННЯ>

Це застарілий метод вивантаження даних до oVirt/RHV за допомогою домену сховища експортування (ESD). Доступ до ESD можна здійснювати або за допомогою NFS (використовуючи формат I<-os esd:/шлях>), або, якщо сховище у вас вже змонтовано за допомогою NFS, визначенням шляху до точки монтування як I<-os /шлях>.

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

=item B<-o vdsm>

Це застарілий метод, який використовувався на внутрішньому рівні інтерфейсом користувача RHV-M. Його використання ніколи не призначалося для кінцевих користувачів.

=back

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

Це новий метод вивантаження гостьових систем до oVirt або RHV безпосередньо за допомогою програмного інтерфейсу REST, потребує oVirt/RHV E<ge> 4.2.

Вам слід вказати I<-o rhv-upload>, а також такі додаткові параметри:

=over 4

=item I<-oc> C<https://ovirt-engine.example.com/ovirt-engine/api>

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

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

=item I<-of raw>

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

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

=item I<-op> F<файл-пароля>

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

=item I<-os> C<дані-ovirt>

Домен сховища.

=item I<-oo rhv-cafile=>F<ca.pem>

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

Якщо увімкнено I<-oo rhv-verifypeer>, цим параметром можна скористатися для керування тим, яка служба сертифікації використовуватиметься для перевірки ідентичності клієнта. Якщо цей параметр не використано, буде використано загальносистемне сховище довірених сертифікатів.

=item I<-oo rhv-cluster=>C<НАЗВА_КЛАСТЕРА>

Встановити назву кластера RHV. Якщо не вказано, буде використано назву C<Default>.

=item I<-oo rhv-disk-uuid=>C<UUID>

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

=over 4

=item *

вам B<слід> передати стільки параметрів I<-oo rhv-disk-uuid=UUID>, скільки дисків є у гостьовій системі;

=item *

the specified UUIDs must not conflict with the UUIDs of existing disks

=back

=item I<-oo rhv-proxy>

Proxy the upload through oVirt Engine.  This is slower than uploading directly to the oVirt node but may be necessary if you do not have direct network access to the nodes.

=item I<-oo rhv-verifypeer>

Перевірити автентичність сервера oVirt/RHV шляхом перевірки сертифіката сервера за допомогою служби сертифікації.

=back

=head1 ВИВЕДЕННЯ ДО ДОМЕНУ СХОВИЩА ЕКСПОРТУВАННЯ

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

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

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

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

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

=head2 Тестування перетворених даних RHV

Якщо у вас немає екземпляра 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

=head2 Діагностування помилок імпортування RHV-M

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

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

=over 4

=item F</var/log/vdsm/import/>

У oVirt E<ge> 4.1.0 VDSM зберігає файл журналу virt-v2v у цьому каталозі протягом 30 днів.

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

=item F</var/log/vdsm/vdsm.log>

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

=item F</var/log/ovirt-engine/engine.log>

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

=back

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

L<virt-v2v(1)>.

=head1 АВТОР

Richard W.M. Jones

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

© Red Hat Inc., 2009–2020

