mxinitstandby

В этом документе описывается инструмент mxinitstandby, который используется для добавления или инициализации резервного экземпляра Master в системе баз данных YMatrix.

1 Описание

Добавляет или инициализирует резервный узел Master в системе баз данных YMatrix.

2 Параметры командной строки

В следующей таблице приведена подробная информация о параметрах командной строки:

Подкоманда Параметр Описание Необязательный
init Преобразует собранные сведения в базовый план
--db-cluster-id Идентификатор кластера базы данных. Используется для идентификации уникального кластера Необязательный
--host Хост, на котором будет добавлен резервный узел Master Обязательный
--port Начальный порт, с которого начинается поиск свободного порта для прослушивания резервным Master. По умолчанию — с порта 5432 Необязательный
plan Генерирует план развертывания
--init-file Абсолютный путь к выходному файлу перенаправления команды init Обязательный
setup Выполняет развертывание
--plan-file Абсолютный путь к выходному файлу перенаправления команды plan Обязательный

3 Пример использования

Команда mxinitstandby должна выполняться пользователем с правами sudo на хосте Master (кроме mxadmin, используйте абсолютный путь /opt/ymatrix/matrixdb5/bin/mxinitstandby). Если команда mxinitstandby init была случайно запущена от имени пользователя без прав sudo, файл mxinitstandby.init будет создан в контексте этого пользователя и будет доступен только для чтения другим пользователям. В таком случае удалите созданный файл и повторно запустите команду от имени пользователя с правами sudo, чтобы создать его заново.

Ниже приведён пример рабочего процесса:

Примечание!
Вы должны полностью выполнить весь процесс добавления резервного узла Master, как описано ниже.

  1. Сбор информации об узлах и частичных данных о развертывании существующей базы данных.
    $ mxinitstandby init --host <standby_hostname> > /tmp/mxinitstandby.init

Примечание!
Замените <host> на фактическое имя хоста.

  1. Создание плана развертывания на основе собранной информации, включающего конкретные шаги по установке.

    $ mxinitstandby plan --init-file /tmp/mxinitstandby.init > /tmp/mxinitstandby.plan
  2. Выполнение развертывания.

    $ mxinitstandby setup --plan-file /tmp/mxinitstandby.plan --mode cli

Примечание!
YMatrix 5 представляет новую архитектуру базы данных. Для добавления резервного узла Master используйте инструмент mxinitstandby. Он несовместим с gpinitstandby. В более ранних версиях можно использовать gpinitstandby.

См. также: mxaddmirrors, mxdeletesystem