文档首页
MySQL 9.0 参考手册
相关文档 下载本手册
PDF (US Ltr) - 40.0Mb
PDF (A4) - 40.1Mb
手册页 (TGZ) - 258.2Kb
手册页 (Zip) - 365.3Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


MySQL 9.0 参考手册  /  ...  /  ndb_waiter — 等待 NDB Cluster 达到指定状态

25.5.31 ndb_waiter — 等待 NDB Cluster 达到指定状态

ndb_waiter 会反复(每隔 100 毫秒)打印所有集群数据节点的状态,直到集群达到指定状态或超过 --timeout 限制,然后退出。默认情况下,它等待集群达到 STARTED 状态,在此状态下所有节点都已启动并连接到集群。可以使用 --no-contact--not-started 选项来覆盖此行为。

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

  • NO_CONTACT: 无法联系到节点。

  • UNKNOWN: 可以联系到节点,但其状态尚不清楚。通常,这意味着节点已从管理服务器接收到 STARTRESTART 命令,但尚未执行该命令。

  • 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=#
    类型 整数
    默认值 12
    最小值 0
    最大值 12

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

  • --connect-retry-delay

    命令行格式 --connect-retry-delay=#
    类型 整数
    默认值 5
    最小值 0
    最大值 5

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

  • --connect-string

    命令行格式 --connect-string=connection_string
    类型 字符串
    默认值 [无]

    --ndb-connectstring 相同。

  • --core-file

    命令行格式 --core-file

    在发生错误时写入核心文件;用于调试。

  • --defaults-extra-file

    命令行格式 --defaults-extra-file=path
    类型 字符串
    默认值 [无]

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

  • --defaults-file

    命令行格式 --defaults-file=path
    类型 字符串
    默认值 [无]

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

  • --defaults-group-suffix

    命令行格式 --defaults-group-suffix=string
    类型 字符串
    默认值 [无]

    还读取具有 concat(group, suffix) 的组。

  • --login-path

    命令行格式 --login-path=path
    类型 字符串
    默认值 [无]

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

  • --no-login-paths

    命令行格式 --no-login-paths

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

  • --help

    命令行格式 --help

    显示帮助文本并退出。

  • --ndb-connectstring

    命令行格式 --ndb-connectstring=connection_string
    类型 字符串
    默认值 [无]

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

  • --ndb-mgm-tls

    命令行格式 --ndb-mgm-tls=level
    类型 枚举
    默认值 relaxed
    有效值

    relaxed

    strict

    设置连接到管理服务器所需的 TLS 支持级别;relaxedstrict 之一。 relaxed(默认)表示尝试建立 TLS 连接,但不需要成功; strict 表示需要 TLS 才能连接。

  • --ndb-mgmd-host

    命令行格式 --ndb-mgmd-host=connection_string
    类型 字符串
    默认值 [无]

    与 --ndb-connectstring 相同。

  • --ndb-nodeid

    命令行格式 --ndb-nodeid=#
    类型 整数
    默认值 [无]

    设置此节点的节点 ID,覆盖 --ndb-connectstring 设置的任何 ID。

  • --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。这可以通过使用 -DWITH_NDB_TLS_SEARCH_PATH 编译 NDB Cluster 来覆盖。

  • --no-contact, -n

    与等待 STARTED 状态不同,ndb_waiter 会继续运行,直到集群达到 NO_CONTACT 状态,然后退出。

  • --no-defaults

    命令行格式 --no-defaults

    不要从登录文件以外的任何选项文件中读取默认选项。

  • --not-started

    与等待 STARTED 状态不同,ndb_waiter 会继续运行,直到集群达到 NOT_STARTED 状态,然后退出。

  • --nowait-nodes=list

    使用此选项时,ndb_waiter 不会等待列出的 ID 的节点。该列表用逗号分隔;范围可以用连字符表示,如这里所示

    $> 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 相同。

  • --verbose

    命令行格式 --verbose=#
    类型 整数
    默认值 2
    最小值 0
    最大值 2

    控制打印的详细程度。这里列出了可能的级别及其效果

    • 0: 不要打印(仅返回退出代码;请参阅以下内容了解退出代码)。

    • 1: 仅打印最终连接状态。

    • 2: 每次检查状态时打印状态。

      这与 8.4 之前版本的 NDB Cluster 中的行为相同。

    这里列出了 ndb_waiter 返回的退出代码及其含义

    • 0: 成功。

    • 1: 等待超时。

    • 2: 参数错误,例如无效的节点 ID。

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