pg-setup
pg-setup — создать кластер баз данных Postgres Pro и управлять соответствующей службой
Синтаксис
pg-setup
initdb
[параметры_initdb
]
pg-setup
find-free-port
pg-setup
set-server-port
порт
pg-setup
set
параметр
значение
pg-setup
service
параметр_service
pg-setup
tune
конфигурация
Описание
Программа pg-setup представляет собой скрипт оболочки, включённый в дистрибутив Postgres Pro и предназначенный для автоматизации установки кластера баз данных в системах Linux. Этот скрипт входит в состав пакета postgrespro-std-17-server
. После установки Postgres Pro вы можете найти pg-setup в каталоге
, где каталог-инсталляции
/binкаталог-инсталляции
обозначает путь /opt/pgpro/std-17
.
Программу pg-setup нужно запускать от имени root, но она выполняет административные операции с базой данных под именем пользователя postgres
. Запуская её с разными параметрами, вы можете:
инициализировать кластер баз данных
проверить доступные порты и изменить порт, который будет использоваться сервером Postgres Pro
изменить параметры конфигурации сервера
включить/отключить автоматический запуск службы Postgres Pro
запустить, остановить или перезапустить службу Postgres Pro
настроить кластер БД для определённого продукта Postgres Pro
Параметры
pg-setup принимает следующие аргументы командной строки:
initdb [
параметры_initdb
]Инициализировать кластер баз данных от имени пользователя
postgres
.По умолчанию кластер баз данных инициализируется в каталоге
/var/lib/pgpro/std-17/data
и настраивается для продукта Postgres Pro; в этом кластере будут включены контрольные суммы, параметрauth-local
будет иметь значениеpeer
, аauth-host
— значениеmd5
. Параметры локализации наследуются из переменной окруженияLANG
, определённой в текущем сеансе. Все переменные окруженияLC_*
при этом игнорируются. Вы можете также передать параметры initdb для дополнительной настройки инсталляции.Если база данных по умолчанию создаётся с помощью pg-setup, путь к каталогу данных сохраняется в файле
/etc/default/postgrespro-standard-17
, чтобы все последующие команды pg-setup, а также все команды, управляющие службой Postgres Pro, воздействовали именно на эту базу данных. Управлять несколькими базами данных с помощью pg-setup нельзя.find-free-port
Найти свободный порт в системе. Это может быть полезно, если вы планируете устанавливать несколько экземпляров серверов, либо стандартный порт 5432 уже используется другой программой.
set-server-port
порт
Задать номер порта, на котором сервер будет принимать соединения. Воспользуйтесь этой командой, чтобы избежать конфликтов, если вы устанавливаете в одной системе более одного сервера.
По умолчанию: 5432
set
name
значение
Установить для заданного параметра конфигурации указанное
значение
в файлеpostgresql.conf
. Если этот параметр ранее был определён командойALTER SYSTEM
, его предыдущее значение удаляется из файлаpostgresql.auto.conf
.service
параметр_service
Управление службой Postgres Pro с помощью следующих команд:
enable
— включить автоматический запуск службы при перезагрузке системы.disable
— отключить автоматический запуск службы при перезагрузке системы.start
— запустить службу.stop
— остановить службу.condrestart
— перезапустить службу, если она работает в момент вызова pg-setup.status
— возвращает статус службы Postgres Pro.
tune
конфигурация
Выбирает заданную конфигурацию для кластера баз данных. Предопределены следующие значения
конфигурации
(их доступность зависит от редакции Postgres Pro):1c
,std
илиent
. Значение1с
допускается для любого продукта. По умолчанию выбирается конфигурация, определяемая устанавливаемой редакцией Postgres Pro Standard. Если вы укажете какое-либо другое, не предопределённое, значение, кластер будет использовать стандартную конфигурацию.В случае, если в вашей системе будут работать несколько серверов БД и/или приложений, может потребоваться изменить настроенную конфигурацию, так как pg_setup выбирает параметры конфигурации в зависимости от характеристик оборудования, полагая, что система будет использоваться только одним сервером БД.
Замечания
Если вы устанавливаете Postgres Pro из пакета postgrespro-std-17
, pg-setup вызывается автоматически с параметрами по умолчанию. В результате создаётся кластер баз данных и база по умолчанию в каталоге /var/lib/pgpro/std-17/data
, настраивается автозапуск службы Postgres Pro и служба запускается.
Если вы устанавливаете сервер Postgres Pro непосредственно из пакета postgrespro-std-17-server
, вы можете запустить этот скрипт вручную для инициализации кластера баз данных или управления службой Postgres Pro.
Установка из двоичных пакетов в Linux подробно описана в Разделе 16.1.