libguestfs-test-tool(1) | Virtualization Support | libguestfs-test-tool(1) |
НАЗВА¶
libguestfs-test-tool — діагностика libguestfs
КОРОТКИЙ ОПИС¶
libguestfs-test-tool [--параметри]
ОПИС¶
libguestfs-test-tool — програма для тестування, яка постачається разом із libguestfs для уможливлення перевірки того, чи працюють базові можливості libguestfs. Ця програма потрібна, оскільки функціональність libguestfs може бути порушено з неконтрольованих розробниками причин: зазвичай, через зміни у базових пакунках qemu або ядра чи зміни у середовищі основної системи.
Якщо ви вважаєте, що проблема полягає у libguestfs, просто віддайте таку команду:
libguestfs-test-tool
У відповідь буде виведено діагностичні повідомлення.
Якщо дії буде виконано успішно до кінця, ви побачите наприкінці списку повідомлень таке:
===== TEST FINISHED OK =====
і засіб тестування завершить роботу із кодом виходу 0.
Якщо виконання програми завершиться помилкою (і/або виходом із ненульовим кодом завершення), будь ласка, додайте повні, нередаговані виведені засобом тестування дані до звіту щодо вади у програмі. Докладніші дані щодо звітування про вади наведено на сайті http://libguestfs.org/.
ПАРАМЕТРИ¶
- --help
- Показати коротку довідку з користування і завершити роботу.
- --qemu виконуваний_файл_qemu
- Якщо вами було отримано інший виконуваний файл qemu, вкажіть за допомогою цього параметра повний шлях до цього виконуваного файла, щоб програма перевірила його.
- --qemudir каталог_коду_qemu
- Якщо вами було зібрано qemu з початкових кодів, вкажіть за допомогою цього параметра шлях до каталогу з кодом, щоб програма перевірила його.
- -t N
- --timeout N
- Встановити час очікування на запуск у значення "N" секунд. Типовим є значення у 600 секунд (10 хвилин). Зазвичай, це значення не потребує коригування.
- -V
- --version
- Показати дані щодо версії libguestfs і завершити роботу.
ТЕСТУВАННЯ ІНШОЇ ВЕРСІЇ QEMU¶
Якщо вами було зібрано якусь іншу версію qemu з початкових кодів і ви хочете виконати її тестування, ви можете скористатися параметром --qemudir, щоб вказати каталог з початковими кодами qemu.
Якщо вами звідкись було отримано інший виконуваний файл qemu, скористайтеся параметром --qemu, щоб вказати цей виконуваний файл.
Зауважте, що користуючись цими параметрами, ви можете не перейматися написанням скриптів-обгорток qemu ("ОБГОРТКИ QEMU" in guestfs(3)), оскільки libguestfs-test-tool автоматично створює такий скрипт-обгортку, якщо він потрібен.
ТЕСТУВАННЯ ІНШОГО ЯДРА¶
Ви можете наказати supermin спробувати скористатися іншим ядром. Зробити це можна за допомогою змінних середовища "SUPERMIN_KERNEL", "SUPERMIN_KERNEL_VERSION" і/або "SUPERMIN_MODULES".
Щоб дізнатися більше про це, зверніться до розділу "ЗМІННІ СЕРЕДОВИЩА" in supermin(1).
ТЕСТУВАННЯ ІНШОЇ ВЕРСІЇ LIBVIRT¶
Щоб дізнатися, який із модулів обробки є типовим у вашому пакунку libguestfs, скористайтеся такою командою:
unset LIBGUESTFS_BACKEND guestfish get-backend
Якщо ви користуєтеся модулем libvirt, ви можете спробувати іншу (наприклад створену розробниками) версію libvirt, віддавши такі команди (не від імені root):
killall libvirtd lt-libvirtd ~/шлях/до/libvirt/run libguestfs-test-tool
Перша команда припиняє роботу усіх процесів "libvirtd" сеансу, які могло бути запущено у системі. Друга команда використовує скрипт "run" libvirt (зберігається у кореневому каталозі збирання libvirt) для встановлення деяких змінних середовища так, щоб для запуску програми використовувалася альтернативна версія libvirt.
ТЕСТУВАННЯ З І БЕЗ LIBVIRT¶
Щоб дізнатися, який із модулів обробки є типовим у вашому пакунку libguestfs, скористайтеся такою командою:
unset LIBGUESTFS_BACKEND guestfish get-backend
Якщо ви користуєтеся модулем libvirt, ви можете спробувати попрацювати без нього (тобто наказати libguestfs напряму запускати qemu), ось так:
export LIBGUESTFS_BACKEND=direct
Або, якщо ви використовуєте типовий модуль обробки (direct), ви можете перейти на модуль libvirt:
export LIBGUESTFS_BACKEND=libvirt
або libvirt і специфічну адресу libvirt:
export LIBGUESTFS_BACKEND=libvirt:qemu:///сеанс
ТЕСТУВАННЯ ІНШИХ ПАРАМЕТРІВ SELINUX¶
Щоб дізнатися, який із модулів обробки є типовим у вашому пакунку libguestfs, скористайтеся такою командою:
unset LIBGUESTFS_BACKEND guestfish get-backend
Щоб перевірити, чи використовується SELinux, віддайте таку команду:
getenforce
Якщо ви користуєтеся libvirt, SELinux та sVirt, ви можете перевірити, чи змінить роботу системи встановлення у SELinux режиму «permissive». Скористайтеся для цього такою командою від імені користувача root:
setenforce Permissive
Якщо виникнуть проблеми, пошукайте у журналі аудиту повідомлення про нещодавні помилки («AVC»):
ausearch -m avc -ts recent
Ви можете перетворити AVC у пропоновані правила SELinux за допомогою програм, подібних до audit2allow(1). Щоб дізнатися більше, ознайомтеся із документом «Security Enhanced Linux User Guide».
Щоб знову увімкнути SELinux і sVirt, зробіть так:
setenforce Enforcing
САМОДІАГНОСТИКА¶
Зверніться до розділу "ПРОЦЕС ЗАВАНТАЖЕННЯ БАЗОВОЇ СИСТЕМИ" in guestfs(3), щоб зрозуміти повідомлення, які виводяться libguestfs-test-tool і/або можливі причини помилок.
СТАН ВИХОДУ¶
libguestfs-test-tool повертає 0, якщо команди виконано без помилок, або 1, якщо сталася помилка.
ЗМІННІ СЕРЕДОВИЩА¶
Повний список змінних середовища, які можуть вплинути на роботу libguestfs, можна знайти на сторінці підручника guestfs(3).
ТАКОЖ ПЕРЕГЛЯНЬТЕ¶
guestfs(3), http://libguestfs.org/, http://qemu.org/.
АВТОРИ¶
Richard W.M. Jones ("rjones at redhat dot com")
АВТОРСЬКІ ПРАВА¶
Copyright (C) 2009-2023 Red Hat Inc.
LICENSE¶
BUGS¶
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.
2024-10-08 | libguestfs-1.54.0 |