pg-setup — создать кластер баз данных Postgres Pro и управлять соответствующей службой
pg-setup initdb [--tune= конфигурация] [--enable-online-upgrade
] [параметры_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-ent-13-server. После установки Postgres Pro вы можете найти pg-setup в каталоге каталог-инсталляции/binкаталог-инсталляции обозначает путь /opt/pgpro/ent-13.
Программу pg-setup нужно запускать от имени root, но она выполняет административные операции с базой данных под именем пользователя postgres. Запуская её с разными параметрами, вы можете:
инициализировать кластер баз данных
проверить доступные порты и изменить порт, который будет использоваться сервером Postgres Pro
изменить параметры конфигурации сервера
включить/отключить автоматический запуск службы Postgres Pro
запустить, остановить или перезапустить службу Postgres Pro
настроить кластер БД для определённого продукта Postgres Pro
pg-setup принимает следующие аргументы командной строки:
initdb [параметры_initdb]Инициализировать кластер баз данных от имени пользователя postgres.
По умолчанию кластер баз данных инициализируется в каталоге /var/lib/pgpro/ent-13/data и настраивается для продукта Postgres Pro; в этом кластере будут включены контрольные суммы, параметр auth-local будет иметь значение peer, а auth-host — значение md5. Параметры локализации наследуются из переменной окружения LANG, определённой в текущем сеансе. Все переменные окружения LC_* при этом игнорируются. Вы можете также передать параметры initdb для дополнительной настройки инсталляции.
Если база данных по умолчанию создаётся с помощью pg-setup, путь к каталогу данных сохраняется в файле /etc/default/postgrespro-enterprise-13, чтобы все последующие команды pg-setup, а также все команды, управляющие службой Postgres Pro, воздействовали именно на эту базу данных. Управлять несколькими базами данных с помощью pg-setup нельзя.
find-free-portНайти свободный порт в системе. Это может быть полезно, если вы планируете устанавливать несколько экземпляров серверов, либо стандартный порт 5432 уже используется другой программой.
set-server-port портЗадать номер порта, на котором сервер будет принимать соединения. Воспользуйтесь этой командой, чтобы избежать конфликтов, если вы устанавливаете в одной системе более одного сервера.
По умолчанию: 5432
set имя значениеУстановить для заданного параметра конфигурации указанное значение в файле 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 Enterprise. Если вы укажете какое-либо другое, не предопределённое, значение, кластер будет использовать стандартную конфигурацию.
В случае, если в вашей системе будут работать несколько серверов БД и/или приложений, может потребоваться изменить настроенную конфигурацию, так как pg_setup выбирает параметры конфигурации в зависимости от характеристик оборудования, полагая, что система будет использоваться только одним сервером БД.
--enable-online-upgradeПодготовить кластер баз данных для обновлений младшей версии «на ходу», без перезапуска сервера. Такой кластер впоследствии можно будет обновить, не прерывая его работу, то есть во время установки новой версии сервера подключения клиентов прерываться не будут.
Если вы устанавливаете Postgres Pro из пакета postgrespro-ent-13, pg-setup вызывается автоматически с параметрами по умолчанию. В результате создаётся кластер баз данных и база по умолчанию в каталоге /var/lib/pgpro/ent-13/data, настраивается автозапуск службы Postgres Pro и служба запускается.
Если вы устанавливаете сервер Postgres Pro непосредственно из пакета postgrespro-ent-13-server, вы можете запустить этот скрипт вручную для инициализации кластера баз данных или управления службой Postgres Pro.
Установка из двоичных пакетов в Linux подробно описана в Разделе 17.1.