6.4. Обновление на версию PPEM 2.0 #
В этом разделе содержатся рекомендации и инструкция по миграции на версию PPEM 2.0.
Важно
Версия 2.0 обратно несовместима с версией 1.0. Инструменты для плавной миграции данных в настоящий момент не предоставляются.
Рекомендации по миграции
При миграции на версию PPEM 2.0 необходимо учесть следующие изменения, реализованные в этой версии:
Компоненты менеджера и агента переписаны на языке Go и реализуют новую версию 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.
За подробной информацией обратитесь к официальной документации Postgres Pro по pgpro-otel-collector и интеграции с PPEM.
Миграция
Полностью выключите все компоненты PPEM 1.0.
На отдельном сервере установите менеджер версии 2.0.
База данных репозитория для менеджера версии 2.0 может быть помещена в тот же экземпляр СУБД, что и база данных репозитория менеджера версии 1.0.
Важно
Не используйте одну и ту же базу данных репозитория для обеих версий, в противном случае менеджер версии 2.0 не сможет запуститься.
Чтобы убедиться в успешности установки менеджера версии 2.0, войдите в веб-приложение и получите API-ключ для настройки агента.
Установите агент версии 2.0.
На всех серверах экземпляров СУБД удалите сначала агенты, а затем менеджер версии 1.0.