Spec-Zone.ru › MySQL 8.4

25.5.31 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: Это отображается для всех узлов данных кластера, когда кластер находится в однопользовательском режиме.

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

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

ndb_waiter [-c connection_string]

Дополнительные опции

  • --character-sets-dir

    Формат командной строки --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

    Записать файл core при ошибке; используется для отладки.

  • --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]

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

  • --no-login-paths

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

    Пропускает чтение параметров из файла пути входа.

  • --help

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

    Отобразить справку и выйти.

  • --ndb-connectstring

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

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

  • --ndb-mgm-tls

    Формат командной строки --ndb-mgm-tls=level
    Тип Enumeration
    Значение по умолчанию relaxed
    Допустимые значения

    relaxed

    strict

    Устанавливает уровень поддержки TLS, необходимый для подключения к серверу управления; одно из relaxed или strict. relaxed (по умолчанию) означает, что попытка соединения TLS предпринимается, но успех не обязателен; strict означает, что для подключения требуется TLS.

  • --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 для отключения.

  • --ndb-tls-search-path

    Формат командной строки --ndb-tls-search-path=list
    Тип Имя пути
    Значение по умолчанию (Unix) $HOME/ndb-tls
    Значение по умолчанию (Windows) $HOMEDIR/ndb-tls

    Укажите список каталогов для поиска файла CA. В операционных системах Unix имена каталогов разделяются двоеточиями (:); в системах Windows используется символ точки с запятой (;) в качестве разделителя. Путь к каталогу может быть относительным или абсолютным; он может содержать одну или несколько переменных среды, каждая из которых обозначается префиксом доллара ($), и расширяется перед использованием.

    Поиск начинается с левого каталога и выполняется слева направо до тех пор, пока файл не будет найден. Пустая строка обозначает пустой путь поиска, что приводит к ошибке всех поисков. Строка, состоящая из одной точки (.), указывает, что путь поиска ограничен текущим каталогом.

    Если путь поиска не указан, используется значение по умолчанию, скомпилированное в программе. Это значение зависит от используемой платформы: в Windows это \ndb-tls; в других платформах (включая Linux) это $HOME/ndb-tls. Это можно изменить, скомпилировав NDB Cluster с помощью -DWITH_NDB_TLS_SEARCH_PATH.

  • --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

    Программа ожидает перехода кластера в режим single user.

  • --usage

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

    Вывести текст справки и завершить; то же, что и --help.

  • --verbose

    Формат командной строки --verbose=#
    Тип Целое число
    Значение по умолчанию 2
    Минимальное значение 0
    Максимальное значение 2

    Управляет уровнем подробности вывода. Возможные уровни и их эффекты перечислены здесь:

    • 0: Не печатать (возвращать только код выхода; см. ниже коды выхода).

    • 1: Печатать только конечное состояние соединения.

    • 2: Печатать состояние каждый раз, когда оно проверяется.

      Это поведение совпадает с версиями NDB Cluster до 8.4.

    Коды возврата ndb_waiter и их значения:

    • 0: Успех.

    • 1: Время ожидания истекло.

    • 2: Ошибка параметра, например, неверный идентификатор узла.

    • 3: Не удалось подключиться к серверу управления.

  • --version

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

    Вывести информацию о версии и завершить.

  • --wait-nodes=list, -w list

    При использовании этого параметра ndb_waiter ожидает только узлов, идентификаторы которых указаны в списке. Список разделен запятыми; диапазоны могут быть указаны дефисом, как показано здесь: 

    $> ndb_waiter --wait-nodes=2,4-6,10
    Важно

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

Пример вывода. Здесь показан вывод 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).

© 2025 Oracle
Licensed under the GPLv2 License.
https://docs.oracle.com/cd/E17952_01/mysql-8.4-en/mysql-cluster-programs-ndb-waiter.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API