Обновление и миграция

Рекомендуется часто обновлять 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:

1. Полностью выключите все компоненты PPEM 1.0.

2. На отдельном сервере установите менеджер версии 2.0.

   База репозитория для менеджера версии 2.0 может быть размещена в том же экземпляре СУБД, где размещена база репозитория менеджера версии 1.0.

   ВАЖНО!

   Не используйте одну и ту же базу репозитория для обеих версий, в противном случае менеджер версии 2.0 не сможет запуститься.

3. Чтобы убедиться в успешности установки менеджера версии 2.0, авторизуйтесь в веб-приложении и получите API-ключ для настройки агента.

4. Установите агент версии 2.0.

5. На всех серверах экземпляров СУБД удалите сначала агенты, а затем менеджер версии 1.0.