Описание поставляемых rpm/deb-пакетов

Сведения

Полный список элементов дистрибутива приведен в разделе«Состав дистрибутива» данного документа.

Содержание

Основные rpm/deb-пакеты:
Дополнительные rpm/deb-пакеты:
- pangolin-dbms-libpq
- pangolin-dbms-libpq-dev
Утилиты:
Мета-пакеты
Отладочные пакеты
Вспомогательные пакеты:
- pangolin-installer-venv-controller
- pangolin-installer-venv-controlled
Расширения
Untrusted расширения

Общая информация

Поставляемые rpm/deb-пакеты упрощают распространение, управление и обновление программного обеспечения.

Необходимо использовать только стандартные средства управления пакетами (dnf, yum, apt или apt-get) для установки, переустановки, удаления, обновления и проверки rpm/deb-пакетов. При работе с данными пакетными менеджерами все зависимости (как внутренние, так и внешние) будут установлены автоматически.

Основные rpm/deb-пакеты

Основные rpm/deb-пакеты поставляемые в owned-части:

pangolin-dbms
pangolin-dbms-client
pangolin-manager
- pangolin-manager-venv
pangolin-pooler
pangolin-pooler-mt
pangolin-backup-tools
- pangolin-backup-tools-venv

Подсказка

При установке данных пакетов, будут созданы системные пользователи (при их отсутствии): postgres с uid/gid: 26 и kmadmin_pg с uid/gid: 126. При возникновении конфликтов идентификаторов создаваемых пользователей обратитесь к разделу «Часто встречающиеся проблемы и пути их устранения».

Версии основных пакетов

Название пакета	Версия
`pangolin-manager`	4.2.0
`pangolin-manager-venv`	4.2.0
`pangolin-backup-tools`	8.2.0
`pangolin-backup-tools-venv`	8.2.0
`pangolin-pooler`	3.2.0
`pangolin-pooler-mt`	1.5.5
`pangolin-dbms`	8.2
`pangolin-dbms-client`	8.2

Пакеты pangolin-dbms и pangolin-dbms-client

Сведения

Данные пакеты являютсяобязательными к установке при развертывании СУБД Pangolin.

В СУБД Pangolin основной rpm/deb-пакет СУБД разделен на две независимые части — клиентскую (pangolin-dbms-client) и серверную (pangolin-dbms), обе из которых доступны пользователю после установки.

Особенности

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

Состав пакетов

В состав клиентского пакета включены следующие утилиты (доступные по пути /opt/pangolin-dbms-client-{short_version}/bin), а также файлы документации и локали, соответствующие им:

clusterdb
createdb
createuser
dropdb
dropuser
pangolin-linker
pg_amcheck
pg_basebackup
pgbench
pg_dump
pg_dumpall
pg_isready
pg_receivewal
pg_recvlogical
pg_restore
pg_verifybackup
psql
reindexdb
vacuumdb

В состав серверного пакета включены следующие утилиты (доступные по пути /opt/pangolin-dbms-server-{base_version}/bin), а также файлы документации и локали, соответствующие им и не только:

admin_protection_disabler
ecpg
initdb
initprotection
oid2name
pangolin-linker
pg_archivecleanup
pg_auth_config
pg_checksums
pg_config
pg_controldata
pg_ctl
pg_repack
pg_resetwal
pg_rewind
pg_test_fsync
pg_test_timing
pg_upgrade
pg_waldump
pkcs12_cert_info
postgres
postmaster
psql_rsa_verify
psql_set_lsn
secure_config_disabler
tde_disabler
trace_decode
vacuumlo

Где {short_version} – короткая версия продукта (текущая: 8.2), а {base_version} – базовая версия продукта (текущая: 8).

Дополнительно, при развертывании пакета серверного компонента, создается директория: /etc/pangolin-auth-encryption. Данный каталог будет использоваться при включенной функциональности хранилище паролей.

Установка

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

Пути до файлов компонентов

Компоненты имеют следующие пути до системных файлов:

Путь развертывания бинарных файлов и библиотек компонентов pangolin-dbms и pangolin-dbms-client в PGHOME/PGHOME_CLIENT:
```
/opt/pangolin-dbms-server-{base_version}/
/opt/pangolin-dbms-client-{base_version}/
```

Где {base_version} - базовая версия продукта (текущая: 8).

Также системно создаются символические ссылки на каталоги PGHOME/PGHOME_CLIENT:

/opt/pangolin-dbms-server/
/opt/pangolin-dbms-client/

Сервисный файл серверной части:
```
/opt/pangolin-dbms-server/share/postgresql.service
```
Для клиентской части отсутствует сервисный файл, так как не подразумевается запуск каких-либо сервисов.
Файл с PID процесса компонента серверной части:
- Без функциональности «Отказ от root»:
```
/var/run/postgresql/
```
  Регулируется конфигурационным параметром unix_socket_directories.
- С функциональностью «Отказ от root»:
```
/var/run/user/{user_id}/postgresql
```
Путь к директории для лог-файлов задается с помощью параметра log_directory. По умолчанию используется:
```
/pangolinlogs/pangolin-dbms
```

Где {base_version} – базовая версия продукта (текущая: 8).

Пакет pangolin-manager

Сведения

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

Пакет отвечает за управление компонентом Pangolin Manager, который является оркестратором кластера СУБД Pangolin.

Структура пакета

Пакет pangolin-manager имеет следующую структуру:

/etc/pangolin-manager/
├── postgres.yml
└── postgres.yml.backup

/opt/pangolin-manager/
├── bin
│   ├── get-pangolin-gucs
│   ├── pangolin-dcs-ctl
│   ├── pangolin-manager
│   ├── pangolin-manager-bin
│   │   ├── get-pangolin-gucs.bin
│   │   ├── pangolin-dcs-ctl.bin
│   │   ├── pangolin-manager.bin
│   │   ├── pangolin-manager-ctl.bin
│   │   └── patroni
│   │       └── <...>
│   ├── pangolin-manager-ctl
│   └── pangolin-manager-raft-controller
├── lib
│   ├── <...>
│   └── plugins
│       └── <...>
├── lib64 -> lib
├── log
└── share
    ├── doc
    │   └── logrotate
    │       └── pangolin-manager
    └── LICENSE

Пути до файлов компонента

Компонент имеет следующие пути до системных файлов:

Путь развертывания бинарных файлов и библиотек компонента:
```
/opt/pangolin-manager/
```

Сервисный файл:

/usr/lib/systemd/system/pangolin-manager.service

Файл с PID процесса компонента — отсутствует.
Файл для ротация файлов логирования компонента:
```
/opt/pangolin-manager/share/doc/logrotate/pangolin-manager/
```
Конфигурационный файл компонента:
```
/etc/pangolin-manager/postgres.yml
```
Расположение лог-файла компонента:
```
/pangolinlogs/pangolin-manager/pangolin-manager.log
```

Где {base_version} – базовая версия продукта (текущая: 8).

Установка

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

При установке пакета или его обновлении с предыдущей версии выполняется следующее:

Исполняемые файлы размещаются в каталоге /opt/pangolin-manager/bin/;
Создается конфигурационный файл по пути /etc/pangolin-manager/postgres.yml при его отсутствии;
Создается сервис pangolin-manager.service при его отсутствии;
Создается пользователь postgres с UID=26 по умолчанию (при отсутствии).

Особенности и зависимости

Особенности:

Может быть установлена только одна версия Pangolin Manager.
Нумерация версии начата с 1.1.0 после переименования с Patroni на Pangolin Manager.
При обновлении Patroni на пакет Pangolin Manager бинарные и конфигурационные файлы Patroni не удаляются;
Обновление компонента предполагает замену только исполняемых файлов и библиотек с сохранением файла настроек и файла службы.

Компонент имеет зависимость pangolin-manager-venv в виде дополнительного rpm/deb-пакета, поставляемого в 3rd Party части.

Пакет pangolin-manager-venv

Пакет содержит в себе зависимости python для работоспособности компонента pangolin-manager.

Состав пакета

Список pip-пакетов, которые входят в состав компонента:

boto - 2.49.0;
certifi - 2025.11.12;
charset-normalizer - 3.4.4;
click - 8.1.8;
dnspython - 2.7.0;
flake8 - 7.3.0;
idna - 3.11;
importlib_metadata - 8.7.1;
kazoo - 2.8.0;
mccabe - 0.7.0;
prettytable - 3.0.0;
psutil - 7.0.0;
psycopg2-binary - 2.9.10;
pycodestyle - 2.14.0;
pyflakes - 3.4.0;
python-dateutil - 2.9.0.post0;
python-etcd - 0.4.5;
python-json-logger - 2.0.7;
PyYAML - 6.0.3;
requests - 2.32.5;
semantic-version - 2.9.0;
setuptools - 80.9.0;
setuptools-rust - 1.1.2;
six - 1.17.0;
typing_extensions - 4.15.0;
urllib3 - 2.6.3;
wcwidth - 0.2.13;
ydiff - 1.2;
zipp - 3.23.0.

click - 8.2.1;
dnspython - 2.7.0;
prettytable - 3.0.0
psutil - 7.0.0
psycopg2-binary - 2.9.10;
python-dateutil - 2.9.0.post0;
python-etcd - 0.4.5;
python-json-logger - 2.0.7;
PyYAML - 6.0.3;
six - 1.17.0;
urllib3 - 2.6.3;
wcwidth - 0.2.13;
ydiff - 1.2.

boto - 2.49.0;
certifi - 2025.11.12;
charset-normalizer - 3.4.4;
click - 8.1.8;
dnspython - 2.7.0;
flake8 - 7.3.0;
idna - 3.11;
importlib_metadata - 8.7.1;
kazoo - 2.8.0;
mccabe - 0.7.0;
prettytable - 3.0.0;
psutil - 7.0.0;
psycopg2-binary - 2.9.10;
pycodestyle - 2.14.0;
pyflakes - 3.4.0;
python-dateutil - 2.9.0.post0;
python-etcd - 0.4.5;
python-json-logger - 2.0.7;
PyYAML - 6.0.3;
requests - 2.32.5;
semantic-version - 2.9.0;
setuptools - 80.9.0;
setuptools-rust - 1.1.2;
six - 1.17.0;
typing_extensions - 4.15.0;
urllib3 - 2.6.3;
wcwidth - 0.2.13;
ydiff - 1.2;
zipp - 3.23.0.

boto - 2.49.0;
certifi - 2025.11.12;
charset-normalizer - 3.4.6;
click - 8.1.8;
dnspython - 2.7.0;
flake8 - 7.3.0;
idna - 3.11;
importlib-metadata - 8.7.1;
kazoo - 2.8.0;
mccabe - 0.7.0;
prettytable - 3.0.0;
psutil - 7.0.0;
psycopg2-binary - 2.9.10;
pycodestyle - 2.14.0;
pyflakes - 3.4.0;
python-dateutil - 2.9.0.post0;
python-etcd - 0.4.5;
python-json-logger - 2.0.7;
pyyaml - 6.0.3;
requests - 2.32.5;
semantic-version - 2.9.0;
setuptools - 80.9.0;
setuptools-rust - 1.1.2;
six - 1.17.0;
typing-extensions - 4.15.0;
urllib3 - 2.6.3;
wcwidth - 0.2.13;
ydiff - 1.2;
zipp - 3.23.0.

boto - 2.49.0;
certifi - 2025.11.12;
charset-normalizer - 3.4.4;
click - 8.1.8;
dnspython - 2.7.0;
flake8 - 7.3.0;
idna - 3.11;
importlib_metadata - 8.7.1;
kazoo - 2.8.0;
mccabe - 0.7.0;
prettytable - 3.0.0;
psutil - 7.0.0;
psycopg2-binary - 2.9.10;
pycodestyle - 2.14.0;
pyflakes - 3.4.0;
python-dateutil - 2.9.0.post0;
python-etcd - 0.4.5;
python-json-logger - 2.0.7;
PyYAML - 6.0.3;
requests - 2.32.5;
semantic-version - 2.9.0;
setuptools - 80.9.0;
setuptools-rust - 1.1.2;
six - 1.17.0;
typing_extensions - 4.15.0;
urllib3 - 2.6.3;
wcwidth - 0.2.13;
ydiff - 1.2;
zipp - 3.23.0.

boto - 2.49.0;
certifi - 2025.11.12;
charset-normalizer - 3.4.4;
click - 8.1.8;
dnspython - 2.7.0;
flake8 - 7.3.0;
idna - 3.11;
importlib_metadata - 8.7.1;
kazoo - 2.8.0;
mccabe - 0.7.0;
prettytable - 3.0.0;
psutil - 7.0.0;
psycopg2-binary - 2.9.10;
pycodestyle - 2.14.0;
pyflakes - 3.4.0;
python-dateutil - 2.9.0.post0;
python-etcd - 0.4.5;
python-json-logger - 2.0.7;
PyYAML - 6.0.3;
requests - 2.32.5;
semantic-version - 2.9.0;
setuptools - 80.9.0;
setuptools-rust - 1.1.2;
six - 1.17.0;
typing_extensions - 4.15.0;
urllib3 - 2.6.3;
wcwidth - 0.2.13;
ydiff - 1.2;
zipp - 3.23.0.

Структура

/opt/pangolin-manager/
└── lib
    ├── python
    │   └── <...>
    └── python3 -> python

Установка

Установка компонента pangolin-manager-venv происходит автоматизированным способом при помощи Pangolin Installer, либо вручную при установке компонента Pangolin Manager.

Пакет pangolin-pooler

Сведения

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

Пакет отвечает за управление компонентом Pangolin Pooler, который является менеджером пулов соединений СУБД Pangolin.

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

Структура пакета

Пакет pangolin-pooler имеет следующую структуру:

/etc/pangolin-pooler/
├── pangolin-pooler.ini
└── userlist.txt

/opt/pangolin-pooler
├── bin
│   ├── pangolin-pooler
│   └── pangolin-pooler-restart.sh
└── lib
    ├── <...>
    └── plugins
        └── <...>

Пути до файлов компонента

Компонент имеет следующие пути до системных файлов:

Путь развертывания бинарных файлов и библиотек компонента:
```
/opt/pangolin-pooler/
```

Сервисный файл:

/usr/lib/systemd/system/pangolin-pooler.service

Файл с PID процесса компонента:
- Без функциональности «Отказ от root»:
```
/var/run/pangolin-pooler/pangolin-pooler.pid
```
- С функциональностью «Отказ от root»:
```
/var/run/user/{user_id}/pangolin-pooler/pangolin-pooler.pid
```
Расположение лог-файла компонента:
```
/pangolinlogs/pangolin-pooler/pangolin-pooler.log
```

Где {base_version} – базовая версия продукта (текущая: 8).

Файл для ротация файлов логирования компонента:
```
/opt/pangolin-pooler/share/doc/logrotate/pangolin-pooler/
```
Конфигурационный файл компонента:
```
/etc/pangolin-pooler/pangolin-pooler.ini
```

Установка

При установке пакета или его обновлении с предыдущей версии выполняется следующее:

Исполняемые файлы и библиотеки размещаются в каталоге /opt/pangolin-pooler/.
Создается файл настроек по пути /etc/pangolin-pooler/pangolin-pooler.ini при его отсутствии.
Создается сервис pangolin-pooler.service при его отсутствии.
Создается пользователь postgres с UID=26 по умолчанию (при его отсутствии).

Особенности

Особенности:

Может быть установлена только одна версия Pangolin Pooler.
Нумерация версии начата с 1.1.0 после переименования с PgBouncer на Pangolin Pooler.
Обновление компонента предполагает замену только исполняемых файлов и библиотек с сохранением файла настроек и файла службы.

Пакет pangolin-pooler-mt

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

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

Структура пакета

Пакет pangolin-pooler-mt имеет структуру:

/etc/pangolin-pooler-mt/
├── pangolin-pooler-mt.ini
└── userlist.txt

/opt/pangolin-pooler-mt/
├── bin/
│   ├── pangolin-pooler-mt
│   └── pangolin-pooler-mt-restart.sh
└── lib/
    ├── <...>
    └── plugins
        └── <...>

Пути до файлов компонента

Компонент имеет следующие пути до системных файлов:

Путь развертывания бинарных файлов и библиотек компонента:
```
/opt/pangolin-pooler-mt/
```

Сервисный файл:

/usr/lib/systemd/system/pangolin-pooler-mt.service

Файл с PID процесса компонента:
- Без функциональности «Отказ от root»:
```
/var/run/pangolin-pooler-mt/pangolin-pooler-mt.pid
```
- С функциональностью «Отказ от root»:
```
/var/run/user/{user_id}/pangolin-pooler-mt/pangolin-pooler-mt.pid
```
Расположение лог-файла компонента:
```
  /pgerrorlogs/08/pangolin-pooler-mt/pangolin-pooler-mt.log
```
Файл для ротация файлов логирования компонента:
```
/opt/pangolin-pooler-mt/share/doc/logrotate/pangolin-pooler-mt/
```
Конфигурационный файл компонента:
```
/etc/pangolin-pooler-mt/pangolin-pooler-mt.ini
```

Установка

Установка данного пакета доступна на этапе развертывания СУБД при помощи автоматизированных Ansible-скриптов, либо в любой момент с помощью инструкции ручной установки.

Пакет pangolin-backup-tools

Сведения

Данный пакет являетсяобязательным к установке при необходимости реализации РК.

Компонент Pangolin Backup Tools представляет собой набор утилит и скриптов, позволяющий настроить процесс резервного копирования хранимых в СУБД Pangolin данных. Инструменты резервного копирования поставляемые в составе данного пакета:

pg_probackup;
manage_backup.bin;
manage_backup.sh;
pangolin_archlogs.sh.

Примечание

Компонент не является полноценной системой резервного копирования и управления резервными копиями. Предназначен для интеграции с внешними инструментами РК.

Структура пакета

Пакет pangolin-backup-tools имеет следующую структуру:

/etc/pangolin-backup-tools
└── backup-tools-env

/opt/pangolin-backup-tools/
├── bin
│   ├── manage_backup.bin
│   ├── manage_backup.sh
│   ├── pangolin_archlogs.sh
│   └── pg_probackup
├── lib
│   ├── <...>
│   └──plugins
│       └── <...>
├── lib64 -> lib
└── share
    ├── backup-tools-env.sample
    └── LICENSE

Пути до файлов компонента

Утилиты расположены после развертывания пакета по пути:

/opt/pangolin-backup-tools/bin/

Файл конфигурируемой части компонента:

/etc/pangolin-backup-tools/backup-tools-env

В данном файле с помощью переменной окружения PG_FAST_CHECKPOINT можно изменить второй параметр функции pg_backup_start, используемой в manage_backup.bin, который управляет выполнением контрольной точки перед началом резервного копирования.

При значении true перед запуском резервного копирования выполняется принудительный CHECKPOINT, что может привести к кратковременному увеличению нагрузки на подсистему ввода/вывода и замедлению параллельно выполняемых задач.

При значении false (или если параметр не указан в /etc/pangolin-backup-tools/backup-tools-env) используется стандартное поведение PostgreSQL: резервное копирование начинается после завершения ближайшего планового CHECKPOINT, без его принудительного выполнения.

Файл с PID процесса компонента отсутствует, как и фиксация отдельного лог-файла.

Установка

Компонент pangolin-backup-tools устанавливается по умолчанию при первичном развертывании или при обновлении стенда, с помощью автоматизированных скриптов, на котором этого компонента ранее не было.

Описание процесса ручной установки представлено в разделе «Утилита резервного копирования pg_probackup» документа «Руководство администратора».

Компонент имеет зависимость pangolin-backup-tools-venv в виде дополнительного rpm/deb-пакета, поставляемого в 3rd Party части.

Пакет pangolin-backup-tools-venv

Пакет содержит в себе зависимости python для работоспособности компонента pangolin-backup-tools.

Состав пакета

Список pip-пакетов, которые входят в состав компонента:

argparse - 1.4.0;
certifi - 2025.11.12;
charset-normalizer - 3.4.4;
docutils - 0.21.2;
idna - 3.11;
lockfile - 0.12.2;
psycopg2-binary - 2.9.10;
python-daemon - 3.1.2;
requests - 2.32.5;
urllib3 - 2.6.3.

certifi - 2025.11.12;
charset-normalizer - 3.4.9;
idna - 3.11;
lockfile - 0.12.2;
psycopg2-binary - 2.9.10;
python-daemon - 3.1.2;
requests - 2.32.5;
urllib3 - 2.6.3.

argparse - 1.4.0;
certifi - 2025.11.12;
charset-normalizer - 3.4.4;
docutils - 0.21.2;
idna - 3.11;
lockfile - 0.12.2;
psycopg2-binary - 2.9.10;
python-daemon - 3.1.2;
requests - 2.32.5;
urllib3 - 2.6.3.

argparse - 1.4.0;
certifi - 2025.11.12;
charset-normalizer - 3.4.6;
docutils - 0.21.2;
idna - 3.11;
lockfile - 0.12.2;
psycopg2-binary - 2.9.10;
python-daemon - 3.1.2;
requests - 2.32.5;
urllib3 - 2.6.3.

argparse - 1.4.0;
certifi - 2025.11.12;
charset-normalizer - 3.4.4;
docutils - 0.21.2;
idna - 3.11;
lockfile - 0.12.2;
psycopg2-binary - 2.9.10;
python-daemon - 3.1.2;
requests - 2.32.5;
urllib3 - 2.6.3.

argparse - 1.4.0;
certifi - 2025.11.12;
charset-normalizer - 3.4.4;
docutils - 0.21.2;
idna - 3.11;
lockfile - 0.12.2;
psycopg2-binary - 2.9.10;
python-daemon - 3.1.2;
requests - 2.32.5;
urllib3 - 2.6.3.

Структура

/opt/pangolin-backup-tools/
└── lib
    ├── python
    │   └── <...>
    └── python3 -> python

Установка

Установка компонента pangolin-backup-tools-venv происходит автоматизированным способом при помощи Pangolin Installer, либо вручную при установке компонента Pangolin Backup Tools.

Дополнительные rpm/deb-пакеты

Дополнительные rpm/deb-пакеты поставляемые в основной части дистрибутива:

pangolin-dbms-libpq
pangolin-dbms-libpq-dev
pangolin-copywala

Пакеты pangolin-dbms-libpq и pangolin-dbms-libpq-dev

Сведения

Пакеты являютсяопциональными для установки, в зависимости от потребности клиента.

Поставляемый пакет libpq - это интерфейс СУБД Pangolin для программирования приложений на языке C. Библиотека содержит набор функций, используя которые клиентские программы могут передавать запросы серверу СУБД Pangolin и принимать результаты этих запросов.

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

Особенности

Компонент libpq из поставки СУБД Pangolin является доработанным и модифицированным модулем (в отличие от оригинального решения) для реализации функций безопасности при работе других компонентов продукта, таких как Pangolin Manager, Backup Tools и другие.

При необходимости использования следующих функций безопасности потребуется установка поставляемого пакета pangolin-libpq:

работа с засекреченным хранилищем паролей;
работа по сертификатам PKCS#12;
засекречиванием пароля при передаче от клиента к БД командой \password (управляется конфигурационным параметром psql_encrypt_password);
исключение истории запросов в psql на стороне клиента.

Структура пакетов

Структура пакета pangolin-dbms-libpq:

/opt/pangolin-dbms-libpq-{short-version}/
├── lib
│   ├── libfe_elog.so
│   ├── libpq.so
│   ├── libpq.so.5
│   └── libpq.so.5.15
└── share
    └── locale
        └── <...>

В состав пакета pangolin-dbms-libpq-dev включен libpq.h:

/opt/pangolin-dbms-libpq-dev-{short-version}/
└── include
    └── libpq.h

Пути до файлов компонента

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

Установка

Компоненты устанавливаются вручную с помощью пакетного менеджера. Описание подготовки среды к разработке приложений описано в разделе «Подключение и конфигурирование» документа «Руководство разработчика».

Пакет pangolin-copywala

Пакет отвечает за установку утилиты резервного копирования и восстановления данных CopyWala.

Подробное описание утилиты представлено в разделе «Утилита резервного копирования CopyWala» документа «Руководство администратора».

Структура пакета

Пакет pangolin-copywala имеет следующую структуру:

/etc/pangolin-copywala/
├── copywala.example.yaml
└── copywala.yaml

/opt/pangolin-copywala/
├── bin
│  └── copywala
├── lib
│   ├── libaes_256_plugin.so
│   ├── libfe_elog.so
│   ├── libpassword_encryption.so
│   ├── libpassword_encryption.so.1
│   └── libpassword_encryption.so.1.1
├── log
└── var

Установка

Утилиты

Сведения

Компоненты представленные в данном разделе являютсяопциональными к установке, в зависимости от потребности клиента.

Список rpm/deb-пакетов в составе дистрибутива каталога utilities/:

pangolin-auth-password
pangolin-auth-reencrypt
pangolin-certs-rotate
pangolin-diagnostic-tool
pangolin-security-utilities
pangolin-tuner
pangolin-inplace-upgrade
pangolin-license-verify
pangolin-secret-storage-client
pangolin-password-hash

А также из каталога installer/utilities/:

pangolin-installer

Пакет pangolin-auth-password

Пакет поставляет утилиту pg_auth_password для засекречивания паролей. Инструмент позволяет получить пароль в засекреченном виде после ввода исходного пароля.

Структура

Пакет pangolin-auth-password имеет следующую структуру:

/opt/pangolin-auth-password/
├── bin/
│   └── pg_auth_password
└── lib/
    ├── libencryption_plugin.so -> plugins/libaes_256_plugin.so
    ├── libfe_elog.so
    └── plugins/
        └── libaes_256_plugin.so

Установка

Утилита устанавливается автоматически при выборе автоматизированного способа развертывания СУБД Pangolin. Описание процесса ручной установки и работы утилиты представлено в подразделе «Установка утилиты pg_auth_password» раздела «Засекречивание параметров подключения» документа «Руководство администратора».

Пути до файлов компонентов

После установки пакета утилита доступна по пути: /opt/pangolin-auth-password/bin/pg_auth_password.

Дополнительные системные файлы компонента отсутствуют.

Пакет pangolin-auth-reencrypt

Пакет поставляет утилиту pangolin-auth-reencrypt для автоматического перекодирования параметров подключения без привлечения администратора базы данных и администратора безопасности, входит в состав продукта, поэтому поставляется в виде rpm/deb-пакета в составе дистрибутива в каталоге utilities/. Утилита предназначена для поддержания высокого уровня безопасности и управления ключами кодирования.

Структура

/etc/pangolin-auth-reencrypt
├── enc_util.cfg
├── kmadmin_pg
│   └── <...>
└── postgres
    └── enc_params.cfg.postgres

/opt/pangolin-auth-reencrypt
├── bin
│   └── pangolin-auth-reencrypt
├── log
└── share
    └── doc
        └── logrotate
            ├── pangolin-auth-reencrypt-kmadmin_pg
            └── pangolin-auth-reencrypt-postgres

Пути до файлов компонентов

После установки пакета утилита pangolin-auth-reencrypt доступна в каталоге /opt/pangolin-auth-reencrypt/bin/pangolin-auth-reencrypt.

Компонент имеет следующие пути до системных файлов:

Путь развертывания бинарных файлов и библиотек компонента:
```
/opt/pangolin-auth-reencrypt/bin/
```

Сервисный файл компонента:

/usr/lib/systemd/system/pangolin-auth-reencrypt@.service или /home/postgres/.config/systemd/user/pangolin-auth-reencrypt.service

Файл с PID процесса компонента:

/var/run/pangolin-auth-reencrypt/pangolin-auth-reencrypt-postgres.pid
/var/run/pangolin-auth-reencrypt/pangolin-auth-reencrypt-kmadmin_pg.pid

Файл для ротация файлов логирования компонента:

/opt/pangolin-auth-reencrypt/share/doc/logrotate/pangolin-auth-reencrypt-postgres
/opt/pangolin-auth-reencrypt/share/doc/logrotate/pangolin-auth-reencrypt-kmadmin_pg

Конфигурационные файлы компонента:

/etc/pangolin-auth-reencrypt/enc_util.cfg
/etc/pangolin-auth-reencrypt/postgres/enc_params.cfg.postgres
/etc/pangolin-auth-reencrypt/kmadmin_pg/enc_params.cfg.kmadmin_pg

Установка

Утилита устанавливается автоматически при выборе автоматизированного способа развертывания СУБД Pangolin. Описание ручной установки представлено в подразделе «Утилиты засекречивания и хранения параметров подключения» раздела «Безопасность» документа «Руководство администратора», а сценарий работы утилиты представлен в подразделе «Восстановление работоспособности узла кластера при смене параметров сервера» раздела «Восстановление и контроль работоспособности» документа «Руководство администратора».

Пакет pangolin-certs-rotate

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

Описание работы агента pangolin-certs-rotate представлено в подразделе «Агент pangolin-certs-rotate» документа «Руководство администратора».

Структура

/etc/pangolin-certs-rotate
└── pangolin-certs-rotate.yml

/opt/pangolin-certs-rotate
├── bin
│   └── pangolin-certs-rotate
├── lib
│   ├── <...>
│   └── plugins
│       └── <...>
├── log
└── share
    └── doc
        └── logrotate
            └── pangolin-certs-rotate

Установка

Агент устанавливается автоматически при выборе автоматизированного способа развертывания СУБД Pangolin. Описание процесса настройки агента pangolin-certs-rotate представлено в подразделе «Агент pangolin-certs-rotate» документа «Руководство администратора».

Пути до файлов компонентов

После установки агент доступен в директории /opt/pangolin-common/bin/.

Компонент имеет следующие пути до системных файлов:

Бинарные файлы и библиотеки:

/opt/pangolin-certs-rotate/bin/
/opt/pangolin-certs-rotate/lib/

Сервисный файл:

/usr/lib/systemd/system/pangolin-certs-rotate.service или /home/postgres/.config/systemd/user/pangolin-certs-rotate.service

Конфигурационный файл компонента:
```
/etc/pangolin-certs-rotate/pangolin-certs-rotate.yml
```

Файл с PID процесса компонента:

/var/run/pangolin-certs-rotate/pangolin-certs-rotate.pid

Ротация лог-файлов агента выполняется с помощью утилиты logrotate. Файл конфигурации для logrotate расположен в:
```
/etc/logrotate.d/pangolin-certs-rotate
```

Пакет pangolin-diagnostic-tool

Пакет предоставляет утилиту diagnostic_tool формирования диагностического отчета с информацией об узле СУБД.

Структура

/opt/pangolin-diagnostic-tool
├── bin
│   ├── pangolin-diagnostic-tool
│   └── pangolin-diagnostic-tool-bin
│       └── pangolin-diagnostic-tool.bin
│
└── lib
    └── <...>

Пути до файлов компонентов

Утилита при развертывании располагается по пути /opt/pangolin-diagnostic-tool/bin/.

Дополнительные системные файлы компонента отсутствуют.

Установка

Пакет устанавливается автоматически при выборе автоматизированного способа развертывания СУБД Pangolin.

Описание работы утилиты представлено в подразделе «Диагностический отчет. Утилита pangolin-diagnostic-tool» раздела «Диагностика и планирование» документа «Руководство администратора».

Пакет pangolin-security-utilities

Компонент представляет собой комплекс утилит:

setup_kms_credentials – инициализирует параметры подключения к защищенному хранилищу;
encrypt_params_file – кодирует статические параметры при использовании KMS-заменителя;
generate_encryption_key – генерирует ключ для кодирования;
pg_dump_generate_secret_file – генерирует файла ключа, использующегося для засекречивания ключей кодирования защищенного дампа;
admin_protection_corrector – осуществляет автоматический поиск и удаления устаревших записей в системных таблицах СЗИ.

Пример использования утилит представлен в разделе «KMS-заменитель» документа «Руководство администратора».

Структура

/etc/pangolin-security-utilities/
├── enc_connection_settings_cert.cfg
└── vault_cache
    ├── certificates.cache
    └── vault_certs_cache.mtime

/opt/pangolin-security-utilities/
├── bin/
│   ├── admin_protection_corrector
│   ├── encrypt_params_file
│   ├── pg_dump_generate_secret_file
│   ├── generate_encryption_key
│   └── setup_kms_credentials
└── lib/
    ├── <...>
    └── plugins
        └── <...>

Пути до файлов компонентов

Бинарные файлы и библиотеки:

/opt/pangolin-security-utilities/bin/

Конфигурационные файлы компонента:

/etc/pangolin-security-utilities/enc_connection_settings.cfg
/etc/pangolin-security-utilities/enc_connection_settings_certs.cfg

Сведения

Создаются при инициализацииsetup_kms_credentials.

Дополнительные системные файлы компонента отсутствуют.

Установка

Пакет устанавливается автоматически при выборе автоматизированного способа развертывания СУБД Pangolin.

Описание использования утилит компонента представлено в разделе «Безопасность» документа «Руководство администратора».

Пакет pangolin-tuner

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

Структура

/opt/pangolin-tuner/
    └── bin/
        ├── pangolin-tuner
        └── <...>

Установка

С подробным описанием, процессом установки и управления утилитой можно ознакомиться в разделе «Тюнинг параметров» документа «Руководство администратора».

Путь до файлов компонента

После установки утилита доступна в каталоге /opt/pangolin-tuner/bin/pangolin-tuner.

Дополнительные системные файлы компонента отсутствуют.

Пакет pangolin-installer

Пакет предоставляет инструмент Pangolin Installer для управления скриптами автоматизации СУБД Pangolin.

Данный пакет имеет зависимость в виде пакета pangolin-installer-venv-controller. Инструмент не сможет корректно функционировать без предустановки данного пакета.

Путь до файлов компонента

Путь до утилиты: /opt/pangolin-installer/bin/pangolin-installer.

Бинарные файлы расположены по пути:

/opt/pangolin-installer/bin/pangolin-installer

Дополнительные системные файлы компонента отсутствуют.

Установка

Описание процесса установки и использование инструмента представлено в разделе «Автоматизированная установка при помощи инструмента Pangolin Installer».

Пакет pangolin-inplace-upgrade

Пакет предоставляет утилиту обновление на месте для обновления системных каталогов Pangolin без изменения структуры данных.

Структура

/opt/pangolin-utilities/bin/pg_inplace_upgrade
     ├── inplace_upgrade.sh
     ├── update_catalog_version
     ├── verify_pg_catalog.py
     └── sql_upgrade_6xx/
         └── <...>

Путь до файлов компонента

Скрипт обновления и все что он использует, находится в директории /opt/pangolin-utilities/bin/pg_inplace_upgrade поставляемого дистрибутива.

Установка

Процесс установки описан в сценариях обновления СУБД Pangolin в случаях этой необходимости.

Описание использования утилиты приведено в разделе «Утилита для обновления системных каталогов Pangolin без изменения структуры данных» данного документа.

Пакет pangolin-license-verify

Пакет предоставляет утилиту psql_rsa_verify для проверки подписанной лицензии.

Структура

/opt/pangolin-license-verify/
├── bin
│  └── psql_rsa_verify

Установка

Утилита верификации входит в состав продукта (серверной части) в месте расположения всех исполняемых файлов, а также отдельно дублируется в utilities в формате rpm/deb-пакета для возможности проверки типа лицензии перед началом развертывания серверной части СУБД (устанавливается инструментом Pangolin Installer).

Пакет pangolin-secret-storage-client

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

Структура

/opt/pangolin-license-verify/
├── bin
│  └── secret_storage_client
├── lib
│  ├── libconnector_plugin.so -> plugins/libvault_plugin.so
│  ├── libencryption_plugin.so -> plugins/libaes_256_plugin.so
│  ├── libfe_elog.so
│  └── plugins
|      └── <...>

Установка

Утилита secret_storage_client устанавливается автоматически при помощи инструмента Pangolin Installer, в процессе установки, либо обновления СУБД Pangolin.

Пакет pangolin-password-hash

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

Структура

/opt/pangolin-password-hash/
├── bin
│  ├── pangolin_password_hash
│  └── <...>

Установка

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

Пакет pangolin-inplace-upgrade

Структура

/opt/pangolin-utilities/bin/pg_inplace_upgrade
    ├── inplace_upgrade.sh
    ├── update_catalog_version
    ├── verify_pg_catalog.py
    └── sql_upgrade_6xx/
        └── <...>

Путь до файлов компонента

Установка

Процесс установки описан в сценариях обновления СУБД Pangolin в случаях этой необходимости.

Где {short_version} – короткая версия продукта (текущая: 8.2).

Мета-пакеты

Мета-пакеты, поставляемые в основной части дистрибутива:

pangolin-orchestrated
pangolin-core
pangolin-manager-dcs
pangolin-full
pangolin-full-debuginfo

Мета-пакеты из untrusted-части:

pangolin-untrusted
pangolin-untrusted-debuginfo

Процесс установки и описание мета-пакетов представлено в разделе «Мета-пакеты для процесса ручной пошаговой установки СУБД Pangolin».

Отладочные пакеты

Сведения

Компоненты, представленные в данном разделе, являютсяопциональными к установке, в зависимости от потребности клиента.

Набор пакетов для установки отладочных символов, собранных для основных модулей и утилит, поставляемые в каталоге debug/:

pangolin-backup-tools-debuginfo
pangolin-dbms-debuginfo
pangolin-dbms-client-debuginfo
pangolin-dbms-libpq-debuginfo
pangolin-manager-debuginfo
pangolin-pooler-debuginfo
pangolin-pooler-mt-debuginfo
pangolin-auth-password-debuginfo
pangolin-certs-rotate-debuginfo
pangolin-security-utilities-debuginfo

А также каталог с untrusted-расширений содержит архив untrusted-distrib с отладочными пакетами данных расширений.

Подробная информация об отладочных пакетах представлена в разделе «Поставка сборки с отладочными пакетами».

Вспомогательные пакеты для работоспособности скриптов автоматизации

Сведения

Компоненты представленные в данном разделе являются инструментами создания виртуального окруженияpython со всеми зависимостями, необходимыми для работоспособности скриптов автоматизации.

Поставляемые вспомогательные venv-пакеты:

pangolin-installer-venv-controller
pangolin-installer-venv-controlled

Пакет pangolin-installer-venv-controller

Пакет pangolin-installer-venv-controller, входящий в состав дистрибутива и располагающийся в 3rdparty, позволяет развернуть виртуальное окружения для корректного запуска скриптов развертывания/обновления. В его состав будут входить все необходимые зависимости для запуска автоматизированных сценариев.

Виртуальное окружение при развертывании rpm/deb-пакета располагается по пути /opt/pangolin-installer/.

Состав пакета

Список pip-пакетов, которые входят в состав компонента, для соответствующей операционной системы:

ansible - 8.7.0;
ansible-core - 2.15.13;
bcrypt - 3.2.0;
cffi - 2.0.0;
cryptography - 46.0.3;
dnspython - 2.7.0;
importlib-resources - 5.0.7;
Jinja2 - 3.1.6;
jmespath - 1.0.1;
loguru - 0.5.3;
MarkupSafe - 3.0.3;
netaddr - 0.8.0;
packaging - 25.0;
pangolin-installer - 2.1.0;
paramiko - 3.5.1;
pip - 25.3;
prettytable - 3.0.0;
progressbar2 - 4.0.0;
psutil - 5.9.8;
pycparser - 2.23;
PyNaCl - 1.5.0;
pyparsing - 3.2.1;
python-utils - 3.1.0;
PyYAML - 6.0.3;
resolvelib - 0.5.4;
setuptools - 80.9.0;
six - 1.17.0;
typing_extensions - 4.15.0;
wcwidth - 0.2.13;
wheel - 0.45.1.

ansible - 8.7.0;
ansible-core - 2.15.13;
bcrypt - 4.2.1;
cffi - 2.1.1;
cryptography - 46.0.3;
dnspython - 2.2.0;
Jinja2 - 3.0.3;
jmespath - 0.9.4;
loguru - 0.5.3;
MarkupSafe - 2.0.1;
netaddr - 0.7.19;
packaging - 21.3;
pangolin-installer - 3.1.0;
paramiko - 3.5.1;
pip - 23.3.2;
prettytable - 3.0.0;
progressbar2 - 4.0.0;
psutil - 7.0.0;
pycparser - 2.21;
PyNaCl - 1.5.0;
pyparsing - 3.0.6;
python-utils - 3.1.0;
PyYAML - 6.0.3;
resolvelib - 0.5.5;
six - 1.16.0;
wcwidth - 0.6.0.

ansible - 8.7.0;
ansible-core - 2.15.13;
bcrypt - 3.2.0;
cffi - 2.0.0;
cryptography - 46.0.3;
dnspython - 2.7.0;
importlib-resources - 5.0.7;
Jinja2 - 3.1.6;
jmespath - 1.0.1;
loguru - 0.5.3;
MarkupSafe - 3.0.3;
netaddr - 0.8.0;
packaging - 25.0;
paramiko - 3.5.1;
pip - 25.3;
prettytable - 3.0.0;
progressbar2 - 4.0.0;
psutil - 5.9.8;
pycparser - 2.23;
PyNaCl - 1.5.0;
pyparsing - 3.2.1;
python-utils - 3.1.0;
PyYAML - 6.0.3;
resolvelib - 0.5.4;
setuptools - 80.9.0;
six - 1.17.0;
typing_extensions - 4.15.0;
wcwidth - 0.2.13;
wheel - 0.45.1.

ansible - 8.7.0;
ansible-core - 2.15.13;
bcrypt - 4.1.3;
cffi - 2.0.0;
cryptography - 46.0.3;
dnspython - 2.7.0;
jinja2 - 3.1.6;
jmespath - 1.0.1;
loguru - 0.5.3;
markupsafe - 3.0.3;
netaddr - 0.8.0;
packaging - 25.0;
paramiko - 3.5.1;
pip - 25.3;
prettytable - 3.0.0;
progressbar2 - 4.0.0;
psutil - 5.9.8;
pycparser - 2.23;
PyNaCl - 1.5.0;
pyparsing - 3.2.1;
python-utils - 3.1.0;
pyyaml - 6.0.3;
resolvelib - 0.5.4;
setuptools - 80.9.0;
six - 1.17.0;
wcwidth - 0.2.13;
wheel - 0.45.1.

ansible - 8.7.0;
ansible-core - 2.15.13;
bcrypt - 4.1.3;
cffi - 2.0.0;
cryptography - 46.0.3;
dnspython - 2.7.0;
Jinja2 - 3.1.6;
jmespath - 1.0.1;
loguru - 0.5.3;
MarkupSafe - 3.0.3;
netaddr - 0.8.0;
packaging - 25.0;
paramiko - 3.5.1;
pip - 25.3;
prettytable - 3.0.0;
progressbar2 - 4.0.0;
psutil - 5.9.8;
pycparser - 2.23;
PyNaCl - 1.5.0;
pyparsing - 3.2.1;
python-utils - 3.1.0;
PyYAML - 6.0.3;
resolvelib - 0.5.4;
setuptools - 80.9.0;
six - 1.17.0;
wcwidth - 0.2.13;
wheel - 0.45.1.

ansible - 8.7.0;
ansible-core - 2.15.13;
bcrypt - 4.1.3;
cffi - 2.0.0;
cryptography - 46.0.3;
dnspython - 2.7.0;
Jinja2 - 3.1.6;
jmespath - 1.0.1;
loguru - 0.5.3;
MarkupSafe - 3.0.3;
netaddr - 0.8.0;
packaging - 25.0;
paramiko - 3.5.1;
pip - 25.3;
prettytable - 3.0.0;
progressbar2 - 4.0.0;
psutil - 5.9.8;
pycparser - 2.23;
PyNaCl - 1.5.0;
pyparsing - 3.2.1;
python-utils - 3.1.0;
PyYAML - 6.0.3;
resolvelib - 0.5.4;
setuptools - 80.9.0;
six - 1.17.0;
wcwidth - 0.2.13;
wheel - 0.45.1.

Структура

/opt/pangolin-installer/
├── bin
│   ├── activate
│   ├── activate.csh
│   ├── activate.fish
│   ├── Activate.ps1
│   ├── ansible
│   ├── ansible-config
│   ├── ansible-connection
│   ├── ansible-console
│   ├── ansible-doc
│   ├── ansible-galaxy
│   ├── ansible-inventory
│   ├── ansible-playbook
│   ├── ansible-pull
│   ├── ansible-test
│   ├── ansible-vault
│   ├── jp.py
│   ├── netaddr
│   ├── pangolin-installer
│   ├── pangolin-installer-bin
│   │   └── <...>
│   ├── pip
│   ├── pip3
│   ├── pip3.9
│   ├── __pycache__
│   │   └── jp.cpython-39.pyc
│   ├── python
│   ├── python3
│   └── python3.9
├── include
├── lib
│   ├── python3 -> python3.9
│   └── python3.9
│       └── <...>
├── lib64 -> lib
├── pyvenv.cfg
└── share
    └── plugins
        ├── __init__.py
        └── writer_count_tasks.py

Установка

Установка компонента pangolin-installer-venv-controller происходит вручную.

Описание установки данного пакета представлено в разделе «Подготовка виртуального окружения».

Подсказка

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

Пакет pangolin-installer-venv-controlled

Сведения

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

Пакет содержит набор pip-пакетов для развертывания виртуального окружения, необходимый для корректной работы автоматизированных сценариев на узлах стенда установки СУБД Pangolin. Данный компонент не входит в состав продукта, поэтому поставляется в каталоге 3rdparty/.

Состав пакета

Список pip-пакетов, которые входят в состав компонента:

certifi - 2025.11.12;
cffi - 2.0.0;
charset-normalizer - 3.4.4;
cryptography - 46.0.3;
idna - 3.11;
pexpect - 4.9.0;
pip - 25.3;
psutil - 7.0.0;
psycopg2-binary - 2.8.6;
ptyprocess - 0.7.0;
pycparser - 2.23;
PyYAML - 6.0.3;
requests - 2.32.5;
ruamel.yaml - 0.17.20;
ruamel.yaml.clib - 0.2.6;
setuptools - 80.9.0;
typing_extensions - 4.15.0;
urllib3 - 2.6.3.

certifi - 2025.11.12;
cffi - 2.1.1;
charset-normalizer - 3.4.9;
cryptography - 46.0.3;
idna - 3.11;
pexpect - 4.9.0;
pip - 25.3;
psutil - 7.0.0;
psycopg2-binary - 2.9.10;
ptyprocess - 0.7.0;
pycparser - 2.23;
PyYAML - 6.0.3;
requests - 2.32.5;
ruamel.yaml - 0.17.20;
setuptools - 80.9.0;
urllib3 - 2.6.3.

certifi - 2025.11.12;
cffi - 2.0.0;
charset-normalizer - 3.4.4;
cryptography - 46.0.3;
idna - 3.11;
pexpect - 4.9.0;
pip - 25.3;
psutil - 7.0.0;
psycopg2-binary - 2.9.10;
ptyprocess - 0.7.0;
pycparser - 2.23;
PyYAML - 6.0.3;
requests - 2.32.5;
ruamel.yaml - 0.17.20;
ruamel.yaml.clib - 0.2.6;
setuptools - 80.9.0;
typing_extensions - 4.15.0;
urllib3 - 2.6.3.

certifi - 2025.11.12;
cffi - 2.0.0;
charset-normalizer - 3.4.6;
cryptography - 46.0.3;
idna - 3.11;
pexpect - 4.9.0;
pip - 25.3;
psutil - 7.0.0;
psycopg2-binary - 2.9.10;
ptyprocess - 0.7.0;
pycparser - 2.23;
pyyaml - 6.0.3;
requests - 2.32.5;
ruamel.yaml - 0.17.20;
setuptools - 80.9.0;
urllib3 - 2.6.3.

certifi - 2025.11.12;
cffi - 2.0.0;
charset-normalizer - 3.4.4;
cryptography - 46.0.3;
idna - 3.11;
pexpect - 4.9.0;
pip - 25.3;
psutil - 7.0.0;
psycopg2-binary - 2.9.10;
ptyprocess - 0.7.0;
pycparser - 2.23;
PyYAML - 6.0.3;
requests - 2.32.5;
ruamel.yaml - 0.17.20;
setuptools - 80.9.0;
urllib3 - 2.6.3.

certifi - 2025.11.12;
cffi - 2.0.0;
charset-normalizer - 3.4.4;
cryptography - 46.0.3;
idna - 3.11;
pexpect - 4.9.0;
pip - 25.3;
psutil - 7.0.0;
psycopg2-binary - 2.9.10;
ptyprocess - 0.7.0;
pycparser - 2.23;
PyYAML - 6.0.3;
requests - 2.32.5;
ruamel.yaml - 0.17.20;
setuptools - 80.9.0;
urllib3 - 2.6.3.

Структура

/opt/pangolin-installer-venv-controlled/
├── bin
│   ├── activate
│   ├── activate.csh
│   ├── activate.fish
│   ├── Activate.ps1
│   ├── normalizer
│   ├── pip
│   ├── pip3
│   ├── pip3.9
│   ├── python
│   ├── python3
│   └── python3.9
├── include
├── lib
│   ├── python3 -> python3.9
│   └── python3.9
│       └── <...>
├── lib64 -> lib
└── pyvenv.cfg

Установка

Пакет pangolin-installer-venv-controlled устанавливается автоматизированным способом при помощи Pangolin Installer, в процессе установки или обновления СУБД Pangolin.

Состав пакета

Список runtime-зависимостей, которые входят в состав компонента:

SberLinux 9
Альт СП 10 версии 2, Альт Сервер 10
РЕД ОС 7.3, РЕД ОС 8, SberLinux 10
Astra Linux 1.8

rsync;
sshpass;
logrotate;
openssl;
tar;
net-tools;
jq;
cronie;
dnf-plugins-core;
iptables-nft.

rsync;
sshpass;
logrotate;
openssl;
tar;
net-tools;
jq;
crontabs;
python3-module-rpm;
iptables.

rsync;
sshpass;
logrotate;
openssl;
tar;
net-tools;
jq;
cronie;
dnf-plugins-core;
iptables-nft.

rsync;
sshpass;
logrotate;
openssl;
tar;
net-tools;
jq;
cron;
iptables.

Установка

Расширения

Расширения oracle_fdw и tds_fdw

Сведения

Дистрибутив продукта содержит следующие расширения, поставляемые в каталоге extensions-distrib:

oracle_fdw
tds_fdw

Пакет oracle_fdw

Расширение oracle_fdw представляет собой внешнюю обертку данных (fdw – foreign-data wrapper) для простого и эффективного доступа к базам данных Oracle из СУБД Pangolin.

Файлы расширения при развертывании пакета располагаются в $PGHOME.

Библиотеки расширения располагаются в $PGHOME/lib/oracle_fdw.so/lib/.

Пакет tds_fdw

Расширение tds_fdw представляет собой обертку внешних данных PostgreSQL для подключения к базам данных Sybase и Microsoft SQL server, использующим протокол табличного потока данных TDS.

Файлы расширения при развертывании пакета располагаются в $PGHOME.

Библиотеки расширения располагаются в $PGHOME/lib/tds_fdw.so/lib/.

Расширения 3rd Party

Сведения

Содержание архива со сторонними зависимостями (расширениями 3rd Party), поддержка которых не осуществляется, не входит в состав продукта. Дистрибутив содержит следующие расширения, поставляемые в каталоге 3rdparty:

pangolin-citus
pangolin-pg-anon
pangolin-pg-background
pangolin-pg-dbms-lock
pangolin-pgcopydb
pangolin-pgloader
pangolin-pgq
pangolin-pgq-coop
pangolin-pgqd
pangolin-pgrouting
pangolin-pgsql-http
pangolin-pldebugger
pangolin-plpgsql-check
pangolin-postgis
pangolin-timescaledb-community

И также расширение pangolin-timescaledb-apache в основной части дистрибутива.

Внимание!

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

Подробное описание всех расширений, а также процесс активации, представлен в документе «Описание расширений продукта СУБД Pangolin». Для каждого поставляемого расширения (в основной и 3rd Party части) выделен отдельный раздел с описанием, процессом установки и использованием модуля.

Пакет pangolin-timescaledb

Расширение для работы с временными рядами. Расширение поставляется в двух форматах: pangolin-timescaledb-apache в основной части дистрибутива и pangolin-timescaledb-community в 3rd Party. Расширение pangolin-timescaledb-apache поддерживается, значит может быть: доработано по требованию безопасности, обновлено с помощью скриптов автоматизации, исправление дефектов, возможное развитие. С расширением pangolin-timescaledb-community гарантируется совместимость, доработка не предусмотрена.

Расширение при развертывании пакета располагается по пути /opt/pangolin-dbms-server-{base_version}/share/extension/.

Библиотеки расширения располагаются в /opt/pangolin-dbms-server-{base_version}/lib/.

Пакет pangolin-citus

Расширение позволяет добавить столбцовое хранение и возможность организации распределенной OLAP БД.

Расширение при развертывании пакета располагается по пути /opt/pangolin-dbms-server-{base_version}/share/extension/.

Библиотеки расширения располагаются в /opt/pangolin-dbms-server-{base_version}/lib/.

Пакет pangolin-pg-anon

Расширение anon(postgresql_anonymizer) для анонимизация и маскировка данных.

Расширение при развертывании пакета располагается по пути /opt/pangolin-dbms-server-{base_version}/share/extension/.

Пакет pangolin-pg-background

Расширение для управления пользовательскими фоновыми процессами. Данный компонент не входит в состав продукта, поэтому поставляется в виде пакета в составе дистрибутива в каталоге 3rdparty/pg_background/. Версия компонента привязана к оригинальной версии расширения.

Расширение при развертывании пакета располагается по пути /opt/pangolin-extensions/0{base_version}/share/extension/.

Библиотеки расширения располагаются в /opt/pangolin-extensions/0{base_version}/lib/.

Пакет pangolin-pg-dbms-lock

Расширение pg_dbms_lock позволяет инициировать пользовательские блокировки.

Расширение при развертывании пакета располагается по пути /opt/pangolin-dbms-server-{base_version}/share/extension/.

Пакет pangolin-pgcopydb

Утилита pgcopydb для автоматизации копирования базы данных на другой сервер. Утилита pgcopydb реализует полную миграцию всей базы данных PostgreSQL из исходного экземпляра в целевой. Данный компонент не входит в состав продукта, поэтому поставляется в виде rpm/deb-пакета в составе дистрибутива в каталоге 3rdparty/pgcopydb/. Версия компонента привязана к оригинальной версии расширения.

Расширение располагается при развертывании по пути: /opt/pangolin-dbms-server-{base_version}/bin/.

Пакет pangolin-pgloader

Утилита pgloader для миграции данных из MSSQL в СУБД Pangolin. Данный компонент не входит в состав продукта, поэтому поставляется в виде rpm/deb-пакетав составе дистрибутива в каталоге 3rdparty/migration_tools/.

Утилита при развертывании пакета располагается по пути: /opt/pangolin-pgloader/bin/.

Пакет ora2pg

Утилита для миграции данных из Oracle в Pangolin. Данный компонент не входит в состав продукта, поэтому поставляется в виде бинарных файлов в составе дистрибутива в каталоге 3rdparty/migration_tools/. Для сборки пакета подготовлен spec-файл.

Пакеты pangolin-pgq и pangolin-pgq-coop

Расширения для поддержки очередей сообщений со стороны СУБД. Данные компоненты не входят в состав продукта, поэтому поставляются в виде rpm/deb-пакетав составе дистрибутива в каталогах 3rdparty/pgq/ и 3rdparty/pgq-coop/. Версии компонентов привязаны к оригинальным версиям расширений. Расширения располагаются в /opt/pangolin-dbms-server-{base_version}/share/extension/.

Библиотеки расширений располагаются в /opt/pangolin-dbms-server-{base_version}/lib/.

Пакет pangolin-pgqd

Сервис для поддержки очередей сообщений со стороны СУБД. Данный компонент не входит в состав продукта, поэтому поставляется в виде rpm/deb-пакетав составе дистрибутива в каталоге 3rdparty/pgqd/. Версия компонента привязана к оригинальной версии расширения.

Бинарный файл компонента при развертывании пакета расположен в /opt/pangolin-dbms-server-{base_version}/bin/.

Сервисный файл компонента расположен по пути /usr/lib/systemd/system/pangolin-pgqd.service или /home/postgres/.config/systemd/user/pangolin-pgqd.service.

Конфигурационный файл расположен в /etc/pangolin-pgqd/pangolin-pgqd.ini.

Расположение файла с PID процесса компонента: /var/run/pangolin-pgqd/pangolin-pgqd.pid.

Пакет pangolin-pgrouting

Расширение, добавляющее поддержку геопространственной маршрутизации и другие функции сетевого анализа. Данный компонент не входит в состав продукта, поэтому поставляется в виде rpm/deb-пакетав составе дистрибутива в каталоге 3rdparty/pgrouting/. Версия компонента привязана к оригинальной версии расширения.

Расположение расширения при развертывании пакета: /opt/pangolin-extensions/0{base_version}/share/extension/.

Расположение библиотек расширения: /opt/pangolin-extensions/0{base_version}/lib/.

Пакет pangolin-pgsql-http

Расширение для поддержки HTTP-клиента на уровне СУБД, позволяющее обращаться к REST-сервисам посредством SQL-запросов. Данный компонент не входит в состав продукта, поэтому поставляется в виде rpm/deb-пакетав составе дистрибутива в каталоге 3rdparty/pgsql_http/. Версия компонента привязана к оригинальной версии расширения.

Расположение расширения при развертывании пакета: /opt/pangolin-dbms-server-{base_version}/share/extension/.

Расположение библиотек расширения при развертывании пакета: /opt/pangolin-dbms-server-{base_version}/lib/.

Пакет pangolin-pldebugger

Расширение, предоставляющее API для выполнения функций с возможностью остановки в заданной точке, пошаговым выполнением и просмотром значений переменных. Расширение интегрировано с решениями от pg_admin и dbeaver (данные утилиты предоставляют графический интерфейс для разработки с использованием возможностей расширения), а также позволяет использовать функции API прямо из psql, поскольку они представляют собой стандартные SQL-функции. Данный компонент не входит в состав продукта, поэтому поставляется в виде rpm/deb-пакетав составе дистрибутива в каталоге 3rdparty/pldebugger/. Версия компонента привязана к оригинальной версии расширения.

Расширение при развертывании пакета располагается в /opt/pangolin-dbms-server-{base_version}/share/extension/.

Библиотеки расширения при развертывании находятся по пути: /opt/pangolin-dbms-server-{base_version}/lib/.

Пакет pangolin-pgsql-check

Статический анализатор кода plpgsql для PostgreSQL, предоставляющее набор функций для анализа и профилирования функций и процедур, написанных на языке PL/pgSQL. Данный компонент не входит в состав продукта, поэтому поставляется в виде rpm/deb-пакетав составе дистрибутива в каталоге 3rdparty/pgsql_check/. Версия компонента привязан к оригинальной версии расширения.

Расположение расширения при развертывании пакета: /opt/pangolin-dbms-server-{base_version}/share/extension/.

Расположение библиотек расширения при развертывании: /opt/pangolin-dbms-server-{base_version}/lib/.

Пакет pangolin-postgis

Расширение, добавляющее поддержку хранения, индексирования и запроса геопространственных данных. Данный компонент не входит в состав продукта, поэтому поставляется в виде rpm/deb-пакетав составе дистрибутива в каталоге 3rdparty/postgis/. Версия компонента привязана к оригинальной версии расширения.

Расположение расширения при развертывании: /opt/pangolin-extensions/0{base_version}/share/extension/.

Расположение сторонних библиотек расширения: /opt/pangolin-extensions/0{base_version}/lib/.

Untrusted-расширения

Сведения

Дистрибутив содержит следующие расширения, поставляемые в каталоге untrusted:

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

plperl
plpython3
pltcl
bool_plperl
hstore_plperl
hstore_plpython3
jsonb_plperl
jsonb_plpython3
ltree_plpython3

А также архив untrusted-distrib.tar.gz пакетов с отладочными символами данных расширений.

Расширения поставляются в отдельном архиве в составе дистрибутива, каждое в своем отдельном rpm/deb-пакете со всеми необходимыми зависимостями.

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

Пакет plperl

Пакет plperl содержит в себе два расширения: загружаемый процедурный язык PL/Perl (plperl) и недоверенный процедурный язык PL/Perlu (plperlu).

Пакет plpython3

Пакет plpython3 содержит расширение загружаемого недоверенного процедурного языка PL/Python3 (plpython3u).

Пакет pltcl

Пакет pltcl содержит в себе два расширения: загружаемый процедурный язык PL/Tcl (pltcl) и недоверенный процедурный язык PL/Tcl (pltclu).

Пакет bool-plperl

Пакет bool-plperl содержит в себе два расширения: преобразование логических значений для языка PL/Perl (plperl) и аналогичная трансформация в недоверенный язык PL/Perlu (plperlu).

Пакет hstore-plperl

Пакет hstore-plperl содержит в себе два расширения: преобразование логических значений для языка PL/Perl (plperl) и аналогичная трансформация в недоверенный язык PL/Perlu (plperlu).

Пакет hstore-plpython3

Пакет hstore-plpython3 содержит в себе расширение для трансформации типа hstore в структуру PL/Python3u (hstore_plpython3u).

Пакет jsonb-plperl

Пакет pltcl содержит в себе два расширения: преобразование jsonb для языка PL/Perl (jsonb_plperl) и аналогичная трансформация в недоверенный язык PL/Perlu (jsonb_plperlu).

Пакет jsonb-plpython3

Пакет jsonb-plperl содержит в себе расширение для трансформации типа jsonb в структуру PL/Python3u (jsonb_plpython3u).

Пакет ltree-plpython3

Пакет ltree-plperl содержит в себе расширение для трансформации типа ltree в структуру PL/Python3u (ltree_plpython3u).

Содержание​

Общая информация​

Основные rpm/deb-пакеты​

Версии основных пакетов​

Пакеты pangolin-dbms и pangolin-dbms-client​

Особенности​

Состав пакетов​

Установка​

Пути до файлов компонентов​

Пакет pangolin-manager​

Структура пакета​

Пути до файлов компонента​

Установка​

Особенности и зависимости​

Пакет pangolin-manager-venv​

Состав пакета​

Структура​

Установка​

Пакет pangolin-pooler​

Структура пакета​

Пути до файлов компонента​

Установка​

Особенности​

Пакет pangolin-pooler-mt​

Структура пакета​

Пути до файлов компонента​

Установка​

Пакет pangolin-backup-tools​

Структура пакета​

Пути до файлов компонента​

Установка​

Пакет pangolin-backup-tools-venv​

Состав пакета​

Структура​

Установка​

Дополнительные rpm/deb-пакеты​

Пакеты pangolin-dbms-libpq и pangolin-dbms-libpq-dev​

Особенности​

Структура пакетов​

Пути до файлов компонента​

Установка​

Пакет pangolin-copywala​

Структура пакета​

Установка​

Утилиты​

Пакет pangolin-auth-password​

Структура​

Установка​

Пути до файлов компонентов​

Пакет pangolin-auth-reencrypt​

Структура​

Пути до файлов компонентов​

Установка​

Пакет pangolin-certs-rotate​

Структура​

Установка​

Пути до файлов компонентов​

Пакет pangolin-diagnostic-tool​

Структура​

Пути до файлов компонентов​

Установка​

Пакет pangolin-security-utilities​

Структура​

Пути до файлов компонентов​

Установка​

Пакет pangolin-tuner​

Структура​

Установка​

Путь до файлов компонента​

Пакет pangolin-installer​

Путь до файлов компонента​

Установка​

Пакет pangolin-inplace-upgrade​

Структура​

Путь до файлов компонента​

Установка​

Пакет pangolin-license-verify​

Структура​

Установка​

Пакет pangolin-secret-storage-client​

Содержание

Общая информация

Основные rpm/deb-пакеты

Версии основных пакетов

Пакеты pangolin-dbms и pangolin-dbms-client

Особенности

Состав пакетов

Установка

Пути до файлов компонентов

Пакет pangolin-manager

Структура пакета

Пути до файлов компонента

Установка

Особенности и зависимости

Пакет pangolin-manager-venv

Состав пакета

Структура

Установка

Пакет pangolin-pooler

Структура пакета

Пути до файлов компонента

Установка

Особенности

Пакет pangolin-pooler-mt

Структура пакета

Пути до файлов компонента

Установка

Пакет pangolin-backup-tools

Структура пакета

Пути до файлов компонента

Установка

Пакет pangolin-backup-tools-venv

Состав пакета

Структура

Установка

Дополнительные rpm/deb-пакеты

Пакеты pangolin-dbms-libpq и pangolin-dbms-libpq-dev

Особенности

Структура пакетов

Пути до файлов компонента

Установка

Пакет pangolin-copywala

Структура пакета

Установка

Утилиты

Пакет pangolin-auth-password

Структура

Установка

Пути до файлов компонентов

Пакет pangolin-auth-reencrypt

Структура

Пути до файлов компонентов

Установка

Пакет pangolin-certs-rotate

Структура

Установка

Пути до файлов компонентов

Пакет pangolin-diagnostic-tool

Структура

Пути до файлов компонентов

Установка

Пакет pangolin-security-utilities

Структура

Пути до файлов компонентов

Установка

Пакет pangolin-tuner

Структура

Установка

Путь до файлов компонента

Пакет pangolin-installer

Путь до файлов компонента

Установка

Пакет pangolin-inplace-upgrade

Структура

Путь до файлов компонента

Установка

Пакет pangolin-license-verify

Структура

Установка

Пакет pangolin-secret-storage-client