Глава 19. Настройка менеджера

  1. Подключите репозиторий пакетов PPEM:

    # wget -O pgpro-repo-add.sh https://repo.postgrespro.ru/ppem/ppem/keys/pgpro-repo-add.sh
    # sh pgpro-repo-add.sh
  2. Установите менеджер:

    # apt install ppem ppem-gui

    Файл конфигурации менеджера ppem-manager.yml будет загружен на ваше локальное устройство.

    Путь к файлу конфигурации — /etc/ppem-manager.yml.

  3. Создайте пользователя СУБД, от имени которого менеджер будет подключаться к базе данных репозитория:

    # sudo -u postgres createuser --pwprompt ppem

    При выполнении этой команды укажите пароль пользователя СУБД.

  4. Создайте базу данных репозитория:

    # sudo -u postgres createdb -O ppem ppem
  5. Убедитесь, что пользователь СУБД может подключиться к базе данных:

    # psql -h localhost -U ppem -d ppem

    При проблемах с подключением убедитесь, что в файл конфигурации pg_hba.conf добавлено правило HBA, разрешающее пользователю СУБД подключаться к базе данных, а также указан метод авторизации.

    За подробной информацией обратитесь к официальной документации Postgres Pro по файлу конфигурации pg_hba.conf.

  6. В файле конфигурации менеджера /etc/ppem-manager.yml:

    • Укажите имя хоста для подключения с помощью параметра repo.host:

      repo:
        host: "localhost"
    • Укажите имя базы данных репозитория с помощью параметра repo.name:

      repo:
        name: "ppem"
    • Укажите имя и пароль пользователя СУБД с помощью параметров repo.user и repo.password:

      repo:
        user: "ppem"
        password: "пароль_пользователя_СУБД"

    Примечание

    Для подключения менеджера к базе данных репозитория вместо параметров выше можно использовать URL. URL необходимо указать в параметре repo.url:

    repo:
      url: "postgres://ppem:пароль_пользователя_СУБД@localhost/ppem"

    За подробной информацией о формате URL обратитесь к официальной документации Postgres Pro по строкам параметров подключения.

  7. (Необязательно) Чтобы разместить объекты базы данных в схеме, отличной от используемой по умолчанию схемы public, укажите имя пользовательской схемы в файле конфигурации менеджера /etc/ppem-manager.yml с помощью параметра repo.schema:

    repo:
      schema: "myschema"

    Пользовательская схема будет создана автоматически. При необходимости её также можно создать вручную:

    # sudo -u postgres psql -d ppem -c "CREATE SCHEMA myschema AUTHORIZATION ppem;"

    Для новой инсталляции PPEM, когда ещё не запущено никаких служб, достаточно указать только имя схемы.

    Для работающего PPEM с множеством уже существующих объектов изменение имени схемы требует более сложных действий.

  8. Запустите службу менеджера и добавьте её в автозагрузку сервера:

    # systemctl start ppem
    # systemctl enable ppem

Веб-приложение будет установлено на сервере.