Руководство по обновлению zVirt Ред ОС

Версия zVirt: 3.1.2 Red OS

1. Введение

В данной инструкции описывается процедура обновления системы управления виртуализацией до версии 3.x. Используется следующая терминология:

Хост - Физический сервер или персональный компьютер.
Гипервизор - это хост, на котором работает одна или несколько виртуальных машин.
Менеджер управления - программное обеспечение zVirt, обеспечивающее управление системой виртуализации;
Хост с ролью HostedEngine - гипервизор, подготовленный для выполнения на нём виртуальной машины HostedEngine;
Хост с ВМ HostedEngine - гипервизор с ролью HostedEngine, на котором в текущий момент времени выполняется эта ВМ;
Хост с менеджером управления - физический сервер или персональный компьютер, на котором установлен менеджер управления в режиме развёртывания Standalone;
Хост с менеджером управления и ролью гипервизора - гипервизор, на котором установлен менеджер управления в режиме развёртывания Standalone All-in-One.
Виртуальная машина HostedEngine - специальная виртуальная машина, на которой установлен менеджер управления. Выполняется только на хостах с ролью HostedEngine. zVirt развёрнут в режиме HostedEngine;
режимы развёртывания zVirt:
- Hosted Engine - менеджер управления установлен в специальной виртуальной машине HostedEngine, которая выполняется на хостах с ролью HostedEngine;
- Standalone - менеджер управления установлен на отдельном физическом хосте, который не выполняет функцию гипервизора;
- Standalone All-in-One - менеджер управления установлен на физическом хосте, который выполняет функцию гипервизора.

Обновление zVirt до версии 3.x заключается в обновлении программного обеспечения менеджера управления и гипервизоров, для чего на первом этапе производится настройка необходимых репозиториев. Далее в инструкции в командах настройки доступа к репозиториям будут встречаются <имя_пользователя> <пароль>, их следует заменить (вместе с угловыми скобками) на имя пользователя (логин) и пароль, которые указаны в лицензионном сертификате, выданном при покупке продукта.

Перед началом обновления гипервизоров, хостов с ролью HostedEngine, их требуется переводить в режим обслуживания, для чего необходимо обеспечить отсутствие на нём выполняющихся виртуальных машин. Если в кластере несколько гипервизоров и на них достаточно ресурсов для приёма виртуальных машин, с подготавливаемого к обновлению гипервизора, и они не закреплены на нём с помощью меток и групп сходства, то включите режим обслуживания, дождитесь окончания миграции ВМ и приступайте к обновлению. Если же к обновляемому гипервизору прикреплены группами и метками сходства виртуальные машины, перевести его в режим обслуживания с первого раза не получится - появится окно сообщения о невозможности включения режима обслуживания. Закройте окно, выключите те машины, которые не начали миграцию, дождитесь окончания миграции и выключения ВМ, активируйте гипервизор и снова переведите его в режим обслуживания. Если гипервизор единственный в кластере, в режим обслуживания переводить не надо, выключите или мигрируйте все выполняющиеся на нём виртуальные машины и после завершения их работы на хосте приступайте к обновлению, при этом выключение ВМ HostedEngine осуществите командой:

hosted-engine --vm-shutdown

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

2. Обновление репозиториев

Описанная ниже последовательность действий позволит обновить репозитории zVirt до версии 3.x

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

Удалите старый репозиторий redos-repos-zvirt-stable:
- Для онлайн репозиториев:
  dnf remove -y redos-repos-zvirt-stable
- Для оффлайн репозиториев:
  umount /mnt rm -rf /var/zvirt-repo
- Очистите директорию /etc/yum.repos.d/
  rm -rf /etc/yum.repos.d/* dnf clean all

Скачайте и установите новые репозитории.

wget --user=<имя_пользователя> --password=<пароль> http://repo-zvirt-redos.orionsoft.ru/repository/zvirt-3-redos73-stable-main/3.X/el7/noarch/redos-repos-zvirt-stable-3.X.X-X.XXXX.zvirt.el7.noarch.rpm

dnf install -y redos-repos-zvirt-stable-3.X.X-X.XXXX.zvirt.el7.noarch.rpm

<имя_пользователя> и <пароль> берутся из лицензионного сертификата, выданного при покупке продукта.

Установите утилиту zvirt-credentials, где здесь и далее <имя_пользователя> и <пароль> берутся из лицензионного сертификата, выданного при покупке продукта::
wget --user=<имя_пользователя> --password=<пароль> http://repo-zvirt-redos.orionsoft.ru/repository/zvirt-3-redos73-stable-main/3.1/el7/noarch/zvirt-credentials-0.1.1-1.10778.zvirt.el7.noarch.rpm dnf install zvirt-credentials-0.1.1-1.10778.zvirt.el7.noarch.rpm -y
<имя_пользователя> и <пароль> берутся из лицензионного сертификата, выданного при покупке продукта.

Настройте доступ к репозиториям::

zvirt-credentials -u <имя_пользователя> -p <пароль>

Убедитесь, что новые репозитории активны и отсутствуют лишние репозитории:
```
dnf repolist all
```

3. Обновление zVirt в режиме развёртывания HostedEngine

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

hosted-engine --set-maintenance --mode=global
hosted-engine --vm-status

Убедитесь, что включен режим глобального обслуживания - в выводе должна присутствовать надпись !! Cluster is in GLOBAL MAINTENANCE mode !!:

Теперь можете приступить к обновлению менеджера управления.

3.1. Обновление менеджера управления в виртуальной машине HostedEngine

Подключитесь по SSH к ВМ HostedEngine.
Удалите все зафиксированные версии пакетов из списка versionlock.list и убедитесь, что список пуст:
```
dnf versionlock clear
dnf versionlock list
```
Обновите репозитории в соответствии с инструкцией.
Выполните команды обновления пакетов:
```
dnf update -y zvirt-appliance
dnf -y update --allowerasing
```
Запустите установку Engine:
```
engine-setup --offline
```
После завершения установки перезапустите сервис:
```
systemctl restart ovirt-engine.service
```
Выйдите из режима глобального обслуживания:
```
hosted-engine --set-maintenance --mode=none
hosted-engine --vm-status
```
В выводе команды не должно присутствовать уведомления о включенном режиме глобального обслуживания.

Обновления менеджера управления в ВМ HostedEngine завершено. Проверить обновление можно на странице входа веб-интерфейса.

3.2. Обновление хостов с ролью HostedEngine

Переведите хост в режим обслуживания если хостов с такой ролью несколько, иначе выключите или мигрируйте все виртуальные машины на хосте (подробнее смотрите во врезке Внимание во Введении).
Подключитесь по SSH к хосту.
Обновите репозитории в соответствии с инструкцией.
Выполните команды обновления пакетов (при offline установке и отработке скрипта create_repo.sh выполнение данных команд не обязательно):
```
dnf update -y zvirt-hosted-engine
dnf -y update --allowerasing
```
После завершения установки перезапустите сервис:
```
systemctl restart vdsmd.service
```
Если хост с ролью HostedEngine является единственным хостом такого типа в кластере, то запустите ВМ HostedEngine:
```
hosted-engine --vm-start
```
Выведите гипервизор из обслуживания, нажав кнопку Включить в веб-интерфейсе или выполнив команду:
```
hosted-engine --set-maintenance --mode=none
```
Переходите к обновлению гипервизоров как описано в разделе Обновление гипервизоров.

4. Обновление zVirt в режимах развёртывания Standalone и Standalone All-in-One

4.1. Обновление менеджера управления

Если zVirt развёрнут в режиме Standalone в вариации All-in-One и к хосту привязаны виртуальные машины, переведите хост в режим обслуживания (подробнее смотрите во врезке Внимание во Введении)

Для перехода на zVirt Ред ОС 3.X, выполните следующие действия:

Подключитесь по SSH к хосту с менеджером управления.
Обновите репозитории в соответствии с инструкцией.
Выполните команды обновления пакетов (при offline установке и отработке скрипта create_repo.sh выполнение данных команд не обязательно):
```
dnf update/install -y zvirt-standalone
dnf update -y --allowerasing
```
Запустите установку Engine:
```
engine-setup --offline
```
После завершения установки перезапустите сервис ovirt-engine:
```
systemctl restart ovirt-engine.service
```
В случае ежима standalone с вариацией all-in-one также перезапустите сервис vdsmd:
```
systemctl restart vdsmd.service
```

Обновления менеджера управления (и его хоста в вариации All-in-one) завершено.

Проверить обновление можно на странице входа веб-интерфейса.

5. Обновление гипервизоров

Переведите хост в режим обслуживания (подробнее смотрите во врезке Внимание во Введении).
Подключитесь по SSH к хосту.
Настройте доступ к репозиториям в соответствии с инструкцией.
Выполните команды обновления пакетов (при offline установке и отработке скрипта create_repo.sh выполнение данных команд не обязательно):

dnf update/install -y zvirt-hosted-engine
dnf -y update --allowerasing

После завершения установки перезапустите сервис:
```
systemctl restart vdsmd.service
```
Выведите гипервизор из обслуживания, нажав кнопку Включить в веб-интерфейсе.
Переходите к обновлению следующего гипервизора.

6. Возможные ошибки

Ошибка 1: --- После обновления и перезагрузки хоста с ролью HostedEngine, который является единственным с этой ролью, может не запуститься ВМ HostedEngine:

hosted-engine --vm-status
The hosted engine configuration has not been retrieved from shared storage yet,
please ensure that ovirt-ha-agent service is running.

В этом случае следует перезапустить сервис ovirt-ha-agent:

systemctl restart ovirt-ha-agent

и через некоторое время проверить состояние ВМ:

hosted-engine --vm-status


--== Host znode1.local.ru (id: 1) status ==--

Host ID                            : 1
Host timestamp                     : 608
Score                              : 3400
Engine status                      : {"vm": "up", "health": "good", "detail": "Up"}