Для систем на базе Linux PostgreSQL для 1С поставляется в виде двоичных пакетов. Все двоичные дистрибутивы PostgreSQL состоят из нескольких пакетов. Структура пакетов отличается от структуры ванильного PostgreSQL и поддерживает следующие режимы установки:
Быстрая установка и настройка. Пакет postgrespro-1c-17 устанавливает и настраивает все компоненты, необходимые для получения готовой к использованию конфигурации, как клиентских, так и серверных компонентов. Выберите этот вариант, если вы планируете установить только один экземпляр PostgreSQL и вас не беспокоят возможные конфликты с другими продуктами на базе PostgreSQL.
При установке пакета postgrespro-1c-17 могут быть удалены существующие инсталляции продуктов на базе PostgreSQL и PostgreSQL. И напротив, установленный пакет PostgreSQL может быть автоматически удалён, если вы впоследствии развернёте другой продукт на базе PostgreSQL. Данный пакет не нужно устанавливать в процессе обновления или миграции, а также если вы планируете разворачивать в одной системе несколько инсталляций.
Расширенная установка. Вы можете выбрать любые пакеты, требующиеся для ваших целей, включая пакеты для разработчиков. Этот вариант требует ручной настройки, поэтому для него необходимо хорошо разбираться в Linux и понимать архитектуру PostgreSQL. Это единственно возможный вариант, если вы планируете реализовать один из следующих сценариев использования PostgreSQL:
Установка одновременно нескольких версий PostgreSQL либо установка вместе с другими продуктами на базе PostgreSQL.
Обновление с другой версии или миграция с другого продукта на базе PostgreSQL.
Управление сервером PostgreSQL с использованием программных средств обеспечения высокой степени доступности, таких как pacemaker, вместо стандартных системных механизмов управления службами.
Минимальные системные требования для установки PostgreSQL, создания кластера баз данных и запуска сервера:
Процессор с частотой 1 ГГц
1 ГБ ОЗУ
1 ГБ свободного дискового пространства
Для вспомогательных компонентов или данных потребуется дополнительное дисковое пространство.
Двоичные пакеты PostgreSQL предоставляются для следующих систем на базе Linux:
Системы Red Hat Enterprise Linux (RHEL) и производные от них: Red Hat Enterprise Linux 8/9/10, Rocky Linux 9/10, Oracle Linux 9/10, AlmaLinux 9/10, РЕД ОС МУРОМ 7.3/8, РОСА «ХРОМ» 2021.1
Системы на базе Debian: Debian 11/12/13, Ubuntu 22.04/24.04/25.10, Astra Linux 1.7/1.8
Альт 10/11, Альт СП релиз 10
SUSE Linux Enterprise Server (SLES) 15/16
Двоичные пакеты PostgreSQL используют библиотеку tzdata, предоставляемую операционной системой, поэтому важно, чтобы в системе была установлена последняя её версия. В случае использования устаревшей библиотеки tzdata значения времени в вашей базе данных могут быть некорректными.
Перед установкой PostgreSQL из двоичных пакетов (с помощью менеджера пакетов вашей операционной системы) необходимо подключить репозиторий пакетов PostgreSQL.
Для подключения репозитория выполните следующие действия:
Перейдите на страницу загрузки PostgreSQL для 1С и нажмите кнопку загрузки.
Заполните опросник, чтобы получить инструкции по установке. Эти инструкции будут высланы на адрес электронной почты, указанный в опроснике.
Загрузите Bash-скрипт pgpro-repo-add.sh по ссылке из письма с инструкциями.
Этот скрипт подключит репозиторий, чтобы менеджер пакетов вашей операционной системы мог использовать его.
Убедитесь, что утилита wget установлена и имеет доступ в Интернет.
Скрипту необходима утилита wget и доступ в Интернет, чтобы проверить доступность репозитория в ходе его подключения.
Для доступа в Интернет невозможно использовать SOCKS5-прокси, поскольку в wget отсутствует поддержка прокси этого типа.
(Необязательно) При необходимости проверьте содержимое файла со скриптом.
Запустите скрипт от имени пользователя root (например, используя sudo).
Теперь все готово к установке PostgreSQL для 1С с помощью менеджера пакетов вашей операционной системы.
Перед установкой PostgreSQL для 1С в Astra Linux в режиме замкнутой программной среды (ЗПС) необходимо добавить публичный ключ для проверки двоичных пакетов PostgreSQL для 1С.
Для добавления публичного ключа выполните следующие действия:
Загрузите файл публичного ключа SSE-ASTRA-GPG-POSTGRESPRO для Astra Linux с репозитория Postgres Pro.
Публичный ключ из репозитория имеет формат ASCII. Но для замкнутой программной среды в Astra Linux требуется публичный ключ в двоичном формате.
Преобразуйте ключ из формата ASCII в двоичный формат:
gpg --dearmor --output pgpro-astra.key SSE-ASTRA-GPG-POSTGRESPRO
Скопируйте публичный ключ в двоичном формате в каталог /etc/digsig/keys/.
Убедитесь, что следующие параметры добавлены в конфигурационный файл /etc/digsig/digsig_initramfs.conf:
DIGSIG_ELF_MODE=1 DIGSIG_XATTR_MODE=0 DIGSIG_IGNORE_XATTR_KEYS=0 DIGSIG_IGNORE_GOST2001=0
Обновите initramfs:
sudo update-initramfs -u -k all
Перезагрузите машину.
Приступайте к установке.
Если вам нужно установить только один экземпляр PostgreSQL и вы не собираетесь использовать никакие другие продукты на базе PostgreSQL в вашей системе, вы можете использовать режим быстрой установки. Типичная процедура установки в этом случае выглядит так:
Подключите репозиторий пакетов, предназначенный для вашей операционной системы.
Установите пакет postgrespro-1c-17. При этом по зависимостям установятся все требуемые компоненты, будет создана база данных по умолчанию, запущен сервер баз данных и настроен автозапуск сервера при загрузке системы, а все предоставляемые программы станут доступными в пути PATH.
По умолчанию конфигурация базы данных настраивается под устанавливаемый продукт PostgreSQL. Если вам нужна другая настройка сервера базы данных, выберите расширенную установку и воспользуйтесь аргументом tune команды pg-setup initdb.
После завершения установки вы можете запустить psql от имени пользователя postgres и подключиться к только что созданной базе данных, находящейся в каталоге данных /var/lib/pgpro/1c-17/data.
Так как база данных по умолчанию создаётся скриптом pg-setup, путь к каталогу данных сохраняется в файле /etc/default/postgrespro-1c-17. Все последующие команды pg-setup, а также любые команды, управляющие службой PostgreSQL, будут нацелены именно на эту базу данных. Кроме того, в указанном файле можно изменить значение PG_OOM_ADJUST_VALUE для дочерних процессов postmaster (за подробностями обратитесь к Подразделу 18.4.4).
Разделение дистрибутива на несколько пакетов позволяет произвести инсталляцию по-разному для различных применений: для серверов баз данных, клиентских систем или рабочих станций разработчиков. Такие инсталляции необходимо настраивать вручную, но это даёт дополнительную гибкость при использовании продукта. Вы можете установить несколько версий PostgreSQL параллельно, а также вместе с другими продуктами PostgreSQL. В частности, это может потребоваться при осуществлении обновления или при миграции с другого продукта на базе PostgreSQL.
Для осуществления расширенной установки выполните следующие действия:
Подключите репозиторий пакетов, предназначенный для вашей операционной системы.
Выберите пакеты PostgreSQL, требующиеся для ваших целей, и установите их с помощью стандартных для вашего дистрибутива Linux команд. Доступные пакеты перечислены в Таблице 17.1.
В результате все файлы будут установлены в каталог /opt/pgpro/1c-17.
Запустите от имени root утилиту pg-wrapper, чтобы добавить и клиентские, и серверные установленные программы в путь поиска PATH, а также включить страницы man по SQL в файл конфигурации страниц man. Эта утилита входит в состав пакета postgrespro-1c-17-client.
/opt/pgpro/1c-17/bin/pg-wrapper links update
Подробнее о разрешении возможных конфликтов рассказывается в pg-wrapper.
Если вы устанавливаете пакет postgrespro-1c-17-server, выполните следующую процедуру настройки сервера:
Создайте начальную базу данных, запустив вспомогательный скрипт pg-setup от имени root с ключом initdb:
/opt/pgpro/1c-17/bin/pg-setup initdb [параметры_initdb]Здесь:
Аргумент tune выбирает вариант конфигурации базы данных.
параметры_initdb — обычные параметры initdb.
По умолчанию pg-setup инициализирует кластер баз данных со включёнными контрольными суммами. Если для вас это нежелательно, укажите --no-data-checksums.
Скрипт pg-setup выполняет административные операции с базами данных от имени пользователя postgres. Если вы не укажете никакие параметры initdb, база по умолчанию создаётся в каталоге /var/lib/pgpro/1c-17/data с параметрами локализации, определяемыми переменной окружения LANG текущего сеанса. Переменные окружения LC_* при этом игнорируются.
Так как база данных по умолчанию создаётся скриптом pg-setup, путь к каталогу данных сохраняется в файле /etc/default/postgrespro-1c-17. Все последующие команды pg-setup, а также любые команды, управляющие службой PostgreSQL, будут нацелены именно на эту базу данных. Кроме того, в указанном файле можно изменить значение PG_OOM_ADJUST_VALUE для дочерних процессов postmaster (за подробностями обратитесь к Подразделу 18.4.4).
Запустите сервер с помощью pg-setup от имени root следующим образом:
/opt/pgpro/1c-17/bin/pg-setup service start
Как и сервер ванильного PostgreSQL, сервер PostgreSQL работает под именем пользователя postgres.
По умолчанию автоматический запуск сервера отключён, чтобы вы могли вручную управлять восстановлением базы данных после перезагрузки системы. Однако вы можете настроить и автоматический запуск сервера PostgreSQL. За подробностями обратитесь к Подразделу 17.1.5.2.
В следующей таблице перечислены все имеющиеся пакеты PostgreSQL.
Таблица 17.1. Пакеты PostgreSQL
|
Пакет |
Описание |
|---|---|
|
|
Пакет верхнего уровня, устанавливающий и настраивающий PostgreSQL для серверных и клиентских систем. Не используйте этот пакет при обновлении или миграции. ВажноПри установке пакета |
|
|
Стандартные клиентские приложения, такие как psql и pg_dump. |
|
|
Общие библиотеки, требующиеся для развёртывания клиентских приложений, включая libpq; библиотеки времени выполнения для обработчика ECPG. |
|
|
Сервер PostgreSQL и серверный язык программирования PL/pgSQL. |
|
|
Дополнительные расширения и программы, разворачиваемые на серверах баз данных. |
|
|
Заголовочные файлы и библиотеки для разработки клиентских приложений и серверных расширений. В системах на базе Debian этот пакет называется |
|
|
Реализация языка Perl для программирования на стороне сервера (см. Главу 44). |
|
|
Реализация языка Python 3 для программирования на стороне сервера (см. Главу 45). |
|
|
Реализация языка Tcl для программирования на стороне сервера (см. Главу 43). |
|
|
Документация на английском языке. |
|
|
Документация на русском языке. |
|
|
Тестовые скрипты для сервера. Этот пакет представлен только для систем на базе RHEL и SUSE. |
|
|
Этот пакет обеспечивает поддержку JIT-компиляции. Этот пакет предоставляется только для поддерживаемых систем Debian и Ubuntu, Astra Linux 1.7/1.8, поддерживаемых систем Альт, CentOS 8, Rocky Linux 8/9, Oracle Linux 8/9, AlmaLinux 9, SLES 15/16 и RHEL 8/9. Чтобы узнать об использовании JIT больше, обратитесь к Главе 30. |
Также PostgreSQL включает библиотеки и утилиты, необходимые для предоставляемых пакетов и сервера PostgreSQL. Эти пакеты предоставляются только для дистрибутивов, в которых отсутствует требуемая версия таких библиотек.
Таблица 17.2. Сторонние библиотеки и утилиты, собранные для PostgreSQL для 1С
|
Библиотека/утилита |
Описание |
|---|---|
|
|
Библиотека для быстрого сжатия данных без потерь. |
|
|
Библиотека для раскрутки стека, используемая параметром |
|
|
Библиотека для обратной трассировки стека, используемая параметром |
|
|
Две библиотеки Perl, используемые в рамках TAP-тестирования и доступные в пакете |
Кроме того, PostgreSQL предоставляет отдельные пакеты с отладочной информацией для некоторых операционных систем:
В системах на базе Debian это пакет postgrespro-1c-17-dbg.
В системах на базе RHEL это пакет postgrespro-1c-17-debuginfo.
В ОС Альт Линукс для всех пакетов с двоичными файлами имеются соответствующие пакеты -debuginfo.
Для серверных инсталляций требуются как минимум следующие пакеты:
postgrespro-1c-17-server
postgrespro-1c-17-client
postgrespro-1c-17-libs
Для использования дополнительных расширений PostgreSQL вы должны также установить пакет postgrespro-1c-17-contrib. В системах на базе Debian пакет postgrespro-1c-17-server зависит от пакета postgrespro-1c-17-contrib, поэтому последний должен всегда устанавливаться вместе с сервером.
Для клиентских инсталляций обычно достаточно установить пакеты postgrespro-1c-17-client и postgrespro-1c-17-libs. Если вы используете независимые приложения и вам не нужны стандартные клиентские утилиты, такие как psql, вы можете установить только пакет postgrespro-1c-17-libs.
Для рабочих станций разработчиков необходимый минимум составляют следующие пакеты:
postgrespro-1c-17-libs
postgrespro-1c-17-devel/ postgrespro-1c-17-dev
Также вы можете установить и настроить сервер с тестовой базой данных. Подробнее о настройке, которая может потребоваться дополнительно, рассказывается в Подразделе 17.1.6.
Если вы производите расширенную установку, автоматический запуск сервера по умолчанию отключается. После создания базы данных по умолчанию вы можете настроить автоматический запуск сервера при загрузке системы, используя имеющиеся в вашей операционной системе механизмы управления службами или сторонние средства обеспечения высокой степени доступности. Для облегчения этой задачи в пакете postgrespro-1c-17-server поставляется скрипт pg-setup, помещаемый в каталог /opt/pgpro/1c-17/bin.
Для настройки автозапуска сервера запустите скрипт pg-setup со следующими параметрами:
pg-setup service enable
Если требуется, вы можете отключить автозапуск сервера, используя тот же скрипт:
pg-setup service disable
Вы также можете использовать системные средства управления службами, непосредственно задействуя скрипты для систем инициализации SysV init.d и systemd, предоставляемые в пакете postgrespro-1c-17-server. В зависимости от дистрибутива Linux PostgreSQL поддерживает следующие механизмы управления службами:
|
Дистрибутив Linux |
Предоставляемые скрипты |
|---|---|
|
Системы на базе RHEL, SLES 15/16 |
Файл службы systemd |
|
Debian, Ubuntu, Альт 10/11 |
И файл службы systemd, и скрипт init.d в стиле SysV |
Для включения автоматического запуска сервера средствами systemd выполните следующую команду:
systemctl enable postgrespro-1c-17
Для использования скрипта init.d в стиле SysV:
В системах Альт Линукс выполните следующую команду:
systemctl enable postgrespro-1c-17
В системах Debian воспользуйтесь скриптом update-rc.d. За подробностями обратитесь к соответствующей странице man.
Хотя может быть достаточно установить пакеты postgrespro-1c-17-libs и postgrespro-1c-17-devel/postgrespro-1c-17-dev, обычно на машинах разработчиков удобно иметь и установленный сервер. Для быстрой установки вы можете воспользоваться пакетом postgrespro-1c-17, который автоматически настроит предоставляемые клиентские и серверные программы, а также создаст начальную базу данных. Однако если вы планируете использовать одновременно несколько продуктов на базе PostgreSQL, следуйте инструкциям по расширенной установке, приведённым в Подразделе 17.1.5.
Чтобы скомпилировать программы с библиотеками PostgreSQL, используя утилиту pg_config, поставляемую с PostgreSQL, необходимо, чтобы её путь был указан в переменной PATH до путей каких-либо других версий pg_config. Заметьте, что в системах на базе RHEL pg_config не добавляется в PATH автоматически. Если в вашей системе нет других версий pg_config, вы можете воспользоваться утилитой pg-wrapper, поставляемой в пакете postgrespro-1c-17-client, для создания символической ссылки на pg_config в стандартном каталоге исполняемых файлов.
Для компиляции программ с использованием pkg-config добавьте путь /opt/pgpro/1c-17/lib/pkgconfig/ в переменную среды PKG_CONFIG_PATH.
Если вы хотите компилировать расширения PostgreSQL с поддержкой встраивания JIT, выполните дополнительные требования:
Установите пакет LLVM для разработки и компилятор Clang. Вы должны выбрать пакеты той же версии, какая использовалась для сборки пакета postgrespro-1c-17-jit, устанавливаемом на сервере. Определить версию, требующуюся для текущего выпуска PostgreSQL, вы можете по значению CLANG в файле /opt/pgpro/1c-17/lib/pgxs/src/Makefile.global.
Выполняя команды make и make install, добавьте параметр with-llvm=yes для компиляции и установки файлов с битовым кодом для вашего расширения. По умолчанию компиляции битового кода отключена, так как она зависит от доступности компилятора Clang.
Чтобы использовать сервер PostgreSQL с клиентской программой из стороннего продукта, вы можете установить версию библиотек PostgreSQL, с которыми компилировалась эта программа. Например, если программа поставляется в составе ванильного PostgreSQL, вам может потребоваться установить пакеты libpq или postgresql-libs, предоставляемые для вашего дистрибутива Linux. В этом случае программа, возможно, не будет использовать некоторые новые возможности сервера PostgreSQL, но скорее всего она и не поддерживает их.
Если вы предпочитаете использовать библиотеки PostgreSQL со сторонней программой или хотели бы задействовать новую возможность, которая не требует изменения самого клиентского приложения, например, проверку подлинности SCRAM, вы можете перекомпилировать вашу программу с библиотеками PostgreSQL.
Если программа скомпилирована с одной версией libpq, а используется с другой, её стабильная работа не гарантируется.
Если вы создаёте пакеты .rpm или .deb для вашей программы, рекомендуется сделать следующее:
Добавьте путь /opt/pgpro/1c-17/bin в переменную PATH в сборочных скриптах (в файле .spec или debian/rules).
Добавьте postgrespro-1c-17-dev в теги BuildDepends или BuildRequires описания пакета вашей программы.
Тем самым вы обеспечите вызов в процессе создания пакетов нужной версии pg_config при каждой пересборке пакета исходного кода.
Чтобы настроить в Linux несколько экземпляров сервера PostgreSQL с разными каталогами данных, нужно проделать следующее:
Установите и настройте PostgreSQL, следуя указаниям в Подразделе 17.1.4 или Подразделе 17.1.5.
После создания начальной базы данных запустите initdb и укажите путь к другому каталогу данных и любые другие параметры, требующиеся для инициализации другого экземпляра сервера.
Задайте другие порты для экземпляров серверов в соответствующих файлах postgresql.conf, чтобы не допустить конфликтов.
Если требуется, настройте автоматический запуск сервера следующим образом:
Создайте копию файла /etc/init.d/postgrespro-1c-17 или /lib/systemd/system/postgrespro-1c-17.service с другим именем и поменяйте в ней путь к каталогу данных.
Включите автоматический запуск сервера, используя скрипты автозапуска, предоставленные для вашего системного механизма управления службами, вместо pg-setup, как описано в Подразделе 17.1.5.2. Убедитесь в том, что вы используете переименованные копии скриптов, созданные на шаге 1.
Настоятельно не рекомендуется использовать антивирусное ПО в системах, где работает PostgreSQL, так как антивирус создаёт дополнительную нагрузку и может оказывать непредсказуемое влияние на работу базы данных, что чревато проблемами с производительностью и надёжностью. Если вам необходимо использовать антивирусное ПО, обязательно добавьте в исключения антивируса следующие каталоги, так как они не содержат исполняемых файлов:
Каталог PGDATA с основными данными кластера (обычно /var/lib/pgpro/1c-17/data или другой каталог, заданный в параметрах initdb)
Каталоги созданных табличных пространств