gpinitstandby
Добавляет и/или инициализирует резервный мастер-хост в кластере Greengage DB.
Синтаксис
gpinitstandby { -s <standby_hostname> [ -P <port> ] | -r | -n }
[ -a ]
[ -q ]
[ -D ]
[ -S <standby_data_directory> ]
[ -l <logfile_directory> ]
[ --hba-hostnames ]
gpinitstandby -v
gpinitstandby -?Описание
Утилита gpinitstandby добавляет резервный мастер в кластер Greengage DB.
Если в кластере уже настроен резервный мастер, используйте параметр -r для его удаления перед добавлением нового.
Перед запуском убедитесь, что ПО Greengage DB установлено на резервном мастер-хосте и выполнен обмен SSH-ключами между хостами. Рекомендуется использовать одинаковый номер порта мастера на основном и резервном мастер-хосте.
Утилита должна запускаться на активном основном мастер-хосте.
Основные действия утилиты:
-
Удаляет информацию о существующем резервном мастере из системного каталога Greengage DB, если указан параметр
-r. -
Добавляет информацию о новом резервном мастере в системный каталог.
-
Обновляет файл pg_hba.conf мастера, добавляя правила, разрешающие подключение нового резервного мастера.
-
Настраивает резервный мастер на альтернативном мастер-хосте.
-
Запускает процесс синхронизации.
Резервный мастер работает в режиме "теплого резерва" на случай отказа основного мастера.
Он поддерживается в актуальном состоянии с помощью процессов репликации журналов транзакций (walsender на основном мастере и walreceiver на резервном мастере), которые синхронизируют данные между основным и резервным мастером.
При отказе основного мастера процесс репликации завершается, и резервный мастер может быть активирован с помощью утилиты gpactivatestandby.
При активации резервного мастера журналы репликации используются для восстановления состояния мастера на момент последней успешно зафиксированной транзакции.
После активации резервный мастер становится полноценным мастером Greengage DB, принимая подключения клиентов и выполняя все обычные операции, включая обработку SQL-команд и управление ресурсами.
Если утилита gpinitstandby ранее не смогла инициализировать резервный мастер, перед повторным запуском необходимо удалить файлы в каталоге данных резервного мастера.
Каталог данных не очищается автоматически после сбоя, так как содержит лог-файлы, которые могут помочь определить причину ошибки.
При сбое инициализации на резервном хосте в каталоге /tmp резервного хоста создается итоговый отчет. Отчет содержит список каталогов, которые необходимо очистить.
Параметры
- -a
-
Не запрашивает подтверждение у пользователя.
- -D
-
Устанавливает уровень логирования
debug. - --hba-hostnames
-
(Опционально) Определяет, будет ли утилита использовать имена хостов при обновлении файла pg_hba.conf для адресов, которые могут подключаться к Greengage DB. По умолчанию утилита использует IP-адреса. Для согласованности рекомендуется использовать то же значение, которое было задано для HBA_HOSTNAMES при инициализации системы Greengage DB.
- -l <logfile_directory>
-
Каталог для записи лог-файла. По умолчанию используется ~/gpAdminLogs.
- -n
-
Запускает резервный мастер Greengage DB, если он был настроен, но по какой-либо причине остановлен.
- -P <port>
-
Задает порт, используемый резервным мастером Greengage DB. По умолчанию используется тот же порт, что и для активного мастера.
Если резервный мастер находится на том же хосте, порты должны различаться. При совпадении портов на одном хосте утилита возвращает ошибку.
- -q
-
Запуск в режиме без вывода сообщений. Вывод команды не отображается на экране, но по-прежнему записывается в лог-файл.
- -r
-
Удаляет текущий резервный мастер из системы Greengage DB.
- -s <standby_hostname>
-
Имя хоста, на котором будет размещен резервный мастер.
- -S <standby_data_directory>
-
Каталог данных для нового резервного мастера. По умолчанию используется тот же каталог, что и у активного мастера.
Если резервный мастер находится на том же хосте, необходимо указать другой каталог с помощью этого параметра.
- -v
-
Отображает версию утилиты, ее статус, дату последнего обновления и контрольную сумму.
- -?
-
Выводит справку.
Примеры
Добавление резервного мастера в систему Greengage DB с запуском процесса синхронизации:
$ gpinitstandby -s smdwЗапуск существующего резервного мастера и синхронизация данных с текущим основным мастером:
$ gpinitstandby -nПараметры -n и -s не следует использовать одновременно в одной команде.
Добавление резервного мастера с указанием альтернативного порта:
$ gpinitstandby -s smdw -P 12000Если резервный мастер размещается на том же хосте, что и активный мастер Greengage DB, необходимо указать другой номер порта с помощью параметра -P и другой каталог данных резервного мастера с помощью параметра -S.
Удаление существующего резервного мастера из конфигурации системы Greengage DB:
$ gpinitstandby -r