Установка Tantor PipelineDB

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

Поскольку Tantor PipelineDB работает как расширение для PostgreSQL, начните с установки PostgreSQL.

Примечание

На данный момент Tantor PipelineDB поддерживает версии PostgreSQL 15, 16 на 64-битных архитектурах, включая x86_64 и ARM.

После установки PostgreSQL на своей системе необходимо загрузить и запустить скрипт db_extension_installer.sh из нашего репозитория Nexus, чтобы установить бинарные файлы Tantor PipelineDB. После установки бинарных файлов следует создать расширение Tantor PipelineDB в базе данных PostgreSQL.

Рассмотрим процесс установки с помощью db_extension_installer.

Загрузка инсталлятора

Начните с загрузки скрипта инсталлятора с предоставленного URL:

wget https://public.tantorlabs.ru/db_extension_installer.sh

После завершения загрузки, предоставьте права на выполнение скрипту:

chmod +x db_extension_installer.sh

Установка Tantor PipelineDB

Перед запуском инсталлятора установите необходимые переменные среды. Эти переменные предоставляют инсталлятору учетные данные и URL для доступа к репозиторию Nexus:

export NEXUS_USER="<имя пользователя>"
export NEXUS_USER_PASSWORD="<пароль>"
export NEXUS_URL="nexus.tantorlabs.ru"

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

db_extension_installer.sh \
  --database-type=<выпуск PostgreSQL> \
  --database-major-version=<версия базы данных> \
  --edition=<издание, только для TantorDB> \
  --extension=<название расширения>

Для настройки процесса установки под ваши нужды скрипт установщика поставляется с несколькими параметрами. Вы можете просмотреть их с помощью опции --help:

db_extension_installer.sh --help

Параметры:

  • --database-type — указывает выпуск PostgreSQL (pgdg, tantor). По умолчанию — tantor.

  • --edition — если вы используете выпуск TantorDB (tantor), необходимо указать его издание: be, se, se-1c или se-certified.

  • --database-major-version — определяет основную версию базы данных: 15, 16. По умолчанию — 15.

  • --extension — устанавливает имя расширения. По умолчанию — pipelinedb.

  • --extension-version — устанавливает версию расширения, если необходимо установить конкретную версию. По умолчанию — последняя версия.

Пример использования:

Вот пример использования, который демонстрирует, как установить переменные среды и запустить инсталлятор с определенными параметрами:

export NEXUS_USER="user_name"
export NEXUS_USER_PASSWORD="user_password"
export NEXUS_URL="nexus.tantorlabs.ru"

db_extension_installer.sh \
  --database-type=tantor \
  --database-major-version=15 \
  --edition=se \
  --extension=pipelinedb

Создание расширения Tantor PipelineDB

Для работы Tantor PipelineDB параметр конфигурации shared_preload_libraries должен быть настроен в postgresql.conf, который находится в вашем каталоге данных. Также рекомендуется установить max_worker_processes на достаточно высокое значение, чтобы обеспечить рабочим процессам Tantor PipelineDB достаточно мощности:

# В нижней части <каталог данных>/postgresql.conf
shared_preload_libraries = 'pipelinedb'
max_worker_processes = 128

Запуск PostgreSQL

Чтобы запустить сервер PostgreSQL в фоновом режиме, используйте драйвер pg_ctl и укажите новый инициализированный каталог данных:

pg_ctl -D <каталог данных> -l postgresql.log start

Чтобы подключиться к работающему серверу, используйте стандартный клиент PostgreSQL psql, который можно использовать для создания расширения Tantor PipelineDB:

psql -c "CREATE EXTENSION pipelinedb"

После создания расширения можно начать использовать Tantor PipelineDB!

Можете ознакомиться с разделом Быстрый старт, и сразу начать передачу данных в Tantor PipelineDB.

Конфигурация

По умолчанию PostgreSQL не принимает входящие подключения от удаленных хостов. Для разрешения входящих подключений сначала настройте строку listen_addresses в postgresql.conf:

listen_addresses = '*'

И в pg_hba.conf добавьте строку, аналогичную следующей, чтобы разрешить входящие подключения:

host    all             all             <ip address>/<subnet>            md5

Например, чтобы разрешить входящие подключения с любого хоста:

host    all             all             0.0.0.0/0            md5

Удаление Tantor PipelineDB

Для удаления Tantor PipelineDB, используйте систему управления пакетами вашего дистрибутива. В системах на основе Debian, можно удалить Tantor PipelineDB, используя следующую команду:

apt-get remove <название расширения>-<выпуск PostgreSQL>-<издание, только для TantorDB>-<версия базы данных>

Например, для указанного выше примера:

apt-get remove pipelinedb-tantor-se-15