gpstop

Contents

Синтаксис
Описание
Параметры
Примеры
См. также

Останавливает или перезапускает кластер Greengage DB.

gpstop [ -d <master_data_directory> ]
       [ -B <parallel_processes> ]
       [ -M smart | fast | immediate ]
       [ -t <timeout_seconds> ]
       [ -r ]
       [ -y ]
       [ -a ]
       [ -l <logfile_directory> ]
       [ -v | -q ]

gpstop -m
       [ -d <master_data_directory> ]
       [ -y ]
       [ -l <logfile_directory> ]
       [ -v | -q ]

gpstop -u
       [ -d <master_data_directory> ]
       [ -l <logfile_directory> ]
       [ -v | -q ]

gpstop --host <host_name>
       [ -d <master_data_directory> ]
       [ -l <logfile_directory> ]
       [ -t <timeout_seconds> ]
       [ -a ]
       [ -v | -q ]

gpstop --version

gpstop -? | -h | --help

Описание

Утилита gpstop останавливает серверы баз данных, составляющие кластер Greengage DB. При остановке кластера одновременно останавливаются несколько процессов postgres — мастер и все экземпляры сегментов. Утилита управляет остановкой отдельных экземпляров параллельно.

Режим остановки по умолчанию (-M smart) ожидает завершения текущих клиентских подключений. Если после истечения тайм-аута остаются открытые подключения или вы прерываете выполнение с помощью Ctrl+C, gpstop выводит список открытых подключений и предлагает продолжить ожидание либо выполнить быструю или немедленную остановку. Тайм-аут по умолчанию — 120 секунд; его можно изменить с помощью параметра -t <timeout_seconds>.

Режим -M fast откатывает все выполняющиеся транзакции и завершает все подключения перед остановкой.

Параметр -u применяет изменения в файлах pg_hba.conf и postgresql.conf мастера без прерывания работы. Активные сессии получат изменения только после переподключения к базе данных.

-a

Не запрашивает подтверждение.

-B <parallel_processes>

Количество сегментов для параллельной остановки. Если параметр не указан, утилита запускает до 64 параллельных процессов в зависимости от количества экземпляров сегментов.

-d <master_data_directory>

(Опционально) Каталог данных мастер-хоста. Если параметр не указан, используется значение переменной MASTER_DATA_DIRECTORY.

--host <host_name>

Останавливает экземпляры сегментов на указанном хосте для его обслуживания. Каждый основной сегмент на хосте останавливается, а связанный с ним зеркальный сегмент становится основным, если он находится на другом хосте. Зеркальные сегменты на хосте также останавливаются.

Утилита возвращает ошибку в следующих случаях:

Зеркалирование сегментов отключено.
На хосте работает основной или резервный мастер.
На хосте находятся и основной сегмент, и его зеркало.

Этот параметр нельзя использовать вместе с -m, -r, -u или -y.

ПРИМЕЧАНИЕ

Утилита gprecoverseg восстанавливает сегменты. Выполните команды gprecoverseg для запуска сегментов в качестве зеркал, а затем для их возвращения в предпочтительную роль (основные сегменты).

-l <logfile_directory>

Каталог для записи лог-файла. По умолчанию ~/gpAdminLogs.

-m

(Опционально) Останавливает мастер, запущенный в режиме обслуживания.

-M fast

Быстрая остановка. Выполняющиеся транзакции прерываются и откатываются.

-M immediate

Немедленная остановка. Выполняющиеся транзакции отменяются.

В этом режиме все процессы postgres прерываются без завершения обработки транзакций и очистки временных файлов.

-M smart

Интеллектуальная остановка (по умолчанию). gpstop ожидает отключения активных подключений, затем продолжает остановку. Если после истечения тайм-аута остаются открытые подключения (или вы прерываете выполнение нажатием Ctrl+C), gpstop выводит их список и предлагает продолжить ожидание либо выполнить быструю или немедленную остановку.

-q

Тихий режим. Вывод команды не отображается на экране, но записывается в лог-файл.

-r

Выполняет перезапуск после остановки.

-t <timeout_seconds>

Тайм-аут (в секундах) для ожидания остановки сегмента. Если сегмент не останавливается в течение указанного времени, gpstop выводит сообщение о том, что один или несколько сегментов все еще останавливаются и что перезапуск Greengage DB невозможен, пока они не остановятся. Параметр полезен, когда нужно откатить большие транзакции. Откат таких транзакций может занять более минуты и превысить тайм-аут по умолчанию в 120 секунд.

-u

Перезагружает файлы pg_hba.conf мастера и сегментов, а также файлы postgresql.conf без остановки кластера. Используйте этот параметр для активации новых настроек после редактирования postgresql.conf или pg_hba.conf. Применяется только к параметрам, изменяемым во время работы.

-v

Отображает подробные сообщения о состоянии, прогрессе и ошибках.

-y

Указывает, что резервный мастер не останавливается. По умолчанию резервный мастер останавливается.

-? | -h | --help

Отображает справку.

--version

Отображает версию утилиты.

Остановка кластера Greengage DB в режиме smart:

$ gpstop

Остановка кластера Greengage DB в режиме fast:

$ gpstop -M fast

Остановка всех экземпляров сегментов с последующим перезапуском кластера:

$ gpstop -r

Остановка экземпляра мастера, запущенного в режиме обслуживания:

$ gpstop -m

Перезагрузка файлов postgresql.conf и pg_hba.conf после внесения изменений в конфигурацию без остановки кластера Greengage DB:

$ gpstop -u

gpstart

gpstate

pg_config

gpstop

Синтаксис

Описание

Параметры

Примеры

См. также