.\" Automatically generated by Podwrapper::Man 1.40.2 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "virt-p2v-make-disk 1" .TH virt-p2v-make-disk 1 "2019-02-07" "libguestfs-1.40.2" "Virtualization Support" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "НАЗВА" .IX Header "НАЗВА" virt\-p2v\-make\-disk — збирання диска virt\-p2v за допомогою virt-builder .SH "КОРОТКИЙ ОПИС" .IX Header "КОРОТКИЙ ОПИС" .Vb 1 \& virt\-p2v\-make\-disk \-o /dev/sdX [версія ОС] .Ve .SH "ОПИС" .IX Header "ОПИС" \&\fBvirt\-p2v\fR\|(1) перетворює фізичну машину для запуску віртуалізованою у \s-1KVM,\s0 під керуванням libvirt, OpenStack, oVirt, Red Hat Enterprise Virtualisation (\s-1RHEV\s0) або одним із інших призначень, підтримку яких передбачено у \&\fBvirt\-v2v\fR\|(1). .PP virt\-p2v\-make\-disk — скрипт, який створює придатний до завантаження образ диска або флешки \s-1USB,\s0 на якому міститься virt\-p2v. Для виконання завдань програма використовує \fBvirt\-builder\fR\|(1). Сама ж програма є невеличким скриптом командної оболонки, призначеним для керування virt-builder. .PP За допомогою обов'язкового параметра \fI\-o\fR визначається місце, куди слід записати виведені дані, наприклад флешка \s-1USB\s0 (приклад: \f(CW\*(C`\-o /dev/sdX\*(C'\fR) або файл. Якщо вами буде передано назву пристрою, \fBнаявні на пристрої дані буде витерто\fR. .ie n .SS "Параметр ""os\-version""" .el .SS "Параметр \f(CWos\-version\fP" .IX Subsection "Параметр os-version" Необов'язковий параметр \f(CW\*(C`os\-version\*(C'\fR визначає базовий дистрибутив Linux, який буде використано для створення операційної системи на образі \s-1ISO.\s0 Якщо ви не вкажете цей параметр, скрипт намагатиметься вибрати відповідне типове значення для вашої системи. У більшості користувачів \fIне\fR має виникати потреби у використанні параметра \f(CW\*(C`os\-version\*(C'\fR. .PP Базова операційна система, яку вибрано для virt\-p2v, ніяким чином не пов'язана із операційною системою фізичної машини, яку ви хочете перетворити. .PP Щоб побачити список можливих комбінацій \f(CW\*(C`os\-version\*(C'\fR, віддайте таку команду: .PP .Vb 1 \& virt\-builder \-l .Ve .SH "ПРИКЛАДИ" .IX Header "ПРИКЛАДИ" Записати придатну до завантаження флешку \s-1USB\s0 з virt\-p2v на \fI/dev/sdX\fR (усі наявні на \fI/dev/sdX\fR дані буде витерто): .PP .Vb 1 \& virt\-p2v\-make\-disk \-o /dev/sdX .Ve .PP Записати придатний до завантаження образ віртуального диска virt\-p2v і завантажити його під qemu: .PP .Vb 4 \& virt\-p2v\-make\-disk \-o /var/tmp/p2v.img fedora\- \& qemu\-kvm \-m 1024 \-boot c \e \& \-drive file=/var/tmp/p2v.img,if=virtio,index=0 \e \& \-drive file=/var/tmp/guest.img,if=virtio,index=1 .Ve .PP де \fI/var/tmp/guest.img\fR — образ диска якоїсь гостьової системи, яку ви хочете перетворити (лише для тестування). .SH "ДОДАВАННЯ ДОДАТКОВИХ ПАКУНКІВ" .IX Header "ДОДАВАННЯ ДОДАТКОВИХ ПАКУНКІВ" Встановити нові пакунки можна за допомогою параметра \&\fI\-\-install\fR. Встановлення нових пакунків може бути корисним для створення повнофункціонального диска virt\-p2v із додатковими інструментами для діагностики та усування вад. Як аргумент параметра слід вказати список пакунків, відокремлених комами. Приклад: .PP .Vb 1 \& virt\-p2v\-make\-disk \-o /var/tmp/p2v.img \-\-install tcpdump,traceroute .Ve .SH "ДОДАВАННЯ ПРОФІЛЮ SSH" .IX Header "ДОДАВАННЯ ПРОФІЛЮ SSH" Ви можете вставити файл профілю \s-1SSH\s0 (закритий ключ) до образу за допомогою параметра \fI\-\-inject\-ssh\-identity\fR. .PP Спочатку створіть пару ключів. Пароль до пари ключів має бути порожнім: .PP .Vb 1 \& ssh\-keygen \-t rsa \-N \*(Aq\*(Aq \-f id_rsa .Ve .PP Ця команда створить закритий ключ (\f(CW\*(C`id_rsa\*(C'\fR) і відкритий ключ (\f(CW\*(C`id_rsa.pub\*(C'\fR). Відкритий ключ слід дописати до файла \f(CW\*(C`authorized_keys\*(C'\fR на сервері перетворення virt\-v2v (зазвичай, до файла \&\f(CW\*(C`/root/.ssh/authorized_keys\*(C'\fR). .PP Закритий ключ має бути вписано на образ диска, а потім витерто: .PP .Vb 2 \& virt\-p2v\-make\-disk [...] \-\-inject\-ssh\-identity id_rsa \& rm id_rsa .Ve .PP При завантаженні virt\-p2v вкажіть адресу вставленого файла ось так: .PP .Vb 5 \& │ Користувач: [root_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_] │ \& │ │ \& │ Пароль: [ <не заповнюйте> ] │ \& │ │ \& │ Адреса профілю SSH: [file:///var/tmp/id_rsa_\|_\|_\|_\|_\|_\|_] │ .Ve .PP або, якщо використовується командний рядок ядра, додайте: .PP .Vb 1 \& p2v.identity=file:///var/tmp/id_rsa .Ve .PP Докладніший опис наведено у розділі \*(L"ПРОФІЛІ \s-1SSH\*(R"\s0 in \fBvirt\-p2v\fR\|(1). .SH "32\-БІТОВА VIRT\-P2V" .IX Header "32-БІТОВА VIRT-P2V" Для поліпшення сумісності із застарілим обладнанням у virt\-p2v\-make\-disk передбачено параметр \fI\-\-arch\fR. Найкориснішим параметром (на основних системах архітектури x86\-64) є параметр \fI\-\-arch i686\fR, який надає змогу зібрати 32\-бітове середовище virt\-p2v, яке працюватиме на застарілому обладнанні. 32\-бітова версія virt\-p2v може перетворювати 64\-бітові фізичні машини і може працювати із 64\-бітовим virt\-v2v та 64\-бітовими гіпервізорами. .PP Щоб скористатися цим параметром вам слід зібрати у якийсь спосіб \&\fIvirt\-p2v.$arch\fR (зазвичай, \fIvirt\-p2v.i686\fR) і встановити його поряд із звичайним виконуваним файлом \fIvirt\-p2v\fR (наприклад, до \fI\f(CI$libdir\fI/virt\-p2v/\fR або \f(CW$VIRT_V2V_DATA_DIR\fR). Опис процедури не є предметом цієї сторінки підручника, втім, ви можете знайти настанови у розділі \&\*(L"ЗБИРАННЯ \s-1VIRT\-P2V\s0 ДЛЯ 32\-БІТОВОЇ АРХІТЕКТУРИ i686\*(R" in \fBguestfs\-building\fR\|(1). .SH "ПАРАМЕТРИ" .IX Header "ПАРАМЕТРИ" .IP "\fB\-\-help\fR" 4 .IX Item "--help" Показати довідкове повідомлення. .IP "\fB\-\-arch\fR АРХІТЕКТУРА" 4 .IX Item "--arch АРХІТЕКТУРА" Встановити архітектуру образу \s-1ISO\s0 із virt\-p2v. Див. \*(L"32\-БІТОВА \s-1VIRT\-P2V\*(R"\s0 вище. .Sp Якщо цей параметр не вказано, типово буде використано ту саму архітектуру, що і архітектура основної системи, у якій запущено virt\-p2v\-make\-disk. .IP "\fB\-\-inject\-ssh\-identity\fR id_rsa" 4 .IX Item "--inject-ssh-identity id_rsa" Додати файл профілю \s-1SSH\s0 (закритий ключ) до образу. Див. \*(L"ДОДАВАННЯ ПРОФІЛЮ \&\s-1SSH\*(R"\s0 вище. .IP "\fB\-\-install\fR пакунок,пакунок,..." 4 .IX Item "--install пакунок,пакунок,..." Додати до образу додаткові пакунки. Див. \*(L"ДОДАВАННЯ ДОДАТКОВИХ ПАКУНКІВ\*(R" вище. .IP "\fB\-\-no\-warn\-if\-partition\fR" 4 .IX Item "--no-warn-if-partition" Зазвичай, вам не слід записувати дані на розділ диска \s-1USB\s0 (тобто не слід користуватися \f(CW\*(C`\-o /dev/sdX1\*(C'\fR, користуйтеся \f(CW\*(C`\-o /dev/sdX\*(C'\fR для створення придатного до завантаження диска \s-1USB\s0). Якщо ви спробуєте створити придатний до запису диск, virt-builder виведе попередження. За допомогою цього параметра можна придушити попередження. .IP "\fB\-o\fR ВИВЕДЕННЯ" 4 .IX Item "-o ВИВЕДЕННЯ" .PD 0 .IP "\fB\-\-output\fR ВИВЕДЕННЯ" 4 .IX Item "--output ВИВЕДЕННЯ" .PD Записати виведені дані до \f(CW\*(C`ВИВЕДЕННЯ\*(C'\fR, яким може бути локальний файл або блоковий пристрій. \fBНаявний вміст пристрою буде витерто\fR. .IP "\fB\-v\fR" 4 .IX Item "-v" .PD 0 .IP "\fB\-\-verbose\fR" 4 .IX Item "--verbose" .PD Увімкнути режим докладних повідомлень. Скористайтеся цим параметром, якщо вам потрібно діагностувати джерело проблеми зі скриптом або створити докладний звіт щодо вади у бібліотеці. .IP "\fB\-V\fR" 4 .IX Item "-V" .PD 0 .IP "\fB\-\-version\fR" 4 .IX Item "--version" .PD Показати дані щодо версії і завершити роботу. .SH "ФАЙЛИ" .IX Header "ФАЙЛИ" .IP "\fI\f(CI$libdir\fI/virt\-p2v/virt\-p2v.xz\fR" 4 .IX Item "$libdir/virt-p2v/virt-p2v.xz" Виконуваний файл \fBvirt\-p2v\fR\|(1), який буде скопійовано на придатний до завантаження образ диска. .Sp Розташування виконуваного файла можна змінити за допомогою встановлення відповідного значення змінної середовища \f(CW\*(C`VIRT_P2V_DATA_DIR\*(C'\fR. .IP "\fI\f(CI$datadir\fI/virt\-p2v/issue\fR" 4 .IX Item "$datadir/virt-p2v/issue" .PD 0 .IP "\fI\f(CI$datadir\fI/virt\-p2v/launch\-virt\-p2v.in\fR" 4 .IX Item "$datadir/virt-p2v/launch-virt-p2v.in" .IP "\fI\f(CI$datadir\fI/virt\-p2v/p2v.service\fR" 4 .IX Item "$datadir/virt-p2v/p2v.service" .PD Різноманітні файли даних, які копіюються на образ диска, придатного до завантаження. .Sp Розташування цих файлів можна змінити за допомогою встановлення відповідного значення змінної середовища \f(CW\*(C`VIRT_P2V_DATA_DIR\*(C'\fR. .SH "ЗМІННІ СЕРЕДОВИЩА" .IX Header "ЗМІННІ СЕРЕДОВИЩА" .ie n .IP """VIRT_P2V_DATA_DIR""" 4 .el .IP "\f(CWVIRT_P2V_DATA_DIR\fR" 4 .IX Item "VIRT_P2V_DATA_DIR" Каталог, у якому virt\-p2v\-make\-disk шукатиме файли даних (див. \*(L"ФАЙЛИ\*(R" вище). Якщо значення не встановлено, буде використано вказане під час компіляції місце. .SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ" .IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ" \&\fBvirt\-p2v\fR\|(1), \fBvirt\-p2v\-make\-kickstart\fR\|(1), \fBvirt\-p2v\-make\-kiwi\fR\|(1), \&\fBvirt\-v2v\fR\|(1), http://libguestfs.org/. .SH "АВТОРИ" .IX Header "АВТОРИ" Richard W.M. Jones http://people.redhat.com/~rjones/ .SH "АВТОРСЬКІ ПРАВА" .IX Header "АВТОРСЬКІ ПРАВА" Copyright (C) 2009\-2019 Red Hat Inc. .SH "LICENSE" .IX Header "LICENSE" .SH "BUGS" .IX Header "BUGS" To get a list of bugs against libguestfs, use this link: https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools .PP To report a new bug against libguestfs, use this link: https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools .PP When reporting a bug, please supply: .IP "\(bu" 4 The version of libguestfs. .IP "\(bu" 4 Where you got libguestfs (eg. which Linux distro, compiled from source, etc) .IP "\(bu" 4 Describe the bug accurately and give a way to reproduce it. .IP "\(bu" 4 Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR output into the bug report.