
=head1 НАЗВА

virt-v2v-in-place - Convert a guest to use KVM in-place

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

 virt-v2v-in-place -i disk [other -i* options] filename

 virt-v2v-in-place -i libvirt|libvirtxml [other -i* options] guest

=head1 ОПИС

Virt-v2v-in-place converts a single guest from a foreign hypervisor to run on KVM.  It does this conversion in place, modifying the original disk.

This manual page only documents the differences between this tool and virt-v2v.  You should read L<virt-v2v(1)> first.

=head2 Selecting the input disk

You normally run virt-v2v with one or more I<-i*> options controlling the input mode.  Virt-v2v-in-place can only convert guests stored in local files.

This command will do an in-place conversion of F<filename.img>:

 virt-v2v-in-place -i disk filename.img

If the guest has been copied to local libvirt then:

 virt-v2v-in-place -i libvirt guest

=head1 ПРИКЛАДИ

=head1 ПАРАМЕТРИ

=over 4

=item B<--help>

Показати довідкове повідомлення.

=item B<-b> ...

=item B<--bridge> ...

Див. I<--network> нижче.

=item B<--colors>

=item B<--colours>

Використовувати послідовності символів ANSI для розфарбовування повідомлень. Ці послідовності типово використовуються, якщо дані виводяться на термінал tty.  Якщо дані, виведені програмою, спрямовуються до файла, послідовності визначення кольорів ANSI буде вимкнено, якщо ви не додасте до команди цей параметр.

=item B<--echo-keys>

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

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

=item B<-i> B<disk>

Встановити метод введення I<disk>.

У цьому режимі ви можете читати образ диска віртуальної машини без метаданих. virt-v2v намагається визначити найкращі типові значення для метаданих. Ці значення, зазвичай, є адекватними, але ви можете додатково змінити їх (наприклад, змінити об'єм пам'яті або кількість віртуальних процесорів) за допомогою параметра I<-i libvirtxml>. У цей спосіб може бути імпортовано лише гостьові системи, які використовують лише один диск.

=item B<-i> B<libvirt>

Встановити метод введення I<libvirt>. Цей метод є типовим.

У цьому режимі вам слід вказати назву гостьової системи libvirt або UUID у рядку команди. Ви також можете вказати адресу з'єднання libvirt (див. I<-ic>).

=item B<-i> B<libvirtxml>

Встановити метод введення I<libvirtxml>.

У цьому режимі вам слід передати за допомогою рядка команди файл XML libvirt. Цей файл буде прочитано для отримання метаданих (зокрема назви та обсягу пам'яті) щодо початкової гостьової системи, а також розташування дисків із вхідними даними. Див. L</Мінімальний XML для параметра -i libvirtxml> нижче.

=item B<-i> B<local>

Те саме, що і I<-i disk>.

=item B<-ic> адреса_libvirt

Вказати адресу з'єднання libvirt, яким слід скористатися під час читання гостьової системи. Використовується, лише якщо S<I<-i libvirt>>.

Only local libvirt connections to locally stored disks can be used.

=item B<-if> формат

Лише для I<-i disk>. Цей параметр вказує формат образу диска вхідних даних. Для інших варіантів вхідних даних вам слід вказати формат вхідних даних у метаданих.

=item B<-io> ПАРАМЕТР=ЗНАЧЕННЯ

Встановити параметри вхідних даних, пов'язані із поточним режимом обробки або пересилання вхідних даних. Щоб ознайомитися із короткою довідкою щодо цих параметрів, ви можете скористатися такою командою:

 virt-v2v-in-place -it disk -io "?"

=item B<-ip> назва_файла

Supply a file containing a password to be used when connecting to the source.  If this is omitted then the input hypervisor may ask for the password interactively.  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.

__INCLUDE:key-option.pod__

__INCLUDE:keys-from-stdin-option.pod__

Зауважте, що I<--keys-from-stdin> стосується лише ключів і паролів до зашифрованих пристроїв і розділів, а не паролів, які використовуються для встановлення з'єднання із віддаленими серверами.

=item B<--mac> aa:bb:cc:dd:ee:ffB<:network:>out

=item B<--mac> aa:bb:cc:dd:ee:ffB<:bridge:>out

Прив'язка MAC-адреси NIC до мережі або містка.

See L<virt-v2v(1)/Networks and bridges>.

=item B<--mac> aa:bb:cc:dd:ee:ffB<:ip:>ipaddr[,gw[,len[,ns,ns,...]]]

Примусово використати для певного інтерфейсу (контрольованого за його MAC-адресою) статичну IP-адресу після завантаження.

Поля у параметрі є такими: C<ipaddr> є IP-адресою; C<gw> — необов'язкова IP-адреса шлюзу; C<len> — довжина маски підмережі (ціле число). Останні параметри є нульовими або додатковими IP-адресами назв серверів.

Цей параметр можна не вказувати або вказувати довільну кількість разів.

Потреба у цьому параметрі виникає лише для деяких гостьових систем із помилками, зокрема Windows, які не здатні зберігати прив'язки MAC-адрес до статичних IP-адрес автоматично. Він вам не знадобиться, якщо Windows використовує DHCP. У поточній версії параметр ігнорується для гостьових систем Linux, оскільки у цих систем цієї проблеми немає.

=item B<--machine-readable>

=item B<--machine-readable>=формат

This option is used to make the output more machine friendly when being parsed by other programs.  See L<virt-v2v(1)/Machine readable output>.

=item B<-n> вхід:вихід

=item B<-n> вихід

=item B<--network> вхід:вихід

=item B<--network> вихід

=item B<-b> вхід:вихід

=item B<-b> вихід

=item B<--bridge> вхід:вихід

=item B<--bridge> вихід

Пов'язати мережу (або місток) із назвою C<вхід> із мережею (або містком) із назвою C<вихід>. Якщо не вказано префікс C<вхід:>, із C<вихід> буде пов'язано усі інші мережі (або містки).

See L<virt-v2v(1)/Networks and bridges>.

=item B<--print-source>

Print information about the source guest and stop.  This option is useful when you are setting up network and bridge maps.  See L<virt-v2v(1)/Networks and bridges>.

=item B<-q>

=item B<--quiet>

Цей параметр вимикає смужки поступу та інші необов'язкові до виведення дані.

=item B<--root ask>

=item B<--root single>

=item B<--root first>

=item B<--root> /dev/sdX

=item B<--root> /dev/VG/LV

Вибрати кореневу файлову систему для перетворення.

Якщо у віртуальній машині передбачено декілька варіантів завантаження або у віртуальній машині є сторонні файлові системи, які виглядають як розділи операційних систем, за допомогою цього параметра можна вибрати кореневу файлову систему (тобто диск C<C:> або F</>) операційної системи, яку слід перетворити. Використання консолі відновлення Windows, деякі долучені диски DVD та вади у евристиці засобу інспектування libguestfs можуть призвести до помилкового визначення гостьової операційної системи як такої, у якій передбачено варіанти завантаження.

Типовим варіантом у virt-v2v E<le> 0.7.1 був параметр S<I<--root single>>, який спричиняв аварійне завершення virt-v2v, якщо виявлялася операційна система із варіантами завантаження.

Починаючи з версії virt-v2v E<ge> 0.7.2 типовим режимом є S<I<--root ask>>: якщо буде виявлено варіанти завантаження у віртуальній машині, virt-v2v припинить роботу, виведе список усіх можливих кореневих файлових системи і попросить користувача вказати ту, яку слід перетворити. Це потребує роботи virt-v2v у інтерактивному режимі.

S<I<--root first>> означає, що слід вибрати перший кореневий пристрій, якщо буде виявлено операційну систему із варіантами завантаження. Оскільки виявлення кореневих пристроїв пов'язано із евристикою, іноді програма може вибрати помилковий пристрій.

Ви також можете вказати певний кореневий пристрій за назвою, наприклад, S<I<--root /dev/sda2>> означає, що слід використати другий розділ на першому диску. Якщо іменованого кореневого пристрою не існує або його не вдасться визначити як кореневий пристрій, virt-v2v повідомить про помилку і завершить роботу.

Зауважте, що у grub є вада, яка заважає успішно завантажувати систему із варіантами завантаження, якщо увімкнено virtio. Grub може завантажувати лише операційні системи з першого диска virtio. Зокрема, F</boot> має бути першим диском virtio, і grub не може ланцюгово завантажувати операційну систему, яка не зберігається на першому диску virtio.

=item B<-v>

=item B<--verbose>

Увімкнути докладний показ повідомлень з метою діагностики.

=item B<-V>

=item B<--version>

Показати дані щодо версії і завершити роботу.

=item B<--wrap>

Wrap error, warning, and informative messages.  This is the default when the output is a tty.  If the output of the program is redirected to a file, wrapping is disabled unless you use this option.

=item B<-x>

Увімкнути трасування викликів програмного інтерфейсу libguestfs.

=back

=head2 Мінімальний XML для параметра -i libvirtxml

Якщо використовується параметр I<-i libvirtxml>, вам слід буде вказати певний файл XML libvirt. Написання такого файла «з нуля» є доволі марудною справою, отже, вам буде корисний наведений нижче шаблон.

B<Зауважте, що цим слід користуватися лише для тестування і/або там, де ви впевнені у своїх діях!> Якщо у вас є метадані libvirt для гостьової системи, завжди користуйтеся ними, а не цим шаблоном.

 <domain type='kvm'>
   <name> NAME </name>
   <memory>1048576</memory>
   <vcpu>2</vcpu>
   <os>
     <type>hvm</type>
     <boot dev='hd'/>
   </os>
   <features>
     <acpi/>
     <apic/>
     <pae/>
   </features>
   <devices>
     <disk type='file' device='disk'>
       <driver name='qemu' type='raw'/>
       <source file='/path/to/disk/image'/>
       <target dev='hda' bus='ide'/>
     </disk>
     <interface type='network'>
       <mac address='52:54:00:01:02:03'/>
       <source network='default'/>
       <model type='rtl8139'/>
     </interface>
   </devices>
 </domain>

=head1 ФАЙЛИ

Files used are the same as for virt-v2v.  See L<virt-v2v(1)/FILES>.

=head1 ЗМІННІ СЕРЕДОВИЩА

Environment variables used are the same as for virt-v2v.  See L<virt-v2v(1)/ENVIRONMENT VARIABLES>.

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

L<virt-v2v(1)>, L<virt-p2v(1)>, L<guestfs(3)>, L<guestfish(1)>, L<qemu-img(1)>, L<nbdkit(1)>, L<http://libguestfs.org/>.

=head1 АВТОРИ

Matthew Booth

Cédric Bosdonnat

Laszlo Ersek

Tomáš Golembiovský

Shahar Havivi

Richard W.M. Jones

Roman Kagan

Mike Latimer

Nir Soffer

Pino Toscano

Xiaodai Wang

Ming Xie

Tingting Zheng

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

Copyright (C) 2009-2022 Red Hat Inc.

