Перейти к основному содержимому

Обновление SberLinux OS Server 8 на версию 9 с предустановленной СУБД Pangolin

Важно

Актуально для СУБД Pangolin версии 6.5.x.

Внимание!

Обновление ОС подразумевает полную недоступность кластера СУБД Pangolin.

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

Перед началом выполнения инструкции необходимо убедиться, что yum/dnf-репозитории настроены корректно.

Обновление СУБД осуществляется пользователем с правами суперпользователя, пользователя postgres и пользователя kmadmin_pg. Необходимо учесть это на старте выполнения инструкции.

Внимание!

Перед началом обновления сохраните дистрибутив СУБД Pangolin SberLinux OS Server 9 на каждый узел. В инструкции каталог будет размещен в ~/pangolin_sbel9, расширения и дополнительные компоненты будут размещены в каталоге ~/party_distrib.

Шаг 1. Подготовка виртуальной машины к процедуре обновления ОС​

  1. Введите компонент Pangolin Manager в режим паузы (опционально):

    sudo -iu postgres
    pangolin-manager-ctl -c /etc/pangolin-manager/postgres.yml edit-config --set 'pause=true' --force
    exit

  2. Остановите все компоненты СУБД Pangolin. В случае кластерной конфигурации действия по остановке произведите сначала на реплике затем на основном узле:

# (опционально) Для конфигурации с pangolin-manager
sudo systemctl stop pangolin-manager
sudo -iu postgres
pg_ctl stop
exit

# (опционально) Для конфигурации с etcd
sudo systemctl stop etcd

# (опционально) Для конфигурации без pangolin-manager
sudo systemctl stop postgresql

# Для любой конфигурации
sudo systemctl stop pangolin-pooler
sudo systemctl stop pangolin-certs-rotate
sudo systemctl stop pangolin-auth-reencrypt@postgres
sudo systemctl stop pangolin-auth-reencrypt@kmadmin_pg

  1. Проверьте, что все компоненты корректно остановлены:

    sudo ps aux | grep -E "pangolin-pooler|pangolin-manager|postgresql|pangolin-certs-rotate|pangolin-auth-reencrypt@postgres|pangolin-auth-reencrypt@kmadmin_pg|etcd" | grep -v grep

  2. Если на предыдущем шаге была выведена информация, то выполните:

    sudo kill -9 <pid>
    sudo ps aux | grep -E "pangolin-pooler|pangolin-manager|postgresql|pangolin-certs-rotate|pangolin-auth-reencrypt@postgres|pangolin-auth-reencrypt@kmadmin_pg|etcd" | grep -v grep

  3. Создайте резервную копию рабочих файлов etcd (опционально):

    sudo mkdir -p ~/pangolin_sbel9/{etcd_backup_lib,etcd_backup_conf}
    sudo cp -ra /var/lib/etcd ~/pangolin_sbel9/etcd_backup_lib/
    sudo cp -ra /etc/etcd ~/pangolin_sbel9/etcd_backup_conf/

Шаг 2. Обновление ОС​

Подсказка

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

  1. Установите утилиту:

    sudo dnf -y install leapp-upgrade

  2. Создайте файл с репозиториями для использования утилиты:

    sudo touch /etc/leapp/files/leapp_upgrade_repositories.repo

    Имена id должны отличаться от id в репозитории /etc/yum.repos.d/.

    leapp_upgrade_repositories.repo:

    [SBERLINUX-BASE-9]
    name=SBERLINUX-BASE
    baseurl=http://<IP-Address>
    gpgcheck=1
    gpgkey=file://<IP-Address>
    enabled=1

    [SBERLINUX-APPSTREAM-9]
    name=SBERLINUX-APPSTREAM
    baseurl=http://<IP-Address>
    gpgcheck=1
    gpgkey=file://<IP-Address>
    enabled=1

    [SBERLINUX-HighAvailability-9]
    name=SBERLINUX-HighAvailability
    baseurl=http://<IP-Address>
    gpgcheck=1
    gpgkey=file://<IP-Address>
    enabled=1

    [SBERLINUX-powertools-9]
    name=SBERLINUX-powertools
    baseurl=http://<IP-Address>
    gpgcheck=1
    gpgkey=file://<IP-Address>
    enabled=1

  3. Замените строки в файле /etc/leapp/repos.d/system_upgrade/common/libraries/config/version.py:

    _SUPPORTED_VERSIONS = {
     #' ': {'rhel': ['   ', '   '], 'rhel-saphana': ['   ', '   ']},
     ' ': {'sberlinux': ['   ', '   '], 'rhel-saphana': ['   ', '   ']},
    }

  4. Уберите проверку checkinstalledkernels:

    sudo mv /etc/leapp/repos.d/system_upgrade/common/actors/kernel/checkinstalledkernels /var/tmp

  5. Обновите с флагом перезагрузки после завершения:

    sudo leapp upgrade --no-rhsm --nogpgcheck –-reboot

  6. Замените репозитории yum на новые в целевом месте (/etc/yum.repos.d/):

    [SBERLINUX-BASE]
    name=SBERLINUX-BASE
    baseurl=http://<IP-Address>
    gpgcheck=1
    gpgkey=file://<IP-Address>
    enabled=1

    [SBERLINUX-APPSTREAM]
    name=SBERLINUX-APPSTREAM
    baseurl=http://<IP-Address>
    gpgcheck=1
    gpgkey=file://<IP-Address>
    enabled=1

    [SBERLINUX-HighAvailability]
    name=SBERLINUX-HighAvailability
    baseurl=http://<IP-Address>
    gpgcheck=1
    gpgkey=file://<IP-Address>
    enabled=1

    [SBERLINUX-powertools]
    name=SBERLINUX-powertools
    baseurl=http://<IP-Address>
    gpgcheck=1
    gpgkey=file://<IP-Address>
    enabled=1

    [SBERLINUX-pangolin]
    name=SBERLINUX-pangolin
    baseurl=http://<IP-Address>
    gpgcheck=1
    gpgkey=file://<IP-Address>
    enabled=1

    [SBERLINUX-pangolin-dev]
    name=SBERLINUX-pangolin-dev
    baseurl=http://<IP-Address>
    gpgcheck=1
    gpgkey=file://<IP-Address>
    enabled=1

  7. Убедитесь в том, что версия ОС была корректна изменена:

    sudo cat /etc/os-release

  8. Обновите пакеты:

    sudo dnf update -y

Шаг 3. Восстановление конфигурационных файлов компонентов​

Подсказка

После обновления версии ОС и удаления rpm-пакетов Pangolin, установленных для предыдущей версии ОС, файлы конфигурации автоматически переименовываются с добавлением постфикса .rpmsave. Перед установкой пакетов Pangolin для новой версии ОС необходимо вернуть исходные имена конфигурационных файлов.

Восстановите конфигурационные файлы компонентов после обновления, если они используются в СУБД:

Для компонента pangolin-backup-tools:

cd /etc/pangolin-backup-tools/
rm backup-tools-env
mv backup-tools-env.rpmsave backup-tools-env

  • Для компонента pangolin-manager:

    cd /etc/pangolin-manager/
    rm postgres.yml
    mv postgres.yml.rpmsave postgres.yml

Шаг 4. Восстановление работы СУБД Pangolin после обновления ОС​

  1. Остановите все компоненты СУБД Pangolin. В случае кластерной конфигурации действия по остановке произведите сначала на реплике, затем на основном:
# (опционально) Для конфигурации с etcd
sudo systemctl stop etcd

# (опционально) Для конфигурации с pangolin-manager
sudo systemctl stop pangolin-manager

# (опционально) Для конфигурации без pangolin-manager
sudo systemctl stop postgresql

# Для любой конфигурации
sudo systemctl stop pangolin-pooler
sudo systemctl stop pangolin-certs-rotate
sudo systemctl stop pangolin-auth-reencrypt@postgres
sudo systemctl stop pangolin-auth-reencrypt@kmadmin_pg

  1. Обновите rpm-пакеты компонентов:

    export PANGOLIN_VER=6.5.2
    export PANGOLIN_MANAGER_VER=2.1.8
    export PANGOLIN_POOLER_VER=1.5.2
    export PANGOLIN_BACKUP_TOOLS_VER=1.2.5

    # (опционально) Для конфигурации с pangolin-manager
    sudo dnf install -y ~/pangolin_sbel9/pangolin-manager-$PANGOLIN_MANAGER_VER-sberlinux9.x86_64.rpm
    # venv для pangolin-manager
    sudo dnf install -y ~/party_distrib/pangolin-manager-venv/pangolin-manager-venv-1.1.0-sberlinux9.5.x86_64.rpm

    # (опционально) Для любой конфигурации
    sudo dnf install -y ~/pangolin_sbel9/utilities/pangolin-security-utilities-$PANGOLIN_VER-sberlinux9.x86_64.rpm
    sudo dnf install -y ~/pangolin_sbel9/pangolin-dbms-6.5-$PANGOLIN_VER-sberlinux9.x86_64.rpm
    sudo dnf install -y ~/pangolin_sbel9/pangolin-dbms-6.5-client-$PANGOLIN_VER-sberlinux9.x86_64.rpm
    sudo dnf install -y ~/pangolin_sbel9/pangolin-pooler-$PANGOLIN_POOLER_VER-sberlinux9.x86_64.rpm
    sudo dnf install -y ~/pangolin_sbel9/pangolin-backup-tools-$PANGOLIN_BACKUP_TOOLS_VER-sberlinux9.x86_64.rpm
    # venv для pangolin-backup-tools
    sudo dnf install -y ~/party_distrib/pangolin-backup-tools-venv/pangolin-backup-tools-venv-1.1.0-sberlinux9.x86_64.rpm
    sudo dnf install -y ~/pangolin_sbel9/timescaledb/pangolin-timescaledb-6.5-apache-2.14.2-sberlinux9.x86_64.rpm
    sudo dnf install -y ~/pangolin_sbel9/utilities/pangolin-auth-reencrypt-$PANGOLIN_VER-sberlinux9.x86_64.rpm
    sudo dnf install -y ~/pangolin_sbel9/utilities/pangolin-certs-rotate-$PANGOLIN_VER-sberlinux9.x86_64.rpm
    sudo dnf install -y ~/pangolin_sbel9/utilities/pangolin-diagnostic-tool-$PANGOLIN_VER-sberlinux9.x86_64.rpm

  2. Восстановите etcd (опционально):

    sudo rm -rf /var/lib/etcd /etc/etcd
    sudo cp -ra ~/pangolin_sbel9/etcd_backup_lib/etcd /var/lib/
    sudo cp -ra ~/pangolin_sbel9/etcd_backup_conf/etcd /etc/

  3. Запустите компоненты СУБД Pangolin.

# (опционально) Для конфигурации с pangolin-manager
sudo systemctl restart pangolin-manager
sudo -iu postgres
pg_ctl start
exit

# (опционально) Для конфигурации без pangolin-manager
sudo systemctl restart postgresql

# (опционально) Для конфигурации с etcd
sudo systemctl restart etcd

# (опционально) Для конфигурации с dsc. !!! Только для узла arbiter.
sudo chmod -R 0440 /opt/pangolin-manager/lib/plugins/ /opt/pangolin-manager/lib/libfe_elog.so
sudo chmod 0770 /opt/pangolin-manager /opt/pangolin-manager/bin /opt/pangolin-manager/lib /opt/pangolin-manager/lib/plugins
sudo chown postgres:pangolin_users /opt/pangolin-manager /opt/pangolin-manager/bin /opt/pangolin-manager/lib /opt/pangolin-manager/lib/plugins /opt/pangolin-manager/lib/libfe_elog.so

# (опционально) Для любой конфигурации
sudo systemctl restart pangolin-pooler
sudo systemctl restart pangolin-certs-rotate
sudo systemctl restart pangolin-auth-reencrypt@postgres
sudo systemctl restart pangolin-auth-reencrypt@kmadmin_pg

  1. Выведите компонент Pangolin Manager из режима паузы (опционально):

    sudo -iu postgres
    pangolin-manager-ctl -c /etc/pangolin-manager/postgres.yml edit-config --set 'pause=false' --force
    exit

  2. Перестройте все объекты баз данных, которые используют параметры сортировки по умолчанию:

    sudo -iu postgres
    psql

    DO $$
    DECLARE
    db_name TEXT;
    BEGIN
    FOR db_name IN (SELECT datname FROM pg_database WHERE datname NOT IN ('template0','template1')) LOOP
    EXECUTE format('ALTER DATABASE %I REFRESH COLLATION VERSION', db_name);
    END LOOP;
    END $$;

    \q
    exit

  3. Проверьте корректность запуска компонентов.

# (опционально) Для конфигурации с pangolin-manager
sudo systemctl status pangolin-manager

# (опционально) Для конфигурации без pangolin-manager
sudo systemctl status postgresql

# (опционально) Для конфигурации с etcd
sudo systemctl status etcd

# (опционально) Для любой конфигурации
sudo systemctl status pangolin-pooler
sudo systemctl status pangolin-certs-rotate
sudo systemctl status pangolin-auth-reencrypt@postgres
sudo systemctl status pangolin-auth-reencrypt@kmadmin_pg

Возможные проблемы при миграции​

  1. Если при миграции ОС возникла следующая ошибка на этапе проверки (leapp preupgrade --no-rhsm --nogpgcheck):

    Upgrade has been inhibited due to the following problems:
    1. Inhibitor: Detected RPMs with RSA/SHA1 signature
    Consult the pre-upgrade report for details and possible remediation.

    Выполните:

    # Сохраните текущее значение
    update-crypto-policies --show > crypt

    # Выставите временное значение
    update-crypto-policies --set LEGACY

    Повторно запустите проверку leapp preupgrade --no-rhsm --nogpgcheck. После полной миграции верните исходное значение:

    # Верните исходное значение
    update-crypto-policies --set $(cat crypt)

  2. Для миграции есть минимальные требования к характеристикам КТС. Если КТС не соответствует каким-то из параметров, то может быть получена ошибка:

    Upgrade has been inhibited due to the following problems:
    1. Inhibitor: Minimum memory requirements for RHEL 9 are not met
       Consult the pre-upgrade report for details and possible remediation.
       Summary: Memory detected: 962 MiB, required: 1536 MiB

    Увеличьте значение mem.