Обновление и миграция
Рекомендуется часто обновлять PPEM, чтобы быть в курсе последних исправлений и улучшений. Вы можете перейти на любую из поддерживаемых версий из любого поддерживаемого выпуска, начиная с версии 2.0.
Информация об обновлениях версий PPEM доступна в разделе Что нового.
Обновление на версию PPEM 2.0
В этом разделе содержатся рекомендации и инструкция по миграции на версию PPEM 2.0.
ПРИМЕЧАНИЕ
Версия 2.0 обратно несовместима с версией 1.0. Инструментов для плавной миграции данных в настоящее время не предоставляется.
Рекомендации по миграции
При миграции на версию PPEM 2.0 необходимо учесть следующие изменения, реализованные в PPEM 2.0:
- Компоненты менеджера и агента переписаны на языке Golang и реализуют новую версию API. По этой причине некоторые компоненты PPEM версии 2.0 несовместимы с компонентами версии 1.0:
- менеджер версии 2.0 несовместим с агентами версии 1.0 и наоборот;
- веб-приложение версии 2.0 несовместимо с менеджером версии 1.0 и наоборот;
- файлы конфигурации менеджера версии 1.0 несовместимы с файлами конфигурации менеджера версии 2.0 и наоборот;
- файлы конфигурации агентов версии 1.0 несовместимы с файлами конфигурации агентов версии 2.0 и наоборот.
- Агенты версии 2.0 теперь не осуществляют регулярный сбор метрик и журналов экземпляров СУБД. Для работы с метриками и журналами PPEM теперь использует
pgpro-otel-collector.
В связи с этим предлагаются следующие рекомендации по миграции на PPEM 2.0:
Развёртывание PPEM 2.0 рекомендуется выполнять на оборудовании, отдельном от PPEM 1.0. Рекомендуется сначала выполнить полное выключение PPEM 1.0, включая агенты и менеджер, затем установку и запуск менеджера и агентов PPEM 2.0.
ВАЖНО!
Попытки одновременного выполнения одних и тех же операций над одними и теми же экземплярами СУБД в двух версиях PPEM могут привести к непредсказуемым последствиям. Избегайте ситуаций одновременной работы в двух версиях PPEM. Одновременная работа двух версий не тестировалась и не гарантирована.
Для использования расширенных функций отслеживания работоспособности экземпляров СУБД в PPEM рекомендуется установить и настроить pgpro-otel-collector. Подробнее читайте в официальной документации pgpro-otel-collector и разделе Интеграция с PPEM.
Порядок миграции
Рекомендуемый порядок миграции на версию 2.0:
Полностью выключите все компоненты PPEM 1.0.
На отдельном сервере установите менеджер версии 2.0.
База репозитория для менеджера версии 2.0 может быть размещена в том же экземпляре СУБД, где размещена база репозитория менеджера версии 1.0.
ВАЖНО!
Не используйте одну и ту же базу репозитория для обеих версий, в противном случае менеджер версии 2.0 не сможет запуститься.
Чтобы убедиться в успешности установки менеджера версии 2.0, авторизуйтесь в веб-приложении и получите API-ключ для настройки агента.
Установите агент версии 2.0.
На всех серверах экземпляров СУБД удалите сначала агенты, а затем менеджер версии 1.0.