16.1. Установка Postgres Pro Standard #

Postgres Pro работает только в ОС на базе Linux и поставляется в виде двоичных пакетов. Все двоичные дистрибутивы Postgres Pro состоят из нескольких пакетов. Структура пакетов отличается от структуры ванильного PostgreSQL и поддерживает следующие режимы установки:

  • Быстрая установка и настройка. Пакет postgrespro-std-17 устанавливает и настраивает все компоненты, необходимые для получения готовой к использованию конфигурации, как клиентских, так и серверных компонентов. Выберите этот вариант, если вы планируете установить только один экземпляр Postgres Pro и вас не беспокоят возможные конфликты с другими продуктами на базе PostgreSQL.

    Важно

    При установке пакета postgrespro-std-17 могут быть удалены существующие инсталляции продуктов на базе Postgres Pro и PostgreSQL. И напротив, установленный пакет Postgres Pro может быть автоматически удалён, если вы впоследствии развернёте другой продукт на базе PostgreSQL. Данный пакет не нужно устанавливать в процессе обновления или миграции, а также если вы планируете разворачивать в одной системе несколько инсталляций.

  • Расширенная установка. Вы можете выбрать любые пакеты, требующиеся для ваших целей, включая пакеты для разработчиков. Этот вариант требует ручной настройки, поэтому для него необходимо хорошо разбираться в Linux и понимать архитектуру PostgreSQL. Это единственно возможный вариант, если вы планируете реализовать один из следующих сценариев использования Postgres Pro:

    • Установка одновременно нескольких версий Postgres Pro либо установка вместе с другими продуктами на базе PostgreSQL.

    • Обновление с другой версии или миграция с другого продукта на базе PostgreSQL.

    • Управление сервером Postgres Pro с использованием программных средств обеспечения высокой степени доступности, таких как pacemaker, вместо стандартных системных механизмов управления службами.

Минимальные системные требования для установки Postgres Pro, создания кластера баз данных и запуска сервера:

  • Процессор с частотой 1 ГГц

  • 1 ГБ ОЗУ

  • 1 ГБ свободного дискового пространства

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

16.1.1. Поддерживаемые дистрибутивы Linux #

Двоичные пакеты Postgres Pro предоставляются для следующих систем на базе Linux:

  • Системы Red Hat Enterprise Linux (RHEL) и производные от них: CentOS 8, Rocky Linux 8/9, Red Hat Enterprise Linux 8/9, Oracle Linux 8/9, РОСА «ХРОМ» 2021.2, РЕД ОС МУРОМ 7.3/8, AlmaLinux 9

  • Системы на базе Debian: Debian 11/12, Ubuntu 20.04/22.04/24.04, Astra Linux 1.7/1.8

  • Альт 10/11, Альт СП релиз 10

  • SUSE Linux Enterprise Server (SLES) 15

  • Системы Linux для архитектуры процессоров Эльбрус: Альт 9/10 для e2kv3/e2kv4, Альт 8.2 СП для e2kv3/e2kv4, Альт СП релиз 10, Astra Linux «Ленинград» 8.1

  • Системы Linux для архитектуры ARM: Альт 9/10/11, Альт СП 8.2 и выше, Astra Linux «Новороссийск», Debian 10/11, РЕД ОС МУРОМ 7.3/8, RHEL 8/9, Ubuntu 20.04/22.04/24.04

Примечание

Двоичные пакеты Postgres Pro используют библиотеку tzdata, предоставляемую операционной системой, поэтому важно, чтобы в системе была установлена последняя её версия. В случае использования устаревшей библиотеки tzdata значения времени в вашей базе данных могут быть некорректными.

16.1.2. Быстрая установка и настройка #

Если вам нужно установить только один экземпляр Postgres Pro и вы не собираетесь использовать никакие другие продукты на базе PostgreSQL в вашей системе, вы можете использовать режим быстрой установки. Типичная процедура установки в этом случае выглядит так:

  1. Подключите репозиторий пакетов, предназначенный для вашей операционной системы. Конкретные адреса репозиториев и команды для их подключения в поддерживаемых дистрибутивах Linux вы можете найти на Странице загрузки для соответствующей версии Postgres Pro.

  2. Установите пакет postgrespro-std-17. При этом по зависимостям установятся все требуемые компоненты, будет создана база данных по умолчанию, запущен сервер баз данных и настроен автозапуск сервера при загрузке системы, а все предоставляемые программы станут доступными в пути PATH.

Примечание

По умолчанию конфигурация базы данных настраивается под устанавливаемый продукт Postgres Pro. Если вам нужна другая настройка сервера базы данных, выберите расширенную установку и воспользуйтесь аргументом tune команды pg-setup initdb.

После завершения установки вы можете запустить psql от имени пользователя postgres и подключиться к только что созданной базе данных, находящейся в каталоге данных /var/lib/pgpro/std-17/data.

Так как база данных по умолчанию создаётся скриптом pg-setup, путь к каталогу данных сохраняется в файле /etc/default/postgrespro-std-17. Все последующие команды pg-setup, а также любые команды, управляющие службой Postgres Pro, будут нацелены именно на эту базу данных. Кроме того, в указанном файле можно изменить значение PG_OOM_ADJUST_VALUE для дочерних процессов postmaster (за подробностями обратитесь к Подразделу 17.4.4).

16.1.3. Расширенная установка #

Разделение дистрибутива на несколько пакетов позволяет произвести инсталляцию по-разному для различных применений: для серверов баз данных, клиентских систем или рабочих станций разработчиков. Такие инсталляции необходимо настраивать вручную, но это даёт дополнительную гибкость при использовании продукта. Вы можете установить несколько версий Postgres Pro параллельно, а также вместе с другими продуктами PostgreSQL. В частности, это может потребоваться при осуществлении обновления или при миграции с другого продукта на базе PostgreSQL.

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

  1. Подключите репозиторий пакетов, предназначенный для вашей операционной системы. Конкретные адреса репозиториев и команды для их подключения в поддерживаемых дистрибутивах Linux вы можете найти на Странице загрузки для соответствующей версии Postgres Pro.

  2. Выберите пакеты Postgres Pro, требующиеся для ваших целей, и установите их с помощью стандартных для вашего дистрибутива Linux команд. Доступные пакеты перечислены в Таблице 16.1.

    В результате все файлы будут установлены в каталог /opt/pgpro/std-17.

  3. Запустите от имени root утилиту pg-wrapper, чтобы добавить и клиентские, и серверные установленные программы в путь поиска PATH, а также включить страницы man по SQL в файл конфигурации страниц man. Эта утилита входит в состав пакета postgrespro-std-17-client.

    /opt/pgpro/std-17/bin/pg-wrapper links update

    Подробнее о разрешении возможных конфликтов рассказывается в pg-wrapper.

  4. Если вы устанавливаете пакет postgrespro-std-17-server, выполните следующую процедуру настройки сервера:

    1. Создайте начальную базу данных, запустив вспомогательный скрипт pg-setup от имени root с ключом initdb:

      /opt/pgpro/std-17/bin/pg-setup initdb [--tune=конфигурация] [параметры_initdb]

      Здесь:

      • Аргумент tune выбирает вариант конфигурации базы данных.

      • параметры_initdb — обычные параметры initdb.

      Примечание

      По умолчанию pg-setup инициализирует кластер баз данных со включёнными контрольными суммами. Если для вас это нежелательно, укажите --no-data-checksums.

      Скрипт pg-setup выполняет административные операции с базами данных от имени пользователя postgres. Если вы не укажете никакие параметры initdb, база по умолчанию создаётся в каталоге /var/lib/pgpro/std-17/data с параметрами локализации, определяемыми переменной окружения LANG текущего сеанса. Переменные окружения LC_* при этом игнорируются.

      Так как база данных по умолчанию создаётся скриптом pg-setup, путь к каталогу данных сохраняется в файле /etc/default/postgrespro-std-17. Все последующие команды pg-setup, а также любые команды, управляющие службой Postgres Pro, будут нацелены именно на эту базу данных. Кроме того, в указанном файле можно изменить значение PG_OOM_ADJUST_VALUE для дочерних процессов postmaster (за подробностями обратитесь к Подразделу 17.4.4).

    2. Запустите сервер с помощью pg-setup от имени root следующим образом:

      /opt/pgpro/std-17/bin/pg-setup service start

      Как и сервер ванильного PostgreSQL, сервер Postgres Pro работает под именем пользователя postgres.

      Примечание

      По умолчанию автоматический запуск сервера отключён, чтобы вы могли вручную управлять восстановлением базы данных после перезагрузки системы. Однако вы можете настроить и автоматический запуск сервера Postgres Pro. За подробностями обратитесь к Подразделу 16.1.3.2.

16.1.3.1. Выбор устанавливаемых пакетов #

В следующей таблице перечислены все имеющиеся пакеты Postgres Pro Standard.

Таблица 16.1. Пакеты Postgres Pro Standard

Пакет

Описание

postgrespro-std-17

Пакет верхнего уровня, устанавливающий и настраивающий Postgres Pro для серверных и клиентских систем. Не используйте этот пакет при обновлении или миграции.

Важно

При установке пакета postgrespro-std-17 могут быть удалены существующие инсталляции продуктов на базе Postgres Pro и PostgreSQL. И напротив, установленный пакет Postgres Pro может быть автоматически удалён, если вы впоследствии развернёте другой продукт на базе PostgreSQL.

postgrespro-std-17-client

Стандартные клиентские приложения, такие как psql и pg_dump.

postgrespro-std-17-libs

Общие библиотеки, требующиеся для развёртывания клиентских приложений, включая libpq; библиотеки времени выполнения для обработчика ECPG.

postgrespro-std-17-server

Сервер Postgres Pro и серверный язык программирования PL/pgSQL.

postgrespro-std-17-contrib

Дополнительные расширения и программы, разворачиваемые на серверах баз данных.

postgrespro-std-17-devel

Заголовочные файлы и библиотеки для разработки клиентских приложений и серверных расширений.

В системах на базе Debian этот пакет называется postgrespro-std-17-dev.

postgrespro-std-17-plperl

Реализация языка Perl для программирования на стороне сервера (см. Главу 43).

postgrespro-std-17-plpython3

Реализация языка Python 3 для программирования на стороне сервера (см. Главу 44).

postgrespro-std-17-pltcl

Реализация языка Tcl для программирования на стороне сервера (см. Главу 42).

postgrespro-std-17-docs

Документация на английском языке.

postgrespro-std-17-docs-ru

Документация на русском языке.

postgrespro-std-17-test

Тестовые скрипты для сервера.

Этот пакет представлен только для систем на базе RHEL и SUSE.

postgrespro-std-17-jit

Этот пакет обеспечивает поддержку JIT-компиляции.

Этот пакет предоставляется только для архитектуры x86_64 и только для поддерживаемых систем Debian и Ubuntu, Astra Linux 1.7/1.8, поддерживаемых систем Альт, CentOS 8, Rocky Linux 8/9, Oracle Linux 8/9, AlmaLinux 9, SLES 15 и RHEL 8/9.

Чтобы узнать об использовании JIT больше, обратитесь к Главе 29.

mamonsu

mamonsu — агент мониторинга для сбора метрик Postgres Pro и операционной системы.

pg-portal-modify-std-17

Расширение, позволяющее модифицировать курсоры Postgres Pro.

pg-probackup-std-17

Утилита pg_probackup.

pgpro-controldata

Утилита pgpro_controldata, показывающая управляющую информацию кластера БД PostgreSQL/Postgres Pro и параметры совместимости кластера и/или сервера.

pgpro-pwr-std-17

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

pgpro-stats-std-17

Расширение pgpro_stats, собирающее статистику выполнения SQL-операторов, подсчитывающее статистику событий ожидания и предоставляющее прочие полезные метрики.


Также Postgres Pro включает библиотеки и утилиты, необходимые для предоставляемых пакетов и сервера Postgres Pro. Эти пакеты предоставляются только для дистрибутивов, в которых отсутствует требуемая версия таких библиотек.

Таблица 16.2. Сторонние библиотеки и утилиты, собранные для Postgres Pro Standard

Библиотека/утилита

Описание

liblz4

Библиотека для быстрого сжатия данных без потерь.

freetds

Библиотека для реализации протокола TDS. Используется расширением tds-fdw и включает в себя freetds-devel, freetds-doc и freetds-libs. Предоставляется для RHEL 8/9.

libunwind

Библиотека для раскрутки стека, используемая параметром crash_info. Предоставляется для RHEL 8.

libbacktrace

Библиотека для обратной трассировки стека, используемая параметром crash_info. Предоставляется для РЕД ОС 7.3/8 и RHEL 8/9.

libsybdb5

Библиотека для реализации протокола TDS. Предоставляется для SLES 15.

perl-IO-Tty, perl-IPC-Run

Две библиотеки Perl, используемые в рамках TAP-тестирования и доступные в пакете postgrespro-std-17-devel для разработчиков расширений и инженеров. perl-IO-Tty предоставляется для РЕД ОС МУРОМ 7.3/8, RHEL 8/9, а perl-IPC-Run — для РЕД ОС МУРОМ 7.3/8, RHEL 8/9, SLES 15.


Кроме этого, имеются отдельные пакеты с несколькими дополнительными модулями, собранные специально для совместимости с Postgres Pro Standard:

Таблица 16.3. Сторонние пакеты, собранные для Postgres Pro Standard

Пакет

Описание

hypopg-std-17

Расширение hypopg, обеспечивающее поддержку гипотетических индексов в Postgres Pro.

odbc-postgrespro-std-17

Драйвер открытого соединения с базами данных (open database connectivity, ODBC) для доступа к системам управления базами данных. В качестве альтернативы можно использовать odbc-postgresql, однако это может привести к конфликтам с устаревшими библиотеками ванильной версии PostgreSQL, которые не поддерживают функциональность новых библиотек.

oracle-fdw-std-17

Расширение oracle_fdw, предоставляющее обёртку сторонних данных для доступа к базам данных Oracle.

Этот пакет предоставляется только для операционных систем на платформе Intel.

orafce-std-17

В этом пакете представлены реализации некоторых функций, которые существуют в СУБД Oracle, но отсутствуют в Postgres Pro (или работают немного по-другому).

pg-filedump-std-17

Утилита pg_filedump, представляющая файлы кучи и индексов, а также управляющие файлы Postgres Pro в понятном человеку виде.

pg-repack-std-17

pg_repack — расширение Postgres Pro и утилита для реорганизации таблиц.

pgbouncer

pgbouncer — пул соединений для Postgres Pro.

pgpro-pgbadger

pgbadger — анализатор журналов Postgres Pro, генерирующий подробные отчёты и графики.

pgvector-std-17

Расширение pgvector, предоставляющее поиск сходства векторов в Postgres Pro.

pldebugger-std-17

Набор разделяемых библиотек, реализующих API для отладки функций PL/pgSQL в Postgres Pro.

plv8-std-17

Разделяемая библиотека PLV8, добавляющая в Postgres Pro поддержку процедурного языка Javascript в реализации V8.

Этот пакет предоставляется только для систем Debian и Ubuntu, Альт 10/11, SLES 15, RHEL 8/9 и РЕД ОС МУРОМ 7.3.

tds-fdw-std-17

Расширение tds_fdw, предоставляющее обёртку сторонних данных для подключения к Microsoft SQL Server и другим базам данных, использующим протокол TDS (Tabular Data Stream, Поток табличных данных).


Кроме того, Postgres Pro предоставляет отдельные пакеты с отладочной информацией для некоторых операционных систем:

  • В системах на базе Debian это пакет postgrespro-std-17-dbg.

  • В системах на базе RHEL это пакет postgrespro-std-17-debuginfo.

  • В ОС Альт Линукс для всех пакетов с двоичными файлами имеются соответствующие пакеты -debuginfo.

Для серверных инсталляций требуются как минимум следующие пакеты:

  • postgrespro-std-17-server

  • postgrespro-std-17-client

  • postgrespro-std-17-libs

Для использования дополнительных расширений Postgres Pro вы должны также установить пакет postgrespro-std-17-contrib. В системах на базе Debian пакет postgrespro-std-17-server зависит от пакета postgrespro-std-17-contrib, поэтому последний должен всегда устанавливаться вместе с сервером.

Для клиентских инсталляций обычно достаточно установить пакеты postgrespro-std-17-client и postgrespro-std-17-libs. Если вы используете независимые приложения и вам не нужны стандартные клиентские утилиты, такие как psql, вы можете установить только пакет postgrespro-std-17-libs.

Для рабочих станций разработчиков необходимый минимум составляют следующие пакеты:

  • postgrespro-std-17-libs

  • postgrespro-std-17-devel/ postgrespro-std-17-dev

Также вы можете установить и настроить сервер с тестовой базой данных. Подробнее о настройке, которая может потребоваться дополнительно, рассказывается в Подразделе 16.1.4.

16.1.3.2. Настройка автоматического запуска сервера #

Если вы производите расширенную установку, автоматический запуск сервера по умолчанию отключается. После создания базы данных по умолчанию вы можете настроить автоматический запуск сервера при загрузке системы, используя имеющиеся в вашей операционной системе механизмы управления службами или сторонние средства обеспечения высокой степени доступности. Для облегчения этой задачи в пакете postgrespro-std-17-server поставляется скрипт pg-setup, помещаемый в каталог /opt/pgpro/std-17/bin.

Для настройки автозапуска сервера запустите скрипт pg-setup со следующими параметрами:

pg-setup service enable

Если требуется, вы можете отключить автозапуск сервера, используя тот же скрипт:

pg-setup service disable

Вы также можете использовать системные средства управления службами, непосредственно задействуя скрипты для систем инициализации SysV init.d и systemd, предоставляемые в пакете postgrespro-std-17-server. В зависимости от дистрибутива Linux Postgres Pro поддерживает следующие механизмы управления службами:

Дистрибутив Linux

Предоставляемые скрипты

Системы на базе RHEL, SLES 15

Файл службы systemd

Debian, Ubuntu, Альт 10/11

И файл службы systemd, и скрипт init.d в стиле SysV

Для включения автоматического запуска сервера средствами systemd выполните следующую команду:

systemctl enable postgrespro-std-17

Для использования скрипта init.d в стиле SysV:

  • В системах Альт Линукс выполните следующую команду:

    systemctl enable postgrespro-std-17
  • В системах Debian воспользуйтесь скриптом update-rc.d. За подробностями обратитесь к соответствующей странице man.

16.1.4. Установка на рабочих станциях разработчиков #

Хотя может быть достаточно установить пакеты postgrespro-std-17-libs и postgrespro-std-17-devel/postgrespro-std-17-dev, обычно на машинах разработчиков удобно иметь и установленный сервер. Для быстрой установки вы можете воспользоваться пакетом postgrespro-std-17, который автоматически настроит предоставляемые клиентские и серверные программы, а также создаст начальную базу данных. Однако если вы планируете использовать одновременно несколько продуктов на базе PostgreSQL, следуйте инструкциям по расширенной установке, приведённым в Подразделе 16.1.3.

Чтобы скомпилировать программы с библиотеками Postgres Pro, используя утилиту pg_config, поставляемую с Postgres Pro, необходимо, чтобы её путь был указан в переменной PATH до путей каких-либо других версий pg_config. Заметьте, что в системах на базе RHEL pg_config не добавляется в PATH автоматически. Если в вашей системе нет других версий pg_config, вы можете воспользоваться утилитой pg-wrapper, поставляемой в пакете postgrespro-std-17-client, для создания символической ссылки на pg_config в стандартном каталоге исполняемых файлов.

Для компиляции программ с использованием pkg-config добавьте путь /opt/pgpro/std-17/lib/pkgconfig/ в переменную среды PKG_CONFIG_PATH.

Если вы хотите компилировать расширения Postgres Pro с поддержкой встраивания JIT, выполните дополнительные требования:

  • Установите пакет LLVM для разработки и компилятор Clang. Вы должны выбрать пакеты той же версии, какая использовалась для сборки пакета postgrespro-std-17-jit, устанавливаемом на сервере. Определить версию, требующуюся для текущего выпуска Postgres Pro, вы можете по значению CLANG в файле /opt/pgpro/std-17/lib/pgxs/src/Makefile.global.

  • Выполняя команды make и make install, добавьте параметр with-llvm=yes для компиляции и установки файлов с битовым кодом для вашего расширения. По умолчанию компиляции битового кода отключена, так как она зависит от доступности компилятора Clang.

16.1.4.1. Использование сторонних программ с Postgres Pro #

Чтобы использовать сервер Postgres Pro с клиентской программой из стороннего продукта, вы можете установить версию библиотек PostgreSQL, с которыми компилировалась эта программа. Например, если программа поставляется в составе ванильного PostgreSQL, вам может потребоваться установить пакеты libpq или postgresql-libs, предоставляемые для вашего дистрибутива Linux. В этом случае программа, возможно, не будет использовать некоторые новые возможности сервера Postgres Pro, но скорее всего она и не поддерживает их.

Если вы предпочитаете использовать библиотеки Postgres Pro со сторонней программой или хотели бы задействовать новую возможность, которая не требует изменения самого клиентского приложения, например, проверку подлинности SCRAM, вы можете перекомпилировать вашу программу с библиотеками Postgres Pro.

Важно

Если программа скомпилирована с одной версией libpq, а используется с другой, её стабильная работа не гарантируется.

Если вы создаёте пакеты .rpm или .deb для вашей программы, рекомендуется сделать следующее:

  1. Добавьте путь /opt/pgpro/std-17/bin в переменную PATH в сборочных скриптах (в файле .spec или debian/rules).

  2. Добавьте postgrespro-std-17-dev в теги BuildDepends или BuildRequires описания пакета вашей программы.

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

16.1.5. Настройка нескольких экземпляров Postgres Pro #

Чтобы настроить в Linux несколько экземпляров сервера Postgres Pro с разными каталогами данных, нужно проделать следующее:

  1. Установите и настройте Postgres Pro, следуя указаниям в Подразделе 16.1.2 или Подразделе 16.1.3.

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

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

  4. Если требуется, настройте автоматический запуск сервера следующим образом:

    1. Создайте копию файла /etc/init.d/postgrespro-std-17 или /lib/systemd/system/postgrespro-std-17.service с другим именем и поменяйте в ней путь к каталогу данных.

    2. Включите автоматический запуск сервера, используя скрипты автозапуска, предоставленные для вашего системного механизма управления службами, вместо pg-setup, как описано в Подразделе 16.1.3.2. Убедитесь в том, что вы используете переименованные копии скриптов, созданные на шаге 1.

16.1.6. Замечания о совместимости с антивирусами #

Настоятельно не рекомендуется использовать антивирусное ПО в системах, где работает Postgres Pro, так как антивирус создаёт дополнительную нагрузку и может оказывать непредсказуемое влияние на работу базы данных, что чревато проблемами с производительностью и надёжностью. Если вам необходимо использовать антивирусное ПО, обязательно добавьте в исключения антивируса следующие каталоги, так как они не содержат исполняемых файлов:

  • Каталог PGDATA с основными данными кластера (обычно /var/lib/pgpro/std-17/data или другой каталог, заданный в параметрах initdb)

  • Каталоги созданных табличных пространств