Перейти к содержанию

Команды управления Numa vServer

Администрирование Numa vServer осуществляется с помощью командной строки (CLI) командами xe.

Общая информация#

Получение справки по отдельным командам xe CLI. 

1
xe help <команда>

Получение справки по формату ввода команд и списка основных команд xe. 

1
xe help

Список всех команд xe. 

1
xe help --all

Основной синтаксис всех команд xe. 

1
xe <команда> <параметр>=<значение> <параметр>=<значение>

Каждая команда содержит свой собственный набор параметров, которые имеют формат <параметр>=<значение>. Некоторые команды имеют обязательные параметры, а большинство имеют набор необязательных параметров. Обычно команда предполагает значения по умолчанию для некоторых необязательных параметров при вызове без них.

Если значение параметра не содержит пробелов, не используйте кавычки. Не включайте пробелы между именем параметра, знаком равенства (=) и значением. Любой параметр, не соответствующий этому формату, игнорируется.

Значения, содержащие пробелы, пишите в следующем формате: <параметр>="значение с пробелами"

Команды имеют функцию автодополнения табуляцией, похожую на функцию в стандартной оболочке Linux bash. Например, если вы введете xe vm-l и затем нажмете клавишу Tab, остальная часть команды будет автоматически дополнена. Если с vm-l начинаются две и более команды, нажмите дважды Tab для вывода списка всех возможных команд. Эта функция полезна при указании UUID объектов в командах.

Примечание

Автодополнение клавишей Tab обычно не работает при запуске команд на удаленном сервере Numa vServer.

Удаленный запуск команд#

Если команда xe запускается удаленно, для подключения и аутентификации используются дополнительные параметры:

  • username или -u – имя пользователя, инициирующее действие
  • password или -pw – пароль пользователя, инициирующего действие
  • server или -s – IP-адрес или имя сервера, над которым производится действие

Пример:

1
xe vm-list


1
xe vm-list username=<имя-пользователя> password=<пароль-пользователя> server=<IP-адрес|имя-сервера>
или 
1
xe vm-list -u <имя-пользователя> -pw <пароль-пользователя> -s <IP-адрес|имя-сервера>

Обратите внимание

Удаленный запуск команд можно сделать только к мастеру пула.

Типы команд#

Команды xe можно разделить на две группы: низкоуровневые и высокоуровневые. Низкоуровневые команды связаны с листингом и манипуляцией параметрами объектов API. Высокоуровневые команды используются для взаимодействия с виртуальными машинами или хостами на более абстрактном уровне.

Формат низкоуровневых команд:

  • <class>-list
  • <class>-param-get
  • <class>-param-set
  • <class>-param-list
  • <class>-param-add
  • <class>-param-remove
  • <class>-param-clear

Где class может принимать следующие значения: bond, host, network, pbd, pif, pool, snapshot, sr, subject, task, template, vbd, vdi, vif, vlan, vm.

Примечание

Не каждый класс может иметь формат <class>-param-<действие>.

Типы параметров#

Большинство параметров могут принимать только одно значение. Например, параметр name-label ВМ содержит одно строковое значение.

В выводах команд для просмотра списка параметров, таких как xe vm-param-list uuid=<vm_uuid> значения параметров могут быть типа чтение-запись (RW) или только чтение (RO). Например: 

1
2
user-version ( RW): 1
is-control-domain ( RO): false
Параметр user-version может быть изменен, а is-control-domain доступен только для чтения.

Также есть еще многозначные параметры типа MRW и SRO. Например: 

1
2
3
platform (MRW): acpi: true; apic: true; pae: true; nx: false
allowed-operations (SRO): pause; clean_shutdown; clean_reboot; \
hard_shutdown; hard_reboot; suspend
Параметр platform имеет множество пар ключ-значение, отделяемых двоеточием (:), например, acpi: true. Буква M перед RW указывает, что этот параметр состоит из пар ключ-значение и доступен для чтения и записи. Пары ключ-значение отделяются точкой с запятой (;). например, acpi: true; apic: true;.

Для изменения параметра с парой ключ-значение используйте двоеточие (:). Например, для изменения значения ключа foo для параметра other-config: 

1
xe vm-param-set uuid=VM uuid other-config:foo=baa

Параметр allowed-operations имеет набор значений. Буква S перед RO указывает, что параметр доступен для чтения, но не для записи.

Справочник команд#

В этом разделе приведены часто используемые команды.

Команды управления bond-интерфейсами#

Команды для работы с физическими сетевыми интерфейсами, объединенными в одну виртуальную интерфейсную группу (bond) с целью увеличения производительности, отказоустойчивости или нагрузки между несколькими физическими интерфейсами.

Действие Команда Примечание
Создание bond-интерфейса из существующих PIF xe bond-create network-uuid=<network_uuid> pif-uuids=<pif_uuid_1>,<pif_uuid_2>,... Команда не выполняется в любом из следующих случаев:
  • Если PIF уже входят в другие bond-интерфейсы
  • Если у какого-либо участника bond-интерфейса установлен тег VLAN
  • Если указанные PIF находятся на разных серверах Numa vServer
  • Если указано менее двух PIF
    • Удаление bond-интерфейса с сервера xe bond-destroy uuid=<bond_uuid>
    Изменение типа связи bond-интерфейса xe bond-set-mode uuid=<bond_uuid> mode=<bond_mode> Параметр mode может принимать следующие значения:
  • balance-slb – используется для объединения пропускной способности нескольких физических интерфейсов и балансировки нагрузки на них
  • active-backup – используется для резервирования подключения. В этом режиме работает один из физических интерфейсов, включенных в агрегацию, а остальные будут задействованы в случае отказа активного
  • lacp – протокол агрегирования каналов, используется для повышения пропускной способности и отказоустойчивости
    		•

    Команды управления серверами#

    Серверы Numa vServer — это физические серверы, на которых установлено и запущено программное обеспечение Numa vServer. На них работают виртуальные машины под управлением специальной привилегированной виртуальной машины, известной как домен управления или dom0.

    Действие Команда Примечание
    Вывод списка серверов в пуле xe host-list
    Формирование файла резервной копии домена управления указанного сервера xe host-backup file-name=<backup_filename> host=<host_name> Внимание! Запускайте команду только с удаленного сервера
    Вычисление объема свободной памяти на сервере xe host-compute-free-memory host=<host_name>
    Вывод информации о физических процессорах сервера xe host-cpu-info [uuid=host_uuid]
    Отключение сервера для предотвращения запуска на нем виртуальных машин. Это действие подготавливает серверы к выключению или перезагрузке xe host-disable host=<host-name>
    Включение сервера для запуска на нем виртуальных машин xe host-enable host=<host-name>
    Перенос (живая миграция) всех работающих ВМ на другой подходящий сервер xe host-evacuate host=<host-name> Порядок эвакуации сервера:
    1. Сначала отключите эвакуируемый сервер с помощью команды xe host-disable host=<host-name>
    2. Если эвакуируемый сервер является мастером пула, то необходимо выбрать другой сервер в качестве мастера пула:
      • При отключенном механизме HA используйте команду xe pool-designate-new-master host-uuid=<uuid_of_new_master>
      • При включенном механизме HA единственным вариантом является выключение сервера (команда xe host-shutdown host=<host-name>) для того, чтобы механизм HA выбрал мастера пула случайным образом.
    3. Далее выполните команду по эвакуации сервера, который перенесет все работающие ВМ на другой сервер: xe host-evacuate host=<host-name>
    Перезагрузка сервера xe host-reboot host=<host-name> Серверы должны быть сначала отключены с помощью команды xe host-disable host=<host-name>, иначе отобразится ошибка HOST_IN_USE.
    Если указанные серверы входят в пул ресурсов, то сначала при выключении серверов произойдет потеря связи с пулом, затем при включении серверов пул восстановит работу. Другие серверы и мастер пула продолжают функционировать.
    Если вы отключите мастера пула, пул перестанет работать до тех пор, пока не произойдет одно из следующих действий:
    1. Вы назначите одного из серверов мастером пула.
    2. Исходный мастер пула перезагружается и снова подключается к сети.

    Когда мастер пула снова подключается к сети, участники повторно подключаются и синхронизируются с мастером пула.
    Выключение сервера xe host-shutdown host=<host-name> Серверы должны быть сначала отключены с помощью команды xe host-disable host=<host-name>, иначе отобразится ошибка HOST_IN_USE.
    Если указанные серверы входят в пул ресурсов, то сначала при выключении серверов произойдет потеря связи с пулом, затем при включении серверов пул восстановит работу. Другие серверы и мастер пула продолжают функционировать.
    Если вы отключите мастера пула, пул перестанет работать до тех пор, пока не произойдет одно из следующих действий:
    1. Вы назначите одного из серверов мастером пула.
    2. Исходный мастер пула перезагружается и снова подключается к сети.

    Когда мастер пула снова подключается к сети, участники повторно подключаются и синхронизируются с мастером пула.

    Команды управления сетями#

    Действие Команда Примечание
    Список объектов xe network-list
    Создание сети xe network-create name-label=<network-name> [name-description=<descriptive_text>] Команда выведет UUID созданной сети
    Уничтожение сети xe network-destroy uuid=<network_uuid>

    Команды управления PBD#

    Команды работы с физическими блочными устройствами (PBD). PBD – это программные объекты, через которые сервер обращается к хранилищам.

    Действие Команда Примечание
    Список объектов PBD xe pbd-list
    Создание PBD xe pbd-create host-uuid=<host-uuid> sr-uuid=<sr-uuid> [device-config:key=<corresponding_value>] Команда выведет UUID созданного PBD
    Уничтожение PBD xe pbd-destroy uuid=<pbd-uuid>
    Подключение PBD к серверу xe pbd-plug uuid=<pbd-uuid> Если команда выполнена успешно, хранилище (и содержащиеся в нем VDI) станет видимым для сервера
    Отключение PBD от сервера xe pbd-unplug uuid=<pbd-uuid>

    Команды управления PIF#

    Команды для работы с PIF (объектами, представляющими физические сетевые интерфейсы).

    Действие Команда Примечание
    Список объектов PIF xe pif-list
    Уничтожение указанного PIF на определенном сервере xe pif-forget uuid=<pif-uuid>
    Создание объекта PIF на сервере xe pif-introduce host-uuid=<host_uuid> mac=<mac_address_for_pif> device=<interface_name>
    Запуск физического интерфейса xe pif-plug uuid=<pif-uuid>
    Вывести из строя физический интерфейс xe pif-unplug uuid=<pif-uuid>
    Сканирование на наличие новых физических интерфейсов на сервере xe pif-scan host-uuid=<host-uuid>
    Изменение IPv6-адреса на PIF xe pif-reconfigure-ipv6 uuid=<uuid_of_pif> [mode=dhcp|mode=static] [gateway=<network_gateway_address>] [IPv6=<static_ip_for_this_pif>] [DNS=<dns_address>]
    Изменение IPv4-адреса на PIF xe pif-reconfigure-ip uuid=<uuid_of_pif> [mode=dhcp|mode=static] gateway=<network_gateway_address> IP=<static_ip_for_this_pif> netmask=<netmask_for_this_pif> [DNS=dns_address] Для статической конфигурации IP установите для параметра mode значение static, и заполните параметры gateway, IP и netmask. Чтобы использовать DHCP, установите для параметра mode значение dhcp и оставьте статические параметры незаполненными.
    Пример настройки статического IP-адреса: xe pif-reconfigure-ip uuid=<pif-uuid> mode=static IP=192.168.1.1 gateway=192.168.1.254 netmask=255.255.255.0 DNS=8.8.4.4
    Пример настройки DHCP: xe pif-reconfigure-ip uuid=<pif-uuid> mode=dhcp

    Команды управления пулом#

    Пул — это совокупность одного или нескольких серверов Numa vServer. Пул использует один или несколько общих хранилищ, чтобы виртуальные машины, работающие на одном сервере в пуле, можно было мигрировать практически в реальном времени на другой сервер в пуле. Эта миграция происходит, пока виртуальная машина все еще работает, без необходимости ее выключения и повторного запуска.

    Каждый сервер на самом деле является пулом, состоящим из одного сервера по умолчанию. Он же будет являться и мастером пула. Когда к пулу присоединяется еще один сервер, он назначается подчиненным сервером.

    Действие Команда Примечание
    Просмотр сведений о пуле xe pool-list
    Назначение нового мастера пула xe pool-designate-new-master host-uuid=<uuid_of_new_master> Эта команда выполняет упорядоченную передачу роли мастера пула другому серверу в пуле. Эта команда работает только тогда, когда текущий мастер пула находится в сети. Она не заменяет команды аварийного режима, перечисленные ниже
    Сброс IP-адреса мастера пула на новое значение через подчиненный сервер и попытка подключения к нему xe pool-emergency-reset-master master-address=<ip-address_of_pool_master> Внимание! Не запускайте данную команду на мастере пула.
    Назначение сервера Numa vServer мастером пула при переходе текущего мастера пула в аварийный режим (с ним нельзя связаться после нескольких повторных попыток) xe pool-emergency-transition-to-master Если пароль сервера был изменен с момента присоединения к пулу, эта команда может привести к сбросу пароля сервера
    Сброс IP-адреса подчиненных серверов в пуле, которые в данный момент работают в аварийном режиме xe pool-recover-slaves Эта команда обычно используется после назначения нового мастера пула с помощью команды xe pool-emergency-transition-to-master
    Отключение внешней аутентификации на всех серверах в пуле xe pool-disable-external-auth [uuid=uuid] [config=config]
    Включение внешней аутентификации на всех серверах в пуле xe pool-enable-external-auth auth-type=<auth_type> service-name=<service_name> config:user=<username> config:pass=<password>
    Вывод указанного сервера из пула xe pool-eject host-uuid=<uuid_of_host_to_eject>
    Присоединение сервера к пулу xe pool-join master-address=<ip-address> master-username=<username> master-password=<password>
    Включение механизма обеспечения высокой доступности в пуле xe pool-ha-enable heartbeat-sr-uuids=<sr-uuid> ha-config:timeout=<время-в-секундах> Где heartbeat-sr-uuids – UUID общего хранилища
    Отключение механизма обеспечения высокой доступности в пуле xe pool-ha-disable
    Расчет максимально допустимого количества отказов сервера с использованием указанных ВМ и их приоритета запуска xe pool-ha-compute-hypothetical-max-host-failures-to-tolerate [vm-uuid=vm_uuid] [restart-priority=restart_priority] Где restart-priority может принимать следующие значения:
  • restart: запуск ВМ до тех пор, пока она не включится
  • best-effort: 1 попытка запуска ВМ после запуска всех ВМ с приоритетом restart
    		•
    Расчет максимально допустимого количества отказов сервера при текущей конфигурации пула xe pool-ha-compute-max-host-failures-to-tolerate

    Команды управления снимками состояния (снапшотами)#

    Действие Команда Примечание
    Создание нового снимка путем клонирования существующего снимка состояния xe snapshot-clone new-name-label=<name_label> uuid=<snapshot-uuid> [new-name-description=<description>] Созданный снимок будет располагаться на том же хранилище
    Создание нового снимка путем копирования существующего снимка состояния xe snapshot-copy new-name-label=name_label uuid=<snapshot-uuid> [new-name-description=<name_description>] [sr-uuid=<sr_uuid>] Образы дисков скопированной виртуальной машины гарантированно будут «полными образами», т.е. не будут частью цепочки CoW
    Уничтожение снимка состояния xe snapshot-destroy [uuid=uuid] [snapshot-uuid=snapshot_uuid] Эта команда оставляет хранилище, связанное со снимком, нетронутым. Чтобы удалить хранилище, используйте xe snapshot-uninstall
    Вывод списка дисков снимков состояния xe snapshot-disk-list [uuid=uuid] [snapshot-uuid=snapshot_uuid] [vbd-params=vbd_params] [vdi-params=vdi_params]
    Экспорт снимка состояния в шаблон ВМ xe snapshot-export-to-template filename=file_name snapshot-uuid=snapshot_uuid [preserve-power-state=true|false]
    Возврат ВМ к предыдущему состоянию или снимку xe snapshot-revert [uuid=uuid] [snapshot-uuid=snapshot_uuid]
    Удаление снимка состояния xe snapshot-uninstall [uuid=uuid] [snapshot-uuid=snapshot_uuid] [--force] Эта операция уничтожит те VDI, которые помечены как RW и подключены только к этому снимку. Чтобы просто удалить снимок ВМ, используйте xe snapshot-destroy

    Команды управления хранилищами#

    Действие Команда Примечание
    Вывод списка хранилищ xe sr-list
    Создание хранилища xe sr-create name-label=<sr-name> physical-size=<size-in-bytes> type=<sr-type> content-type=<content_type> device-config:config_name=<value> [host-uuid=<host_uuid>] [shared=true|false] Данная команда создает хранилище на диске, вводит его в базу данных и создает PBD для подключения хранилища к серверу Numa vServer.
    При указании для параметра shared значения true PBD создается на каждом сервере в пуле.
    При указании для параметра shared значения false PBD создается только на сервере, UUID которого был указан в параметре host-uuid.
    Значение параметра device_config различается в зависимости от типа хранилища (type).
    Уничтожение хранилища xe sr-destroy uuid=<sr_uuid>
    Сканирование хранилища xe sr-probe type=<sr-type> [host-uuid=<host_uuid>] [device-config:config_name=<value>]
    Принудительное сканирование хранилища xe sr-scan uuid=<sr_uuid>

    Команды управления субъектами доступа#

    Действие Команда Примечание
    Добавление пользователя в список субъектов доступа, которые могут получить доступ к пулу xe subject-add subject-name=<subject_name>
    Удаление пользователя из списка субъектов доступа, которые имеют доступ к пулу xe subject-remove subject-uuid=<uuid>
    Присвоение роли субъекту доступа xe subject-role-add uuid=<subject-uuid> [role-name=<role_name>] [role-uuid=<role_uuid>]
    Удаление роли субъекта доступа xe subject-role-remove uuid=<subject-uuid> [role-name=<role_name>] [role-uuid=<role_uuid>]

    Команды управления задачами#

    Команды для работы с длительными асинхронными задачами. Эти команды представляют собой такие задачи, как запуск, остановка и приостановка виртуальной машины. Задачи обычно состоят из набора других атомарных подзадач, которые вместе выполняют запрошенную операцию.

    Действие Команда Примечание
    Вывод списка задач xe task-list
    Отмена выполнения задачи xe task-cancel uuid=<task-uuid>

    Команды управления шаблонами ВМ#

    Шаблоны по сути являются ВМ, параметр is-a-template которой имеет значение true. Шаблон — это эталонный образ, содержащий все различные параметры конфигурации для создания экземпляра конкретной виртуальной машины.

    Numa vServer содержит базовый набор шаблонов, которые являются сырыми ВМ, для развертывания которых необходимо загрузить установочный образ ОС. Также есть возможность создать ВМ, настроить их для ваших конкретных нужд и сохранить их копии в качестве шаблонов для будущего использования при развертывании ВМ.

    Примечание

    Шаблон нельзя напрямую преобразовать в ВМ, установив параметр is-a-template в значение false. Установка для параметра is-a-template значения false не поддерживается и приводит к невозможности запуска ВМ.

    Действие Команда Примечание
    Вывод списка шаблонов в Numa vServer xe template-list
    Преобразование ВМ в шаблон xe vm-param-set uuid=<vm-uuid> is-a-template=true
    Экспорт копии указанного шаблона в файл xe template-export template-uuid=<uuid_of_existing_template> filename=<filename_for_new_template>
    Удаление пользовательского шаблона xe template-uninstall template-uuid=<template_uuid> [--force] Эта команда уничтожит те VDI, которые помечены как «принадлежащие» этому шаблону

    Команды управления VBD#

    Команды для работы с виртуальными блочными устройствами.

    VBD — это программный объект, который соединяет ВМ с VDI, представляющим содержимое виртуального диска. VBD имеет атрибуты, которые связывают VDI с ВМ (загрузочный ли он, его метрики чтения/записи и т. д.). VDI имеет информацию о физических атрибутах виртуального диска (какой тип хранилища, является ли диск общим, является ли носитель доступным для чтения/записи или только для чтения и т. д.).

    Действие Команда Примечание
    Вывод списка VBD и их параметров xe vbd-list
    Создание VBD на виртуальной машине xe vbd-create vm-uuid=<uuid_of_the_vm> device=<device_value> vdi-uuid=<uuid_of_vdi_to_connect_to> [bootable=true] [type=Disk|CD] [mode=RW|RO] Допустимые значения для device — целые числа от 0 до 15. Указанное число должно быть уникальным для каждой виртуальной машины. Текущие допустимые значения можно увидеть в параметре allowed-VBD-devices на указанной виртуальной машине. Это рассматривается как userdevice в параметре vbd.
    Если type является Disk, потребуется vdi-uuid. Для диска параметр mode может быть в значении RO или RW.
    Если type является CD, указывать vdi-uuid необязательно. Если UUID VDI не указан, для CD создается пустой VBD. Для компакт-диска (CD) параметр mode должен быть в значении RO
    Уничтожение VBD xe vbd-destroy uuid=<uuid_of_vbd> Если VBD имеет параметр other-config:owner в значении true, соответствующий VDI также уничтожается.
    Извлечение носителя из привода xe vbd-eject uuid=<uuid_of_vbd> Эта команда работает только в том случае, если носитель является съемным (физический CD или ISO). В противном случае появится сообщение об ошибке VBD_NOT_REMOVABLE_MEDIA
    Подключение нового носителя в привод xe vbd-insert uuid=<uuid_of_vbd> vdi-uuid=<uuid_of_vdi_containing_media> Эта команда работает только в том случае, если носитель является съемным (физический CD или ISO). В противном случае появится сообщение об ошибке VBD_NOT_REMOVABLE_MEDIA
    Попытка подключения VBD при включенном ВМ xe vbd-plug uuid=<uuid_of_vbd>
    Попытка отсоединения VBD от ВМ, находящегося во включенном состоянии xe vbd-unplug uuid=<uuid_of_vbd>

    Команды управления VDI#

    Команды для работы с образами виртуальных дисков.

    VDI — это программный объект, представляющий содержимое виртуального диска, видимого виртуальной машиной. VDI отличается от VBD, который является объектом, связывающим виртуальную машину с VDI. VDI содержит информацию о физических атрибутах виртуального диска (какой тип хранилища, является ли диск общим, является ли носитель доступным для чтения/записи или только для чтения и т. д.). VBD содержит атрибуты, связывающие VDI с виртуальной машиной (загрузочный ли он, его метрики чтения/записи и т. д.).

    Действие Команда Примечание
    Вывод списка VDI и их параметров xe vdi-list
    Создание новой, записываемой копии VDI, которую можно использовать напрямую xe vdi-clone uuid=<vdi-uuid> Это вариант vdi-copy, который может предоставить высокоскоростные возможности клонирования образа там, где они существуют
    Копирование VDI в указанное хранилище xe vdi-copy uuid=<vdi-uuid> sr-uuid=<uuid_of_the_destination_sr>
    Создание VDI xe vdi-create sr-uuid=<uuid_of_sr_to_create_vdi_on> name-label=<name_for_the_vdi> type=system|user|suspend|crashdump virtual-size=<size_of_virtual_disk> sm-config-\*=storage_specific_configuration_data Параметр virtual-size может быть указан в байтах или с использованием стандартных суффиксов KiB, MiB, GiB и TiB.
    Примечание. Типы хранилищ, которые поддерживают тонкое выделение дисков (например, Local VHD и NFS), не обеспечивают виртуальное распределение дисков. Будьте очень осторожны при избыточном выделении виртуального дискового пространства на хранилище. Если избыточно выделенное хранилище заполняется, дисковое пространство должно быть доступно либо на целевом хранилище, либо путем удаления неиспользуемых VDI в хранилище.
    Некоторые типы хранилищ могут округлить значение параметра virtual-size, чтобы сделать его делимым на настроенный размер блока
    Уничтожение VDI xe vdi-destroy uuid=<vdi-uuid> Если вы используете отслеживание измененных блоков для создания инкрементных резервных копий VDI, убедитесь, что вы используете команду vdi-data-destroy для удаления снимков, но сохранения метаданных. Не используйте vdi-destroy на снимках VDI, в которых включено отслеживание измененных блоков.
    Для типов Local VHD и NFS SR дисковое пространство не освобождается немедленно vdi-destroy, но периодически во время операции сканирования хранилища. Если вам необходимо принудительно сделать удаленное дисковое пространство доступным, вызовите sr-scan вручную.
    Экспорт VDI xe vdi-export uuid=<vdi-uuid> filename=<filename_to_export_to> [format=format] [base=uuid_of_base_vdi] [--progress] Вы можете экспортировать VDI в одном из следующих форматов:
  • raw
  • vhd

    • Формат VHD может быть разреженным. Если в VDI есть нераспределенные блоки, эти блоки могут быть исключены из файла VHD, что сделает файл VHD меньше. Вы можете экспортировать в формат VHD из всех поддерживаемых типов хранилищ на основе VHD (EXT3/EXT4, NFS).
    Если вы укажете параметр base, эта команда экспортирует только те блоки, которые изменились между экспортированным VDI и базовым VDI.
    Удаление записи VDI из базы данных, не удаляя его из хранилища xe vdi-forget uuid=<vdi-uuid> Для полноценного удаления используйте команду vdi-destroy.
    Импорт VDI xe vdi-import uuid=<vdi-uuid> filename=<filename_to_import_from> [format=format] [--progress] Вы можете экспортировать VDI в одном из следующих форматов:
  • raw
  • vhd
    		•
    Изменение размера VDI xe vdi-resize uuid=<vdi-uuid> disk-size=<new_size_for_disk> Параметр disk-size может быть указан в байтах или с использованием стандартных суффиксов KiB, MiB, GiB и TiB
    Создание версии VDI для чтения и записи, которую можно использовать для создания шаблона xe vdi-snapshot uuid=<vdi-uuid> [driver-params=params] Шаблон можно создать с использованием любых VDI

    Команды управления VLAN#

    Команды для работы с VLAN (виртуальными сетями). Чтобы вывести список и изменить виртуальные интерфейсы, обратитесь к командам PIF, которые имеют параметр VLAN, указывающий на то, что у них есть связанная виртуальная сеть.

    Действие Команда Примечание
    Вывод списка VLAN xe vlan-list
    Создание VLAN на сервере xe vlan-create pif-uuid=<pif-uuid> vlan=<vlan-number> network-uuid=<network-uuid>
    Создание VLAN на всех серверах пула xe pool-vlan-create pif-uuid=<pif-uuid> vlan=<vlan-number> network-uuid=<network-uuid> Создание VLAN на всех серверах пула с определением интерфейса (например, eth0), на котором будет находиться сеть (на каждом сервере), а затем создав и подключив новый объект PIF к каждому серверу соответственно
    Удаление VLAN xe vlan-destroy uuid=<uuid_of_pif_mapped_to_vlan> Требуется указать UUID PIF, который представляеет VLAN

    Команды управления VIF#

    Команды для работы с VIF (виртуальными сетевыми интерфейсами).

    Действие Команда Примечание
    Просмотр списка VIF xe vif-list
    Создание VIF на ВМ xe vif-create vm-uuid=<uuid_of_the_vm> device=<device-value> network-uuid=<uuid_of_network_to_connect_to> [mac=<mac_address>] Допустимые значения для device — целые числа
    Уничтожение VIF xe vif-destroy uuid=<vif-uuid>
    Перенос VIF на другую сеть xe vif-move uuid=<vif-uuid> network-uuid=<network-uuid>
    Подключение VIF к работающей ВМ xe vif-plug uuid=<vif-uuid>
    Отключение VIF от работающей ВМ. xe vif-unplug uuid=<vif-uuid>
    Настройка конфигурации IPv4 для VIF. Настройка static VIF xe vif-configure-ipv4 uuid=<vif-uuid> mode=static address=<CIDR_address> gateway=<gateway_address>
    Настройка конфигурации IPv4 для VIF. Очистка конфигурации IPv4 xe vif-configure-ipv4 uuid=<vif-uuid> mode=none
    Настройка конфигурации IPv6 для VIF. Настройка static VIF xe vif-configure-ipv6 uuid=<vif-uuid> mode=static address=<IP_address> gateway=<gateway_address>
    Настройка конфигурации IPv6 для VIF. Очистка конфигурации IPv6 xe vif-configure-ipv6 uuid=<vif-uuid> mode=none

    Команды управления ВМ#

    В данном разделе описаны базовые команды для управления виртуальными машинами (ВМ).

    Действие Команда Примечание
    Действия с ВМ
    Создание ВМ (импорт) xe vm-import filename=<filename.xva> Создание ВМ путем импорта файла-образа ВМ с расширением ova или xva.
    Данная команда создает ВМ на локальном хранилище сервера.
    Для выбора другого хранилища используйте параметр sr-uuid с указанием uuid необходимого хранилища
    Создание ВМ (из установочного образа) xe vm-install new-name-label=<vm-name> template=<template-name> Создание ВМ из установочного образа.
    Процесс создания ВМ из установочного образа описан в разделе Установка виртуальной машины
    Удаление ВМ (destroy) xe vm-destroy uuid=<vm-uuid> Удаление ВМ. VDI ВМ не будет удален
    Удаление ВМ (uninstall) xe vm-uninstall vm=<vm-name> Полное удаление ВМ, включая ее VDI. Необходимо подтверждение удаления ВМ и VDI
    Копирование ВМ xe vm-copy vm=<vm-name> new-name-label=<vm-copy-name> Создание полной копии ВМ с возможностью выбора целевого хранилища.
    Для выбора целевого хранилища используйте параметр sr-uuid с указанием uuid необходимого хранилища
    Клонирование ВМ xe vm-clone vm=<vm-name> new-name-label=<vm-clone-name> Создание клона ВМ на том же хранилище, на котором расположена исходная ВМ
    Миграция ВМ xe vm-migrate vm=<vm-name> host=<host-name> Выполнение миграции ВМ на другой физический сервер.
    Миграция предназначена для переноса ВМ между серверами c сохранением всех настроек и параметров
    Создание снимка состояния (снапшота) ВМ xe vm-snapshot vm=<vm-name> new-name-label=<snapshot-name> Снимок будет создан на том же хранилище, на котором расположена исходная ВМ
    Управление состоянием ВМ
    Запуск ВМ xe vm-start vm=<vm-name>
    Выключение ВМ xe vm-shutdown vm=<vm-name>
    Перезагрузка ВМ xe vm-reboot vm=<vm-name>
    Приостановка ВМ (suspend) xe vm-suspend vm=<vm-name> Приостановка ВМ с сохранением текущей памяти, состояния процессора, запущенных приложений и с освобождением используемых ресурсов. Возобновление работы ВМ требует некоторое время
    Возобновление работы ВМ (из состояния suspend) xe vm-resume vm=<vm-name>
    Приостановка ВМ (pause) xe vm-pause vm=<vm-name> Приостановка ВМ без сохранения ее состояния на диск, ресурсы не освобождаются. Работа ВМ может быть быстро возобновлена.
    Возобновление работы ВМ (из состояния pause) xe vm-unpause vm=<vm-name>
    Управление параметрами ВМ
    Просмотр всех параметров ВМ xe vm-param-list uuid=<vm-uuid> Вывод списка текущих параметров указанной ВМ
    Задание параметра xe vm-param-set uuid=<vm-uuid> <param-name>=<value> Задание нового значения параметра ВМ
    Очистка параметра xe vm-param-clear param-name=<param-name> uuid=<vm-uuid> Удаление значения параметра ВМ
    Удаление параметра xe vm-param-remove param-name=<param-name> uuid=<vm-uuid> param-key=<key> Удаление существующего параметра ВМ и его значения.
    У каждой ВМ свой набор параметров и ключей. Чтобы посмотреть для конкретной ВМ все param-key нужно либо вывести все параметры вм командой xe vm-param-list, либо конкретный параметр xe vm-param-get param-name=<param-name> и посмотреть в выводе ключи для этого параметра.