VMX: Гостьову систему слід вимкнути¶

The guest must be shut down before conversion starts. Because the -i vmx method works directly against the storage, checking for concurrent access is not possible. See also "The guest should not be running" in virt-v2v(1).

VMX: Доступ до сховища, у якому містяться файли VMX і VMDK¶

Якщо файли vmx і vmdk не доступні локально, вам слід або змонтувати сховище даних NFS на сервері перетворення або уможливити безпарольний доступ SSH на гіпервізорі ESXi.

VMX: Розпізнавання за допомогою SSH

Ви можете скористатися розпізнаванням за допомогою SSH за паролем, вказавши назву файла, який містить пароль, як аргумент параметра -ip (зауважте, що цей параметр не приймає пароль безпосередньо). Вам слід скоригувати /etc/ssh/sshd_config на сервері VMware, встановивши "PasswordAuthentication yes".

Якщо ви не використовуєте розпізнавання за паролем, альтернативою є використання ssh-agent і додавання вашого відкритого ключа ssh до /etc/ssh/keys-root/authorized_keys (у гіпервізорі ESXi). Після виконання цих дій вам слід перевірити, чи працює доступ без пароля з сервера virt-v2v до гіпервізора ESXi. Приклад:

 $ ssh root@esxi.example.com
 [ журналювання безпосередньо до оболонки, пароль не потрібен ]

Зауважте, що підтримка неінтерактивного розпізнавання за допомогою параметра -ip є неповною. Деякі дії все ще вимагають від користувача введення пароля вручну. Тому рекомендуємо скористатися ssh-agent замість параметра -ip. Див. https://bugzilla.redhat.com/1854275.

VMX: побудова адреси SSH

При використанні вхідного каналу передавання даних SSH вам слід вказати віддалену адресу "ssh://...", яка вказуватиме на файл VMX. Типова адреса виглядає так:

 ssh://root@esxi.example.com/vmfs/volumes/datastore1/my%20guest/my%20guest.vmx

Ім'я користувача можна не вказувати, якщо воно збігається із назвою вашого локального облікового запису користувача.

Крім того, ви можете вказати номер порту після назви вузла, якщо сервер SSH працює на нетиповому порту (не на порту 22).

Щоб визначити компонент шляху адреси, увійдіть на сервер ESXi за допомогою SSH інтерактивно і визначте абсолютний шлях до файла VMX на сервері ESXi, приклад:

 /vmfs/volumes/datastore1/my guest/my guest.vmx

Згодом у командному рядку virt-v2v закодуйте з використанням відсоток-кодування будь-які зарезервовані символи, які ви знайдете в окремих компонентах шляху. Наприклад, слід вказувати як %20:

 /vmfs/volumes/datastore1/my%20guest/my%20guest.vmx

Див. https://bugzilla.redhat.com/1938954.

VMX: Імпортування гостьової системи¶

Щоб імпортувати файл vmx з локального файла або NFS, віддайте таку команду:

 $ virt-v2v -i vmx guest.vmx -o local -os /var/tmp

Щоб імпортувати файл vmx за допомогою SSH, додайте -it ssh, щоб вибрати канал передавання даних SSH і вказати віддалену адресу SSH:

 $ virt-v2v \
     -i vmx -it ssh \
     "ssh://root@esxi.example.com/vmfs/volumes/datastore1/guest/guest.vmx" \
     -o local -os /var/tmp

Virt-v2v обробляє файл vmx і використовує отримані дані для встановлення розташування усіх дисків vmdk.

VDDK: Попередні вимоги¶

1.

Оскільки бібліотека VDDK не є вільним програмним забезпеченням, а умови ліцензування на бібліотеку не дозволяють її повторного розповсюдження або комерційного використання, вам доведеться отримати VDDK самостійно і переконатися, що її використання не порушує умов ліцензування.

2.

Рекомендуємо скористатися nbdkit ≥ 1.6, оскільки ці версії постачаються із безумовно увімкненим додатком VDDK.

3.

Імпортування VDDK потребує можливості, яку було додано у libvirt ≥ 3.7.

4.

Сервер VMware не повинен перебувати у режимі супроводу.

VDDK: Обмеження пам'яті для служби NFC ESXi¶

У докладному журналі буде наведено повідомлення щодо помилок, подібні до такого:

 nbdkit: vddk[3]: error: [NFC ERROR] NfcFssrvrProcessErrorMsg:
 received NFC error 5 from server: Failed to allocate the
 requested 2097176 bytes

Така ситуація є типовою, якщо із сервером VMware відкрито декілька паралельних з'єднань.

Такі з'єднання можуть призвести до перевищення обмежень на використання ресурсів, встановлених на сервері VMware. Ви можете зменшити строгість обмежень для служби NFC редагуванням файла /etc/vmware/hostd/config.xml, змінивши у ньому значення параметра "<maxMemory>":

 <nfcsvc>
   <path>libnfcsvc.so</path>
   <enabled>true</enabled>
   <maxMemory>50331648</maxMemory>
   <maxStreamMemory>10485760</maxStreamMemory>
 </nfcsvc>

із наступним перезапуском служби "hostd":

 # /etc/init.d/hostd restart

Докладніший опис можна знайти тут: https://bugzilla.redhat.com/1614276.

VDDK: "error: VixDiskLibVim: Failed to open disk using NFC. VixError 1"¶

Якщо ви бачите повідомлення про помилку, подібне до такого:

 nbdkit: vddk[2]: error: VixDiskLibVim: Failed to open disk using NFC. VixError 1 at 1166.

тоді причиною є вада у VDDK ≤ 6.7. Пропонуємо позбутися її встановленням найсвіжішої версії VDDK. Див. також https://bugzilla.redhat.com/1684075

VDDK: АДРЕСА¶

Побудуйте правильну адресу "vpx://" (для vCenter) або "esx://" (для ESXi). Вона виглядає якось так:

 vpx://root@vcenter.example.com/Datacenter/esxi
 esx://root@esxi.example.com

Щоб перевірити, що у вас правильна адреса, скористайтеся командою virsh(1) для отримання списку гостьових систем на сервері vCenter, ось так:

 $ virsh -c 'vpx://root@vcenter.example.com/Datacenter/esxi' list --all
 Введіть пароль root до vcenter.example.com: ***
 
  Id    Name                           State
 ----------------------------------------------------
  -     Fedora 20                      shut off
  -     Windows 2003                   shut off

Якщо ви отримуєте повідомлення про помилку «Сертифікат вузла не може бути уповноважено за допомогою вказаних сертифікатів CA» або подібне, ви можете або імпортувати сертифікат вузла vCenter, або обійти перевірку підписів додаванням прапорця "?no_verify=1":

 $ virsh -c 'vpx://root@vcenter.example.com/Datacenter/esxi?no_verify=1' list --all

Крім того, вам слід спробувати створити дамп метаданих з будь-якої гостьової системи на вашому сервері, ось так:

 $ virsh -c 'vpx://root@vcenter.example.com/Datacenter/esxi' dumpxml "Windows 2003"
 <domain type='vmware'>
   <name>Windows 2003</name>
   [...]
   <vmware:moref>vm-123</vmware:moref>
 </domain>

Якщо у метаданих немає "<vmware:moref>", вам слід оновити libvirt.

Якщо наведені вище команди не дають бажаного результату, virt-v2v також не працюватиме. Перш ніж продовжувати, виправте вашу адресу і/або сервера vCenter VMware.

VDDK: Імпортування гостьової системи¶

Параметр -it vddk визначає VDDK як вхідний канал передавання даних для дисків.

To import a particular guest from vCenter server or ESXi hypervisor, use a command like the following, substituting the URI and guest name:

 $ virt-v2v \
     -ic 'vpx://root@vcenter.example.com/Datacenter/esxi?no_verify=1' \
     -it vddk \
     -io vddk-libdir=/path/to/vmware-vix-disklib-distrib \
     "Windows 2003" \
     -o local -os /var/tmp

Other options that you might need to add in rare circumstances include -io vddk-compression, -io vddk-config, -io vddk-cookie, -io vddk-file, -io vddk-nfchostport, -io vddk-port, -io vddk-snapshot, -io vddk-thumbprint and -io vddk-transports, which are all explained in the nbdkit-vddk-plugin(1) documentation. Do not use these options unless you know what you are doing.

VDDK: Thumbprint¶

You may specify the thumbprint of the VMware server using the -io vddk-thumbprint=XX:XX... parameter. Doing so increases security against some man-in-the-middle attacks.

Since virt-v2v 2.10, this parameter is not required. Virt-v2v will get the thumbprint from the server if it is not specified (but the openssl(1) command must be installed for this to work).

VDDK: Діагностування помилок VDDK¶

З бібліотекою VDDK можна працювати у режимі докладних повідомлень, у якому бібліотека (дуже) докладно повідомляє про свої дії. Скористайтеся командою «virt-v2v -v -x» у звичний спосіб, щоб увімкнути режим докладних повідомлень.

VDDK: повільне імпортування і повторювані повідомлення NBD_ClientOpen¶

Якщо імпортування за допомогою VDDK є повільними, а у відповідь на «virt-v2v -v -x» система показує багато повідомлень "NBD_ClientOpen", ви зіткнулися із видимою вадою у VDDK 6.7 (https://bugzilla.redhat.com/1901489). Оновлення до VDDK 7 має усунути причину вади.

OVA: Створення OVA¶

Щоб створити OVA у vSphere, скористайтеся параметром «Export OVF Template» (з контекстного меню віртуальної машини або з меню «File»). Можна вибрати варіант «Folder of files» (OVF) або «Single file» (OVA), втім, працювати з OVA, ймовірно простіше. Файли OVA є просто стиснутими файлами tar, тому ви можете користуватися командами, подібними до "tar tf VM.ova", для перегляду їхнього вмісту.

Створення OVA за допомогою ovftool

Ви також можете скористатися пропрієтарною програмою "ovftool" з VMware:

 ovftool --noSSLVerify \
   vi://КОРИСТУВАЧ:ПАРОЛЬ@esxi.example.com/VM \
   VM.ova

Для встановлення з'єднання із vCenter:

 ovftool  --noSSLVerify \
   vi://КОРИСТУВАЧ:ПАРОЛЬ@vcenter.example.com/НАЗВА-ДАТАЦЕНТРУ/vm/VM \
   VM.ova

Для проходження розпізнавання Active Directory з використанням назв записів нижнього рівня ("ДОМЕН\КОРИСТУВАЧ") вам слід замінити символ "\" його шістнадцятковим кодом у ascii — (%5c):

 vi://ДОМЕН%5cКОРИСТУВАЧ:ПАРОЛЬ@...

OVA: Імпортування гостьової системи¶

Щоб імпортувати файл OVA із назвою VM.ova, віддайте таку команду:

 $ virt-v2v -i ova VM.ova -o local -os /var/tmp

Якщо ви експортували гостьову систему як «Folder of files» (теку з файлами), або якщо ви розпакували власноруч архів tar OVA, ви можете вказати virt-v2v каталог, у якому містяться файли:

 $ virt-v2v -i ova /шлях/до/файлів -o local -os /var/tmp

OVA: Permissions issues with oVirt import¶

oVirt provides a graphical user interface for importing from OVA files which uses this method. It requires that oVirt is able to access the OVA file which can be a problem if the file is owned by root (oVirt runs as a non-root user).

Пропонованим обхідним маневром є копіювання OVA до загальнодоступного каталогу, зокрема /var/tmp, до виконання імпортування і, можливо, змінити користувача і групу власника файла.

Докладніші відомості за цими посиланнями:

• https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html-single/virtual_machine_management_guide/index#Importing_a_virtual_machine_from_a_host
• https://bugzilla.redhat.com/show_bug.cgi?id=2039597

vCenter: АДРЕСА¶

Адреса libvirt сервера vCenter виглядає десь так:

 vpx://користувач@сервер/Datacenter/esxi

де

"користувач@"

є необов'язковим, але рекомендованим записом користувача, для якого слід встановити з'єднання.

Якщо ім'я користувача містить символ зворотної похилої риски (наприклад "DOMAIN\USER"), вам доведеться скористатися маскуванням символу у адресі за допомогою послідовності %5c: "DOMAIN%5cUSER" (5c — шістнадцятковий код ASCII символу зворотної похилої риски). Ймовірно, інші символи пунктуації також доведеться маскувати.

Пароль користувача має бути надано у локальному файлів за допомогою параметра -ip.

"server"

це сервер vCenter (не гіпервізор).

"Datacenter"

це назва датацентру.

Якщо у назві міститься пробіл, замініть його екранованим кодом адрес, %20.

"esxi"

назва гіпервізору ESXi, на якому запущено гостьову систему.

Якщо при розгортанні VMware використано підтеки, може виникнути потреба у додаванні їх до адреси. Приклад:

 vpx://користувач@сервер/Тека/Датацентр/esxi

Повний опис адрес libvirt наведено тут: http://libvirt.org/drvesx.html

Типовими помилками, про які повідомляє libvirt / virsh, якщо адреса є помилковою, є такі:

• Не вдалося знайти датацентр, вказаний у «...»
• Не вдалося знайти обчислювальний ресурс, вказаний у «...»
• Шлях «...» не визначає обчислювального ресурсу
• Шлях «...» не визначає основну систему
• Не вдалося знайти основну систему, вказану у «...»

vCenter: Перевірка з'єднання libvirt з vCenter¶

Скористайтеся командою virsh(1) для отримання списку гостьових систем на сервері vCenter, ось так:

 $ virsh -c 'vpx://root@vcenter.example.com/Datacenter/esxi' list --all
 Введіть пароль root до vcenter.example.com: ***
 
  Id    Name                           State
 ----------------------------------------------------
  -     Fedora 20                      shut off
  -     Windows 2003                   shut off

Якщо ви отримуєте повідомлення про помилку «Сертифікат вузла не може бути уповноважено за допомогою вказаних сертифікатів CA» або подібне, ви можете або імпортувати сертифікат вузла vCenter, або обійти перевірку підписів додаванням прапорця "?no_verify=1":

 $ virsh -c 'vpx://root@vcenter.example.com/Datacenter/esxi?no_verify=1' list --all

Крім того, вам слід спробувати створити дамп метаданих з будь-якої гостьової системи на вашому сервері, ось так:

 $ virsh -c 'vpx://root@vcenter.example.com/Datacenter/esxi' dumpxml "Windows 2003"
 <domain type='vmware'>
   <name>Windows 2003</name>
   [...]
 </domain>

Якщо наведені вище команди не дають бажаного результату, virt-v2v також не працюватиме. Перш ніж продовжувати, виправте ваші налаштування libvirt і/або сервера vCenter VMware.

vCenter: надання пароля¶

Пароль vCenter (зазвичай для облікового запису root або облікового запису, який визначено "user@" в адресі vpx) має бути записано до локального файла, і назву цього файла вказано у рядку команди virt-v2v за допомогою параметра -ip файл_пароля.

vCenter: Імпортування гостьової системи¶

Щоб імпортувати певну гостьову систему з сервера vCenter, віддайте таку команду:

 $ virt-v2v -ic 'vpx://root@vcenter.example.com/Datacenter/esxi?no_verify=1' \
      -ip файл_пароля \
      "Windows 2003" \
   -o local -os /var/tmp

де "Windows 2003" — назва гостьової системи (яку має бути вимкнено).

У цьому випадку прапорці виведення встановлено так, щоб перетворена гостьова система записувалася до тимчасового каталогу, оскільки це лише приклад, але ви також можете записати перетворену систему до libvirt або будь-якого іншого підтримуваного призначення.

vCenter: Неадміністративна роль¶

Замість використання ролі адміністратора vCenter, ви можете створити нетипову неадміністративну роль для виконання перетворення. Втім, вам доведеться увімкнути такі права доступу (або, доки це буде доступним, старіші версії VMware, де не було деяких з цих параметрів):

1.

Створіть нетипову роль у vCenter.

2.

Увімкніть (позначте) такі об'єкти:

 Datastore:
  - Browse datastore
  - Low level file operations
 
 Sessions:
  - Validate session
 
 Віртуальна машина:
   Взаємодія:
     - Керування гостьовими віртуальними машинами за допомогою програмного інтерфейсу VIX
   Приготування:
     - Дозволити доступ до дисків
     - Дозволити доступ до дисків лише для читання
     - Дозволити отримання віртуальної машини
 
 Криптографічні дії:
  - Розшифрування
  - Безпосередній доступ
    

vCenter: Параметри брандмауера і проксі¶

vCenter: Порти

Якщо між сервером перетворення virt-v2v і сервером vCenter працює брандмауер, вам потрібно відкрити у ньому порт 443 (https) і порт 5480.

Порт 443 використовується для копіювання образів дисків гостьової системи. Порт 5480 використовується для опитування vCenter щодо метаданих гостьової системи.

Це лише типові номери портів. Ви можете змінити налаштування vCenter так, щоб використовувалися порти із іншими номерами. У цьому випадку вам слід вказати ці порти у адресі "vpx://". Див. "vCenter: АДРЕСА" вище.

Ці порти стосуються лише перетворень virt-v2v. Ви можете відкрити інші порти для користування іншими можливостями vCenter, наприклад для інтернет-інтерфейсу користувача. Відповідні номери для vCenter наведено у інтернет-документації до VMware.

 ┌────────────┐   порт 443 ┌────────────┐        ┌────────────┐
 │   сервер   │────────────▶ сервер     │────────▶ гіпервізор │
 │перетворення│────────────▶ vCenter    │        │ ESXi       │
 │ virt-v2v   │  порт 5480 │            │        │   ┌─────┐  │
 └────────────┘            └────────────┘        │   │гість│  │
                                                 └───┴─────┴──┘

(На наведеній вище діаграмі стрілки показують напрям, у якому ініціюється з'єднання TCP, не обов'язково напрям передавання даних.)

Сама програма virt-v2v не з'єднується безпосередньо із гіпервізором ESXi, де міститься гостьова система. Втім, з гіпервізором з'єднується vCenter і переспрямовує дані, тому, якщо між vCenter і його гіпервізорами працює брандмауер (мережевий екран), ймовірно, вам слід відкрити у ньому додаткові порти (визначити їхні номери вам допоможе документація щодо VMware).

Під час перетворень з vCenter пов'язані із проксі-сервером змінні середовища ("https_proxy", "all_proxy", "no_proxy", "HTTPS_PROXY", "ALL_PROXY" і "NO_PROXY") буде проігноровано.

vCenter: Проблеми із сертифікатами SSL/TLS¶

Ви можете побачити таке повідомлення про помилку:

  CURL: Error opening file: SSL: no alternative certificate subject
  name matches target host name

(Щоб побачити це повідомлення, вам слід увімкнути діагностичні повідомлення за допомогою команди «virt-v2v -v -x».)

Причиною може бути використання IP-адреси замість повноцінної назви у домені DNS для сервера vCenter, тобто використання "vpx://vcenter.example.com/..." замість, скажімо, "vpx://11.22.33.44/..."

Ще однією причиною проблем із сертифікатами може бути те, що FQDN сервера vCenter не відповідає IP-адресі, наприклад, якщо сервер отримав нову IP-адресу з DHCP. Щоб усунути цю проблему, вам слід змінити налаштування вашого сервера DHCP або мережі так, щоб сервер vCenter завжди отримував незмінну IP-адресу. Після цього, увійдіть до консолі адміністрування сервера vCenter за адресою "https://vcenter:5480/". На вкладці "Admin" позначте пункт "Certificate regeneration enabled" і перезавантажте сервер.

vCenter: "Out of HTTP sessions: Limited to ..."¶

Здається, vCenter VMware обмежує кількість сеансів HTTP і за певних обставин virt-v2v може перевищувати це значення. Ви можете скоригувати або вилучити обмеження редагуванням файла /etc/vmware-vpx/vpxd.cfg на сервері vCenter. Збільште значення поля "<maxSessionCount>" або встановіть значення 0, щоб зняти обмеження:

 <soap>
   <maxSessionCount>0</maxSessionCount>
 </soap>