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. Вы можете передать любые параметры initdb для тонкой настройки инсталляции.

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

Примечание

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.