MySQL :: MySQL 8.3 Reference Manual :: 25.5.31 ndb_waiter — Wait for NDB Cluster to Reach a Given Status

version 8.3

8.0 current
5.7

8.0 Japanese

MySQL 8.3 Reference Manual / ... / ndb_waiter — Wait for NDB Cluster to Reach a Given Status

25.5.31 ndb_waiter — 等待 NDB 集群达到给定状态

ndb_waiter 重复（每 100 毫秒）打印出所有集群数据节点的状态，直到集群达到给定状态或超时限制被超过，然后退出。默认情况下，它等待集群达到 STARTED 状态，在该状态下所有节点都已启动并连接到集群中。这可以使用 --no-contact 和 --not-started 选项来覆盖。

该实用程序报告的节点状态如下：

NO_CONTACT：无法联系到节点。
UNKNOWN：可以联系到节点，但其状态尚未知。通常，这意味着节点已经从管理服务器接收到 START 或 RESTART 命令，但尚未采取行动。
NOT_STARTED：节点已经停止，但仍然与集群保持联系。这是在使用管理客户端的 RESTART 命令重启节点时看到的。
STARTING：节点的 ndbd 进程已经启动，但节点尚未加入集群。
STARTED：节点已经启动并加入了集群。
SHUTTING_DOWN：节点正在关闭。
SINGLE USER MODE：这是在集群处于单用户模式时显示的所有集群数据节点。

可以与 ndb_waiter 一起使用的选项在下表中显示。以下是表格的详细描述。

表 25.51 使用 ndb_waiter 程序的命令行选项

Format	Description	Added, Deprecated, or Removed
`--connect-retries=#`	在放弃之前重试连接的次数	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--connect-retry-delay=#`	在尝试联系管理服务器之间等待的秒数	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--connect-string=connection_string`, `-c connection_string`	与 --ndb-connectstring 相同	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--defaults-extra-file=path`	在读取全局文件后读取给定的文件	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--defaults-file=path`	仅从给定的文件中读取默认选项	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--defaults-group-suffix=string`	也读取带有 concat(group, suffix) 的组	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--help`, `-?`	显示帮助文本并退出	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--login-path=path`	从登录文件中读取给定的路径	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--no-login-paths`	不从登录路径文件中读取登录路径	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--ndb-connectstring=connection_string`, `-c connection_string`	设置连接字符串以连接到 ndb_mgmd。语法："[nodeid=id;][host=]hostname[:port]"。覆盖 NDB_CONNECTSTRING 和 my.cnf 中的条目	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--ndb-mgm-tls=level`	ndb_mgm 客户端 TLS 要求级别	ADDED: 8.3.0
`--ndb-mgmd-host=connection_string`, `-c connection_string`	与 --ndb-connectstring 相同	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--ndb-tls-search-path=list`	包含 TLS 密钥和证书的目录列表	ADDED: 8.3.0
`--no-contact`, `-n`	等待集群达到 NO CONTACT 状态	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--no-defaults`	不从任何选项文件中读取默认选项，除了登录文件	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--not-started`	等待集群达到 NOT STARTED 状态	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--nowait-nodes=list`	不等待的节点列表	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--print-defaults`	打印程序参数列表并退出	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--single-user`	等待集群进入单用户模式	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--timeout=#`, `-t #`	等待这么多秒，然后退出，不管集群是否达到所需状态	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--usage`, `-?`	显示帮助文本并退出；与 --help 相同	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--version`, `-V`	显示版本信息并退出	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--wait-nodes=list`, `-w list`	要等待的节点列表	(在所有基于 MySQL 8.3 的 NDB 版本中支持)

使用

ndb_waiter [-c connection_string]

附加选项

--字符集目录

Command-Line Format	`--字符集目录=path`

包含字符集的目录。

--连接重试次数

Command-Line Format	`--连接重试次数=#`
Type	整数
Default Value	`12`
Minimum Value	`0`
Maximum Value	`12`

在放弃之前重试连接的次数。

--连接重试延迟

Command-Line Format	`--连接重试延迟=#`
Type	整数
Default Value	`5`
Minimum Value	`0`
Maximum Value	`5`

在尝试联系管理服务器之间等待的秒数。

--连接字符串

Command-Line Format	`--连接字符串=connection_string`
Type	字符串
Default Value	`[none]`

与 --ndb-connectstring相同。

--核心文件

Command-Line Format	`--核心文件`

在错误时写入核心文件；用于调试。

--额外默认文件

Command-Line Format	`--额外默认文件=path`
Type	字符串
Default Value	`[none]`

在全局文件读取后读取给定的文件。

--默认文件

Command-Line Format	`--默认文件=path`
Type	字符串
Default Value	`[none]`

仅从给定的文件读取默认选项。

--默认组后缀

Command-Line Format	`--默认组后缀=string`
Type	字符串
Default Value	`[none]`

也读取带有后缀的组。

--登录路径

Command-Line Format	`--登录路径=path`
Type	字符串
Default Value	`[none]`

从登录文件读取给定的路径。

--不使用登录路径

Command-Line Format	`--不使用登录路径`

跳过从登录路径文件读取选项。

--帮助

Command-Line Format	`--帮助`

显示帮助文本并退出。

--NDB连接字符串

Command-Line Format	`--NDB连接字符串=connection_string`
Type	字符串
Default Value	`[none]`

设置连接到 ndb_mgmd 的连接字符串。语法：[nodeid=id;][host=]hostname[:port]。覆盖 NDB_CONNECTSTRING 和 my.cnf 中的条目。

--NDB管理TLS

Command-Line Format	`--NDB管理TLS=level`
Type	枚举
Default Value	`relaxed`
Valid Values	`松散` `严格`

设置连接管理服务器所需的 TLS 支持级别；可以是 松散 或 严格。松散（默认）表示尝试 TLS 连接，但不要求成功：严格 表示需要 TLS 连接。

--ndb-mgmd-host

Command-Line Format	`--ndb-mgmd-host=connection_string`
Type	字符串
Default Value	`[none]`

与 --ndb-connectstring 相同。

--ndb-nodeid

Command-Line Format	`--ndb-nodeid=#`
Type	整数
Default Value	`[none]`

设置此节点的节点 ID，覆盖 --ndb-connectstring 设置的 ID。

--ndb-optimized-node-selection

Command-Line Format	`--ndb-optimized-node-selection`

启用事务节点选择的优化。默认启用；使用 --skip-ndb-optimized-node-selection 禁用。

--ndb-tls-search-path

Command-Line Format	`--ndb-tls-search-path=list`
Type	路径名
Default Value (Unix)	`$HOME/ndb-tls`
Default Value (Windows)	`$HOMEDIR/ndb-tls`

指定要搜索 CA 文件的目录列表。在 Unix 平台上，目录名用冒号 (:) 分隔；在 Windows 系统上，分号字符 (;) 用作分隔符。目录引用可以是相对的或绝对的，可以包含一个或多个环境变量，每个变量以美元符号 ($) 开头，并在使用前展开。

搜索从左到右进行，直到找到文件。空字符串表示空搜索路径，导致所有搜索失败。点 (.) 表示搜索路径仅限于当前工作目录。

如果未提供搜索路径，将使用编译时的默认值。该值取决于平台：在 Windows 上是 \ndb-tls；在其他平台（包括 Linux）上是 $HOME/ndb-tls。这可以通过使用 -DWITH_NDB_TLS_SEARCH_PATH 编译 NDB Cluster 来覆盖。

--no-contact, -n

而不是等待 STARTED 状态，ndb_waiter 继续运行，直到集群达到 NO_CONTACT 状态后退出。

--no-defaults

Command-Line Format	`--no-defaults`

不从任何选项文件中读取默认选项，除了登录文件。

--not-started

而不是等待 STARTED 状态，ndb_waiter 继续运行，直到集群达到 NOT_STARTED 状态后退出。
--nowait-nodes=list

当使用此选项时，ndb_waiter 不等待其 ID 在列表中的节点。列表以逗号分隔；范围可以用破折号表示，如下所示：
```
$> ndb_waiter --nowait-nodes=1,3,7-9
```
Important

不要将此选项与 --wait-nodes 选项一起使用。

--print-defaults

Command-Line Format	`--print-defaults`

打印程序参数列表并退出。

--timeout=秒, -t 秒

等待时间。如果在指定的秒数内未达到所需状态，则程序退出。默认为 120 秒（1200 报告周期）。
--single-user

程序等待集群进入单用户模式。

--usage

Command-Line Format	`--usage`

显示帮助文本并退出；与 --help相同。

--version

Command-Line Format	`--version`

显示版本信息并退出。

--wait-nodes=列表, -w 列表

当使用此选项时，ndb_waiter 只等待其 ID 在列表中的节点。列表以逗号分隔；范围可以用破折号表示，如下所示：
```
$> ndb_waiter --wait-nodes=2,4-6,10
```
Important

不要将此选项与 --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

Note

如果未指定连接字符串，则 ndb_waiter 尝试连接到 localhost 上的管理服务器，并报告 Connecting to mgmsrv at (null)。

PREV HOME UP NEXT