Русский

mxinitstandby

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

Примечание!
Команда mxinitstandby должна выполняться пользователем с правами sudo на хосте Master (кроме пользователя mxadmin) и указываться с полным абсолютным путём: /opt/ymatrix/matrixdb6/bin/mxinitstandby.

1 Описание

Выполняет инициализацию или удаление резервного узла (Standby) в системе баз данных YMatrix.

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

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

Подкоманда	Параметр	Описание	Обязательный?
init		Собирает информацию о системе и формирует базовый план инициализации.
	--db-cluster-id	Указывает идентификатор кластера базы данных для уникальной идентификации кластера.	Необязательно
	--host	Имя хоста машины, на которой будет добавлен резервный узел.	Обязательно
	--port	Начальный номер порта для поиска свободного порта Standby; по умолчанию поиск начинается с `5432`.	Необязательно
plan		Формирует план развёртывания на основе собранной информации.
	--init-file	Абсолютный путь к файлу с выходными данными команды `init`.	Обязательно
setup		Выполняет план развёртывания.
	--plan-file	Абсолютный путь к файлу с выходными данными команды `plan`.	Обязательно
-r		Флаг, указывающий режим удаления резервного узла.	Обязательно

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

3.1 Добавление или инициализация резервного узла

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

Пример последовательности действий при добавлении резервного узла:

Сбор информации об узле и частичной конфигурации существующего кластера базы данных:
```
$ mxinitstandby init --host <standby_hostname> > /tmp/mxinitstandby.init
```
Примечание!
Замените <host> на фактическое имя хоста.
Создание плана развёртывания на основе собранных данных:
```
$ mxinitstandby plan --init-file /tmp/mxinitstandby.init > /tmp/mxinitstandby.plan
```
Выполнение развёртывания:
```
$ mxinitstandby setup --plan-file /tmp/mxinitstandby.plan --mode cli
```
Примечание!
Если вы случайно запустите команду mxinitstandby init без прав sudo, файл mxinitstandby.init будет создан в контексте этого пользователя и станет доступен только для чтения другим пользователям. Вам необходимо удалить этот файл и повторно запустить команду от имени пользователя с правами sudo, чтобы корректно пересоздать его.

3.2 Удаление резервного узла

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

Пример последовательности действий при удалении резервного узла:

Сбор информации, необходимой для удаления:
```
$ mxinitstandby -r init > /tmp/mxinitstandby_remove.init
```

Создание плана удаления:

$ mxinitstandby -r plan --init-file /tmp/mxinitstandby_remove.init > /tmp/mxinitstandby_remove.plan

Выполнение удаления:
```
$ mxinitstandby -r setup --plan-file /tmp/mxinitstandby_remove.plan
```
Примечание!
Удаление резервного узла автоматически очищает связанные конфигурационные файлы и каталоги данных.
Операция останавливает службу Standby и исключает узел из конфигурации кластера.

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

Смотрите также: mxaddmirrors, mxdeletesystem

← Предыдущая

mxgate

mxmoveseg

Русский English 简体中文