- Обзор команд virsh
- Команды управления виртуальными машинами
- Управление ресурсами виртуальных машин
- Другие команды virsh
- Примеры использования VIRSH
- Подключение к гипервизору
- Создание XML-файла конфигурации виртуальной машины
- Создание виртуальной машины на основе файла конфигурации
- Редактирование файла конфигурации виртуальной машины
- Приостановка виртуальной машины
- Возобновление работы виртуальной машины
- Сохранение виртуальной машины
- Восстановление виртуальной машины
- Завершение работы виртуальной машины
- Перезагрузка виртуальной машины
- Принудительная остановка виртуальной машины
- Определение идентификатора домена
- Определение имени домена
- Определение UUID
- Получение информации о виртуальной машине
- Получение информации об узле
- Просмотр списка виртуальных машин
- Получение информации о виртуальных процессорах
- Настройка соответствий виртуальных процессоров
- Изменение числа виртуальных процессоров
- Изменение выделенного объема памяти
- Получение информации о блочных устройствах
- Получение информации о сетевых устройствах
- Миграция виртуальных машин
- Управление виртуальными сетями
Обзор команд virsh
Приведенные ниже таблицы содержат перечень основных параметров командной строки virsh.
Команды управления виртуальными машинами
Команда | Description |
---|---|
help | Краткая справка. |
list | Просмотр всех виртуальных машин. |
dumpxml | Вывести файл конфигурации XML для заданной виртуальной машины. |
create | Создать виртуальную машину из файла конфигурации XML и ее запуск. |
start | Запустить неактивную виртуальную машину. |
destroy | Принудительно остановить работу виртуальной машины. |
define | Определяет файл конфигурации XML для заданной виртуальной машины. |
domid | Просмотр идентификатора виртуальной машины. |
domuuid | Просмотр UUID виртуальной машины. |
dominfo | Просмотр сведений о виртуальной машине. |
domname | Просмотр имени виртуальной машины. |
domstate | Просмотр состояния виртуальной машины. |
quit | Закрыть интерактивный терминал. |
reboot | Перезагрузить виртуальную машину. |
restore | Восстановить сохраненную в файле виртуальную машину. |
resume | Возобновить работу приостановленной виртуальной машины. |
save | Сохранить состояние виртуальной машины в файл. |
shutdown | Корректно завершить работу виртуальной машины. |
suspend | Приостановить работу виртуальной машины. |
undefine | Удалить все файлы виртуальной машины. |
migrate | Перенести виртуальную машину на другой узел. |
Управление ресурсами виртуальных машин
Для управления ресурсами виртуальной машины и гипервизора используются следующие команды virsh :
Команда | Description |
---|---|
setmem | Определяет размер выделенной виртуальной машине памяти. |
setmaxmem | Ограничивает максимально доступный гипервизору объем памяти. |
setvcpus | Изменяет число предоставленных гостю виртуальных процессоров. |
vcpuinfo | Просмотр информации о виртуальных процессорах. |
vcpupin | Настройка соответствий виртуальных процессоров. |
domblkstat | Просмотр статистики блочных устройств для работающей виртуальной машины. |
domifstat | Просмотр статистики сетевых интерфейсов для работающей виртуальной машины. |
attach-device | Подключить определенное в XML-файле устройство к гостю. |
attach-disk | Подключить новое дисковое устройство к гостю |
attach-interface | Подключить новый сетевой интерфейс к гостю |
detach-device | Отключить устройство от гостя (принимает те же определения XML, что и attach-device ). |
detach-disk | Отключить дисковое устройство от гостя. |
detach-interface | Отключить сетевой интерфейс от гостя. |
Другие команды virsh
Примеры использования VIRSH
Подключение к гипервизору
Подключение к сессии гипервизора с помощью virsh :
Where is the machine name of the hypervisor. To initiate a read-only connection, append the above command with -readonly .
Создание XML-файла конфигурации виртуальной машины
Выведите файл конфигурации виртуальной машины:
This command outputs the guest’s XML configuration file to standard out ( stdout ). You can save the data by piping the output to a file. An example of piping the output to a file called guest.xml :
# virsh dumpxmlGuestID
>guest.xml
This file guest.xml can recreate the guest (refer to Редактирование файла конфигурации виртуальной машины. You can edit this XML configuration file to configure additional devices or to deploy additional guests. Refer to Раздел 18.1, «Использование файлов конфигурации с помощью virsh» for more information on modifying files created with virsh dumpxml .Пример вывода virsh dumpxml :
# virsh dumpxml r5b2-mySQL01r5b2-mySQL01 4a4c59a7ee3fc78196e4288f2862f011 /usr/bin/pygrub linux /var/lib/libvirt/vmlinuz.2dgnU_ /var/lib/libvirt/initrd.UQafMw ro root=/dev/VolGroup00/LogVol00 rhgb quiet 512000 1 destroy restart restart
Создание виртуальной машины на основе файла конфигурации
Guests can be created from XML configuration files. You can copy existing XML from previously created guests or use the dumpxml option (refer to Создание XML-файла конфигурации виртуальной машины). To create a guest with virsh from an XML file:
# virsh create configuration_file.xml
Редактирование файла конфигурации виртуальной машины
Instead of using the dumpxml option (refer to Создание XML-файла конфигурации виртуальной машины) guests can be edited either while they run or while they are offline. The virsh edit command provides this functionality. For example, to edit the guest named softwaretesting :
# virsh edit softwaretesting
Откроется окно текстового редактора, заданного переменной оболочки $EDITOR (по умолчанию используется vi ).
Приостановка виртуальной машины
Команда приостановки виртуальной машины с помощью virsh :
When a guest is in a suspended state, it consumes system RAM but not processor resources. Disk and network I/O does not occur while the guest is suspended. This operation is immediate and the guest can be restarted with the resume (Возобновление работы виртуальной машины) option.
Возобновление работы виртуальной машины
Возобновить работу приостановленной виртуальной машины можно с помощью параметра resume команды virsh :
Работа машины будет возобновлена немедленно. Параметры будут сохраняться между циклами suspend и resume .
Сохранение виртуальной машины
Команда сохранения текущего состояния виртуальной машины:
This stops the guest you specify and saves the data to a file, which may take some time given the amount of memory in use by your guest. You can restore the state of the guest with the restore (Восстановление виртуальной машины) option. Save is similar to pause, instead of just pausing a guest the present state of the guest is saved.
Восстановление виртуальной машины
Restore a guest previously saved with the virsh save command (Сохранение виртуальной машины) using virsh :
Сохраненная машина будет восстановлена из файла и перезапущена, что может занять некоторое время. Имя и идентификатор UUID виртуальной машины останутся неизменными, но будет предоставлен новый идентификатор домена.
Завершение работы виртуальной машины
Команда завершения работы:
Поведение выключаемого гостя можно контролировать с помощью параметра on_shutdown в его файле конфигурации.
Перезагрузка виртуальной машины
Поведение перезагружаемого гостя можно контролировать с помощью параметра on_reboot в его файле конфигурации.
Принудительная остановка виртуальной машины
Команда принудительной остановки:
This command does an immediate ungraceful shutdown and stops the specified guest. Using virsh destroy can corrupt guest file systems . Use the destroy option only when the guest is unresponsive. For para-virtualized guests, use the shutdown option(Завершение работы виртуальной машины) instead.
Определение идентификатора домена
Команда определения идентификатора домена виртуальной машины:
Определение имени домена
Команда определения имени домена виртуальной машины:
Определение UUID
Команда определения универсального идентификатора UUID виртуальной машины:
Пример вывода virsh domuuid :
# virsh domuuid r5b2-mySQL01 4a4c59a7-ee3f-c781-96e4-288f2862f011
Получение информации о виртуальной машине
Команда для получения информации:
Пример вывода virsh dominfo :
# virsh dominfo r5b2-mySQL01 id: 13 name: r5b2-mysql01 uuid: 4a4c59a7-ee3f-c781-96e4-288f2862f011 os type: linux state: blocked cpu(s): 1 cpu time: 11.0s max memory: 512000 kb used memory: 512000 kb
Получение информации об узле
Команда получения информации об узле:
Пример вывода virsh nodeinfo :
# virsh nodeinfo CPU model x86_64 CPU (s) 8 CPU frequency 2895 Mhz CPU socket(s) 2 Core(s) per socket 2 Threads per core: 2 Numa cell(s) 1 Memory size: 1046528 kb
Вывод содержит информацию об узле и машинах, поддерживающих виртуализацию.
Просмотр списка виртуальных машин
Команда для просмотра списка виртуальных машин и их состояния:
Можно добавить аргументы: —inactive покажет список неактивных доменов (неактивным считается тот домен, который был определен, но в настоящий момент не является активным). —all покажет все виртуальные машины независимо от их состояния. Пример:
# virsh list --all Id Name State ---------------------------------- 0 Domain-0 running 1 Domain202 paused 2 Domain010 inactive 3 Domain9600 crashed
Столбец «Status» может содержать следующие значения:
- running — работающие виртуальные машины, то есть те машины, которые используют ресурсы процессора в момент выполнения команды.
- blocked — заблокированные, неработающие машины. Такой статус может быть вызван ожиданием ввода/вывода или пребыванием машины в спящем режиме.
- paused — приостановленные домены. В это состояние они переходят, если администратор нажал кнопку паузы в окне менеджера виртуальных машин или выполнил команду xm pause или virsh suspend . В приостановленном состоянии гость продолжает потреблять ресурсы, но не может занимать больше процессорных ресурсов.
- shutdown — виртуальные машины, завершающие свою работу. При получении виртуальной машиной сигнала завершения работы, она начнет завершать все процессы. Стоит отметить, что некоторые операционные системы не отвечают на такие сигналы.
- dying — сбойные домены и домены, которые не смогли корректно завершить свою работу.
- crashed — сбойные домены, работа которых была прервана. В этом состоянии домены находятся, если не была настроена их перезагрузка в случае сбоя.
Получение информации о виртуальных процессорах
Команда получения информации о виртуальных процессорах:
# virsh vcpuinfo r5b2-mySQL01 VCPU: 0 CPU: 0 State: blocked CPU time: 0.0s CPU Affinity: yy
Настройка соответствий виртуальных процессоров
Команда сопоставления виртуальных процессоров физическим:
# virsh vcpupin vcpu, cpulist
Здесь vcpu — номер виртуального процессора, а список_cpu — сопоставляемые ему физические процессоры.
Изменение числа виртуальных процессоров
Команда изменения числа процессоров для домена:
Обратите внимание, что заданное число не может превышать значение, определенное при создании гостя.
Изменение выделенного объема памяти
Команда изменения выделенного виртуальной машине объема памяти:
Объем памяти, определяемый заданным числом, должен быть указан в килобайтах. Обратите внимание, что объем не может превышать значение, определенное при создании виртуальной машины, но в то же время не должен быть меньше 64 мегабайт. Изменение максимального объема памяти может оказать влияние на функциональность гостя только в том случае, если указанный размер меньше исходного. В таком случае использование памяти будет ограничено.
Получение информации о блочных устройствах
Команда для получения информации о блочных устройствах работающей виртуальной машины:
# virsh domblkstat GuestName block-device
Получение информации о сетевых устройствах
Команда для получения информации о сетевых интерфейсах работающей виртуальной машины:
# virsh domifstat GuestName interface-device
Миграция виртуальных машин
virsh позволяет переносить виртуальные машины с одного узла на другой. Для выполнения живой миграции просто нужно указать параметр —live . Команда переноса выглядит так:
# virsh migrate --live GuestName DestinationURL
Параметр —live не является обязательным.The GuestName parameter represents the name of the guest which you want to migrate.The DestinationURL parameter is the URL or hostname of the destination system. The destination system must run the same version of Fedora, be using the same hypervisor and have libvirt running.Once the command is entered you will be prompted for the root password of the destination system.
Управление виртуальными сетями
В этой секции будет рассмотрены управляющие команды virsh . Например, команда просмотра списка виртуальных сетей выглядит так:
Пример вывода этой команды:
# virsh net-list Name State Autostart ----------------------------------------- default active yes vnet1 active yes vnet2 active yes
Просмотр информации для заданной виртуальной сети:
# virsh net-dumpxml NetworkName
Пример вывода этой команды (в формате XML):
# virsh net-dumpxml vnet1vnet1 98361b46-1581-acb7-1643-85a412626e70
Другие команды управления виртуальными сетями:
- virsh net-autostart имя_сети — автоматический запуск заданной сети.
- virsh net-create файл_XML — создание и запуск новой сети на основе существующего XML-файла.
- virsh net-define файл_XML — создание нового сетевого устройства на основе существующего XML-файла. Устройство не будет запущено.
- virsh net-destroy имя_сети — удаление заданной сети.
- virsh net-name UUID_сети — преобразование заданного идентификатора в имя сети.
- virsh net-uuid имя_сети — преобразование заданного имени в идентификатор UUID.
- virsh net-start имя_неактивной_сети — запуск неактивной сети.
- virsh net-undefine имя_неактивной_сети — удаление определения неактивной сети.
- virsh net-define [XML file] — Generates a new network from a preexisting XML file without starting it
- virsh net-destroy [network name] — Destroy a network specified as [network name]
- virsh net-name [network UUID] — Convert a specified [network UUID] to a network name
- virsh net-uuid [network name — Convert a specified [network name] to a network UUID
- virsh net-start [name of an inactive network] — Starts a previously undefined inactive network
- virsh net-undefine [name of an inactive network] — Undefine an inactive network