Provided by: libguestfs-tools_1.40.2-7ubuntu5_amd64 
НАЗВА
virt-p2v-make-kickstart — програма для збирання kickstart virt-p2v
КОРОТКИЙ ОПИС
virt-p2v-make-kickstart [-o p2v.ks] [--proxy=http://...] сховище [сховище...]
ОПИС
virt-p2v(1) перетворює фізичну машину для запуску віртуалізованою у KVM, під керуванням
libvirt, OpenStack, oVirt, Red Hat Enterprise Virtualisation (RHEV) або одним із інших
призначень, підтримку яких передбачено у virt-v2v(1).
Kickstart — формат, який використовується у похідних від Red Hat дистрибутивах (зокрема
Fedora, Red Hat Enterprise Linux, CentOS, Scientific Linux тощо) для опису процесу
створення компакт-дисків із портативною системою, встановлення дистрибутива, створення
«варіантів» тощо. Дані у цьому форматі зберігаються у файлі kickstart.
virt-p2v-make-kickstart збирає файл kickstart, яким можна скористатися для збирання
придатного до завантаження ISO P2V, образу портативної системи для компакт-диска, флешки
USB або образу PXE. Ця програма лише створює файл kickstart, але на цій сторінці
підручника описано деякі зі способів використання файла kickstart.
ЗБИРАННЯ ФАЙЛА KICKSTART
Користуватися virt-p2v-make-kickstart дуже просто:
virt-p2v-make-kickstart fedora
збере файл kickstart для Fedora. Файл kickstart називатиметься p2v.ks і зберігатиметься у
поточному каталозі.
Параметрі є списком з одного або декількох сховищ. Деякі із наявних вбудованих сховищ:
"fedora", "rawhide", "koji" або "rhel-ВЕРСІЯ" (наприклад "rhel-7.1"). Ви також можете
змінити адресу як параметр для вказування на сховище. Приклад:
virt-p2v-make-kickstart https://dl.fedoraproject.org/pub/fedora/linux/releases/21/Everything/x86_64/os/
Для керування назвою файла-результату скористайтеся параметром -o. Щоб наказати kickstart
скористатися проксі-сервером або вебкешем для отримання файлів, скористайтеся параметром
--proxy.
ЗБИРАННЯ ISO АБО ОБРАЗУ ДИСКА ІЗ ПОРТАТИВНОЮ СИСТЕМОЮ
Щойно у вас буде файл kickstart, ви можете скористатися livecd-creator(8) для створення
образу компакт-диска із портативною системою:
sudo livecd-creator p2v.ks
Перш ніж віддавати команду, зауважте, що вам слід, ймовірно, запустити "livecd-creator" в
одноразовій віртуальній машині з таких причин:
• На час роботи із програмою вам слід вимкнути SELinux.
• Цю програму слід запускати від імені користувача root. Також її виконання іноді
супроводжується помилками із доволі прикрими наслідками.
• Ви можете створювати образи компакт-дисків портативної системи лише з тим самим
дистрибутивом, що і в основній системі. Крос-компіляція завершуватиметься дивними
повідомленнями про помилки (див., наприклад, RHBZ#1092327).
ЗБИРАННЯ ВАРІАНТА FEDORA ЗА ДОПОМОГОЮ KOJI
Це потребує прав доступу "spin-livecd" для Koji, які зазвичай не надаються, навіть для
пакувальників Fedora. Втім, припускаючи, що у вас є відповідні права доступу (або,
наприклад, ваш власний екземпляр Koji), ви можете зробити так:
koji spin-livecd [--scratch] virt-p2v 1.XX.YY rawhide x86_64 p2v.ks
• Додайте параметр "--scratch" для створення тестової збірки (рекомендовано для
тестування).
• "1.XX.YY" має збігатися із версією libguestfs
• Замість "rawhide" ви можете скористатися будь-якою іншою ціллю Koji.
ЗБИРАННЯ ПРИДАТНОГО ДО ЗАВАНТАЖЕННЯ НОСІЯ USB
Скористайтеся програмою livecd-iso-to-disk(8) для перетворення створеного за наведеним
вище рецептом образу ISO на запис на носії USB:
sudo livecd-iso-to-disk livecd-p2v.iso /dev/sdX
ЗБИРАННЯ ОБРАЗУ ДЛЯ ЗАВАНТАЖЕННЯ PXE
Скористайтеся програмою "livecd-iso-to-pxeboot" для перетворення створеного вище образу
ISO у образ для завантаження PXE.
sudo livecd-iso-to-pxeboot livecd-p2v.iso
Ця команда створює підкаталог "tftpboot" у поточному каталозі, який міститиме файли,
потрібні, щоб PXE завантажила virt-p2v:
$ ls -1R tftpboot/
tftpboot/:
initrd0.img
pxelinux.0
pxelinux.cfg/
vmlinuz0
tftpboot/pxelinux.cfg:
default
32- ЧИ 64-БІТОВА VIRT-P2V?
Virt-p2v може перетворювати будь-які 32- або 64-бітові гостьові системи, незалежно від
того, чи є сама virt-p2v зібраною як 32- або 64-бітовою програмою. Єдиним обмеженням є те,
що 64-бітову версію virt-p2v не може бути запущено на 32-бітовому обладнанні.
Застаріла версія virt-p2v 0.9 завжди збиралася як 32-бітовий (i686) образ ISO. Це
означало, що компакт-диск із такою системою могло бути завантажено на будь-якому 32- або
64-бітовому обладнанні архітектури i686 або x86-64, і вона могла перетворювати будь-які
гостьові системи. Застарілий образ ISO virt-p2v, що постачався Red Hat, було засновано на
Red Hat Enterprise Linux (RHEL) 6.
Оскільки у RHEL 7 було припинено підтримку 32-бітових машин, поточну версію virt-p2v на
RHEL може бути зібрано лише у 64-бітовій версії. Цю систему не може бути запущено на
застарілому обладнанні 32-бітової архітектури.
Образи ISO virt-p2v для Fedora типово збираються для 32-бітової архітектури, отже, подібно
до застарілої версії на основі RHEL 6, virt-p2v 0.9, їх можна завантажувати на будь-якому
обладнанні.
ТЕСТУВАННЯ VIRT-P2V ЗА ДОПОМОГОЮ QEMU
ТЕСТУВАННЯ ISO P2V ЗА ДОПОМОГОЮ QEMU
Ви можете скористатися qemu для тестового завантаження образу ISO P2V:
qemu-kvm -m 1024 -hda /tmp/guest.img -cdrom /tmp/livecd-p2v.iso -boot d
Зауважте, що "-hda" є (віртуальною) системою, яку ви хочете перетворити (з тестовою
метою). Нею може бути гостьова система будь-якого типу, підтримуваного у virt-v2v(1),
зокрема Windows або Red Hat Enterprise Linux.
ТЕСТУВАННЯ ПІДТРИМКИ PXE ЗА ДОПОМОГОЮ QEMU
• Розпакуйте каталог tftpboot до /tmp (щоб її було показано як /tmp/tftpboot).
• Скопіюйте pxelinux.0 і ldlinux.c32 з syslinux (зазвичай з /usr/share/syslinux) до
/tmp/tftpboot.
• Скоригувати рядок "APPEND" у /tmp/tftpboot/pxelinux.cfg/default, якщо потрібно. Див.
"НАЛАШТУВАННЯ КОМАНДНОГО РЯДКА ЯДРА" in virt-p2v(1).
• Запустіть qemu ось так, щоб програма працювала як сервер TFTP і BOOTP, емулюючи
завантаження з мережі:
qemu-kvm \
-m 4096 -hda /tmp/guest.img \
-boot n \
-netdev user,id=unet,tftp=/tmp/tftpboot,bootfile=/pxelinux.0 \
-device virtio-net-pci,netdev=unet \
-serial stdio
Зауважте, що це потребує значно більше пам'яті, оскільки образ PXE завантажується до
пам'яті. Крім того, через те, що сервер TFTP qemu є дуже повільним, а образ PXE
virt-p2v є дуже великим, образ може, як здається» «зависати» після запуску pxelinux.
ДОДАВАННЯ ДОДАТКОВИХ ПАКУНКІВ
Встановити нові пакунки можна за допомогою параметра --install. Встановлення нових
пакунків може бути корисним для створення повнофункціонального диска virt-p2v із
додатковими інструментами для діагностики та усування вад. Як аргумент параметра слід
вказати список пакунків, відокремлених комами. Приклад:
virt-p2v-make-kickstart [...] --install tcpdump,traceroute
ДОДАВАННЯ ПРОФІЛЮ SSH
Ви можете вставити файл профілю SSH (закритий ключ) до kickstart, а отже до ISO, за
допомогою параметр --inject-ssh-identity. Зауважте, що ви не можете вставити ключ після
збирання образу ISO.
Спочатку створіть пару ключів. Пароль до пари ключів має бути порожнім:
ssh-keygen -t rsa -N '' -f id_rsa
Ця команда створить закритий ключ ("id_rsa") і відкритий ключ ("id_rsa.pub"). Відкритий
ключ слід дописати до файла "authorized_keys" на сервері перетворення virt-v2v (зазвичай,
до файла "/root/.ssh/authorized_keys").
Закритий ключ має бути додано до файла kickstart, а потім відкинуто:
virt-p2v-make-kickstart [...] --inject-ssh-identity id_rsa
rm id_rsa
Образ ISO далі може бути зібрано на основі kickstart у звичний спосіб (див. вище), і він
міститиме вбудований профіль SSH (/var/tmp/id_rsa).
При завантаженні virt-p2v вкажіть адресу вставленого файла ось так:
│ Користувач: [root____________________________] │
│ │
│ Пароль: [ <не заповнюйте> ] │
│ │
│ Адреса профілю SSH: [file:///var/tmp/id_rsa_______] │
або, якщо використовується командний рядок ядра, додайте:
p2v.identity=file:///var/tmp/id_rsa
Докладніший опис наведено у розділі "ПРОФІЛІ SSH" in virt-p2v(1).
ПАРАМЕТРИ
--help
Показати довідкове повідомлення.
--inject-ssh-identity id_rsa
Додати файл профілю SSH (закритий ключ) до kickstart. Див. "ДОДАВАННЯ ПРОФІЛЮ SSH"
вище.
--install пакунок,пакунок,...
Додати додаткові пакунки до розділу %packages kickstart. Див. "ДОДАВАННЯ ДОДАТКОВИХ
ПАКУНКІВ" вище.
-o ВИВЕДЕННЯ
--output ВИВЕДЕННЯ
Записати kickstart до "ВИВЕДЕННЯ". Якщо не вказано, буде типово використано p2v.ks у
поточному каталозі.
--proxy АДРЕСА
Наказати kickstart використати для отримання даних проксі-сервер або вебкеш.
-v
--verbose
Увімкнути режим докладних повідомлень. Скористайтеся цим параметром, якщо вам потрібно
діагностувати джерело проблеми зі скриптом або створити докладний звіт щодо вади у
бібліотеці.
-V
--version
Показати дані щодо версії і завершити роботу.
ФАЙЛИ
$libdir/virt-p2v/virt-p2v.xz
Виконуваний файл virt-p2v(1), який копіюється до файла kickstart.
Розташування виконуваного файла можна змінити за допомогою встановлення відповідного
значення змінної середовища "VIRT_P2V_DATA_DIR".
$datadir/virt-p2v/issue
$datadir/virt-p2v/launch-virt-p2v.in
$datadir/virt-p2v/p2v.ks.in
$datadir/virt-p2v/p2v.service
Різноманітні файли даних, які використовуються для створення kickstart.
Розташування цих файлів можна змінити за допомогою встановлення відповідного значення
змінної середовища "VIRT_P2V_DATA_DIR".
ЗМІННІ СЕРЕДОВИЩА
"VIRT_P2V_DATA_DIR"
Каталог, де virt-p2v-make-kickstart шукатиме файли даних і виконуваний файл virt-p2v
(див. "ФАЙЛИ" вище). Якщо не встановлено, буде використано вказане під час компіляції
місце.
ТАКОЖ ПЕРЕГЛЯНЬТЕ
virt-p2v(1), virt-p2v-make-disk(1), virt-v2v(1), livecd-creator(8), livecd-iso-to-disk(8),
http://libguestfs.org/.
АВТОРИ
Richard W.M. Jones http://people.redhat.com/~rjones/
АВТОРСЬКІ ПРАВА
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.