Глава 3. Быстрый старт
Пред.	Наверх	Документация Postgres Pro Enterprise Manager	Начало	След.

Глава 3. Быстрый старт

В этом разделе описано, как установить PPEM на сервере в соответствии со схемой развёртывания «всё-в-одном» (all-in-one). В результате выполнения приведённых инструкций вы протестируете процесс установки и получите минимальную работоспособную версию PPEM для демонстрационных целей.

При выполнении команд, приведённых в этом разделе, обратите внимание на следующие особенности:

Приведены команды для операционной системы Debian Linux. Для других версий операционных систем используйте соответствующие им команды.
В командах указаны стандартные имена для объектов, например ppem для базы данных репозитория. При необходимости можно указать другие имена.

Процесс установки состоит из следующих этапов:

Убедитесь, что выполнены предварительные требования.
Настройте менеджер.
Настройте агент.

PPEM будет установлен. Вы можете обновить страницу браузера с веб-приложением и начать работу.

Предварительные требования

Подготовьте сервер, на котором будет установлен PPEM, в соответствии с аппаратными и программными требованиями.
Установите на сервере экземпляр СУБД Postgres Pro.
За подробной информацией об установке обратитесь к официальной документации Postgres Pro.
Запустите новый сеанс от имени суперпользователя:
```
$ sudo -s
```

Настройте менеджер

Установите репозиторий:

# wget -O pgpro-repo-add.sh https://repo.postgrespro.ru/ppem/ppem/keys/pgpro-repo-add.sh
# sh pgpro-repo-add.sh

Установите менеджер:
```
# apt install ppem ppem-gui
```
Файл конфигурации менеджера ppem-manager.yml будет загружен на ваше локальное устройство.
Создайте пользователя СУБД, от имени которого менеджер будет подключаться к базе данных репозитория:
```
# sudo -u postgres createuser --pwprompt ppem
```
В этом примере создаётся пользователь ppem. Этот пользователь будет упоминаться в других командах в этом разделе.
При выполнении этой команды укажите пароль пользователя СУБД.
Создайте базу данных репозитория:
```
# sudo -u postgres createdb -O ppem ppem
```
Убедитесь, что пользователь СУБД может подключиться к базе данных:
```
# psql -h localhost -U ppem -d ppem
```
При проблемах с подключением убедитесь, что в файл конфигурации pg_hba.conf добавлено правило HBA, разрешающее пользователю СУБД подключаться к базе данных, а также указан метод авторизации.
За подробной информацией обратитесь к официальной документации Postgres Pro по файлу конфигурации pg_hba.conf.
В файле конфигурации менеджера ppem-manager.yml:
- Укажите имя базы данных репозитория с помощью параметра repo.name:
```
repo:
  name: "ppem"
```
- Укажите имя и пароль пользователя СУБД с помощью параметров repo.user и repo.password:
```
repo:
  user: "ppem"
  password: "пароль_пользователя_СУБД"
```
- Укажите URL для подключения менеджера к базе данных репозитория с помощью параметра repo.url:
```
repo:
  url: "postgres://ppem:пароль_пользователя_СУБД@localhost/ppem"
```
  За подробной информацией о формате URL обратитесь к официальной документации Postgres Pro по строкам параметров подключения.
Запустите службу менеджера и добавьте её в автозагрузку сервера:
```
# systemctl start ppem
# systemctl enable ppem
```

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

Настройте агент

Установите агент:
```
# apt install ppem-agent
```
Файл конфигурации агента ppem-agent.yml будет загружен на ваше локальное устройство.
Создайте пользователя СУБД, от имени которого агент будет подключаться к базе данных репозитория:
```
# sudo -u postgres createuser -s --pwprompt ppem_agent
```
В этом примере создаётся пользователь ppem_agent. Этот пользователь будет упоминаться в других командах в этом разделе.
При выполнении этой команды укажите пароль пользователя СУБД.
Убедитесь, что пользователь СУБД может подключиться к базе данных репозитория:
```
# psql -h localhost -U ppem_agent -d ppem
```
При проблемах с подключением убедитесь, что в файл конфигурации pg_hba.conf добавлено правило HBA, разрешающее пользователю СУБД подключаться к базе данных, а также указан метод авторизации.
За подробной информацией обратитесь к официальной документации Postgres Pro по файлу конфигурации pg_hba.conf.
Получите ключ API для настройки агента:
1. Войдите в веб-приложение.
2. Скопируйте ключ API из отобразившейся инструкции по установке агентов и сохраните его.
В файле конфигурации агента ppem-agent.yml укажите параметры агента:
```
agent:
  name: "имя_агента"
  manager:
    url: "URL_для_подключения_к_менеджеру"
    api_key: "ключ_API_для_подключения_к_менеджеру"
  instance:
    connection_defaults:
      user: "имя_пользователя_СУБД"
      password: "пароль_пользователя_СУБД"
http:
  server:
    address: "сетевой_адрес_для_входящих_подключений"
    port: "порт_для_входящих_подключений"
```
Где:
- agent.name: уникальное имя агента.
- agent.manager.url: URL для подключения агента к менеджеру в формате схема://сетевой_адрес_менеджера/путь_к_версии_API.
- agent.manager.api_key: ранее полученный ключ API для подключения агента к менеджеру.
- agent.instance.connection_defaults.user и agent.instance.connection_defaults.password: имя и пароль пользователя СУБД.
- http.server.address и http.server.port: сетевой адрес и номер порта для входящих сетевых подключений.
  Чтобы включить прослушивание всех сетевых адресов и портов, не указывайте значения для этих параметров.
Запустите службу агента и добавьте её в автозагрузку сервера:
```
# systemctl start ppem-agent
# systemctl enable ppem-agent
```

Пред.	Наверх	След.
2.4. Что нового в PPEM 2.0	Начало	Глава 4. Установка и настройка