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

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

Версия zVirt: 3.3

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

Если SSL-сертификат веб-портала заменен в соответствии с инструкцией Замена SSL-сертификата для веб-портала (zVirt 3.2 и ниже), то после обновления необходимо выполнить настройку в соответствии с инструкцией Замена SSL-сертификата для веб-портала (zVirt 3.3 и выше).

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

  • При обновлении с версии 3.0 обратите внимание, что в гипервизоре изменилось ядро операционной системы (начиная с версии 3.1.1 используется релиз 4.18.0-448.el8.x86_64), поэтому предварительно проверьте ваше аппаратное обеспечение на совместимость.

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

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

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

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

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

img1

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

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

Обновление с версии 3.0

  1. Подключитесь по SSH к ВМ HostedEngine.

  2. Установите утилиту zvirt-credentials и настройте доступ к репозиториям:

    wget --user=<имя_пользователя> --password=<пароль> https://repo-zvirt.orionsoft.ru/repository/zvirt-3-centos8s-stable-main/3.X/el8/noarch/zvirt-credentials-X.X.X-X.XXXX.zvirt.el8.noarch.rpm
dnf install zvirt-credentials-X.X.X-X.XXXX.zvirt.el8.noarch.rpm -y
    <имя_пользователя> и <пароль> берутся из лицензионного сертификата, выданного при покупке продукта

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

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

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

  5. В zvirt 3.X используется новая версия coreutils-single (требуется для libguestfs-appliance), соответственно необходимо выполнить установку с одновременным удалением старой версии (флаг allowerasing):

    dnf install -y coreutils-single --allowerasing

  6. Обновите политики selinux выполнив команду:

    dnf update -y selinux-policy*

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

    dnf install -y zvirt-appliance

  8. Очистите старую конфигурацию engine для работы с БД:

    /usr/share/ovirt-engine/dbscripts/engine-psql.sh -c "select fn_db_delete_config_value('AdminPassword','general');"

  9. Запустите установку Engine (установка с флагом offline является более безопасной с точки зрения конфликтности между версиями старых и новых rpm-пакетов):

    engine-setup --offline

  10. Обновите ядро операционной системы:

    dnf update -y kernel*

  11. Отключите репозиторий centos-zvirt-extras (репозиторий выключается с целью исключения конфликтов между версиями старых и новых rpm-пакетов, а также возможных установленных пакетов клиентами) выполните обновление программного обеспечения:

    dnf config-manager --disable centos-zvirt-extras
dnf -y update

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

    reboot

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

    hosted-engine --set-maintenance --mode=none
hosted-engine --vm-status
hosted-engine --vm-start
    img4
Обновление с версии 3.1/3.1.1

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

  2. Установите утилиту zvirt-credentials и настройте доступ к репозиториям:

    wget --user=<имя_пользователя> --password=<пароль> https://repo-zvirt.orionsoft.ru/repository/zvirt-3-centos8s-stable-main/3.Х/el8/noarch/zvirt-credentials-X.X.X-X.XXXX.zvirt.el8.noarch.rpm

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

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

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

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

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

    dnf install -y zvirt-appliance
dnf install -y rsyslog-gnutls

  6. Запустите установку Engine (установка с флагом offline является более безопасной с точки зрения конфликтности между версиями старых и новых rpm-пакетов):

    engine-setup --offline

  7. Отключите репозиторий centos-zvirt-extras (репозиторий выключается с целью исключения конфликтов между версиями старых и новых rpm-пакетов, а также возможных установленных пакетов клиентами) и выполните обновление программного обеспечения:

    dnf config-manager --disable centos-zvirt-extras
dnf -y update

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

    systemctl restart ovirt-engine.service

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

    hosted-engine --set-maintenance --mode=none
hosted-engine --vm-status
hosted-engine --vm-start
    img4

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

img5

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

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

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

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

Обновление с версии 3.0

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

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

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

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

  4. В zvirt 3.X используется новая версия coreutils-single (требуется для libguestfs-appliance), соответственно необходимо выполнить установку с одновременным удалением старой версии (флаг allowerasing):

    dnf install -y coreutils-single --allowerasing

  5. Обновите политики selinux выполнив команду:

    dnf update -y selinux-policy*

  6. Выполните следующие команды для удаления старого релиза т.к. он защищён от перезаписи:

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

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

    dnf install -y zvirt-hosted-engine
dnf install -y rsyslog-gnutls

  8. Обновите ядро операционной системы:

    dnf update -y kernel*

  9. Отключите репозиторий centos-zvirt-extras (репозиторий выключается с целью исключения конфликтов между версиями старых и новых rpm-пакетов, а также возможных установленных пакетов клиентами) и выполните обновление ПО:

    dnf config-manager --disable centos-zvirt-extras
dnf -y update

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

    reboot

  11. Если хост с ролью HostedEngine является единственным хостом такого типа в кластере, то запустите ВМ HostedEngine:

    hosted-engine --vm-start

  12. Выведите гипервизор из обслуживания, нажав кнопку Включить в веб-интерфейсе или выполнив команду:

    hosted-engine --set-maintenance --mode=none
Обновление с версии 3.1/3.1.1 и выше

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

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

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

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

  4. Выполните следующие команды для удаления старого релиза т.к. он защищён от перезаписи:

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

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

    dnf update/install -y zvirt-hosted-engine
dnf install -y rsyslog-gnutls

  6. Отключите репозиторий centos-zvirt-extras (репозиторий выключается с целью исключения конфликтов между версиями старых и новых rpm-пакетов, а также возможных установленных пакетов клиентами) и выполните обновление ПО:

    dnf config-manager --disable centos-zvirt-extras
dnf -y update

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

    systemctl restart vdsmd.service

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

    hosted-engine --vm-start

  9. Выведите гипервизор из обслуживания, нажав кнопку Включить в веб-интерфейсе или выполнив команду:

    hosted-engine --set-maintenance --mode=none

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

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

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

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

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

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

  3. В zvirt 3.X используется новая версия coreutils-single (требуется для libguestfs-appliance), соответственно необходимо выполнить установку с одновременным удалением старой версии (флаг allowerasing):

    dnf install -y coreutils-single --allowerasing

  4. Обновите политики selinux выполнив команду:

    dnf update -y selinux-policy*

  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-standalone:

    dnf install -y zvirt-standalone

  7. Очистите старую конфигурацию engine для работы с БД:

    /usr/share/ovirt-engine/dbscripts/engine-psql.sh -c "select fn_db_delete_config_value('AdminPassword','general');"

  8. Запустите установку Engine (установка с флагом offline является более безопасной с точки зрения конфликтности между версиями старых и новых rpm-пакетов):

    engine-setup --offline

  9. Обновите ядро и программное обеспечение операционной системы:

    dnf update -y kernel*

  10. Отключите репозиторий centos-zvirt-extras (репозиторий выключается с целью исключения конфликтов между версиями старых и новых rpm-пакетов, а также возможных установленных пакетов клиентами) и выполните обновление ПО:

    dnf config-manager --disable centos-zvirt-extras
dnf -y update

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

    reboot

  12. В случае, если изначально 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

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

Обновление с версии 3.1/3.1.1 и выше

  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-standalone:

    dnf install -y zvirt-standalone

  5. Запустите установку Engine (установка с флагом offline является более безопасной с точки зрения конфликтности между версиями старых и новых rpm-пакетов):

    engine-setup --offline

  6. Отключите репозиторий centos-zvirt-extras (репозиторий выключается с целью исключения конфликтов между версиями старых и новых rpm-пакетов, а также возможных установленных пакетов клиентами) и выполните обновление ПО:

    dnf config-manager --disable centos-zvirt-extras
dnf -y update

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

    systemctl restart ovirt-engine.service

    В случае режима standalone с вариацией all-in-one

    systemctl restart vdsmd.service

  8. В случае, если изначально 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

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

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

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

img5

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

Переходите к обновлению гипервизоров - Обновление гипервизоров

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

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

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

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

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

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

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

  5. В zvirt 3.X используется новая версия coreutils-single (требуется для libguestfs-appliance), соответственно необходимо выполнить установку с одновременным удалением старой версии (флаг allowerasing):

    dnf install -y coreutils-single --allowerasing

  6. Обновите политики selinux выполнив команду:

    dnf update -y selinux-policy*

  7. Выполните следующие команды для удаления старого релиза т.к. он защищён от перезаписи:

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

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

    dnf install -y zvirt-hosted-engine
dnf install -y rsyslog-gnutls

  9. Обновите ядро и программное обеспечение операционной системы:

    dnf update -y kernel*

  10. Отключите репозиторий centos-zvirt-extras (репозиторий выключается с целью исключения конфликтов между версиями старых и новых rpm-пакетов, а также возможных установленных пакетов клиентами) и выполните обновление ПО:

    dnf config-manager --disable centos-zvirt-extras
dnf -y update

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

    reboot

  12. Выведите гипервизор из обслуживания, нажав кнопку Включить в веб-интерфейсе.

Обновление с версии 3.1/3.1.1

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

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

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

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

  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
dnf install -y rsyslog-gnutls

  7. Отключите репозиторий centos-zvirt-extras (репозиторий выключается с целью исключения конфликтов между версиями старых и новых rpm-пакетов, а также возможных установленных пакетов клиентами) и выполните обновление ПО:

    dnf config-manager --disable centos-zvirt-extras
dnf -y update

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

    systemctl restart vdsmd.service

  9. Выведите гипервизор из обслуживания, нажав кнопку Включить в веб-интерфейсе.

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

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

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

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

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

  1. Удалите репозиторий и очистите директорию /etc/yum.repos.d/:

    • В случае обновления со старых версий (3.0) удалите репозиторий zvirt-release44

      dnf remove -y zvirt-release44

    • В случае обновления с версии 3.1.1 (3.1) и выше удалите репозиторий zvirt-repos-stable

      dnf remove -y zvirt-repos-stable

    • Очистите директорию /etc/yum.repos.d/

      rm -rf /etc/yum.repos.d/*
dnf clean all

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

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

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

  3. Проверьте новые репозитории:

    dnf repolist all
    img2

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

    dnf versionlock clear
dnf versionlock list
В случае обновления менеджера управления в режиме HostedEngine необходимо будет в файле репозиториев /etc/yum.repos.d/centos-zvirt-stable.repo прописать строчку module_hotfixes=1 под [centos-zvirt-main] и [centos-zvirt-extras]

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

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

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

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