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 в вашей системе, вы можете использовать режим быстрой установки. Типичная процедура установки в этом случае выглядит так:
Подключите репозиторий пакетов, предназначенный для вашей операционной системы. Конкретные адреса репозиториев и команды для их подключения в поддерживаемых дистрибутивах Linux вы можете найти на Странице загрузки для соответствующей версии Postgres Pro.
Установите пакет
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.
Для осуществления расширенной установки выполните следующие действия:
Подключите репозиторий пакетов, предназначенный для вашей операционной системы. Конкретные адреса репозиториев и команды для их подключения в поддерживаемых дистрибутивах Linux вы можете найти на Странице загрузки для соответствующей версии Postgres Pro.
Выберите пакеты Postgres Pro, требующиеся для ваших целей, и установите их с помощью стандартных для вашего дистрибутива Linux команд. Доступные пакеты перечислены в Таблице 16.1.
В результате все файлы будут установлены в каталог
/opt/pgpro/std-17
.Запустите от имени root утилиту pg-wrapper, чтобы добавить и клиентские, и серверные установленные программы в путь поиска
PATH
, а также включить страницы man по SQL в файл конфигурации страниц man. Эта утилита входит в состав пакетаpostgrespro-std-17-client
./opt/pgpro/std-17/bin/pg-wrapper links update
Подробнее о разрешении возможных конфликтов рассказывается в pg-wrapper.
Если вы устанавливаете пакет
postgrespro-std-17-server
, выполните следующую процедуру настройки сервера:Создайте начальную базу данных, запустив вспомогательный скрипт 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).Запустите сервер с помощью
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
Пакет | Описание |
---|---|
| Пакет верхнего уровня, устанавливающий и настраивающий Postgres Pro для серверных и клиентских систем. Не используйте этот пакет при обновлении или миграции. ВажноПри установке пакета |
| Стандартные клиентские приложения, такие как psql и pg_dump. |
| Общие библиотеки, требующиеся для развёртывания клиентских приложений, включая libpq; библиотеки времени выполнения для обработчика ECPG. |
| Сервер Postgres Pro и серверный язык программирования PL/pgSQL. |
| Дополнительные расширения и программы, разворачиваемые на серверах баз данных. |
| Заголовочные файлы и библиотеки для разработки клиентских приложений и серверных расширений. В системах на базе Debian этот пакет называется |
| Реализация языка Perl для программирования на стороне сервера (см. Главу 43). |
| Реализация языка Python 3 для программирования на стороне сервера (см. Главу 44). |
| Реализация языка Tcl для программирования на стороне сервера (см. Главу 42). |
| Документация на английском языке. |
| Документация на русском языке. |
| Тестовые скрипты для сервера. Этот пакет представлен только для систем на базе RHEL и SUSE. |
| Этот пакет обеспечивает поддержку 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 — агент мониторинга для сбора метрик Postgres Pro и операционной системы. |
| Расширение, позволяющее модифицировать курсоры Postgres Pro. |
| Утилита pg_probackup. |
| Утилита pgpro_controldata, показывающая управляющую информацию кластера БД PostgreSQL/Postgres Pro и параметры совместимости кластера и/или сервера. |
| Расширение pgpro_pwr, позволяющее получать отчёты по нагрузке, полезные для выявления наиболее ресурсоёмких операций в базе данных. |
| Расширение pgpro_stats, собирающее статистику выполнения SQL-операторов, подсчитывающее статистику событий ожидания и предоставляющее прочие полезные метрики. |
Также Postgres Pro включает библиотеки и утилиты, необходимые для предоставляемых пакетов и сервера Postgres Pro. Эти пакеты предоставляются только для дистрибутивов, в которых отсутствует требуемая версия таких библиотек.
Таблица 16.2. Сторонние библиотеки и утилиты, собранные для Postgres Pro Standard
Библиотека/утилита | Описание |
---|---|
| Библиотека для быстрого сжатия данных без потерь. |
| Библиотека для реализации протокола TDS. Используется расширением |
| Библиотека для раскрутки стека, используемая параметром |
| Библиотека для обратной трассировки стека, используемая параметром |
| Библиотека для реализации протокола TDS. Предоставляется для SLES 15. |
| Две библиотеки Perl, используемые в рамках TAP-тестирования и доступные в пакете |
Кроме этого, имеются отдельные пакеты с несколькими дополнительными модулями, собранные специально для совместимости с Postgres Pro Standard:
Таблица 16.3. Сторонние пакеты, собранные для Postgres Pro Standard
Пакет | Описание |
---|---|
| Расширение hypopg, обеспечивающее поддержку гипотетических индексов в Postgres Pro. |
| Драйвер открытого соединения с базами данных (open database connectivity, ODBC) для доступа к системам управления базами данных. В качестве альтернативы можно использовать |
| Расширение oracle_fdw, предоставляющее обёртку сторонних данных для доступа к базам данных Oracle. Этот пакет предоставляется только для операционных систем на платформе Intel. |
| В этом пакете представлены реализации некоторых функций, которые существуют в СУБД Oracle, но отсутствуют в Postgres Pro (или работают немного по-другому). |
| Утилита pg_filedump, представляющая файлы кучи и индексов, а также управляющие файлы Postgres Pro в понятном человеку виде. |
| pg_repack — расширение Postgres Pro и утилита для реорганизации таблиц. |
| pgbouncer — пул соединений для Postgres Pro. |
| pgbadger — анализатор журналов Postgres Pro, генерирующий подробные отчёты и графики. |
| Расширение pgvector, предоставляющее поиск сходства векторов в Postgres Pro. |
| Набор разделяемых библиотек, реализующих API для отладки функций PL/pgSQL в Postgres Pro. |
| Разделяемая библиотека PLV8, добавляющая в Postgres Pro поддержку процедурного языка Javascript в реализации V8. Этот пакет предоставляется только для систем Debian и Ubuntu, Альт 10/11, SLES 15, RHEL 8/9 и РЕД ОС МУРОМ 7.3. |
| Расширение 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
для вашей программы, рекомендуется сделать следующее:
Добавьте путь
/opt/pgpro/std-17/bin
в переменнуюPATH
в сборочных скриптах (в файле.spec
илиdebian/rules
).Добавьте
postgrespro-std-17-dev
в тегиBuildDepends
илиBuildRequires
описания пакета вашей программы.
Тем самым вы обеспечите вызов в процессе создания пакетов нужной версии pg_config при каждой пересборке пакета исходного кода.
16.1.5. Настройка нескольких экземпляров Postgres Pro #
Чтобы настроить в Linux несколько экземпляров сервера Postgres Pro с разными каталогами данных, нужно проделать следующее:
Установите и настройте Postgres Pro, следуя указаниям в Подразделе 16.1.2 или Подразделе 16.1.3.
После создания начальной базы данных запустите initdb и укажите путь к другому каталогу данных и любые другие параметры, требующиеся для инициализации другого экземпляра сервера.
Задайте другие порты для экземпляров серверов в соответствующих файлах
postgresql.conf
, чтобы не допустить конфликтов.Если требуется, настройте автоматический запуск сервера следующим образом:
Создайте копию файла
/etc/init.d/postgrespro-std-17
или/lib/systemd/system/postgrespro-std-17.service
с другим именем и поменяйте в ней путь к каталогу данных.Включите автоматический запуск сервера, используя скрипты автозапуска, предоставленные для вашего системного механизма управления службами, вместо
pg-setup
, как описано в Подразделе 16.1.3.2. Убедитесь в том, что вы используете переименованные копии скриптов, созданные на шаге 1.
16.1.6. Замечания о совместимости с антивирусами #
Настоятельно не рекомендуется использовать антивирусное ПО в системах, где работает Postgres Pro, так как антивирус создаёт дополнительную нагрузку и может оказывать непредсказуемое влияние на работу базы данных, что чревато проблемами с производительностью и надёжностью. Если вам необходимо использовать антивирусное ПО, обязательно добавьте в исключения антивируса следующие каталоги, так как они не содержат исполняемых файлов:
Каталог
PGDATA
с основными данными кластера (обычно/var/lib/pgpro/std-17/data
или другой каталог, заданный в параметрах initdb)Каталоги созданных табличных пространств