
=head1 НАЗВА

virt-v2v-in-place - перетворення гостьової системи для використання KVM на місці

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

 virt-v2v-in-place -i диск [інші параметриr -i*]
                   [параметри virt-customize]
                   назва_файла
                   [-O результат.xml]

 virt-v2v-in-place -i libvirt|libvirtxml [інші параметри -i*]
                   [параметри virt-customize]
                   гостьова_система
                   [-O результат.xml]

=head1 ОПИС

Virt-v2v-in-place перетворює одну гостьову систему зі стороннього гіпервізора для запуску у KVM. Перетворення виконується на місці, зі внесенням змін до початкового диска.

На цій сторінці документації наведено дані щодо відмінностей між цим інструментом і virt-v2v. Вам слід спочатку прочитати сторінку L<virt-v2v(1)>.

=head2 Вибір диска вхідних даних

Зазвичай, virt-v2v запускають з одним або декількома параметрами I<-i*>, що керують режимом вхідних даних. Virt-v2v-in-place може перетворювати лише гостьові системи, що зберігаються у локальних файлах.

Ця команда виконує перетворення на місці файла F<назва_файла.img>:

 virt-v2v-in-place -i disk назва_файла.img

Якщо гостьову систему було скопійовано до локальної libvirt, тоді:

 virt-v2v-in-place -i libvirt guest

=head2 Виведення до XML

Якщо потрібно, скористайтеся параметром I<-O>, щоб записати створені після перетворення метадані щодо гостьової системи до файла XML. Це той самий формат, що і у L<virt-v2v-inspector(1)>. Цим можна скористатися, наприклад, для визначення того, яку операційну систему та мікропрограму було виявлено всередині гостьової системи під час перетворення.

=head2 Код виходу

Якщо робота virt-v2v-in-place завершується помилкою, програма повертає ненульовий стан виходу (помилку). У цьому випадку образ диска перебуватиме у стані B<unknown, possibly corrupted state>.

Якщо образ містить важливу інформацію, вам слід переконатися, що у вас є резервна копія, перш ніж пробувати перетворення virt-v2v-in-place. І вам варто перевірити, чи є нульовим код виходу, перш ніж використовувати образ диска після перетворення.

=head1 ПРИКЛАДИ

=head1 ПАРАМЕТРИ

=over 4

=item B<--help>

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

=item B<-b> ...

=item B<--bridge> ...

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

ifelse(ENABLE_BLOCK_DRIVER, yes, `

=item B<--block-driver> B<virtio-blk>

=item B<--block-driver> B<virtio-scsi>

Вибираючи блоковий драйвер для гостьових систем Windows, віддавайте перевагу C<virtio-blk> або C<virtio-scsi>. Типовим є C<virtio-blk>.

Note this has no effect for Linux guests at the moment.  That may be added in future.  ')

=item B<--collect> GUEST[B<:>LOCAL]

=item B<--collect-output> PATH/TO/OUTPUTB<.tar.xz>

See L<virt-v2v(1)/Collecting files for later diagnostics>

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

Можна використовувати лише локальні з'єднання libvirt з локальними сховищами даних на дисках.

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

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

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

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

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

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

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

__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 до мережі або містка.

Див. L<virt-v2v(1)/Мережі і містки>.

=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>=формат

За допомогою цього параметра можна зробити виведені дані придатнішими для обробки комп'ютером, якщо для цієї обробки використовуються інші програми. Див. L<virt-v2v(1)/Придатне до читання компʼютером виведення>.

=item B<-m> MB

=item B<--memsize> MB

Change the amount of memory allocated when doing the conversion. Virt-v2v-in-place will usually choose a suitable default.  Increase this if you see that the conversion step is running out of memory.

=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<вихід> буде пов'язано усі інші мережі (або містки).

Див. L<virt-v2v(1)/Мережі і містки>.

=item B<--no-fstrim>

Do not trim the filesystem.  See L<virt-v2v(1)/Trimming>.

=item B<-O> результат.xml

=item B<-O ->

Якщо вказано цей параметр, записати метадані про гостьову систему після перетворення до вказаного файла XML або до stdout, якщо використано I<-O ->. Це такий самий формат, як L<virt-v2v-inspector(1)>.

=item B<--print-source>

Вивести дані щодо початкової гостьової системи і припинити обробку. Цей параметр корисний, якщо ви налаштовуєте прив'язки мереж та містків. Див. L<virt-v2v(1)/Мережі і містки>.

=item B<-q>

=item B<--quiet>

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

=item B<--root> ...

Choose the root filesystem to be converted.  See the documentation of this option in L<virt-v2v(1)>.

=item B<--smp> N

Change the number of virtual CPUs used when doing the conversion. Virt-v2v-in-place will usually choose a suitable default.

Increasing this beyond 8 may improve conversion performance, if your host has sufficient physical CPUs.  You may also need to increase the memory size (I<--memsize> option).

=item B<-v>

=item B<--verbose>

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

=item B<-V>

=item B<--version>

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

=item B<--wrap>

Переносити рядки повідомлень помилок, попереджень та відомостей. Типовий варіант, якщо дані виводяться на термінал tty.  Якщо дані, виведені програмою, спрямовуються до файла, перенесення рядків буде вимкнено, якщо ви не додасте до команди цей параметр.

=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'/>
       <checksum method='sha256' fail='error'>123123...</checksum>
     </disk>
     <interface type='network'>
       <mac address='52:54:00:01:02:03'/>
       <source network='default'/>
       <model type='rtl8139'/>
     </interface>
   </devices>
 </domain>

=head2 Контрольна сума диска

Необов'язкове поле E<lt>checksumE<gt> визначає очікуваний хеш відповідного диска. Його може бути вказано засобами керування з метою виконання міжвузлових перевірок цілісності даних.

Зауважте, що це контрольна сума даних на диску у необробленому форматі. Якщо диск зберігається у форматі контейнера (наприклад qcow2), це контрольна сума даних, а I<не> контейнера.

Атрибут методу обчислення контрольної суми може мати значення C<md5>, C<sha256> або C<sha512>.

Значенням атрибута fail може бути C<error> для завершення перетворення, якщо контрольні суми не збігаються; C<warn> для виведення попередження, але з продовженням обробки; C<ignore> для ігнорування контрольної суми навіть без її обчислення або C<print> для виведення самої контрольної суми і продовження обробки. Типовим значенням є C<fail=warn>.

Обчислення контрольної суми для віддаленого джерела (наприклад HTTP) може бути повільним і обчислювально витратним завданням.

=head1 ФАЙЛИ

Використані файли збігаються з тими, що і для virt-v2v. Див. L<virt-v2v(1)/ФАЙЛИ>.

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

Використані змінні середовища є тими самими, що і для virt-v2v. Див. L<virt-v2v(1)/ЗМІННІ СЕРЕДОВИЩА>.

=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-2025 Red Hat Inc.

