.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Podwrapper::Man 2.4.0 (Pod::Simple 3.45) .\" .\" 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 .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . 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-v2v-output-openstack 1" .TH virt-v2v-output-openstack 1 2024-01-04 virt-v2v-2.4.0 "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\-v2v\-output\-openstack — використання virt\-v2v для перетворення гостьових систем із виведенням даних до OpenStack .SH "КОРОТКИЙ ОПИС" .IX Header "КОРОТКИЙ ОПИС" .Vb 5 \& virt\-v2v [параметри \-i*] \-o openstack \& \-oo server\-id=СЕРВЕР \& [\-oo guest\-id=ГОСТЬОВА_СИСТЕМА] \& [\-oo verify\-server\-certificate=false] \& [\-oo os\-username=admin] [\-oo os\-*=*] \& \& virt\-v2v [параметри \-i*] \-o glance .Ve .SH ОПИС .IX Header "ОПИС" На цій сторінці наведено документацію щодо використання \fBvirt\-v2v\fR\|(1) для перетворення гостьових систем на формат, придатний до запуску в OpenStack. Існує два режими виведення даних, якими ви можете скористатися, але, зазвичай, слід використовувати лише \fI\-o openstack\fR. .IP "\fB\-o openstack\fR \fB\-oo server\-id=\fRСЕРВЕР [...]" 4 .IX Item "-o openstack -oo server-id=СЕРВЕР [...]" Повний опис: "ВИВЕДЕННЯ ДО OPENSTACK" .Sp Це сучасний метод для вивантаження даних до OpenStack за допомогою програмного інтерфейсу REST. Гостьові системи можна безпосередньо перетворити на томи Cinder. .IP "\fB\-o glance\fR" 4 .IX Item "-o glance" Повний опис: "ВИВЕДЕННЯ ДО GLANCE" .Sp Це застарілий метод вивантаження до Glance. На жаль, Glance не дуже пристосовано для зберігання перетворених гостьових систем (оскільки virt\-v2v працює з «домашніми тваринками», а не шаблонною «худобою»), тому не рекомендуємо користуватися цим методом, якщо ви не зовсім впевнені у наслідках своїх дій. .SH "ВИВЕДЕННЯ ДО OPENSTACK" .IX Header "ВИВЕДЕННЯ ДО OPENSTACK" Щоб вивести дані до OpenStack, скористайтеся параметром \fI\-o openstack\fR. .SS "OpenStack: Налаштовування базової системи для перетворення" .IX Subsection "OpenStack: Налаштовування базової системи для перетворення" При перетворенні за допомогою virt\-v2v до формату OpenStack незвичною особливістю є те, що virt\-v2v \fBмає\fR бути запущено у віртуальній машині, яка працює на «хмарі» OpenStack. Ця віртуальна машина називається «базовою системою перетворення» («conversion appliance»). Зауважте, що ця віртуальна машина не пов'язана із гостьовою системою, перетворення якої виконується. .PP Це спричинено тим, що для створення томів Cinder, які міститимуть дані гостьової системи (перетвореної програмою) нам доведеться долучити ці томи Cinder до якоїсь віртуальної машини OpenStack. .PP У базовій системі слід ініціалізувати команду \f(CW\*(C`openstack\*(C'\fR. Ми використовуємо цю команду для обміну даними з OpenStack. .PP Коли virt\-v2v працюватиме у базовій системі перетворення, вам слід вказати назву або UUID цієї базової системи перетворення virt\-v2v. Приклад: .PP .Vb 6 \& $ openstack server list \& +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-+ \& | ID | Name | Status | \& +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-+ \& | bbb0147a\-44b9\-4d19\-9a9d\-10ca9a984744 | test1 | ACTIVE | \& +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-+ \& \& # virt\-v2v [...] \e \& \-o openstack \-oo server\-id=bbb0147a\-44b9\-4d19\-9a9d\-10ca9a984744 .Ve .PP або: .PP .Vb 1 \& # virt\-v2v [...] \-o openstack \-oo server\-id=test1 .Ve .PP Якщо потрібно, ви можете запустити декілька паралельних перетворень у одній базовій системі перетворення, якщо у ній достатньо для цього ресурсів. Втім, сам OpenStack накладає обмеження, які слід враховувати: OpenStack не здатен долучати більше за приблизно 25 дисків [точна кількість залежить від конфігурації системи] до однієї базової системи. Це обмежує кількість гостьових систем, які можна перетворювати паралельно, оскільки на час копіювання кожен з дисків гостьової системи слід долучити до базової системи. .SS "OpenStack: Розпізнавання" .IX Subsection "OpenStack: Розпізнавання" Перетворювання до формату OpenStack потребує доступу до тимчасових (неадміністративних) точок доступу до програмного інтерфейсу. Вам доведеться або налаштувати ваші змінні середовища \f(CW\*(C`$OS_*\*(C'\fR, або скористатися параметрами виведення у рядку команди virt\-v2v для проходження розпізнавання на OpenStack. .PP Приклад: .PP .Vb 1 \& export OS_USERNAME=admin .Ve .PP або: .PP .Vb 1 \& virt\-v2v [...] \-o openstack \-oo os\-username=admin .Ve .PP дають той самий результат і працюють так само, як \fI\-\-os\-username\fR у рядку команди програмних інструментів OpenStack. .PP Normally there is a file called \fIovercloudrc\fR or \fIkeystonerc_admin\fR which you can simply \f(CW\*(C`source\*(C'\fR to set everything up. .PP If you need to copy \fIovercloudrc\fR to another machine, check if it references the \f(CW\*(C`OS_CLOUD\*(C'\fR environment variable. If so, you may have to copy the \fIclouds.yaml\fR file from \fI/etc/openstack/\fR or \fR\f(CI$HOME\fR\fI/.config/openstack/\fR to the other machine as well. See the section "CLOUD CONFIGURATION" in the openstack CLI manual. .SS "OpenStack: Запуск від імені root" .IX Subsection "OpenStack: Запуск від імені root" Оскільки virt\-v2v має отримувати доступ до томів Cinder, які представляються як пристрої \fI/dev\fR у базовій системі перетворення, зазвичай у режимі \fI\-o openstack\fR virt\-v2v слід запускати від імені користувача root. .PP Якщо ви використовуєте \f(CW\*(C`sudo\*(C'\fR для запуску virt\-v2v і використовуєте змінні середовища для розпізнавання, не забудьте скористатися параметром \f(CW\*(C`sudo \-E\*(C'\fR для того, щоб зберігати середовище. .SS "OpenStack: Ідентифікатор гостьової системи" .IX Subsection "OpenStack: Ідентифікатор гостьової системи" .Vb 1 \& virt\-v2v [...] \-o openstack \-oo guest\-id=123\-456\-7890 .Ve .PP Крім того, ви можете додатково вказати у рядку команди \fI\-oo guest\-id=...\fR. Цей ідентифікатор (який може бути довільним рядком) зберігається на кожному томі Cinder у властивості тому \f(CW\*(C`virt_v2v_guest_id\*(C'\fR. .PP Цим можна скористатися для пошуку дисків, які пов'язано із гостьовою системою, або встановлення взаємної відповідності дисків із гостьовими системами при одночасному перетворенні декількох гостьових систем. .SS "OpenStack: Ігнорування сертифіката сервера" .IX Subsection "OpenStack: Ігнорування сертифіката сервера" За допомогою \fI\-oo verify\-server\-certificate=false\fR ви можете повідомити клієнту openstack про те, що слід ігнорувати сертифікат сервера при з'єднанні із кінцевими точками програмного інтерфейсу OpenStack. Це матиме такі самі наслідки, як додавання параметра \fI\-\-insecure\fR до команди \f(CW\*(C`openstack\*(C'\fR. .SS "OpenStack: Перетворення гостьової системи" .IX Subsection "OpenStack: Перетворення гостьової системи" Остаточною командою для перетворення гостьової системи, яку слід віддавати від імені користувача root, є такою: .PP .Vb 2 \& # virt\-v2v [\-i параметри ...] \e \& \-o openstack \-oo server\-id=НАЗВА|UUID [\-oo guest\-id=ІДЕНТИФІКАТОР] .Ve .PP Якщо ви хочете включити параметри розпізнавання до рядка команди, команда буде такою: .PP .Vb 2 \& # virt\-v2v [\-i параметри ...] \e \& \-o openstack \-oo server\-id=НАЗВА|UUID \-oo os\-username=admin [тощо] .Ve .SS "OpenStack: Завантаження гостьової системи" .IX Subsection "OpenStack: Завантаження гостьової системи" Гостьові системи перетворюються як томи Cinder (один том на диск початкової гостьової системи). Щоб завантажити з них систему, скористайтеся параметром \f(CW\*(C`openstack server create \-\-volume\*(C'\fR: .PP .Vb 11 \& $ openstack volume list \& +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-+ \& | ID | Name | Status | \& +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-+ \& | c4d06d15\-22ef\-462e\-9eff\-ab54ab285a1f | fedora\-27\-sda | available | \& +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-+ \& $ openstack server create \e \& \-\-flavor x1.small \e \& \-\-volume c4d06d15\-22ef\-462e\-9eff\-ab54ab285a1f \e \& myguest \& $ openstack console url show myguest .Ve .SS "OpenStack: Інші параметри перетворення" .IX Subsection "OpenStack: Інші параметри перетворення" Для визначення типу тому Cinder скористайтеся параметром \fI\-os\fR. Якщо параметр не буде вказано, припускатиметься, що немає ніякого типу тому Cinder. .PP Підтримки таких параметрів для OpenStack \fBне\fR передбачено: \fI\-oa\fR, \fI\-of\fR. .SH "ВИВЕДЕННЯ ДО GLANCE" .IX Header "ВИВЕДЕННЯ ДО GLANCE" Зауважте, що цей варіант вважається застарілим. У більшості випадків вам слід використовувати "ВИВЕДЕННЯ ДО OPENSTACK". .PP Щоб вивести дані до OpenStack Glance, скористайтеся параметром \fI\-o glance\fR. .PP This runs the \fBglance\fR\|(1) CLI program which must be installed on the virt\-v2v conversion host. For authentication to work, you will need to set \f(CW\*(C`OS_*\*(C'\fR environment variables. See "OpenStack: Authentication" above. .PP Virt\-v2v додає метадані щодо гостьової системи до Glance, описуючи такі речі, як назва гостьової операційної системи і список потрібних їй драйверів. Команда \f(CW\*(C`glance image\-show\*(C'\fR покаже метадані як поля «Property», зокрема \f(CW\*(C`os_type\*(C'\fR і \f(CW\*(C`hw_disk_bus\*(C'\fR. .SS "Glance і розрідженість" .IX Subsection "Glance і розрідженість" Засоби вивантаження образів до Glance неправильно працюють із розрідженістю. З цієї причини, використання qcow2 буде швидшим і потребуватиме менше місця на сервері Glance. Скористайтеся параметром virt\-v2v \fI\-of\ qcow2\fR. .SS "Glance і робота з декількома дисками" .IX Subsection "Glance і робота з декількома дисками" Якщо у гостьовій системі єдиний диск, назва цього диску у Glance буде назвою гостьової системи. Керувати назвою можна за допомогою параметра \fI\-on\fR. .PP У Glance не передбачено прив'язки декількох дисків до однієї гостьової системи, у Nova також заборонено завантаження гостьової системи з декількох дисків Glance. Якщо у гостьовій системі декілька дисків, перший (який вважається системним диском) називатиметься так, як і гостьова система, другий і наступні диски із даними називатимуться \f(CW\*(C`\fR\f(CIназва_гостьової_системи\fR\f(CW\-disk2\*(C'\fR, \f(CW\*(C`\fR\f(CIназва_гостьової_системи\fR\f(CW\-disk3\*(C'\fR тощо. Ймовірно, найкраще лишити системний диск у Glance, а важливі диски із даними передати до Cinder. .SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ" .IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ" \&\fBvirt\-v2v\fR\|(1), https://docs.openstack.org/python\-openstackclient/latest/cli/man/openstack.html, \fBglance\fR\|(1). .SH АВТОР .IX Header "АВТОР" Richard W.M. Jones .SH "АВТОРСЬКІ ПРАВА" .IX Header "АВТОРСЬКІ ПРАВА" © Red Hat Inc., 2009–2020 .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.