Инструкция по установке Postgres Pro Enterprise Manager 2.X
Postgres Pro © 2016–2025 — Общество с ограниченной ответственностью «Постгрес Профессиональный».
Ниже приведена инструкция по установке Postgres Pro Enterprise Manager для версий 2.X. Расширенная документация доступна в составе установочного пакета ppem-2.X.X в каталоге /usr/share/doc/ppem.
Обычная установка
Предварительные требования
В качестве базы данных менеджера (репозитория) используется СУБД PostgreSQL, поэтому перед установкой PPEM необходимо развернуть экземпляр СУБД для нужд менеджера PPEM.
Подробные инструкции по загрузке и установке СУБД PostgreSQL можно найти на официальном сайте PostgreSQL.
Установка PPEM выполняется в несколько этапов:
- установка репозиториев пакетного менеджера
- установка и запуск менеджера PPEM
- установка и запуск агентов PPEM
Дальнейшая установка выполняется на примере ОС Debian Linux
Переключение в пользователя root
Запустите новый сеанс с root-привилегиями:
$ sudo -s
Установка репозиториев
Скачайте скрипт установки репозиториев и запустите его.
# wget https://repo.postgrespro.ru/ppem/ppem/keys/pgpro-repo-add.sh
# sh pgpro-repo-add.sh
# apt update
Этот шаг является обязательным и должен быть выполнен на всех узлах.
Установка менеджера
# apt install ppem ppem-gui
Создание базы данных репозитория
Убедитесь, что сервер базы данных запущен и доступен для подключения.
Выполните следующие команды на узле СУБД.
# sudo -u postgres createuser --pwprompt ppem
# sudo -u postgres createdb -O ppem ppem
Убедитесь, что для созданного пользователя подключение к созданной БД выполняется успешно.
# psql -h localhost -U ppem -d ppem
Настройка подключения менеджера к СУБД
Отредактируйте файл `/etc/ppem-manager.yml`, в параметре `repo.url` укажите URL для подключения к СУБД, в которой будет размещена база данных репозитория.
repo:
url: "postgres://ppem:password@localhost/ppem"
Запуск менеджера
Запустите службу менеджера
# systemctl start ppem
Добавьте службу менеджера в автозагрузку:
# systemctl enable ppem
Вход в среду управления
Введите в браузер адрес среды управления менеджера, например http://ppem.example.org.
Для входа под учетной записью администратора используйте учетную запись `admin` с паролем `admin`.
Скопируйте API-ключ
На ознакомительной странице ознакомьтесь с инструкцией по установке агентов и скопируйте API-ключ, он понадобится при настройке агентов.
Установка агента
Установку агента следует выполнить на всех узлах, где установлены экземпляры СУБД, включая и тот экземпляр, где установлена база данных менеджера PPEM.
# apt install ppem-agent
Создание пользователя для подключения к СУБД
Убедитесь, что сервер базы данных запущен и доступен для подключения.
Выполните следующие команды на узле СУБД:
# sudo -u postgres createuser -s --pwprompt ppem_agent
Убедитесь, что для созданного пользователя подключение к созданной БД выполняется успешно (при необходимости внести соответствующие разрешения в `pg_hba.conf`).
# psql -h localhost -U ppem_agent -d ppem
Настройка агента
Отредактируйте файл `/etc/ppem-agent.yml`.
Имя агента и настройки подключения к менеджеру PPEM:
- agent.name - уникальное имя агента.
- agent.manager.url - URL для подключения к менеджеру. URL обязательно должен начинаться со схемы (http или https) и иметь путь к версии API; текущая версия v1. Пример URL: https://ppem.example.org/v1.
- agent.manager.api_key - API-ключ используемый для подключения к менеджеру.Настройки подключения к обнаруженным экземплярам СУБД:
agent.instance.connection_defaults.user` - пользователь СУБД.
agent.instance.connection_defaults.password` - пароль пользователя СУБД.
Настройки HTTP-сервера:
- http.server.address - локальный адрес для входящих сетевых подключений (пустая строка включает прослушивание всех адресов).
Пример файла конфигурации:
agent:
name: "local"
manager:
url: "https://ppem.example.org/v1"
api_key: "ваш-api-ключ"
instance:
connection_defaults:
user: "ppem_agent"
password: "ppem_agent_password"
http:
server:
address: "1.2.3.4"
Запуск агента
# systemctl start ppem-agent
Добавьте службу агента в автозагрузку
# systemctl enable ppem-agent
Начните использовать PPEM
Вернитесь назад в браузер и обновите страницу.
Установка и настройка средств мониторинга
Для работы с метриками экземпляров СУБД PPEM полагается на pgpro-otel-collector. Для работы с метриками должны быть соблюдены следующие требования:
- на сервере с экземпляром СУБД должен быть установлен pgpro-otel-collector.
- pgpro-otel-collector должен быть настроен на сбор метрик с экземпляра СУБД.
- pgpro-otel-collector должен быть настроен на отправку метрик в PPEM или внешнее хранилище
- в случае хранения метрик во внешнем хранилище PPEM должен быть настроен на получение метрик из хранилища.
Установка pgpro-otel-collector
Для установки pgpro-otel-collector обратитесь к документации коллектора по установке.
Настройка сбора метрик в pgpro-otel-collector
Для настройки сбора метрик pgpro-otel-collector обратитесь к документации коллектора по настройке сбора метрик.
Настройка отправки метрик
Для настройки отправки метрик в PPEM обратитесь к документации коллектора по настройке PPEM.
Настройка хранилищ в PPEM
PPEM предусматривает прием метрик от pgpro-otel-collector и может хранить во встроенном внутреннем хранилище.
Важно: внутреннее встроенное хранилище предназначено для ознакомления и не рекомендуется для использования в производственных установках PPEM. Для производственных окружений с большим количество экземпляров СУБД и большими объемами производимых метрик рекомендуется использовать отдельные внешние хранилища.
Установка и настройка средств журналирования
Для работы с журналами экземпляров СУБД PPEM полагается на pgpro-otel-collector. Для работы с журналами должны быть соблюдены следующие требования:
- экземпляр СУБД должен быть настроен на журналирование в формате CSV или JSON.
- на сервере с экземпляром СУБД должен быть установлен pgpro-otel-collector.
- pgpro-otel-collector должен быть настроен на сбор журналов экземпляра СУБД.
- pgpro-otel-collector должен быть настроен на отправку журналов в PPEM или внешнее хранилище.
- в случае хранения журналов во внешнем хранилище PPEM должен быть настроен на получение метрик из хранилища.
Настройка журналирования экземпляра СУБД.
Для настройки журналирования обратитесь к документации PostgreSQL по настройке журналирования. В частности важна настройка параметров: logging_collector, log_destination, log_directory и log_filename.
Установка pgpro-otel-collector
Для установки pgpro-otel-collector обратитесь к документации коллектора по установке.
Настройка сбора журналов в pgpro-otel-collector
Для настройки сбора журналов pgpro-otel-collector обратитесь к документации коллектора по настройке сбора журналов.
Настройка отправки журналов
Для настройки отправки журналов в PPEM обратитесь к документации коллектора по настройке PPEM.
Хранилища в PPEM
PPEM предусматривает прием журналов от pgpro-otel-collector и может хранить во встроенном внутреннем хранилище.
Важно: внутреннее встроенное хранилище предназначено для ознакомления и не рекомендуется для использования в производственных установках PPEM. Для производственных окружений с большим количество экземпляров СУБД и большими объемами производимых журналов рекомендуется использовать отдельные внешние хранилища.
Установка и настройка средств резервного копирования и восстановления
PostgresPro Enterprise Manager имеет поддержку резервного копирования и восстановления средствами pg_probackup.
Для использования возможностей pg_probackup его необходимо установить самостоятельно.
Установка pg_probackup
Замечание: Есть две редакции pg_probackup - Standard и Enterprise, - которые отличаются набором функциональности. Возможности резервного копирования и восстановления PPEM напрямую зависят от установленной редакции pg_probackup.
Важно: Устанавливаемая версия pg_probackup должна соответствовать версии СУБД.
Подробные инструкции по загрузке и установке pg_probackup можно найти по адресам:
Настройка в Postgres Pro Enterprise Manager
После того, как pg_probackup установлен на сервере СУБД, агент PPEM автоматически найдет pg_probackup и сообщит об этом менеджеру PPEM, после чего сервер СУБД станет доступным для последующей настройки и запуска резервного копирования.