Приведенные ниже таблицы содержат перечень основных параметров командной строки 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

Команда	Description
`version`	Просмотр версии `virsh`.
`nodeinfo`	Просмотр информации о гипервизоре.

Примеры использования VIRSH

Подключение к гипервизору

Подключение к сессии гипервизора с помощью virsh :

# virsh connect {hostname OR URL}

Where <name> is the machine name of the hypervisor. To initiate a read-only connection, append the above command with-readonly.

Создание XML-файла конфигурации виртуальной машины

Выведите файл конфигурации виртуальной машины:

# virsh dumpxml {domain-id, domain-name or domain-uuid}

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 dumpxml GuestID > 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 withvirsh dumpxml.Пример вывода virsh dumpxml:

# virsh dumpxml r5b2-mySQL01
<domain type='xen' id='13'>
    <name>r5b2-mySQL01</name>
    <uuid>4a4c59a7ee3fc78196e4288f2862f011</uuid>
    <bootloader>/usr/bin/pygrub</bootloader>
    <os>
        <type>linux</type>
        <kernel>/var/lib/libvirt/vmlinuz.2dgnU_</kernel>
  <initrd>/var/lib/libvirt/initrd.UQafMw</initrd>
        <cmdline>ro root=/dev/VolGroup00/LogVol00 rhgb quiet</cmdline>
    </os>
    <memory>512000</memory>
    <vcpu>1</vcpu>
    <on_poweroff>destroy</on_poweroff>
    <on_reboot>restart</on_reboot>
    <on_crash>restart</on_crash>
    <devices>
        <interface type='bridge'>
            <source bridge='xenbr0'/>
            <mac address='00:16:3e:49:1d:11'/>
            <script path='vif-bridge'/>
        </interface>
        <graphics type='vnc' port='5900'/>
        <console tty='/dev/pts/4'/>
    </devices>
</domain>

Создание виртуальной машины на основе файла конфигурации

Guests can be created from XML configuration files. You can copy existing XML from previously created guests or use thedumpxml option (refer to Создание XML-файла конфигурации виртуальной машины). To create a guest with virshfrom 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:

# virsh suspend {domain-id, domain-name or domain-uuid}

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:

# virsh resume {domain-id, domain-name or domain-uuid}

Работа машины будет возобновлена немедленно. Параметры будут сохраняться между циклами suspend и resume.

Сохранение виртуальной машины

Команда сохранения текущего состояния виртуальной машины:

# virsh save {domain-name, domain-id or domain-uuid} filename

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:

# virsh restore filename

Сохраненная машина будет восстановлена из файла и перезапущена, что может занять некоторое время. Имя и идентификатор UUID виртуальной машины останутся неизменными, но будет предоставлен новый идентификатор домена.

Завершение работы виртуальной машины

Команда завершения работы:

# virsh shutdown {domain-id, domain-name or domain-uuid}

Поведение выключаемого гостя можно контролировать с помощью параметра on_shutdown в его файле конфигурации.

Перезагрузка виртуальной машины

Команда перезагрузки:

#virsh reboot {domain-id, domain-name or domain-uuid}

Поведение перезагружаемого гостя можно контролировать с помощью параметра on_reboot в его файле конфигурации.

Принудительная остановка виртуальной машины

Команда принудительной остановки:

# virsh destroy {domain-id, domain-name or domain-uuid}

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 theshutdown option(Завершение работы виртуальной машины) instead.

Определение идентификатора домена

Команда определения идентификатора домена виртуальной машины:

# virsh domid {domain-name or domain-uuid}

Определение имени домена

Команда определения имени домена виртуальной машины:

# virsh domname {domain-id or domain-uuid}

Определение UUID

Команда определения универсального идентификатора UUID виртуальной машины:

# virsh domuuid {domain-id or domain-name}

Пример вывода virsh domuuid:

# virsh domuuid r5b2-mySQL01
4a4c59a7-ee3f-c781-96e4-288f2862f011

Получение информации о виртуальной машине

Команда для получения информации:

# virsh dominfo {domain-id, domain-name or domain-uuid}

Пример вывода 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:

# 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

Вывод содержит информацию об узле и машинах, поддерживающих виртуализацию.

Просмотр списка виртуальных машин

Команда для просмотра списка виртуальных машин и их состояния:

# virsh list

Можно добавить аргументы:--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 {domain-id, domain-name or domain-uuid}

Пример вывода:

# virsh vcpuinfo r5b2-mySQL01
VCPU:           0
CPU:            0
State:          blocked
CPU time:       0.0s
CPU Affinity:   yy

Настройка соответствий виртуальных процессоров

Команда сопоставления виртуальных процессоров физическим:

# virsh vcpupin {domain-id, domain-name or domain-uuid} vcpu, cpulist

Здесь vcpu — номер виртуального процессора, а список_cpu — сопоставляемые ему физические процессоры.

Изменение числа виртуальных процессоров

Команда изменения числа процессоров для домена:

# virsh setvcpus {domain-name, domain-id or domain-uuid} count

Обратите внимание, что заданное число не может превышать значение, определенное при создании гостя.

Изменение выделенного объема памяти

Команда изменения выделенного виртуальной машине объема памяти:

# virsh setmem {domain-id or domain-name} count

Объем памяти, определяемый заданным числом, должен быть указан в килобайтах. Обратите внимание, что объем не может превышать значение, определенное при создании виртуальной машины, но в то же время не должен быть меньше 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

Пример вывода этой команды:

# virsh net-list
Name                 State      Autostart
-----------------------------------------
default              active     yes      
vnet1              active     yes      
vnet2              active     yes

Просмотр информации для заданной виртуальной сети:

# virsh net-dumpxml NetworkName

Пример вывода этой команды (в формате XML):

# virsh net-dumpxml vnet1
<network>
  <name>vnet1</name>
  <uuid>98361b46-1581-acb7-1643-85a412626e70</uuid>
  <forward dev='eth0'/>
  <bridge name='vnet0' stp='on' forwardDelay='0' />
  <ip address='192.168.100.1' netmask='255.255.255.0'>
    <dhcp>
      <range start='192.168.100.128' end='192.168.100.254' />
    </dhcp>
  </ip>
</network>

Другие команды управления виртуальными сетями:

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 имя_неактивной_сети — удаление определения неактивной сети.

a preexisting XML file

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

Обзор команд virsh