.\" Automatically generated by Podwrapper::Man 2.2.0 (Pod::Simple 3.43) .\" .\" 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-v2v-output-rhv 1" .TH virt-v2v-output-rhv 1 "2023-01-10" "virt-v2v-2.2.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\-rhv — використання virt\-v2v для перетворення гостьових систем із виведенням даних до oVirt або \s-1RHV\s0 .SH "КОРОТКИЙ ОПИС" .IX Header "КОРОТКИЙ ОПИС" .Vb 7 \& virt\-v2v [\-i* options] \-o rhv\-upload [\-oc ENGINE_URL] \-os STORAGE \& [\-op PASSWORD] [\-of raw] \& [\-oo rhv\-cafile=FILE] \& [\-oo rhv\-cluster=CLUSTER] \& [\-oo rhv\-proxy] \& [\-oo rhv\-disk\-uuid=UUID ...] \& [\-oo rhv\-verifypeer] \& \& virt\-v2v [параметри \-i*] \-o rhv \-os [esd:/шлях|/шлях] \& \& virt\-v2v [параметри \-i*] \-o vdsm \& [\-oo vdsm\-image\-uuid=UUID] \& [\-oo vdsm\-vol\-uuid=UUID] \& [\-oo vdsm\-vm\-uuid=UUID] \& [\-oo vdsm\-ovf\-output=КАТАЛОГ] .Ve .SH "ОПИС" .IX Header "ОПИС" На цій сторінці наведено документацію щодо використання \fBvirt\-v2v\fR\|(1) для перетворення гостьових систем на керований екземпляр системи oVirt або \s-1RHV.\s0 Передбачено три режими виведення даних, одним з яких ви можете скористатися, але, зазвичай, слід користуватися лише \fI\-o rhv-upload\fR. Два інших режими вважаються застарілими: .IP "\fB\-o rhv-upload\fR \fB\-os\fR СХОВИЩЕ" 4 .IX Item "-o rhv-upload -os СХОВИЩЕ" Повний опис: \*(L"ВИВЕДЕННЯ ДО \s-1RHV\*(R"\s0 .Sp Це сучасний метод вивантаження до oVirt/RHV за допомогою програмного інтерфейсу \s-1REST.\s0 Потребує oVirt/RHV ≥ 4.2. .IP "\fB\-o rhv\fR \fB\-os\fR esd:/шлях" 4 .IX Item "-o rhv -os esd:/шлях" .PD 0 .IP "\fB\-o rhv\fR \fB\-os\fR /шлях" 4 .IX Item "-o rhv -os /шлях" .PD Повний опис: \*(L"ВИВЕДЕННЯ ДО ДОМЕНУ СХОВИЩА ЕКСПОРТУВАННЯ\*(R" .Sp Це застарілий метод вивантаження даних до oVirt/RHV за допомогою домену сховища експортування (\s-1ESD\s0). Доступ до \s-1ESD\s0 можна здійснювати або за допомогою \s-1NFS\s0 (використовуючи формат \fI\-os esd:/шлях\fR), або, якщо сховище у вас вже змонтовано за допомогою \s-1NFS,\s0 визначенням шляху до точки монтування як \fI\-os /шлях\fR. .Sp Домен сховища експортування вважається застарілим з часу oVirt 4, тому у певний момент у майбутньому цей спосіб вже не працюватиме. .IP "\fB\-o vdsm\fR" 4 .IX Item "-o vdsm" Це застарілий метод, який використовувався на внутрішньому рівні інтерфейсом користувача RHV-M. Його використання ніколи не призначалося для кінцевих користувачів. .SH "ВИВЕДЕННЯ ДО RHV" .IX Header "ВИВЕДЕННЯ ДО RHV" Це новий метод вивантаження гостьових систем до oVirt або \s-1RHV\s0 безпосередньо за допомогою програмного інтерфейсу \s-1REST,\s0 потребує oVirt/RHV ≥ 4.2. .PP Вам слід вказати \fI\-o rhv-upload\fR, а також такі додаткові параметри: .ie n .IP "\fI\-oc\fR ""https://ovirt\-engine.example.com/ovirt\-engine/api""" 4 .el .IP "\fI\-oc\fR \f(CWhttps://ovirt\-engine.example.com/ovirt\-engine/api\fR" 4 .IX Item "-oc https://ovirt-engine.example.com/ovirt-engine/api" Адреса програмного інтерфейсу \s-1REST,\s0 яка, зазвичай, складається із назви сервера із дописуванням рядка \f(CW\*(C`/ovirt\-engine/api\*(C'\fR, але може бути іншою, якщо ви вибрали інший каталог для встановлення рушія oVirt. .Sp Крім того, ви можете додати до адреси ім'я користувача і порт. Якщо ім'я користувача не вказано, virt\-v2v типово використовуватиме комбінацію \f(CW\*(C`admin@internal\*(C'\fR, яка задає типові параметри облікового запису суперкористувача для екземплярів систем oVirt. .IP "\fI\-of raw\fR" 4 .IX Item "-of raw" У поточній версії, вам слід використовувати \fI\-of raw\fR, і ви не можете використовувати \fI\-oa preallocated\fR. .Sp Ці обмеження буде знято у майбутніх версіях. .IP "\fI\-op\fR \fIфайл\-пароля\fR" 4 .IX Item "-op файл-пароля" Файл, який містить пароль, яким слід скористатися для з'єднання із рушієм oVirt. Зауважте, що файл має містити увесь пароль, \fBбез завершального символу нового рядка\fR, і, з міркувань безпеки, для файла має бути встановлено режим доступу \f(CW0600\fR, щоб інші користувачі не змогли його читати. .ie n .IP "\fI\-os\fR ""дані\-ovirt""" 4 .el .IP "\fI\-os\fR \f(CWдані\-ovirt\fR" 4 .IX Item "-os дані-ovirt" Домен сховища. .IP "\fI\-oo rhv\-cafile=\fR\fIca.pem\fR" 4 .IX Item "-oo rhv-cafile=ca.pem" Файл \fIca.pem\fR (служби сертифікації), скопійований з \fI/etc/pki/ovirt\-engine/ca.pem\fR у рушії oVirt. .Sp Якщо увімкнено \fI\-oo rhv-verifypeer\fR, цим параметром можна скористатися для керування тим, яка служба сертифікації використовуватиметься для перевірки ідентичності клієнта. Якщо цей параметр не використано, буде використано загальносистемне сховище довірених сертифікатів. .ie n .IP "\fI\-oo rhv\-cluster=\fR""НАЗВА_КЛАСТЕРА""" 4 .el .IP "\fI\-oo rhv\-cluster=\fR\f(CWНАЗВА_КЛАСТЕРА\fR" 4 .IX Item "-oo rhv-cluster=НАЗВА_КЛАСТЕРА" Встановити назву кластера \s-1RHV.\s0 Якщо не вказано, буде використано назву \f(CW\*(C`Default\*(C'\fR. .ie n .IP "\fI\-oo rhv\-disk\-uuid=\fR""UUID""" 4 .el .IP "\fI\-oo rhv\-disk\-uuid=\fR\f(CWUUID\fR" 4 .IX Item "-oo rhv-disk-uuid=UUID" Цим параметром можна скористатися для визначення \s-1UUID\s0 вручну для дисків при створенні віртуальної машини. Якщо не вказано, рушій oVirt створить випадкові \s-1UUID\s0 для дисків. Будь ласка, зауважте, що: .RS 4 .IP "\(bu" 4 вам \fBслід\fR передати стільки параметрів \fI\-oo rhv\-disk\-uuid=UUID\fR, скільки дисків є у гостьовій системі; .IP "\(bu" 4 the specified UUIDs must not conflict with the UUIDs of existing disks .RE .RS 4 .RE .IP "\fI\-oo rhv-proxy\fR" 4 .IX Item "-oo rhv-proxy" Proxy the upload through oVirt Engine. This is slower than uploading directly to the oVirt node but may be necessary if you do not have direct network access to the nodes. .IP "\fI\-oo rhv-verifypeer\fR" 4 .IX Item "-oo rhv-verifypeer" Перевірити автентичність сервера oVirt/RHV шляхом перевірки сертифіката сервера за допомогою служби сертифікації. .SH "ВИВЕДЕННЯ ДО ДОМЕНУ СХОВИЩА ЕКСПОРТУВАННЯ" .IX Header "ВИВЕДЕННЯ ДО ДОМЕНУ СХОВИЩА ЕКСПОРТУВАННЯ" Вміст цього розділу стосується лише режиму виведення \fI\-o rhv\fR. Якщо ви використовуєте virt\-v2v з інтерфейсу користувача RHV-M, за сценою імпортування керується \s-1VDSM\s0 з використанням режиму виведення \fI\-o vdsm\fR (режиму, яким кінцеві користувачі не повинні користуватися безпосередньо). .PP Вам слід вказати \fI\-o rhv\fR і параметр \fI\-os\fR, який вказує на домен сховища експортування RHV-M. Ви можете або вказати сервер \s-1NFS\s0 і точку монтування, наприклад \f(CW\*(C`\-os rhv\-storage:/rhv/export\*(C'\fR, або можете спочатку змонтувати домен і вказати каталог, до якого його змонтовано, наприклад \f(CW\*(C`\-os /tmp/mnt\*(C'\fR. Будьте обережні: не слід вказувати домен сховища даних (Data Storage Domain), оскільки це не спрацює. .PP Якщо усі дії вдасться виконати успішно, virt\-v2v запише нову гостьову систему до домену сховища експортування, але ця система ще не буде готова до запуску. Перш ніж нею можна буде скористатися, її слід імпортувати до \s-1RHV\s0 за допомогою інтерфейсу користувача. .PP У \s-1RHV\s0 ≥ 2.2 зробити це можна за допомогою вкладки «Storage» («Сховище»). Виберіть домен експортування, до якого було записано гостьову систему. У відповідь під списком доменів збереження буде показано панель із декількома вкладками, одна з яких називатиметься «VM Import». У списку буде пункт перетвореної гостьової системи. Позначте його і натисніть кнопку «Import». Докладніший опис можна знайти у документації з \s-1RHV.\s0 .PP Якщо ви експортуєте декілька гостьових систем, потім ви зможете усі їх імпортувати одночасно за допомогою інтерфейсу користувача. .SS "Тестування перетворених даних \s-1RHV\s0" .IX Subsection "Тестування перетворених даних RHV" Якщо у вас немає екземпляра oVirt або \s-1RHV\s0 для тестування, ви можете виконати тестування перетворення, створивши структуру каталогів, яка подібна до структури каталогів домену сховища експортування RHV-M, щоб «надурити» virt\-v2v: .PP .Vb 8 \& uuid=\`uuidgen\` \& mkdir /tmp/rhv \& mkdir /tmp/rhv/$uuid \& mkdir /tmp/rhv/$uuid/images \& mkdir /tmp/rhv/$uuid/master \& mkdir /tmp/rhv/$uuid/master/vms \& touch /tmp/rhv/$uuid/dom_md \& virt\-v2v [...] \-o rhv \-os /tmp/rhv .Ve .SS "Діагностування помилок імпортування RHV-M" .IX Subsection "Діагностування помилок імпортування RHV-M" Коли ви експортуєте дані до домену сховища експортування RHV-M, а потім імпортуєте гостьову систему за допомогою інтерфейсу користувача RHV-M, ви можете зіткнутися із помилками при імпортуванні. Діагностування причини цих помилок — справа дуже складна, оскільки, зазвичай, інтерфейс користувача приховує справжню причину помилки. .PP Цікавими з цієї точки зору є такі файли журналів: .IP "\fI/var/log/vdsm/import/\fR" 4 .IX Item "/var/log/vdsm/import/" У oVirt ≥ 4.1.0 \s-1VDSM\s0 зберігає файл журналу virt\-v2v у цьому каталозі протягом 30 днів. .Sp Цей каталог розташовано на вузлі, де виконується перетворення. Цей вузол можна вибрати за допомогою діалогового вікна імпортування або може бути знайдено за допомогою вкладки \f(CW\*(C`Events\*(C'\fR в адміністративному інтерфейсі oVirt. .IP "\fI/var/log/vdsm/vdsm.log\fR" 4 .IX Item "/var/log/vdsm/vdsm.log" Як і вище, цей файл зберігається на вузлі, де виконується перетворення. У ньому містяться докладні повідомлення про помилки, пов'язані із низькорівневими операціями, які виконує \s-1VDSM.\s0 Він корисний, якщо помилку було пов'язано не з virt\-v2v, а з \s-1VDSM.\s0 .IP "\fI/var/log/ovirt\-engine/engine.log\fR" 4 .IX Item "/var/log/ovirt-engine/engine.log" Цей файл журналу зберігається на сервері RHV-M. У цьому містяться докладніші дані щодо усіх помилок, які було пов'язано із графічним інтерфейсом користувача oVirt. .SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ" .IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ" \&\fBvirt\-v2v\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.