Утилита hosted-engine

1. Назначение утилиты hosted-engine.

Утилита hosted-engine предназначена для управления виртуальной машиной HostedEngine с хоста zVirt.

Запустить hosted-engine можно на любом узле с ролью hosted engine.

2. Синтаксис утилиты hosted-engine.

Базовый синтаксис:

hosted-engine [--help] <command> [<command-args>]

Получение подробной информации об использовании:

hosted-engine --help

Получение дополнительной информации по конкретной команде:

hosted-engine --<command> --help (1)

1	Команда, информацию о которой необходимо получить.

Таблица 1. Базовые команды утилиты hosted-engine
Команда	Описание
`--help`	Показать справку
`--deploy [options]`	Запустить развертывание ВМ HostedEngine
`--vm-start`	Запустить ВМ HostedEngine на хосте
`--vm-start-paused`	Запустить ВМ HostedEngine на хосте с остановленным агентом qemu
`--vm-shutdown`	Корректное выключение ВМ HostedEngine на хосте
`--vm-poweroff`	Принудительное выключение ВМ HostedEngine на хосте
`--vm-status [--json]`	Состояние ВМ HostedEngine по данным агента HA. `--json` - вывод в формате JSON
`--add-console-password [--password=<password>]`	Создание временного пароля для vnc/spice соединения. `--password` - задать пароль. В противном случае будет использоваться переменная окружения `OVIRT_HOSTED_ENGINE_CONSOLE_PASSWORD` если она была установлена, пароль будет прочитан в интерактивном режиме
`--config-append=<file>`	Загрузить дополнительные файлы конфигурации или файлы ответов
`--check-deployed`	Проверка наличия развернутой ВМ HostedEngine
`--check-liveliness`	Проверка состояния ВМ HostedEngine
`--connect-storage`	Подключить домен хранения где расположена ВМ HostedEngine
`--disconnect-storage`	Отключить домен хранения где расположена ВМ HostedEngine
`--console`	Открыть последовательную консоль
`--set-maintenance --mode=<mode>`	Установить статус обслуживания в один из следующих режимов: `global` - глобальный режим, `local` - локальный режим, `none` - отключение режима обслуживания.
`--set-shared-config <key> <value> [--type=<type>]`	Установить значение для указанного ключа. Если ключ дублируется в нескольких файлах, то должен быть установлен тип.
`--get-shared-config <key> [--type=<type>]`	Получить значения для указанного ключа. Если ключ дублируется в нескольких файлах, то должен быть установлен тип.
`--reinitialize-lockspace`	Повторная инициализация блокировки области sanlock. Убедитесь что все агенты отключены.
`--clean-metadata`	Удалить метаданные для агента текущего хоста из глобальной базы данных, что заставляет другие хосты забыть об этом хосте.

Таблица 2. Субкоманды и опции для `hosted-engine --deploy`
Команда	Описание
`--help`	Показать справку по команде `--deploy`.
`--config-append=<file>`	Позволяет указать дополнительные файлы конфигурации или файлы ответов, которые будут использоваться при развертывании.
`--generate-answer=<file>`	Позволяет сгенерировать файл ответов.
`--restore-from-file=<file>`	Позволяет восстановить конфигурацию Менеджера управления из файла резервной копии во время развертывания.
`--4`	Принудительное использование IPv4 в Dual Stack среде.
`--6`	Принудительное использование IPv6 в Dual Stack среде.
`--ansible-extra-vars=DATA`	Позволяет передать дополнительные переменные для Ansible в процессе развертывания. Переменные передаются в формате `var=value`, например, `hosted-engine --deploy --ansible-extra-vars=he_ipv4_subnet_prefix=192.168.222`

3. Обновление конфигурации hosted engine

Чтобы обновить конфигурацию hosted engine, воспользуйтесь командой hosted-engine --set-shared-config. Эта команда обновляет конфигурацию hosted engine в общем домене хранения после первоначального развертывания.

Чтобы просмотреть текущие значения параметров конфигурации, воспользуйтесь командой hosted-engine --get-shared-config.

Чтобы просмотреть список всех доступных ключей конфигурации и соответствующих им типов, введите следующую команду:

hosted-engine --set-shared-config <key> --type=<type> --help

где type может принимать одно из следующих значений:

Значение Описание

Значение	Описание
`he_local`	Устанавливает значения в локальном экземпляре /etc/ovirt-hosted-engine/hosted-engine.conf на локальном хосте, поэтому только этот хост использует новые значения. Чтобы применить новое значение, перезапустите службы ovirt-ha-agent и ovirt-ha-broker.
`he_shared`	Устанавливает значения в /etc/ovirt-hosted-engine/hosted-engine.conf на общем хранилище, поэтому все хосты, развернутые после изменения конфигурации, используют эти значения. Чтобы применить новое значение на существующем хосте, переустановите этот хост.
`ha`	Устанавливает значения в /var/lib/ovirt-hosted-engine-ha/ha.conf на локальном хранилище. Новые настройки вступают в силу немедленно.
`broker`	Устанавливает значения в /var/lib/ovirt-hosted-engine-ha/broker.conf на локальном хранилище. Чтобы применить новые настройки, перезапустите службу ovirt-ha-broker.

he_local

Устанавливает значения в локальном экземпляре /etc/ovirt-hosted-engine/hosted-engine.conf на локальном хосте, поэтому только этот хост использует новые значения. Чтобы применить новое значение, перезапустите службы ovirt-ha-agent и ovirt-ha-broker.

he_shared

Устанавливает значения в /etc/ovirt-hosted-engine/hosted-engine.conf на общем хранилище, поэтому все хосты, развернутые после изменения конфигурации, используют эти значения. Чтобы применить новое значение на существующем хосте, переустановите этот хост.

ha

Устанавливает значения в /var/lib/ovirt-hosted-engine-ha/ha.conf на локальном хранилище. Новые настройки вступают в силу немедленно.

broker

Устанавливает значения в /var/lib/ovirt-hosted-engine-ha/broker.conf на локальном хранилище. Чтобы применить новые настройки, перезапустите службу ovirt-ha-broker.