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