Добавление ресурсов ВМ HostedEngine

1. Аннотация

В данной инструкции описан порядок действий для увеличения ресурсов ВМ HostedEngine.

2. Предварительные действия

Для редактирования свойств ВМ HostedEngine на портале администрирования необходимо, чтобы свойство AllowEditingHostedEngine было установлено в значении true.

Для проверки и установки необходимого значения выполните следующие действия:

Подключитесь к ВМ HostedEngine по SSH и авторизуйтесь под пользователем root.
Определите текущее значение параметра AllowEditingHostedEngine:
engine-config -g AllowEditingHostedEngine
Ожидаемый вывод:
AllowEditingHostedEngine: true version: general
Если свойство имеет значение false, измените его на true, выполнив следующие команды:
```
engine-config -s AllowEditingHostedEngine=true
systemctl restart ovirt-engine
```

3. Изменение ресурсов ВМ HostedEngine

3.1. Изменение ОЗУ

Для изменения объема ОЗУ, выделенной для ВМ HostedEngine, выполните следующие действия:

Авторизуйтесь на портале администрирования с правами администратора.
Перейдите в раздел Ресурсы Виртуальные машины.
Выделите ВМ HostedEngine и нажмите Изменить.
В окне Изменить виртуальную машину перейдите на вкладку Система.
Введите необходимое значение свойства Оперативная память (разделяемая)

Добавляемый объем ОЗУ должен быть кратен 256 Мб
Нажмите ОК.

В zVirt 4.5 и страрше объем используемой памяти для сервисов рассчитывается на момент создания ВМ и прописывается в конфигурационных файлах. После добавления ресурсов на портале администратора необходимо внести исправления в конфигурационные файлы:

ovirt-engine
Выделенный объем памяти для ovirt-engine задается в конфигурационном файле /etc/ovirt-engine/engine.conf.d/10-setup-java.conf, в параметрах ENGINE_HEAP_MAX и ENGINE_HEAP_MIN. Обычно, значения этих параметров должны быть равны <объем памяти ВМ в МБ> / 4. Например, если объем памяти ВМ равен 16384 МБ значения этих параметров можно указать как 4096M.
zvirt-engine-backend
Выделенный объем памяти для zvirt-engine-backend задается в конфигурационном файле /etc/zvirt/zvirt-engine-backend.conf, в параметрах HEAP_MAX и HEAP_MIN. Обычно, значения для этих параметров должны быть равны 3 * <объем памяти ВМ в МБ> / 10, но не менее 4096M. Например, если объем памяти ВМ равен 16384 МБ, то значения этих параметров можно указать как 4915M.
ovirt-engine-keycloak
Выделенный объем памяти для ovirt-engine-keycloak задается в конфигурационном файле /usr/share/ovirt-engine-keycloak/conf/ovirt-engine-keycloak.conf, в параметре KEYCLOAK_HEAP_SIZE. Переопределять это значение необходимо в файле /etc/ovirt-engine/engine.conf.d/12-setup-keycloak.conf. Обычно, для Keycloak с числом пользователей около 400 достаточно 512M. Добавляемый объем ОЗУ рекомендуется задавать кратным 512 Мб.

После выполнения изменений в конфигурационных файлах необходимо перезапустить сервис ovirt-engine:

systemctl restart ovirt-engine

3.2. Изменение ЦП

Для изменения количества vCPU, установленных для ВМ HostedEngine, выполните следующие действия:

Авторизуйтесь на портале администрирования с правами администратора.
Перейдите в раздел Ресурсы Виртуальные машины.
Выделите ВМ HostedEngine и нажмите Изменить.
В окне Изменить виртуальную машину перейдите на вкладку Система.
Установите необходимое значение свойства Всего ЦП.
Нажмите ОК.
Перейдите в раздел Ресурсы Хосты.
Определите FQDN/IP адрес хоста, помеченный иконкой .
Подключитесь к этому хосту по SSH и авторизуйтесь под пользователем root.
Включите режим глобального обслуживания:
hosted-engine --set-maintenance --mode=global
Убедитесь, что режим глобального обслуживания включен:
hosted-engine --vm-status
В выводе команды должна присутствовать запись !! Cluster is in GLOBAL MAINTENANCE mode !!.
Выключите ВМ HostedEngine:
hosted-engine --vm-poweroff
Дождитесь выключения ВМ. Её статус можно проверить следующей командой:
hosted-engine --vm-status
Запустите ВМ HostedEngine:
```
hosted-engine --vm-start
```
Дождитесь запуска ВМ. Её статус можно проверить командой hosted-engine --vm-status. Ожидаемый статус:
```
Engine status  : {"vm": "up", "health": "good", "detail": "Up"}
```
Выключите режим глобального обслуживания:
```
hosted-engine --set-maintenance --mode=none
```

В случае, если есть необходимость кратковременного добавления ЦП можно:

Авторизуйтесь на портале администрирования с правами администратора.
Перейдите в раздел Ресурсы Хосты.
Определите FQDN/IP адрес хоста, помеченный иконкой .
Подключитесь к этому хосту по SSH и авторизуйтесь под пользователем root.
Проверьте возможность "живого" добавления vCPU:
virsh -c qemu:///system?authfile=/etc/ovirt-hosted-engine/virsh_auth.conf dumpxml HostedEngine | grep vcpu
Вывод будет содержать информацию, например:
<vcpu placement='static' current='5'>16</vcpu>
В текущем выводе 5 - это текущее количество vCPU, а 16 - максимально допустимое количество

Добавьте vCPU следующей командой:

virsh -c qemu:///system?authfile=/etc/ovirt-hosted-engine/virsh_auth.conf setvcpus HostedEngine 6

В результате выполнения команды ВМ HostedEngine будет назначено 6 vCPU.

3.3. Изменение размера диска

Для увеличения размера диска выполните следующие действия:

Подключитесь к ВМ HostedEngine по SSH и авторизуйтесь под пользователем root.

Выполните следующие команды:

su - postgres
psql
\c engine
update base_disks set disk_content_type=0 where disk_alias='he_virtio_disk';

Авторизуйтесь на портале администрирования с правами администратора.
Перейдите в раздел Ресурсы Виртуальные машины.
Нажмите на имя ВМ HostedEngine для перехода в подробное представление.
На странице подробного представления перейдите на вкладку Диски.
Нажмите Изменить.
В окне Изменить виртуальный диск в поле Увеличить размер на (GB) укажите на какой объем необходимо увеличить диск he_virtio_disk.
Дождитесь успешного завершения операции увеличения диска.
Вернитесь в SSH консоль ВМ HostedEngine и выполните команды:
```
update base_disks set disk_content_type=5 where disk_alias='he_virtio_disk';
exit
exit
exit
```

Дальнейшее распределение дополнительного объема зависит от нужд среды.

Например, для увеличения корневого раздела выполните следующие действия:

growpart /dev/vda 2
pvresize /dev/vda2
lvextend -r -l +100%FREE /dev/mapper/ovirt-root

4. Завершение

По завершению работ по изменению параметров ВМ HostedEngine рекомендуется установить свойство AllowEditingHostedEngine в значении false:

engine-config -s AllowEditingHostedEngine=false
systemctl restart ovirt-engine