Для улучшения работы сайта мы используем файлы cookies. Оставаясь на сайте, вы соглашаетесь с политикой обработки персональных данных.

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

Версия zVirt: 4.1

1. Введение

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

  • Хост - Физический сервер или персональный компьютер.

  • Гипервизор - это хост, на котором работает одна или несколько виртуальных машин.

  • Менеджер управления - программное обеспечение zVirt, обеспечивающее управление системой виртуализации;

  • Хост с ролью HostedEngine - гипервизор, подготовленный для выполнения на нём виртуальной машины HostedEngine;

  • Хост с ВМ HostedEngine - гипервизор с ролью HostedEngine, на котором в текущий момент времени выполняется эта ВМ;

  • Стандартный хост - гипервизор, на котором не может выполняться виртуальная машина HostedEngine;

  • Хост с менеджером управления - физический сервер или персональный компьютер, на котором установлен менеджер управления в режиме развёртывания Standalone;

  • Хост с менеджером управления и ролью гипервизора - гипервизор, на котором установлен менеджер управления в режиме развёртывания Standalone All-in-One.

  • Виртуальная машина HostedEngine - специальная виртуальная машина, на которой установлен менеджер управления. Выполняется только на хостах с ролью HostedEngine. zVirt развёрнут в режиме HostedEngine;

  • режимы развёртывания zVirt:

    • Hosted Engine - менеджер управления установлен в специальной виртуальной машине HostedEngine, которая выполняется на хостах с ролью HostedEngine;

    • Standalone - менеджер управления установлен на отдельном физическом хосте, который не выполняет функцию гипервизора;

    • Standalone All-in-One - менеджер управления установлен на физическом хосте, который выполняет функцию гипервизора.

Обновление zVirt до версии 4.X заключается в обновлении программного обеспечения менеджера управления и гипервизоров, а также обновлении версий совместимости кластеров и центров данных до последней версии.

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

Перед выполнением обновления до версии 4.X необходимо выполнить обновление текущей версии до 3.3

Перед началом обновления гипервизоров (стандартных хостов и хостов с ролью HostedEngine), их требуется переводить в режим обслуживания, для чего необходимо обеспечить отсутствие на нём выполняющихся виртуальных машин:

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

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

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

    hosted-engine --vm-shutdown

При обновлении будет остановка трафика в рамках SDN с момента обновления engine, поэтому следует предусмотреть сервисное окно.

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

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

Обновление zVirt в режиме Hosted Engine

  1. Обновите ВМ HostedEngine.

  2. Обновите все свободные хосты с ролью HostedEngine. Под "свободными" понимаются хосты, на которых в текущий момент не выполняется ВМ HostedEngine.

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

  4. Обновите стандартные хосты

  5. Обновите версии совместимости кластеров и центров данных

Обновление zVirt в режимах Standalone и Standalone All-in-One

  1. Обновите Менеджер управления.

  2. Обновите стандартные хосты

  3. Обновите версии совместимости кластеров и центров данных

При отсутствии сетевого доступа к онлайн-репозиториям zVirt, можно настроить локальные репозитории в соответствии с инструкцией.

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

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

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

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

img1

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

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

  1. Подключитесь по SSH к виртуальной машине HostedEngine.

  2. Обновите репозитории в соответствии с разделом Обновление репозиториев

  3. Установите пакет zvirt-appliance:

    dnf install -y zvirt-appliance

  4. Выполните обновление программного обеспечения:

    dnf -y update --allowerasing

  5. Запустите установку Engine:

    engine-setup --offline

  6. Установите дополнительный пакет для исправления кодов типов гостевых ОС:

    dnf install -y typeosupdater

  7. После завершения установки перезапустите сервисы:

    systemctl restart ovirt-engine ovirt-provider-ovn zvirt-engine-backend

  8. Верните рабочий режим на хосте с ВМ HostedEngine и убедитесь, что режим глобального обслуживания выключен (в выводе отсутствует уведомление !! Cluster is in GLOBAL MAINTENANCE mode !!):

    hosted-engine --set-maintenance --mode=none
hosted-engine --vm-status
    img4
    Рисунок 1. Ожидаемый статус ВМ HostedEngine

    Если ВМ HostedEngine не запустилась, запустите её:

    hosted-engine --vm-start

В версии 4.1 осуществлён переход на шифрование паролей в файлах конфигурации zVirt.

В процессе обновления не шифруется пароль:

  • В файлах конфигурации подключения внешних LDAP-серверов аутентификации в каталоге /etc/ovirt-engine/aaa параметр vars.password.

  • В файлах конфигурации ovirt-provider-ovn:

    • Параметр ovirt-sso-client-secret в файле /etc/ovirt-provider-ovn/ovirt-provider-ovn.conf.

    • Параметр ovirt-sso-client-secret в файле /etc/ovirt-provider-ovn/conf.d/10-setup-ovirt-provider-ovn.conf.

В случае необходимости поменяйте на хеши, которые генерируются так:

/usr/share/ovirt-engine/bin/ovirt-engine-crypto-tool.sh crypto-encode --password=pass:ПАРОЛЬ

Кроме того, можно удалить сохранённые файлы конфигураций вида 10-setup-dwh-database.conf.20240207160126 (с суффиксом из даты и времени создания файла) с незашифрованными паролями в каталогах:

  • /etc/ovirt-engine/aaa/

  • /etc/ovirt-engine/engine.conf.d/

  • /etc/ovirt-engine-dwh/ovirt-engine-dwhd.conf.d/

  • /etc/ovirt-engine-setup.conf.d/

  • /etc/ovirt-provider-ovn/conf.d

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

img5

и наличием нового функционала.

new features

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

Хост с ролью Hosted Engine - это хост, на котором установлены пакеты Hosted Engine, обеспечивающие возможность размещения на хосте виртуальной машины с Менеджером управления.

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

  1. Подключитесь по SSH к хосту.

  2. Обновите репозитории в соответствии с разделом Обновление репозиториев

  3. Обновите релиз:

    rm -rf /etc/dnf/protected.d/*-release-host-node.conf
dnf remove -y zvirt-release-host-node
dnf install -y zvirt-release-host-node

  4. Установите метапакет zvirt-hosted-engine:

    dnf install -y zvirt-hosted-engine

  5. Установите необходимые дополнительные пакеты:

    dnf install -y rsyslog-gnutls

  6. Выполните обновление ПО:

    dnf -y update

  7. После завершения установки перезапустите сервис:

    systemctl restart vdsmd.service

  8. Если хост с ролью HostedEngine является единственным хостом такого типа в кластере:

    1. перезапустите сервисы HA:

      systemctl restart ovirt-ha-broker.service
systemctl restart ovirt-ha-agent.service

    2. запустите ВМ HostedEngine:

      hosted-engine --vm-start

    3. Убедитесь в корректности статуса ВМ HostedEngine (для запуска требуется некоторое время)

      hosted-engine --vm-status
      img4
      Рисунок 2. Ожидаемый статус ВМ HostedEngine

  9. Выведите гипервизор из обслуживания:

    1. На портале администрирования перейдите Ресурсы  Хосты.

    2. Выделите нужный хост и нажмите Управление > Включить.

Для проверки того, что хост успешно обновился:

  1. На портале администрирования перейдите Ресурсы  Хосты.

  2. Нажмите на имя обновлённого хоста для перехода в подробное представление.

  3. Проверьте версию ОС на вкладке Общее:

    check host update
    Рисунок 3. Ожидаемая версия ОС

Переходите к обновлению стандартных хостов как описано в разделе Обновление стандартных хостов.

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

Обновление zVirt в режиме Stаndalone подходит для всех вариаций режима Stаndalone как для варианта All-in-One (менеджер управления установлен на физическом хосте, который выполняет функцию гипервизора), так и для режима Stаndalone с вариантом установки, где менеджер управления установлен на отдельном физическом хосте, который не выполняет функцию гипервизора.

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

  1. Подключитесь по SSH к хосту с менеджером управления.

  2. Обновите репозитории в соответствии с разделом Обновление репозиториев

  3. Установите новый релиз:

    dnf install -y zvirt-release-host-node

  4. Установите пакет zvirt-standalone:

    dnf install -y zvirt-standalone

  5. Выполните обновление программного обеспечения:

    dnf -y update --allowerasing

  6. Запустите установку Engine:

    engine-setup --offline

  7. Установите дополнительный пакет для исправления кодов типов гостевых ОС:

    dnf install -y typeosupdater

  8. После завершения установки перезапустите сервисы:

    systemctl restart ovirt-engine ovirt-provider-ovn zvirt-engine-backend

  9. В случае режима standalone с вариацией all-in-one перезапустите сервис vdsmd

    systemctl restart vdsmd.service

  10. В случае, если изначально SA/SA(aio) был сконфигурирован без ovirt-provider-ovn, то для работы подсистемы SDN сделайте следующее:

    1. Исправьте значение переменной OVESETUP_OVN/ovirtProviderOvn с False на True в файле /etc/ovirt-engine-setup.conf.d/20-setup-ovirt-post.conf .

      OVESETUP_OVN/ovirtProviderOvn=bool:True

    2. Запустите engine-setup

    3. Перезапустите службы:

      systemctl restart zvirt-engine-backend
systemctl restart ovirt-engine

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

  12. В случае режима standalone с вариацией all-in-one выведите гипервизор из обслуживания:

    1. На портале администрирования перейдите Ресурсы  Хосты.

    2. Выделите нужный хост и нажмите Управление > Включить.

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

img5

и наличием нового функционала.

Переходите к обновлению стандартных хостов как описано в разделе Обновление стандартных хостов.

5. Обновление стандартных хостов

Данный алгоритм обновления подходит для всех хостов, за исключением хоста, который работает совместно с менеджером управления в режиме Standalone All-in-one. Он обновляется совместно с менеджером управления как описано ранее.

  1. Переведите хост в режим обслуживания (подробнее смотрите во врезке Внимание во Введении).

  2. Если хост используется в кластере SDN, удалите его из кластера.

  3. Подключитесь по SSH к хосту.

  4. Обновите репозитории в соответствии с разделом Обновление репозиториев

  5. Обновите релиз:

    rm -rf /etc/dnf/protected.d/*-release-host-node.conf
dnf remove -y zvirt-release-host-node
dnf install -y zvirt-release-host-node

  6. Обновите метапакет zvirt-hosted-engine:

    dnf install -y zvirt-hosted-engine

  7. Установите необходимые дополнительные пакеты:

    dnf install -y rsyslog-gnutls

  8. Выполните обновление ПО:

    dnf -y update

  9. После завершения установки перезапустите сервис:

    systemctl restart vdsmd.service

  10. Если хост на этапе 2 удалялся из кластера SDN, снова добавьте его в кластер.

  11. Выведите гипервизор из обслуживания:

    1. На портале администрирования перейдите Ресурсы  Хосты.

    2. Выделите нужный хост и нажмите Управление > Включить.

Для проверки того, что хост успешно обновился:

  1. На портале администрирования перейдите Ресурсы  Хосты.

  2. Нажмите на имя обновлённого хоста для перехода в подробное представление.

  3. Проверьте версию ОС на вкладке Общее:

    check host update
    Рисунок 4. Ожидаемая версия ОС

Переходите к обновлению следующего гипервизора.

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

6. Обновление версий совместимости

6.1. Обновление версии совместимости кластеров

После обновления менеджера управления и хостов необходимо обновить версию совместимости кластеров для получения доступа к новому функционалу.

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

  1. На портале администрирования перейдите в Ресурсы  Кластеры.

  2. Выделите нужный кластер и нажмите Изменить.

  3. На вкладке Общее в меню Версия совместимости выберите последнюю доступную версию.

    cl comp update

  4. Нажмите OK.

    Если в кластере есть запущенные ВМ, появится предупреждение, содержащее описание того, каким образом необходимо обновить версию совместимости ВМ. Нажмите OK. А затем следуйте этому описанию.

6.2. Обновление версии совместимости центров данных

Обновление версии совместимости центра данных необходимо выполнять после обновления версии совместимости всех кластеров в этом центре данных.
Порядок действий:

  1. На портале администрирования перейдите в Ресурсы  Центры данных.

  2. Выделите нужный центр данных и нажмите Изменить.

  3. В окне редактирования центра данных установите последнюю версию совместимости.

    dc comp update

  4. Нажмите OK.

6.3. Проверка версий совместимости

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

  1. Для центра данных: перейдите в Ресурсы  Центры данных и убедитесь в том, что установлена нужная версия совместимости.

    dc comp check

  2. Для кластера: зайдите в подробное представление нужного кластера и убедитесь, что установлена корректная версия совместимости.

    cl comp check

  3. Для ВМ: зайдите в подробное представление нужной ВМ и убедитесь, что установлена корректная версия совместимости, а также в отсутствии предупреждения о несоответствии версии.

    vm comp check

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

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

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

При отсутствии сетевого доступа к онлайн-репозиториям zVirt, можно настроить локальные репозитории в соответствии с инструкцией.

  1. Удалите старые репозитории:

    dnf remove -y zvirt-repos-stable
dnf clean all

  2. С помощью команды wget скачайте пакет zvirt-repos-stable с новыми репозиториями и установите его:

    wget --user=<имя_пользователя> --password=<пароль> https://repo-zvirt.orionsoft.ru/repository/zvirt-4/4.1/packages/zvirt-repos-stable-4.1.0-1.XXXXX.zvirt.el8.noarch.rpm

dnf install -y zvirt-repos-stable-4.1.0-1.XXXXX.zvirt.el8.noarch.rpm
    <имя_пользователя> и <пароль> берутся из лицензионного сертификата, выданного при покупке продукта

  3. Убедитесь, что включены новые репозитории zvirt-main и zvirt-extras:

    dnf repolist all
    img2
    Рисунок 5. Ожидаемый вывод команды dnf repolist all

    Если указанные репозитории по каким-то причинам отключены, их можно включить следующей командой

    dnf config-manager --enable "zvirt-*"

    После использования команды убедитесь, что все репозитории zVirt включились

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

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

  5. Удалите фиксацию версий пакетов из списка versionlock.list и убедитесь, что список пуст:

    dnf versionlock clear
dnf versionlock list

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

Ошибка 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"}
Ошибка 2

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

В этом случае вам будет необходимо перезагрузить службы:

systemctl restart zvirt-engine-backend
systemctl restart ovirt-engine