Утилита vdsm-client

vdsm-client

Средство командной строки, может использоваться для выполнения команд: запуска ВМ, управления хранилищем, устройствами и т.д.

Использование команды:

vdsm-client [-h] [-a ADDRESS] [-p PORT] [–insecure] [–timeout TIMEOUT] [-f FILE] namespace method [name=value [name=value] …]

Если аргументы не передаются, vdsm-клиент подключится к localhost.

Описание команд доступно в консоли. Для получения описания, к команде требуется добавить параметр –h.

Пример:

vdsm-client -h

Примеры выполнения команд:

  1. Получение списка ВМ:

    vdsm-client Host getVMList
    vdsm-client Host getVMList fullStatus=True

    Остановленные ВМ не показываются т.к. не определены.

  2. Получение информации о хосте:

    vdsm-client Host getCapabilities

    Получение статистики хоста:

    vdsm-client Host getStats
  3. Получение статистики работающих ВМ:

    vdsm-client Host getAllVmStats
  4. Получение сведений о VG хранилище:

    vdsm-client Host getLVMVolumeGroups
  5. Остановка виртуальной машины:

    • получить vmId:

      vdsm-client Host getVMList fullStatus=True
    • выключить виртуальную машину:

      vdsm-client VM destroy vmID=
  6. Возобновление ВМ:

    • получить vmId:

      vdsm-client Host getVMList fullStatus=True
    • возобновить работу ВМ:

      vdsm-client VM cont vmID=
  7. Настройка vnc для подключения к ВМ :

    • получить идентификатор ВМ и displayPort:

      vdsm-client Host getVMList fullStatus=True
    • установить пароль vnc для ВМ:

      vdsm-client VM setTicket vmID= password= ttl=0 existingConnAction=keep params={val:key}
    • попробовать использовать vnc-клиент:

      vncviewer :

Полный список команд для управления ВМ представлен в таблице 1.

Таблица 1 – Полный список команд для управления ВМ

Команда

Описание

vdsm-client VM changeFloppy vmID=<>

Заменить диск в дисководе ВМ

vdsm-client VM thaw vmID=<>

Разморозить смонтированные файловые системы в гостевой системе (следовательно, может потребоваться гостевой агент в зависимости от используемого гипервизора)

vdsm-client VM changeCD vmID=<>

Заменить диск в устройстве CD-ROM ВМ

vdsm-client VM start_backup vmID=<>

Запустить резервное копирование для указанной ВМ и выбранных дисков этой ВМ

vdsm-client VM desktopSendHcComman vmID=<>

Отправить гостевому агенту произвольную команду

vdsm-client VM setNumberOfCpus vmID=<>

Установить количество процессоров для ВМ

vdsm-client VM getInfo vmID=<>

Получить подробную информацию о ВМ

vdsm-client VM migrate vmID=<>

Перенести ВМ на удаленный хост

vdsm-client VM delete_checkpoints vmID=<>

Удалить указанные идентификаторы контрольных точек

vdsm-client VM merge vmID=<>

Выполнить «живое» слияние диска ВМ, чтобы удалить ненужный моментальный снимок. Все данные между baseVolUUID и topVolUUID будут объединены в baseVolUUID, а любые снимки, зависящие от topVolUUID, теперь будут зависеть от baseVolUUID

vdsm-client VM diskSizeExtend vmID=<>

Увеличить виртуальный размер диска за счет работающей ВМ

vdsm-client VM seal vmID=<>

Запустить virt-sysprep на всех образах дисков ВМ, удалив всю машиннозависимую конфигурацию из файловой системы

vdsm-client VM migrationCreate vmID=<>

Запустить мигрирующую ВМ на целевом хосте

vdsm-client VM getStats vmID=<>

Получить статистику о работающей ВМ

vdsm-client VM hibernate vmID=<>

Сохранить текущее состояние ВМ на диск и остановить его

vdsm-client VM redefine_checkpoint vmID=<>

Переопределить контрольные точки ВМ с указанным списком

vdsm-client VM stop_backup vmID=<>

Остановить резервное копирование с указанным UUID

vdsm-client VM desktopLogin vmID=<>

Войти в гостевую операционную систему

vdsm-client VM setIoTune vmID=<>

Установить параметры ioTune для блочных устройств

vdsm-client VM desktopLogoff vmID=<>

Выйти из системы активного пользователя гостевой операционной системы

vdsm-client VM cont vmID=<>

Возобновить приостановленную ВМ

vdsm-client VM hotplugMemory vmID=<>

Выполнить горячее подключение памяти к работающему узлу NUMA ВМ

vdsm-client VM setCpuTunePeriod vmID=<>

Установить параметр настройки периода vCpu для ВМ

vdsm-client VM diskReplicateFinish vmID=<>

Остановить репликацию переключения диска в место назначения

vdsm-client VM hostdevHotplug vmID=<>

Добавить новое хост-устройство к работающей ВМ

vdsm-client VM migrateChangeParams vmID=<>

Изменить параметры текущей миграции

vdsm-client VM hostdevHotunplug vmID=<>

Удалить хост-устройство из работающей ВМ

vdsm-client VM shutdown vmID=<>

Выполнить правильное завершение работы ВМ

vdsm-client VM hotplugDisk vmID=<>

Добавить новое дисковое устройство к работающей ВМ

vdsm-client VM getIoTunePolicy vmID=<>

Получить параметры политики ioTune для блочных устройств

vdsm-client VM getIoTune vmID=<>

Установить параметры ioTune для блочных устройств

vdsm-client VM getMigrationStatus vmID=<>

Сообщить статистику миграции ВМ, о ходе выполнения или статистику по выполненной миграции

vdsm-client VM destroy vmID=<>

Принудительно остановить работающую ВМ

vdsm-client VM hotplugNic vmID=<>

Добавить новое сетевое устройство к работающей ВМ

vdsm-client VM hotunplugLease vmID=<>

Удалить арендованное устройство из работающей ВМ

vdsm-client VM pause vmID=<>

Приостановить работающей ВМ

vdsm-client VM setDestroyOnRebootvmID=<>

Установить ловушку для выключения ВМ при перезагрузке, инициированной гостем

vdsm-client VM hotplugLease vmID=<>

Добавить новое арендованное устройство к работающей ВМ

vdsm-client VM hotunplugMemory vmID=<>

Оперативно отключить память от работающей ВМ

vdsm-client VM setTicket vmID=<>

Установить пароль, который будет использоваться для подключения к дисплею ВМ

vdsm-client VM diskReplicateStart vmID=<>

Запустить репликацию диска в место назначения

vdsm-client VM desktopLock vmID=<>

Заблокировать активный сеанс пользователя в гостевой операционной системе

vdsm-client VM updateDevice vmID=<>

Обновить статус устройства ВМ

vdsm-client VM setCpuTuneQuota vmID=<>

Установить параметр настройки квоты vCpu для ВМ

vdsm-client VM create vmID=<>

Создать новую ВМ

vdsm-client VM backup_info vmID=<>

Получить информацию о резервной копии ВМ

vdsm-client VM freeze vmID=<>

Заморозить смонтированные файловые системы в гостевой системе (следовательно, может потребоваться гостевой агент в зависимости от используемого гипервизора)

vdsm-client VM reset vmID=<>

Перезагрузить ВМ

vdsm-client VM updateVmPolicy vmID=<>

Установить параметры SLA ВМ

vdsm-client VM migrateCancel vmID=<>

Отменить текущий исходящий процесс миграции

vdsm-client VM getDiskAlignment vmID=<>

Проверить разделы диска ВМ

vdsm-client VM setBalloonTarget vmID=<>

Динамически изменить целевой объем физической памяти, выделенной гостю

vdsm-client VM hotunplugDisk vmID=<>

Удалить дисковое устройство из работающей ВМ

vdsm-client VM snapshot vmID=<>

Создать мгновенный снимок дисков ВМ

vdsm-client VM hotunplugNic vmID=<>