Обновление zVirt

В zVirt 5.0 используется ядро Linux 6.1.158. В связи с переходом на новую платформу поддержка ядра 4.18 прекращена, начиная с данной версии.

1. Рекомендуемый алгоритм обновления

Обновление zVirt c архитектурой Hosted Engine

Подготовьте сервисную ВМ zvirt-upgrade.
Обновите хосты.
Обновите Менеджер управления.
При необходимости обновите версии совместимости кластеров и центров данных.

Обновление zVirt c архитектурой Standalone

Подготовьте сервисную ВМ zvirt-upgrade.
Обновите хосты.
Обновите Менеджер управления.
При необходимости обновите версии совместимости кластеров и центров данных.

1.1. Особенности и ограничения

Если в среде используются модули "Репликация и DR" или/и "Конвертация", необходимо учитывать следующие особенности:

Для модуля "Репликация и DR. Аппаратная репликация"

Перед обновлением необходимо дождаться завершения активных процессов:
- плановое перемещение
- аварийное перемещение
- обратное перемещение
Рекомендуется перевести планы аппаратной репликации в исходное состояние, при котором они готовы к выполнению планового перемещения.

После завершения процесса обновления необходимо проверить на хостах IQN (значения не должны измениться).

Если значение IQN изменилось, возможны следующие варианты:

указать прежнее значение IQN в файле /etc/iscsi/initiatorname.iscsi с последующей перезагрузкой хоста;
обновить значение IQN на стороне СХД.

Для модуля "Репликация и DR. Программная репликация"

Перед обновлением необходимо:
- остановить процесс репликации для групп репликации;
- отсоединить либо удалить задания на восстановление.
Перед обновлением рекомендуется убедиться, что репликация функционирует корректно и у виртуальных машин есть точки восстановления в РЦОД.
После завершения процесса обновления необходимо обновить контроллер репликации и агентов.

Подробнее см. в статье Репликация и DR. Программная репликация.

Для модуля "Конвертация"

Перед обновлением необходимо:
- дождаться завершения процесса репликации для реплицируемых ВМ;
- отсоединить либо удалить задачи на конвертацию.
После завершения процесса обновления хостов и Менеджера управления необходимо обновить контроллер конвертации и агентов.

Подробнее см. в статье Конвертация виртуальных машин.

2. Процедура обновления

Предварительные требования:

Менеджер управления обновлен до версии 4.5 с обновлением №3.
Создана полная резервная копия Менеджера управления
Убедитесь, что на хостах достаточно ресурсов для миграции работающих виртуальных машин, либо предварительно выключите их.

2.1. Подготовка сервисной ВМ

Порядок действий:

На один из хостов загрузить образ сервисной виртуальной машины zvirt-upgrade-XXXXXXXX.ova (где XXXXXXXX — версия) с помощью команды wget:
```
wget https://repo-zvirt.orionsoft.ru/repository/zvirt-5/5.0/iso/zvirt-upgrade-XXXXXX.ova
```
Перейти в Ресурсы (Compute) Виртуальные машины (Virtual Machines) и нажать Импортировать(Import).
В окне Импорт ВМ указать хост на который был загружен образ сервисной ВМ zvirt-upgrade-XXXXXXXX.ova и путь до файла с образом.
Нажать Загрузить(Load).
Переместить ВМ zvirt-upgrade в список Виртуальные машины для импорта и нажать Далее.
Проверить параметры и нажать OK.
Дождаться окончания импорта и запустить ВМ zvirt-upgrade.
Нажать Консоль (Console), чтобы подключиться к ВМ zvirt-upgrade. В случае выбора Консоль VNC или Консоль SPICE вам будет предложено загрузить файл .vv.
Откройте файл с помощью virt-viewer.

При подключении по протоколу SSH используйте пользователя root с паролем zvirt.

2.2. Обновление хостов

Перед обновлением хостов учтите следующие особенности и ограничения:

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

Для предотвращения сбоев при массовой миграции виртуальных машин (ВМ) с обновляемых хостов, ВМ zvirt-upgrade следует вручную перенести на хост, не участвующий в процессе обновления (например, на уже обновлённый хост).

Хосты с ВМ Hosted Engine в архитектуре Hosted Engine или хосты с менеджером управления в архитектуре Standalone необходимо обновлять последними.

Порядок действий:

Подключиться к сервисной ВМ zvirt-upgrade.
Oзнакомиться с инструкцией по обновлению.
Дальнейшие действия будут выполняться внутри сервисной ВМ.
1. Нажать Выход для перехода к Главному меню инструкции.
2. В меню выбрать пункт 1 Настроить сеть и указать параметры IP-адресации для сервисной ВМ.
3. Будет запущена утилита nmtui.
4. Перейти в раздел Изменить подключение.
5. Выделить нужный интерфейс и нажмите Enter.
6. Изменить следующие параметры:
  - Метод назначения указать Вручную(Manual).
  - Нажать Показать(Show).
  - Ввести ipv4-адрес в формате address/prefix
  - Убедиться, что активна опция Подключаться автоматически(Automatically connect).
  - Нажать OK.
  - В разделе Активировать подключение(Activate connection) деактивировать и снова активировать соединения.
7. В меню выбрать пункт 2 Настроить параметры доступа к системе управления виртуализацией и указать:
  1. IP-адрес Менеджера управления
  2. Имя пользователя с ролью SuperUser в формате <имя>@internalsso (например, admin@zvirt@internalsso).
    
    При использовании провайдера AAA JDBC имя пользователя указывается в формате <имя>@internal (например, admin@internal).
  3. Пароль от пользователя с ролью SuperUser
  4. Пароль пользователя root от ВМ Hosted Engine или от хоста при установке в архитектуре Standalone.
  5. Указанные параметры будут сохранены в файле playbooks/vars/secrets.yml.
8. В меню выбрать пункт 3 Получить данные для обновления
  1. Дождаться окончания процесса получения данных.
  2. Нажать Выход для перехода к Главному меню инструкции.
Выполнить обновление стандартных хостов.
1. В меню выбрать пункт 4 Выбрать и обновить хосты.
  1. В списке выбрать один или несколько хостов и нажать OK
  2. Дождаться окончания подготовки хоста к обновлению и нажать Выход.
  3. Подтвердить запуск переустановки для выбранных хостов.
  4. После окончания переустановки хостов нажать Выход.
2. Подключиться к Порталу администрирования.
3. Нажать Ресурсы (Compute) Хосты (Hosts) и выбрать из списка обновленный хост.
4. Перейти в подробное представление и во вкладке Общее убедиться в том что версия ОС zVirt Node 5.0.
5. При обновлении хостов по очереди действия с шага Выбрать и обновить хосты повторить для всех стандартных хостов.
При установке с архитектурой Hosted Engine подключиться к консоли хоста на котором работает ВМ Hosted Engine.
1. Выключить ВМ Hosted Engine с помощью команды:
  hosted-engine --vm-shutdown
2. Подключиться к консоли обновленного хоста и запустить ВМ Hosted Engine с помощью команды:
  hosted-engine --vm-start
3. Проверить запуск ВМ Hosted Engine с помощью команды:
  hosted-engine --vm-status
4. Выполнить обновление хоста на котором работала ВМ Hosted Engine.

2.3. Обновление Менеджера управления в архитектуре Hosted Engine

Предварительные требования:

Подготовлен обновленный хост с zVirt Node 5.0.

Порядок действий

Подключиться по SSH к менеджеру управления.
1. Сделать полную резервную копию конфигурации с помощью команды:
  engine-backup
2. Скопировать файл резервной копии в хранилище вне системы виртуализации.
  scp /var/lib/ovirt-engine-backup/ovirt-engine-backup-<date>.backup root@<deploy-host>:/root/
Подключиться к сервисной ВМ zvirt-upgrade.
1. В меню выбрать пункт 4 Обновить ВМ Hosted Engine.
2. Дождаться окончания процесса обновления.
При возникновении ошибки обновления ВМ Hosted Engine рекомендуется обратиться в техническую поддержку.

2.4. Обновление Менеджера управления в архитектуре Standalone

Порядок действий

Подключиться к консоли хоста на котором работает Менеджер управления.
1. Сделать полную резервную копию конфигурации с помощью команды:
  engine-backup
2. Скопировать файл резервной копии в хранилище вне системы виртуализации.
  scp /var/lib/ovirt-engine-backup/ovirt-engine-backup-<date>.backup root@<deploy-host>:/<directory>/
Переустановить на хосте ОС на zVirt Node 5.0 согласно инструкции.
Выполнить восстановление конфигурации на новый хост согласно инструкции.