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-10-server. После установки Postgres Pro вы можете найти pg-setup в каталоге каталог-инсталляции/binкаталог-инсталляции обозначает путь /opt/pgpro/std-10.
Программу pg-setup нужно запускать от имени root, но она выполняет административные операции с базой данных под именем пользователя postgres. Запуская её с разными параметрами, вы можете:
инициализировать кластер баз данных
проверить доступные порты и изменить порт, который будет использоваться сервером Postgres Pro
изменить параметры конфигурации сервера
включить/отключить автоматический запуск службы Postgres Pro
запустить, остановить или перезапустить службу Postgres Pro
настроить кластер БД для определённого продукта Postgres Pro
Параметры
pg-setup принимает следующие аргументы командной строки:
initdb [параметры_initdb]Инициализировать кластер баз данных от имени пользователя
postgres.По умолчанию кластер баз данных инициализируется в каталоге
/var/lib/pgpro/std-10/dataи настраивается для продукта Postgres Pro; в этом кластере будут включены контрольные суммы, параметрauth-localбудет иметь значениеpeer, аauth-host— значениеmd5. Параметры локализации наследуются из переменной окруженияLANG, определённой в текущем сеансе. Все переменные окруженияLC_*при этом игнорируются. Вы можете также передать параметры initdb для дополнительной настройки инсталляции.Если база данных по умолчанию создаётся с помощью pg-setup, путь к каталогу данных сохраняется в файле
/etc/default/postgrespro-standard-10, чтобы все последующие команды 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 Standard. Если вы укажете какое-либо другое, не предопределённое, значение, кластер будет использовать стандартную конфигурацию.В случае, если в вашей системе будут работать несколько серверов БД и/или приложений, может потребоваться изменить настроенную конфигурацию, так как pg_setup выбирает параметры конфигурации в зависимости от характеристик оборудования, полагая, что система будет использоваться только одним сервером БД.
Замечания
Если вы устанавливаете 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.