Ручная пошаговая установка конфигурации standalone

Сведения

При переходе к данному разделу предполагается, что изучена информация общего блокаручной установки.

Данный раздел рассматривает процесс ручной пошаговой установки экземпляра СУБД Pangolin в конфигурации standalone.

Все приведенные команды и примеры заполненных конфигураций являются примерами. Их необходимо отредактировать в соответствии с требуемыми параметрами и конфигурациями.

Обозначения

В инструкции используются переменные для динамической настройки. Перед выполнением команд скорректируйте значение относительно реализуемого сценария установки:

{OS} - операционная система;
{version_OS} - версия операционной системы;
{path} - полный путь к директории distributive или путь к дистрибутиву;
{product_version} - версия продукта (текущая версия: 7.3.1);
{short_version} - короткая версия продукта (текущая: 7.3);
{base_version} - основная версия продукта (текущая: 7);
{version_component} - версия компонента.

Подготовка к ручной установке

Предупреждение!

В случае использования сертифицированной ОС Astra Linux «Смоленск» обратитесь кразделу особенностей работы с данной ОС.

Проверьте что порт для работы СУБД (по умолчанию 5432) не заблокирован на уровне сети или виртуальной машины.
Проверьте занятость uid/gid. Для установки экземпляра СУБД Pangolin по умолчанию используется: uid/gid: 26 для postgres, uid/gid: 126 для kmadmin_pg и gid: 226 для группы pangolin_users. Пример команды проверки:
```
getent passwd | grep 26
getent passwd | grep 126
getent group | grep 226
```
В случае занятости данных uid/gid переопределите переменные через изменение значений. Пример изменения uid/gid для пользователя postgres:
```
sudo POSTGRES_USER_GUID=<unused_uid> POSTGRES_GROUP_GUID=<unused_gid> dnf install pangolin-dbms-7
```
Важно
Изменение актуально для ОС Astra Linux, в связи с занятостью gid: 126 группой tape и для ОС Альт СП 10 версии 2 (занятость gid=26):
error: group with gid=126 already exists
Список переменных окружения, использующих uid/gid:
```
POSTGRES_USER_GUID             # изменение uid пользователя postgres (по умолчанию 26)
POSTGRES_GROUP_GUID            # изменение gid группы postgres (по умолчанию 26)
KMADMIN_PG_USER_GUID           # изменение uid пользователя kmadmin_pg (по умолчанию 126)
KMADMIN_PG_GROUP_GUID          # изменение gid группы kmadmin_pg (по умолчанию 126)
PANGOLIN_USERS_GROUP_GUID      # изменение gid группы pangolin_users (по умолчанию 226)
```
Проверьте, что виртуальные машины, которые будут использоваться для установки СУБД, находятся в области видимости. Воспользуйтесь командой ping.

Сведения
Выполните данный пункт в случае установки кластерной конфигурации (cluster).

Замените переменные на значения DNS/IP-адресов хостов и выполните команды с мастера:
```
ping <dns/ip-address replica>
ping <dns/ip-address arbiter>
```
Убедитесь, что дистрибутив распакован с использованием скрипта unpacker-distrib.sh (с ключом --not-pack) и каталог дистрибутива присутствует на всех узлах кластера.

Примечание

Использование мета-пакетов может упростить дальнейшие шаги установки rpm/deb-пакетов. Особенно в случае, когда требуется установка нескольких компонентов.

Установка экземпляра СУБД Pangolin

Данный раздел описывает сценарий процесса ручной установки на операционные системы (ОС), такие как:

Platform V SberLinux OS Server;
РЕД ОС;
CentOS;
Astra Linux / Astra Linux релиз «Смоленск»;
Альт СП / Альт Сервер.

Для уточнения поддерживаемых версий указанных ОС обратитесь к списку в разделе «Системные требования».

Подсказка

Для развертывания СУБД Pangolin на окружении 1С выполните шаги с пометкой «для окружения 1С», вместо «обычное окружение».

Порядок установки

Шаги процесса ручной установки:

Установка rpm/deb-пакетов серверной и клиентской части СУБД.
Создание системных директорий необходимых для работы СУБД.
Выполнение импорта лицензии.
Подготовка переменных окружения.
Инициализация кластера СУБД.
Конфигурирование СУБД Pangolin.
Запуск СУБД.
Проверка результата.
Ознакомление с дальнейшими шагами.

Шаг 1. Установка rpm/deb-пакетов

Установите пакеты серверной и клиентской части СУБД:

SberLinux, РЕД ОС, CentOS
Astra Linux
Альт СП

sudo dnf install /{path}/pangolin-dbms-{base_version}-7.3.1-{OS}.x86_64.rpm
sudo dnf install /{path}/pangolin-dbms-{base_version}-client-7.3.1-{OS}.x86_64.rpm

sudo apt install /{path}/pangolin-dbms-{base_version}-7.3.1_amd64.deb
sudo apt install /{path}/pangolin-dbms-{base_version}-client_7.3.1_amd64.deb

sudo apt-get install /{path}/pangolin-dbms-{base_version}-7.3.1-altlinux{version_OS}.x86_64.rpm
sudo apt-get install /{path}/pangolin-dbms-{base_version}-client-7.3.1-altlinux{version_OS}.x86_64.rpm

Подсказка

Пример заполненной команды:

sudo dnf -y install ~/distributive/pangolin-dbms-7-7.3.1-sberlinux9.x86_64.rpm
sudo dnf -y install ~/distributive/pangolin-dbms-7-client-7.3.1-sberlinux9.x86_64.rpm

В случае использования настроенного локального репозитория используйте упрощенные команды для установки пакетов. Например, sudo dnf -y install pangolin-dbms-{short_version}. Пакетный менеджер самостоятельно найдет нужный пакет в репозитории и предложит его к установке.

Шаг 2. Создание системных директорий

Создайте директории /pgdata, /pangolinlogs:

sudo mkdir -p /pgdata /pangolinlogs/pangolin-dbms
sudo chown -R postgres:postgres /pgdata /pangolinlogs
sudo chmod -R 700 /pgdata /pangolinlogs

Шаг 3. Импорт лицензии

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

Сведения

Лицензия поставляется вместе с дистрибутивом в личном кабинете клиента. В случае ее отсутствия, обратитесь к менеджеру.

Добавьте файл с лицензией license.json в папку /opt/pangolin-license/ и назначьте необходимые права:

sudo mkdir -p /opt/pangolin-license
sudo mv /{path}/license.json /opt/pangolin-license
sudo chown -R postgres:pangolin_users /opt/pangolin-license
sudo chmod 770 /opt/pangolin-license
sudo chmod 440 /opt/pangolin-license/license.json

Шаг 4. Подготовка переменных окружения

Из под пользователя postgres измените файл .bash_profile (в случае ОС Astra Linux - .profile) при помощи текстового редактора, добавив следующие строки с переменными окружения (замените переменные в скобках { } на актуальные значения). После перечитайте переменные окружения для .bash_profile/.profile:

sudo -iu postgres

   umask 022
export PG_PLUGINS_PATH=/opt/pangolin-dbms-server-7/lib
export PG_LICENSE_PATH=/opt/pangolin-license
export PGHOME=/opt/pangolin-dbms-server-7
export PGHOME_CLIENT=/opt/pangolin-dbms-client-7
export PGDATABASE=postgres
export PGUSER=postgres
export PGHOST=127.0.0.1
export PGPORT=5432
export PGCLIENTENCODING=UTF8
export PGDATA=/pgdata/07/data
export MANPATH=$MANPATH:$PGHOME/share/man

. ~/.bash_profile
exit

Шаг 5. Инициализация кластера СУБД

Инициализируйте новый кластер СУБД Pangolin:

обычное окружение:

  sudo -iu postgres
initdb --locale en_US.UTF-8 -k -D /pgdata/07/data/
exit

окружение с 1С:
```
  sudo -iu postgres
initdb --locale ru_RU.UTF-8 -k -D /pgdata/07/data/
exit
```
Для окружения с 1С крайне важно указать локаль, в будущем она будет использоваться для инициализации БД, которая создает 1С.

Шаг 6. Конфигурирование СУБД Pangolin

Отредактируйте конфигурационный файл /pgdata/0{base_version}/data/postgresql.conf:
1. Рекомендуется выполнять конфигурирование СУБД при помощи вспомогательного инструмента Pangolin Tuner. Описание утилиты и шаги по запуску описаны в подразделе «Установка компонента Pangolin Tuner».
2. С помощью текстового редактора под пользователем postgres измените значение конфигурационного параметра enabled_extra_auth_methods с указанием методов аутентификации (эти же методы нужно будет указать в pg_hba.conf в следующем пункте) к использованию:
  - обычное окружение:
    enabled_extra_auth_methods = 'peer, trust'
  - окружение с 1С:
    enabled_sec_admin_extra_auth_methods = 'md5,trust,peer,cert' enabled_extra_auth_methods = 'md5,trust,peer,cert'
  Примечание
  Параметрenabled_sec_admin_extra_auth_methods отвечает за список дополнительно разрешенных к использованию методов аутентификации для ролей администраторов безопасности, тогда как в enabled_extra_auth_methods передается список для всех остальных ролей.
3. С помощью текстового редактора под пользователем postgres задайте для параметра listen_addresses значение 0.0.0.0, чтобы разрешить подключение к СУБД по IP-адресу сервера Pangolin.
```
listen_addresses = '0.0.0.0'
```
4. Аналогично измените параметр log_directory, который должен быть равен пути до каталога pangolinlogs, созданного на шаге 2.
```
log_directory = /pangolinlogs/pangolin-dbms
```
С помощью текстового редактора под пользователем postgres измените конфигурационный файл /pgdata/0{base_version}/data/pg_hba.conf (добавьте строки в конец файла):
```
local   all           all                                peer
host    all           all           0.0.0.0/0            trust
```

Шаг 7. Запуск СУБД

Запустите экземпляр СУБД Pangolin:

sudo -iu postgres
pg_ctl -D /pgdata/07/data/ start
exit

Результат

После завершения процесса установки экземпляра СУБД рекомендуется провести чек-лист проверки корректности работы.

В результате выполнения данных этапов по инструкции формируется:

Готовый к работе экземпляр СУБД в конфигурации standalone.
Настроенный файл конфигурации (postgresql.conf), адаптированный под нужный профиль использования (OLAP/OLTP/1C).
Возможность самостоятельно адаптировать СУБД под индивидуальные требования (настройка расширений, функциональностей и пр.).

Установка компонентов продукта СУБД Pangolin

Установка компонента Pangolin Tuner

Pangolin Tuner — это инструмент для работы с конфигурацией Postgres-like СУБД, предназначенный для оптимизации производительности баз данных в различных сценариях использования. Инструмент автоматически определяет оптимальные настройки в зависимости от профиля рабочей нагрузки / профиля использования. Это позволяет значительно сократить время настройки и минимизировать риски, связанные с неправильной конфигурацией. Подробнее смотрите в отдельном разделе про утилиту Pangolin Tuner.

Порядок установки

Шаги процесса ручной установки компонента:

Установка rpm/deb-пакета утилиты.
Описание процесса оптимизации конфигурационного файла СУБД.

Шаг 1. Установка rpm/deb-пакета

SberLinux, РЕД ОС, CentOS
Astra Linux
Альт СП

sudo dnf install /{path}/utilities/pangolin-tuner-{version_component}-{OS}.x86_64.rpm

sudo apt install /{path}/utilities/pangolin-tuner-{version_component}_amd64.deb

sudo apt-get install /{path}/utilities/pangolin-tuner-{version_component}-altlinux{version_OS}.x86_64.rpm

Подсказка

Пример заполненной команды:

sudo dnf -y install ~/distributive/utilities/pangolin-tuner-1.2.0-sberlinux9.x86_64.rpm

Шаг 2. Оптимизация конфигурационного файла СУБД

Выберите профиль рабочей нагрузки, соответствующий конкретным потребностям для использования оптимальных значений параметров.

Запустите утилиту Pangolin Tuner с необходимыми настройками и сконфигурируйте файл под нужный профиль:

Профиль OLTP:

     sudo -iu postgres
/opt/pangolin-tuner/bin/pangolin-tuner --config /pgdata/07/data/postgresql.conf --profile oltp --output-file /pgdata/07/data/postgresql.conf.oltp
exit

Профиль OLAP:

     sudo -iu postgres
/opt/pangolin-tuner/bin/pangolin-tuner --config /pgdata/07/data/postgresql.conf --profile olap --output-file /pgdata/07/data/postgresql.conf.olap
exit

Профиль 1C (для окружения 1С):

     sudo -iu postgres
/opt/pangolin-tuner/bin/pangolin-tuner --config /pgdata/07/data/postgresql.conf --profile 1c --output-file /pgdata/07/data/postgresql.conf.1c
exit

Примените созданный конфигурационный файл:
```
   sudo -iu postgres
mv /pgdata/07/data/postgresql.conf.oltp /pgdata/07/data/postgresql.conf
chmod 600 /pgdata/07/data/postgresql.conf
exit
```
Сведения
Pangolin Tuner не конфигурирует индивидуальные настройки, связанные с количеством подключений либо с активацией расширений. Данные параметры необходимо настроить самостоятельно.
Описание параметров, по которым утилита Pangolin Tuner формирует значение, расположено в разделе «Тюнинг параметров» документа «Руководство администратора».

Установка компонента Pangolin Pooler

Сведения

Установка компонента Pangolin Pooler является опциональной для standalone-конфигурации СУБД. Отсутствие Pangolin Pooler не влияет на работоспособность экземпляра СУБД.

Компонент Pangolin Pooler – это доработанная версия PgBouncer, а именно программа, управляющая пулом соединений Pangolin DBMS. Любое клиентское приложение может подключиться к Pangolin Pooler, как если бы это был непосредственно сервер DBMS, и Pangolin Pooler создаст подключение к реальному серверу, либо задействует одно из ранее установленных подключений. Предназначение Pangolin Pooler — минимизировать издержки, связанные с установлением новых подключений к Pangolin DBMS.

Подробное описание компонента представлено в разделе «Администрирование Pangolin Pooler» документа «Руководство администратора».

Порядок установки

Шаги процесса ручной установки компонента:

Установка rpm/deb-пакета компонента Pangolin Pooler.
Создание системных директорий, необходимых для работы компонента.
Конфигурирование Pangolin Pooler.
Настройка ротации журналов.
Запуск компонента.

Шаг 1. Установка rpm/deb-пакета

Выполните установку компонента Pangolin Pooler под пользователем root:

SberLinux, РЕД ОС, CentOS
Astra Linux
Альт СП

sudo dnf install /{path}/pangolin-pooler-{version_component}-{OS}.x86_64.rpm

sudo apt install /{path}/pangolin-pooler-{version_component}-{OS}_amd64.deb

sudo apt-get install /{path}/pangolin-pooler-{version_component}-{OS}.x86_64.rpm

Пример заполненной команды:

sudo dnf install -y ~/distributive/pangolin-pooler-1.6.1-sberlinux9.x86_64.rpm

Шаг 2. Создание системных директорий

Создайте директории /pangolinlogs/pangolin-pooler:

sudo mkdir -p /pangolinlogs/pangolin-pooler
sudo chown -R postgres:postgres /pangolinlogs
sudo chmod -R 700 /pangolinlogs

Шаг 3. Конфигурирование Pangolin Pooler

С помощью текстового редактора под пользователем postgres отредактируйте файл /etc/pangolin-pooler/pangolin-pooler.ini, заполнив поля значениями, соответствующими данным вашего стенда:
Пример файла pangolin-pooler.ini с минимальными настройками
[databases] * = host=<ip-address> port=<port> [pgbouncer] listen_port = 6544 listen_addr = * auth_type = scram-sha-256 auth_file = /etc/pangolin-pooler/userlist.txt logfile = /pangolinlogs/pangolin-pooler/pangolin-pooler.log pidfile = /var/run/pangolin-pooler/pangolin-pooler.pid admin_users = pgbouncer
С помощью текстового редактора под пользователем postgres измените файл /etc/pangolin-pooler/userlist.txt, заполнив поля значениями, соответствующими данным вашего стенда:
```
"<user>" "<password>"
```
Пример файла userlist.txt:
```
"user" "qwerty"
```
Или в засекреченном виде:
```
"user" "md5175c641eaed0b6c05ae8444b73d789f0"
```

Шаг 4. Настройка ротации журналов

С помощью текстового редактора под пользователем root измените файл /opt/pangolin-pooler/share/doc/logrotate/pangolin-pooler, заполнив поля значениями, соответствующими данным вашего стенда:

Пример файла pangolin-pooler:

/pangolinlogs/pangolin-pooler/pangolin-pooler.log {
      rotate 10
      su postgres postgres
      missingok
      sharedscripts
      notifempty
      compress
      daily
      create 0600 postgres postgres
      postrotate
           /bin/kill -HUP `cat /var/run/pangolin-pooler/pangolin-pooler.pid 2> /dev/null` 2>/dev/null ||true
      endscript
}

Перенесите готовый файл в системный каталог ротации логов и назначьте права:

sudo cp /opt/pangolin-pooler/share/doc/logrotate/pangolin-pooler /etc/logrotate.d/pangolin-pooler
sudo chown postgres:postgres /etc/logrotate.d/pangolin-pooler
sudo chmod 0644 /etc/logrotate.d/pangolin-pooler

Шаг 5. Запуск Pangolin Pooler

Произведите запуск службы Pangolin Pooler:
```
sudo systemctl restart pangolin-pooler
```

Проверьте корректность запуска и состояние сервиса. Пример статуса:

sudo systemctl status pangolin-pooler

Пример успешного старта сервиса pangolin-pooler

● pangolin-pooler.service - Pangolin Pooler connection pooling for PostgreSQL
     Loaded: loaded (/usr/lib/systemd/system/pangolin-pooler.service; disabled; preset: disabled)
     Active: active (running) since Mon 2026-02-02 18:58:35 MSK; 4s ago
    Process: 2292612 ExecStartPre=/bin/mkdir -p /var/run/pangolin-pooler (code=exited, status=0/SUCCESS)
    Process: 2292613 ExecStartPre=/bin/chown -R postgres:postgres /var/run/pangolin-pooler (code=exited, status=0/SUCCESS)
    Process: 2292614 ExecStart=/opt/pangolin-pooler/bin/pangolin-pooler -d ${POOLERCONF} (code=exited, status=0/SUCCESS)
    Process: 2292617 ExecStartPost=/bin/sleep 1 (code=exited, status=0/SUCCESS)
   Main PID: 2292616 (pangolin-pooler)
      Tasks: 2 (limit: 50508)
     Memory: 3.8M
        CPU: 18ms
     CGroup: /system.slice/pangolin-pooler.service
             └─2292616 /opt/pangolin-pooler/bin/pangolin-pooler -d /etc/pangolin-pooler/pangolin-pooler.ini

Feb 02 18:58:34 srv-123 systemd[1]: Starting Pangolin Pooler connection pooling for PostgreSQL...
Feb 02 18:58:35 srv-123 systemd[1]: Started Pangolin Pooler connection pooling for PostgreSQL...

Дальнейшие шаги

После выполнения ручной установки экземпляра СУБД в конфигурации standalone доступно:

добавить сервис файл СУБД Pangolin;
настроить ролевую модель;
установить необходимые расширения;
установить утилиту резервного копирования CopyWala;
подключить и настроить доступные функциональности безопасности продукта СУБД Pangolin и установить другие требуемые функциональности.

Сведения

Шаги по установке других поставляемых пакетов представлены всоответствующих разделах их функциональности.

Подготовка к ручной установке​

Установка экземпляра СУБД Pangolin​

Порядок установки​

Шаг 1. Установка rpm/deb-пакетов​

Шаг 2. Создание системных директорий​

Шаг 3. Импорт лицензии​

Шаг 4. Подготовка переменных окружения​

Шаг 5. Инициализация кластера СУБД​

Шаг 6. Конфигурирование СУБД Pangolin​

Шаг 7. Запуск СУБД​

Результат​

Установка компонентов продукта СУБД Pangolin​

Установка компонента Pangolin Tuner​

Порядок установки​

Шаг 1. Установка rpm/deb-пакета​

Шаг 2. Оптимизация конфигурационного файла СУБД​

Установка компонента Pangolin Pooler​

Порядок установки​

Шаг 1. Установка rpm/deb-пакета​

Шаг 2. Создание системных директорий​

Шаг 3. Конфигурирование Pangolin Pooler​

Шаг 4. Настройка ротации журналов​

Шаг 5. Запуск Pangolin Pooler​

Дальнейшие шаги​

Подготовка к ручной установке

Установка экземпляра СУБД Pangolin

Порядок установки

Шаг 1. Установка rpm/deb-пакетов

Шаг 2. Создание системных директорий

Шаг 3. Импорт лицензии

Шаг 4. Подготовка переменных окружения

Шаг 5. Инициализация кластера СУБД

Шаг 6. Конфигурирование СУБД Pangolin

Шаг 7. Запуск СУБД

Результат

Установка компонентов продукта СУБД Pangolin

Установка компонента Pangolin Tuner

Порядок установки

Шаг 1. Установка rpm/deb-пакета

Шаг 2. Оптимизация конфигурационного файла СУБД

Установка компонента Pangolin Pooler

Порядок установки

Шаг 1. Установка rpm/deb-пакета

Шаг 2. Создание системных директорий

Шаг 3. Конфигурирование Pangolin Pooler

Шаг 4. Настройка ротации журналов

Шаг 5. Запуск Pangolin Pooler

Дальнейшие шаги