
=head1 НАЗВА

virt-v2v-output-rhv - Using virt-v2v to convert guests to oVirt or 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* 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]

=head1 ОПИС

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

=over 4

=item B<-o rhv-upload> B<-os> STORAGE

Full description: L</OUTPUT TO RHV>

This is the modern method for uploading to oVirt/RHV via the REST API.  It requires oVirt/RHV E<ge> 4.2.

=item B<-o rhv> B<-os> esd:/path

=item B<-o rhv> B<-os> /path

Full description: L</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 I<-os esd:/path> form) or if you have already NFS-mounted it somewhere specify the path to the mountpoint as I<-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.

=item B<-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.

=back

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

This new method to upload guests to oVirt or RHV directly via the REST API requires oVirt/RHV E<ge> 4.2.

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

=over 4

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

The URL of the REST API which is usually the server name with C</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 C<admin@internal> which is the typical superuser account for oVirt instances.

=item I<-of raw>

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

These restrictions will be loosened in a future version.

=item I<-op> F<password-file>

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

=item I<-os> C<ovirt-data>

The storage domain.

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

The F<ca.pem> file (Certificate Authority), copied from F</etc/pki/ovirt-engine/ca.pem> on the oVirt engine.

If I<-oo rhv-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.

=item I<-oo rhv-cluster=>C<CLUSTERNAME>

Set the RHV Cluster Name.  If not given it uses C<Default>.

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

This option can used to manually specify UUIDs for the disks when creating the virtual machine.  If not specified, the oVirt engine will generate random UUIDs for the disks.  Please note that:

=over 4

=item *

you B<must> pass as many I<-oo rhv-disk-uuid=UUID> options as the amount of disks in the guest

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

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

=back

=head1 OUTPUT TO EXPORT STORAGE DOMAIN

Вміст цього розділу стосується лише режиму виведення 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 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

=head2 Debugging RHV-M import failures

Коли ви експортуєте дані до домену сховища експортування 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 АВТОРСЬКІ ПРАВА

Copyright (C) 2009-2020 Red Hat Inc.

