guestfs-testing —
тестування
libguestfs вручну, ви
можете
допомогти!
На цій
сторінці
наведено
настанови
щодо
тестування
libguestfs вручну. У
всіх
користувачів
бібліотеки
різні
комбінації
платформ,
обладнання
та
гостьових
систем,
тому таке
тестування
дуже
важливе.
Наперед
вдячні за
вашу
допомогу!
Тести,
позначені
символом
*
(зірочкою)
можуть
знищити
дані, якщо
ви не
будете
обережними.
Решта
тестів є
безпечними
— вони не
вносять
жодних
змін до
важливих
даних.
Для
виконання
цих
перевірок
потрібна libguestfs
≥ 1.22.
Повідомляти
про
виявлені
вади можна
за цим
посиланням:
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
або
надішліть
допис до
списку
листування
(можете
не
підписуватися
на список
листування,
якщо не
хочете.
Втім, для
непідписаних
користувачів
повідомлення
з'являються
у списку із
затримкою,
потрібною
на
модерацію.):
https://www.redhat.com/mailman/listinfo/libguestfs
Віддайте
команду:
libguestfs-test-tool
Ця команда
виконує
дуже
просте і
неруйнівне
тестування
того, чи є libguestfs
працездатною
на
базовому
рівні.
Команду не
потрібно
віддавати
від імені
користувача
root.
Якщо
не
буде
виведено
рядок "===== TEST FINISHED OK
=====",
повідомте
про це, як
про ваду.
Дуже
важливим є
включення
до вашого
повідомлення
про ваду
повного,
нередагованого
масиву
виведених
даних "libguestfs-test-tool".
Див. розділ
"ВАДИ"
наприкінці
цієї
сторінки
підручника.
Якщо у
вашій
основній
системі
передбачено
апаратне
прискорення
віртуалізації,
із
«гарячим»
кешем libguestfs
повинна
запускатися
за
декілька
секунд.
Віддайте
вказану
нижче
команду
декілька
разів:
time guestfish -a /dev/null run
Протягом
циклу з
декількох
запусків
час має
стабілізуватися
на рівні
декількох
секунд
(менше 3
секунд на
швидкому
64-бітовому
обладнанні).
Якщо
вказана
вище
команда не
працюватиме,
скористайтеся
libguestfs-test-tool(1).
Ознайомтеся
із
виведеними
"libguestfs-test-tool"
даними і
перевірте:
- •
- Яка
версія libguestfs
використовується?
На початку
виведених
даних ви
побачите
такий
рядок:
library version: 1.22.0fedora=19,release=1.fc19,libvirt
- •
- Чи
використовується
libvirt?
Визначити
це можна,
пошукавши
модуль
обробки (backend):
guestfs_get_backend: direct
або:
guestfs_get_backend: libvirt
- •
- Яка
версія qemu
використовується?
Дані
версії
може бути
виведено
ось так:
libguestfs: qemu version 1.5
- •
- Яке ядро
використовується?
supermin(1)
намагається
використатися
найсвіжіше
ядро зі
встановлених
у вашій
системі. Ви
можете
побачити
дані щодо
версії у
виведенні
базової
системи.
Приклад:
[ 0.000000] Linux version 3.9.2-200.fc18.x86_64 [...]
Для цього
тесту
можна
скористатися
будь-яким
образом
диска
гостьової
системи. Не
забудьте
скористатися
параметром
"--ro", щоб
програма
guestfish(1)
відкрила
образ
диска у
режимі
лише
читання.
guestfish --ro -a /шлях/до/образу.диска -i
Якщо
команду
буде
успішно
виконано,
вона має
вивести
назву
гостьової
операційної
системи і
відкрити
для вас
запит щодо
команди guestfish
"><fs>". Ви
можете
скористатися
командами
guestfish,
подібними
до "ll /", щоб
зазирнути
всередину
образу
диска. Щоб
завершити
сеанс
дослідження
гостьової
системи,
введіть
команду "exit".
Якщо ви
отримуєте
повідомлення
про
помилку,
спробуйте
увімкнути
діагностику
(додати "-v"
до рядка
команди).
Також слід
переконатися,
що
програма
libguestfs-test-tool(1)
здатна
працювати.
Ймовірно,
вам також
доведеться
вимкнути libvirt
встановленням
такої
змінної
середовища:
export LIBGUESTFS_BACKEND=direct
Якщо у вас є
образ
диска,
Доступ до
якого
можна
отримати
за
допомогою
HTTP/FTP,
спробуйте
його
відкрити.
guestfish --ro -i --format=raw -a http://www.example.com/диск.img
Якщо
використовуватимете
SSH, вам слід
належним
чином
налаштувати
ssh-agent, щоб для
входу до
віддаленої
машини не
довелося
вводити
пароль.
Далі, має
спрацювати
команда,
подібна до
такої:
guestfish --ro -i --format=raw \
-a ssh://remote.example.com/шлях/до/диск.img
Якщо ви
отримуєте
повідомлення
про
помилку,
спробуйте
увімкнути
діагностику
(додати "-v"
до рядка
команди).
Також слід
переконатися,
що
програма
libguestfs-test-tool(1)
здатна
працювати.
Запустіть
virt-alignment-scan(1) на
гостьових
системах
або
образах
дисків:
virt-alignment-scan -a /шлях/до/образу
або:
virt-alignment-scan -d Guest
Чи
відповідає
звіт щодо
вирівнювання
справжньому
вирівнюванню
розділів
гостьової
системи?
virt-cat(1) може
показувати
файли у
гостьових
системах.
Для
гостьової
системи Linux
можете
спробувати
таку
команду:
virt-cat LinuxGuest /etc/passwd
Нещодавно
реалізованою
можливістю
є
підтримка
шляхів у Windows.
Приклад:
virt-cat WindowsGuest 'c:\windows\win.ini'
Ще
потрібнішими
будуть
результати,
якщо у вас є
гостьова
система Windows
із
декількома
дисками. Чи
працюють
як слід
шляхи "D:", "E:"
тощо?
virt-copy-in(1) може
рекурсивно
копіювати
файли і
каталоги
до
гостьової
системи
або образу
диска.
virt-copy-in -d Guest /etc /tmp
Ця команда
має
скопіювати
локальний
каталог
/etc
до
/tmp/etc у
гостьовій
системі
(рекурсивно).
Чи можете
ви бачити
усі
скопійовані
файли і
каталоги
після
завантаження
гостьової
системи?
Завершіть
роботу
гостьової
системи і
спробуйте
скопіювати
декілька
файлів і
каталогів:
virt-copy-in -d Guest /home /etc/issue /tmp
virt-copy-out(1) може
рекурсивно
копіювати
файли і
каталоги з
гостьової
системи
або образу
диска.
virt-copy-out -d Guest /home .
Зауважте,
що
завершальний
пробіл і
крапка у
команді не
є
друкарською
помилкою.
Це має
скопіювати
/home з
гостьової
системи до
поточного
каталогу.
virt-df(1) показує
список
даних щодо
простору
на диску.
Віддайте
команду:
virt-df
Ви можете
порівняти
результати
виконання
цієї
команди із
результатами
виконання
df(1)
всередині
гостьової
системи,
але з
урахуванням
декількох
особливостей:
- •
- Гостьова
система
має бути
бездіяльною.
- •
- Диски
гостьової
системи
має бути
синхронізовано
за
допомогою
sync(1).
- •
- Будь-яка
дія,
зокрема
завантаження
гостьової
системи,
призведе
до запису
файлів
журналу і
зміни
числових
даних.
Ми не
гарантуємо,
що числа
будуть
ідентичними
навіть з
урахуванням
цих
обставин.
Вони
можуть
бути
подібними.
Про ваду
свідчитиме
лише
суттєва
відмінність
у
показаних
числових
даних.
Віддайте
команду:
virt-df --csv > /tmp/report.csv
Тепер
спробуйте
завантажити
ці дані до
вашої
улюбленої
програми
для
керування
електронними
таблицями
або бази
даних. Чи
відтворюються
результати
відповідним
чином у
електронній
таблиці
або базі
даних?
http://www.postgresql.org/docs/8.1/static/sql-copy.html
http://dev.mysql.com/doc/refman/5.1/en/load-data.html
Програма
virt-edit(1) здатна
редагувати
файли
усередині
гостьових
систем.
Спробуйте
цю команду
на
гостьовій
системі RHEL
або Fedora:
virt-edit LinuxGuest /etc/sysconfig/network
У інших
гостьових
системах Linux
спробуйте
редагувати
інші файли,
наприклад
такі:
virt-edit LinuxGuest /etc/motd
Чи можна
побачити
зміни у
гостьовій
системі
після її
завантаження?
Програмою
virt-filesystems(1) можна
скористатися
для
перегляду
файлових
систем у
гостьовій
системі.
Спробуйте
цю команду
на
будь-якому
образі
диска або
гостьовій
системі:
virt-filesystems -a /шлях/до/образу --all --long -h
або:
virt-filesystems -d Guest --all --long -h
Чи
збігаються
результати
із тими, які
можна
бачити у
гостьовій
системі?
Скористайтеся
virt-inspector(1) для
отримання
звіту щодо
усіх ваших
гостьових
систем або
образів
дисків:
virt-inspector -a /шлях/до/образу | less
або:
virt-inspector -d Guest | less
Чи
відповідають
результати
тим, які
насправді
є у
гостьовій
системі?
Якщо у вас є
нетипова
гостьова
система
(давній
дистрибутив
Linux, свіжа
версія Windows), чи
розпізнає
її virt-inspector? Якщо
ні,
ймовірно,
це вада у
програмі.
Показати
список
всіх
програм з setuid
або setgid у
віртуальній
машині Linux:
virt-ls -lR -d Guest / | grep '^- [42]'
Показати
список
всіх
каталогів
з
відкритим
для всіх
доступом
на запис у
віртуальній
машині Linux:
virt-ls -lR -d Guest / | grep '^d ...7'
Показати
список
всіх
сокетів
доменів Unix у
віртуальній
машині Linux:
virt-ls -lR -d Guest / | grep '^s'
Показати
список
усіх
звичайних
файлів,
назви яких
завершуються
на «.png»:
virt-ls -lR -d Guest / | grep -i '^-.*\.png$'
Щоб
переглянути
список
файлів у
домашніх
каталогах,
розмір
яких
перевищує 10
МБ:
virt-ls -lR -d Guest /home | awk '$3 > 10*1024*1024'
Знайти всі
об’єкти,
які було
змінено
протягом
попередніх
7 днів:
virt-ls -lR -d Guest --time-days / | awk '$6 <= 7'
Знайти
звичайні
файли,
зміни до
яких було
внесено
протягом
попередніх
24 годин:
virt-ls -lR -d Guest --time-days / | grep '^-' | awk '$6 < 1'
Чи
збігаються
результати
із тими, які
можна
бачити у
гостьовій
системі?
Скористайтеся
virt-make-fs(1) для
створення
образу
диска з
будь-якого
архіву tar,
який у вас є:
virt-make-fs --partition=mbr --type=vfat /десь/якийсь.tar.gz образ_результат.img
Додайте
«образ_результат.img»
як
звичайний (raw)
диск до
наявної
гостьової
системи.
Перевірте,
чи бачить
гостьова
система
файли. Цей
тест
зокрема
корисний,
якщо ви
спробуєте
зробити це
із
гостьовою
системою Windows.
Спробуйте
інші схеми
поділу на
диски,
наприклад
--partition=gpt.
Спробуйте
інші
формати
файлових
систем,
наприклад
--type=ntfs,
--type=ext2.
Скористайтеся
virt-rescue(1) для
інспектування,
порятунку
або
відновлення
вимкненої
гостьової
системи
або образу
диска:
virt-rescue -a /шлях/до/образу.img
або:
virt-rescue -d Guest
Чи можна
скористатися
звичайними
командами
оболонки
для
вивчення
гостьової
системи?
Скористайтеся
virt-resize(1) для
надання
гостьовій
системі
додаткового
місця.
Наприклад,
якщо образ
диска
менший за 30
ГБ,
збільште
його до 30 ГБ
такими
командами:
truncate -s 30G новий_диск.img
virt-filesystems -a /шлях/до/старий_диск.img --all --long -h
virt-resize /шлях/до/старий_диск.img новий_диск.img --expand /dev/sda1
qemu-kvm -m 1024 -hda новий_диск.img
Чи
завантажується
після
цього
гостьова
система?
Спробуйте
розширити
інші
розділи.
За
допомогою
virt-sparsify(1)
зменшіть
образ
диска:
virt-sparsify /шлях/до/старий_диск.img новий_диск.img
Чи можна
завантажити
новий_диск.img
після
ущільнення?
Чи є
диск-результат
меншим
(скористайтеся
"du", щоб
перевірити
це)?
За
допомогою
virt-builder(1)
виберіть
гостьову
систему зі
списку:
virt-builder -l
зберіть її:
virt-builder -o диск.img [версія операційної системи з наведеного вище списку]
і
завантажте
її:
qemu-kvm -cpu host -m 2048 -drive file=диск.img,format=raw
Чи
завантажується
система?
Зауважте,
ця дія
насправді
може
зашкодити
наявній
гостьовій
системі,
отже варто
створити
клон
гостьової
системи,
перш ніж
намагатися
виконати
тестування.
virt-sysprep --hostname newhost.example.com -a /шлях/до/диск.img
Чи успішно
виконано sysprep?
Які зміни
внесено
після
завантаження
і чи були
вони
успішними?
Скористайтеся
virt-win-reg(1) для
створення
дампу
реєстру Windows з
наявних у
вас
гостьових
систем Windows.
virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\Software' |
less
virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\System' |
less
Чи
відповідають
отримані
дані тому,
що можна
побачити
за
допомогою
"regedit" у
гостьовій
системі?
Нещодавно
реалізованою
можливістю
є
можливість
створення
дампів
реєстрів
користувачів.
Отже, вам
слід
перевірити
і її,
замінивши
рядок
користувач
на ім'я
локального
користувача
у
гостьовій
системі:
virt-win-reg --unsafe-printable-strings WindowsGuest 'HKEY_USERS\користувач' |
less
guestfs(3),
guestfish(1),
guestfs-examples(3),
http://libguestfs.org/.
Richard W.M. Jones ("rjones at redhat dot com")
© Red Hat Inc., 2011–2012
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.