21.5.30 ndb_waiter — Wait for NDB Cluster to Reach a Given Status — MySQL 5.7

21.5.30 ndb_waiter — Ожидание достижения кластером NDB заданного состояния

ndb_waiter многократно (каждые 100 миллисекунд) выводит состояние всех узлов данных кластера, пока кластер не достигнет заданного состояния или не будет превышен лимит --timeout, после чего завершается. По умолчанию, он ожидает, пока кластер достигнет состояния STARTED, в котором все узлы запущены и подключены к кластеру. Это можно переопределить, используя опции --no-contact и --not-started.

Состояния узлов, сообщаемые этой утилитой, следующие:

NO_CONTACT: Узел недоступен.
UNKNOWN: Узел доступен, но его состояние ещё неизвестно. Обычно это означает, что узел получил команду START или RESTART от сервера управления, но ещё не выполнил её.
NOT_STARTED: Узел остановлен, но остаётся в контакте с кластером. Это наблюдается при перезапуске узла с помощью команды RESTART клиента управления.
STARTING: Процесс ndbd узла запущен, но узел ещё не присоединился к кластеру.
STARTED: Узел работает и присоединился к кластеру.
SHUTTING_DOWN: Узел завершает работу.
SINGLE USER MODE: Это отображается для всех узлов данных кластера, когда кластер находится в режиме single user.

Опции, которые могут быть использованы с ndb_waiter, показаны в следующей таблице. Дополнительные описания приведены после таблицы.

Таблица 21.46 Параметры командной строки, используемые с программой ndb_waiter

Таблица 21.46 Параметры командной строки, используемые с программой ndb_waiter
Формат	Описание	Добавлено, устарело или удалено
`--character-sets-dir=path`	Директория, содержащая наборы символов	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--connect-retries=#`	Количество попыток повторного подключения перед отказом	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--connect-retry-delay=#`	Количество секунд ожидания между попытками связи с сервером управления	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--connect-string=connection_string`, `-c connection_string`	То же, что и --ndb-connectstring	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--core-file`	Запись файла core при ошибке; используется при отладке	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--defaults-extra-file=path`	Чтение указанного файла после чтения глобальных файлов	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--defaults-file=path`	Чтение стандартных параметров только из указанного файла	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--defaults-group-suffix=string`	Также чтение групп с concat(group, suffix)	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--help`, `-?`	Отображение текста справки и выход	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--login-path=path`	Чтение указанного пути из файла входа	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--ndb-connectstring=connection_string`, `-c connection_string`	Устанавливает строку подключения для подключения к ndb_mgmd. Синтаксис: "[nodeid=id;][host=]hostname[:port]". Перезаписывает записи в NDB_CONNECTSTRING и my.cnf	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--ndb-mgmd-host=connection_string`, `-c connection_string`	То же, что и --ndb-connectstring	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--ndb-nodeid=#`	Установить идентификатор узла для этого узла, переопределяя любой ID, установленный с помощью --ndb-connectstring	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--ndb-optimized-node-selection`	Включение оптимизаций для выбора узлов для транзакций. Включено по умолчанию; используйте --skip-ndb-optimized-node-selection для отключения	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--no-contact`, `-n`	Ожидание, пока кластер не достигнет состояния NO CONTACT	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--no-defaults`	Не читать стандартные параметры из файла параметров, кроме файла входа	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--not-started`	Ожидание, пока кластер не достигнет состояния NOT STARTED	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--nowait-nodes=list`	Список узлов, для которых не нужно ждать	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--print-defaults`	Вывод списка аргументов программы и выход	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--single-user`	Ожидание перехода кластера в режим одного пользователя	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--timeout=#`, `-t #`	Ожидание заданного количества секунд, после чего выход независимо от того, достиг ли кластер желаемого состояния	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--usage`, `-?`	Отображение текста справки и выход; то же, что и --help	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--version`, `-V`	Отображение информации о версии и выход	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--wait-nodes=list`, `-w list`	Список узлов, для которых нужно ждать	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)

Использование

ndb_waiter [-c connection_string]

Дополнительные параметры

--character-sets-dir

Формат командной строки --character-sets-dir=path

Каталог, содержащий кодировки символов.

Формат командной строки	`--character-sets-dir=path`

--connect-retries

Формат командной строки	`--connect-retries=#`
Тип	Integer
Значение по умолчанию	`12`
Минимальное значение	`0`
Максимальное значение	`12`

Количество попыток повторного подключения перед отказом.

--connect-retry-delay

Формат командной строки	`--connect-retry-delay=#`
Тип	Integer
Значение по умолчанию	`5`
Минимальное значение	`0`
Максимальное значение	`5`

Количество секунд ожидания между попытками связаться с сервером управления.

--connect-string

Формат командной строки --connect-string=connection_string

Тип String

Значение по умолчанию [none]

То же, что и --ndb-connectstring.
--core-file

Формат командной строки --core-file

Записать дамп памяти при ошибке; используется для отладки.
--defaults-extra-file

Формат командной строки --defaults-extra-file=path

Тип String

Значение по умолчанию [none]

Прочитать заданный файл после прочтения глобальных файлов.
--defaults-file

Формат командной строки --defaults-file=path

Тип String

Значение по умолчанию [none]

Прочитать параметры по умолчанию только из заданного файла.
--defaults-group-suffix

Формат командной строки --defaults-group-suffix=string

Тип String

Значение по умолчанию [none]

Также прочитать группы с concat(group, suffix).
--login-path

Формат командной строки --login-path=path

Тип String

Значение по умолчанию [none]

Прочитать заданный путь из файла входа.
--help

Формат командной строки --help

Отобразить справку и завершить работу.
--ndb-connectstring

Формат командной строки --ndb-connectstring=connection_string

Тип String

Значение по умолчанию [none]

Установить строку подключения для подключения к ndb_mgmd. Синтаксис: "[nodeid=id;][host=]hostname[:port]". Переопределяет записи в NDB_CONNECTSTRING и my.cnf.
--ndb-mgmd-host

Формат командной строки --ndb-mgmd-host=connection_string

Тип String

Значение по умолчанию [none]

То же, что и --ndb-connectstring.
--ndb-nodeid

Формат командной строки --ndb-nodeid=#

Тип Integer

Значение по умолчанию [none]

Установить идентификатор узла для этого узла, переопределяя любой идентификатор, установленный с помощью --ndb-connectstring.
--ndb-optimized-node-selection

Формат командной строки --ndb-optimized-node-selection

Включить оптимизацию выбора узлов для транзакций. Включено по умолчанию; используйте --skip-ndb-optimized-node-selection для отключения.
--no-contact, -n

Вместо ожидания состояния STARTED, ndb_waiter продолжает работу до тех пор, пока кластер не достигнет состояния NO_CONTACT перед выходом.
--no-defaults

Формат командной строки --no-defaults

Не читать параметры по умолчанию из любого файла параметров, кроме файла входа.
--not-started

Вместо ожидания состояния STARTED, ndb_waiter продолжает работу до тех пор, пока кластер не достигнет состояния NOT_STARTED перед выходом.
--nowait-nodes=list

При использовании этого параметра, ndb_waiter не ожидает узлы, идентификаторы которых указаны в списке. Список разделяется запятыми; диапазоны могут быть указаны с помощью тире, как показано здесь:
```
$> ndb_waiter --nowait-nodes=1,3,7-9
```
Важно

Не используйте этот параметр вместе с параметром --wait-nodes.
--print-defaults

Формат командной строки --print-defaults

Распечатать список аргументов программы и завершить работу.
--timeout=seconds, -t seconds

Время ожидания. Программа завершается, если желаемое состояние не достигнуто в течение этого количества секунд. Значение по умолчанию — 120 секунд (1200 циклов отчётности).
--single-user

Программа ожидает перехода кластера в режим одного пользователя.
--usage

Формат командной строки --usage

Отобразить справку и завершить работу; то же, что и --help.
--version

Формат командной строки --version

Отобразить информацию о версии и завершить работу.
--wait-nodes=list, -w list

При использовании этого параметра, ndb_waiter ожидает только узлы, идентификаторы которых указаны в списке. Список разделяется запятыми; диапазоны могут быть указаны с помощью тире, как показано здесь:
```
$> ndb_waiter --wait-nodes=2,4-6,10
```
Важно

Не используйте этот параметр вместе с параметром --nowait-nodes.

Формат командной строки	`--connect-string=connection_string`
Тип	String
Значение по умолчанию	`[none]`

Формат командной строки	`--core-file`

Формат командной строки	`--defaults-extra-file=path`
Тип	String
Значение по умолчанию	`[none]`

Формат командной строки	`--defaults-file=path`
Тип	String
Значение по умолчанию	`[none]`

Формат командной строки	`--defaults-group-suffix=string`
Тип	String
Значение по умолчанию	`[none]`

Формат командной строки	`--login-path=path`
Тип	String
Значение по умолчанию	`[none]`

Формат командной строки	`--help`

Формат командной строки	`--ndb-connectstring=connection_string`
Тип	String
Значение по умолчанию	`[none]`

Формат командной строки	`--ndb-mgmd-host=connection_string`
Тип	String
Значение по умолчанию	`[none]`

Формат командной строки	`--ndb-nodeid=#`
Тип	Integer
Значение по умолчанию	`[none]`

Формат командной строки	`--ndb-optimized-node-selection`

Формат командной строки	`--no-defaults`

Формат командной строки	`--print-defaults`

Формат командной строки	`--usage`

Формат командной строки	`--version`

Пример вывода. Здесь показан вывод команды ndb_waiter при запуске на кластере из 4 узлов, в котором два узла были остановлены, а затем запущены вручную. Повторные сообщения (указанные как ...) опушены.

$> ./ndb_waiter -c localhost

Connecting to mgmsrv at (localhost)
State node 1 STARTED
State node 2 NO_CONTACT
State node 3 STARTED
State node 4 NO_CONTACT
Waiting for cluster enter state STARTED

...

State node 1 STARTED
State node 2 UNKNOWN
State node 3 STARTED
State node 4 NO_CONTACT
Waiting for cluster enter state STARTED

...

State node 1 STARTED
State node 2 STARTING
State node 3 STARTED
State node 4 NO_CONTACT
Waiting for cluster enter state STARTED

...

State node 1 STARTED
State node 2 STARTING
State node 3 STARTED
State node 4 UNKNOWN
Waiting for cluster enter state STARTED

...

State node 1 STARTED
State node 2 STARTING
State node 3 STARTED
State node 4 STARTING
Waiting for cluster enter state STARTED

...

State node 1 STARTED
State node 2 STARTED
State node 3 STARTED
State node 4 STARTING
Waiting for cluster enter state STARTED

...

State node 1 STARTED
State node 2 STARTED
State node 3 STARTED
State node 4 STARTED
Waiting for cluster enter state STARTED

Примечание

Если строка подключения не указана, то ndb_waiter пытается подключиться к управлению по localhost и сообщает Connecting to mgmsrv at (null).

До версии NDB 7.5.18 и 7.6.14 эта программа печатала NDBT_ProgramExit - status по завершении выполнения из-за ненужной зависимости от библиотеки тестирования NDBT. Эта зависимость теперь удалена, что устраняет лишний вывод.