gpstart

Contents

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

Запускает кластер Greengage DB.

gpstart [ -d <master_data_directory> ]
        [ -B <parallel_processes> ]
        [ -R ]
        [ -m ]
        [ -y ]
        [ -a ]
        [ -t <timeout_seconds> ]
        [ -l <logfile_directory> ]
        [ --skip-heap-checksum-validation ]
        [ -v | -q ]

gpstart -? | -h | --help

gpstart --version

Описание

Утилита gpstart запускает серверные процессы Greengage DB. При запуске кластера одновременно стартуют несколько процессов-обработчиков СУБД postgres: мастер и все экземпляры сегментов. Утилита gpstart запускает экземпляры кластера параллельно.

При запуске утилита проверяет согласованность настройки контрольных сумм heap на мастере и сегментах — она должна быть либо включена, либо отключена на всех экземплярах. Если настройка различается, возвращается ошибка, и Greengage DB не запускается. Эту проверку можно отключить с помощью параметра --skip-heap-checksum-validation.

ПРИМЕЧАНИЕ

Перед запуском Greengage DB кластер необходимо инициализировать с помощью gpinitsystem. Настройка контрольных сумм задается при инициализации и не может быть изменена позже.

Если кластер настроен с резервным мастером и gpstart не обнаруживает его при запуске, утилита выводит предупреждение и позволяет отменить операцию.

Без параметра -a (отключение интерактивных подсказок) gpstart выводит и логирует сообщения:

Standby host is unreachable, cannot determine whether the standby is currently acting as the master. Received error: <error>
Continue only if you are certain that the standby is not acting as the master.

И подсказку для продолжения:

Continue with startup Yy|Nn (default=N):

С параметром -a утилита не запускает систему, а только логирует сообщения и добавляет в лог:
```
Non interactive mode detected. Not starting the cluster. Start the cluster in interactive mode.
```

Если резервный мастер недоступен, можно запустить кластер и устранить проблемы в процессе работы.

-a

Не запрашивает подтверждение. Отключает интерактивный режим.

-B <parallel_processes>

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

-d <master_data_directory>

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

-l <logfile_directory>

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

-m

(Опционально) Запускает только мастер, что может быть полезно для обслуживания. В этом режиме можно подключаться к мастеру только в служебном режиме. Например:

$ PGOPTIONS='-c gp_session_role=utility' psql postgres

Согласованность контрольных сумм heap на мастере и сегментах не проверяется.

-q

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

-R

Запускает Greengage DB в ограниченном (restricted) режиме, в котором доступ разрешен только суперпользователям.

--skip-heap-checksum-validation

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

ВНИМАНИЕ

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

-t <timeout_seconds>

Тайм-аут (в секундах) ожидания запуска экземпляра сегмента. Если сегмент был остановлен аварийно (например, из-за сбоя питания или принудительного завершения процесса postgres), запуск может занять больше времени из-за восстановления и проверки базы данных. По умолчанию — 600 секунд.

-v

Включает подробный вывод сообщений о статусе, ходе выполнения и ошибках.

-y

(Необязательно) Не запускает резервный мастер. По умолчанию резервный мастер запускается и начинается процесс синхронизации.

-? | -h | --help

Выводит справку.

--version

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

Запустить кластер Greengage DB:

$ gpstart

Запустить в ограниченном режиме (только для суперпользователей):

$ gpstart -R

Запустить только мастер и подключиться в служебном режиме:

$ gpstart -m
$ PGOPTIONS='-c gp_session_role=utility' psql

gpssh-exkeys

gpstate

gpstart

Синтаксис

Описание

Параметры

Примеры

См. также