概述

本章，您将学习管理节点中主要使用的命令以及相关选项。

管理节点主要涉及到 ndb_mgmd 和 ndb_mgm 这两个命令。

ndb_mgmd 命令

该命令是一个进程，其需要读取全局配置文件 config.ini，并在之后将信息分发给请求该信息的群集中的所有节点进程。

常用选项如下：

• --bind-address=host - 管理节点绑定的主机名或 IP 地址。选项值类型为字符串且无默认值
• --config-cache[=TRUE|FALSE] - 是否启用管理服务器的配置缓存。选项值类型为布尔类型且默认为 true
• --config-file=file 或 -f file - 指定全局配置文件
• --config-dir=directory - 指定管理服务器的配置缓存目录（必须为绝对路径）。默认值为 $INSTALLDIR/mysql-cluster
• --daemon 或 -d - 是否以守护进程的方式运行 ndb_mgmd 进程，默认启用该选项（即使未在终端中指定）
• --initial - 初始化操作的选项，初始化指的是强制服务器删除任何现有的缓存文件，并从全局配置文件（config.ini）中重新读取配置且构建一个新的缓存
• --ndb-nodeid=# - 设置该节点的节点 ID。选项值类型为整数
• --print-defaults - 打印程序的参数列表并退出
• --reload - 当配置文件与缓存不匹配时重新加载配置

ndb_mgm 命令

该命令是 NDB Cluster 的管理客户端，它主要用来检查集群的状态、启动与备份、其他管理功能等。

前面见过了：

Shell(192.168.100.10) > ndb_mgm
-- NDB Cluster -- Management Client --

ndb_mgm> show
Connected to management server at localhost port 1186 (using cleartext)
Cluster Configuration
---------------------
[ndbd(NDB)]     2 node(s)
id=2    @192.168.100.12  (mysql-8.4.8 ndb-8.4.8, Nodegroup: 0, *)
id=3    @192.168.100.14  (mysql-8.4.8 ndb-8.4.8, Nodegroup: 0)

[ndb_mgmd(MGM)] 1 node(s)
id=1    @192.168.100.10  (mysql-8.4.8 ndb-8.4.8)

[mysqld(API)]   1 node(s)
id=4    @192.168.100.16  (mysql-8.4.8 ndb-8.4.8)

ndb_mgm> quit

该命令的用法为 —— ndb_mgm [host_name] [port_num]

常见选项如下：

• --backup-password-from-stdin[=TRUE|FALSE] - 创建备份时，是否从标准输入（stdin）中输入密码
• --execute=command - 在命令上执行交互命令，如 ndb_mgm -e "show"
• --ndb-nodeid=# - 设置该节点的节点 ID。选项值类型为整数
• --print-defaults - 打印程序的参数列表并退出

ndb_mgm 的常见交互命令如下：

• show - 显示有关集群和集群节点的基本信息。对于所有节点，它的输出包括：节点的ID、类型与软件版本。如果节点已经连接，则还会显示其 IP 地址；如果节点未连接，则会显示 "not connected, accepting connect from any host"。对于数据节点，还会显示节点组（node group），* 表示这是数据节点中的主节点

• create nodegroup nodeid[,nodeid,...] - 针对数据节点，创建一个新的 NDB Cluster 节点组，并使其中的数据节点加入到该节点组中。创建的新节点组的 ID 自动确定，不能手动设置。每个 NDB Cluster 节点组的数量必须一致，换句话说，如果 NDB Cluster 由 2 个节点组组成，每个节点组有 2 个数据节点，那么新的节点组也必须有 2 个数据节点

• drop nodegroup nodegroup_id - 针对数据节点，删除指定了节点组 ID 的 NDB Cluster 节点组。仅在节点组中所有的数据节点完全没有任何表数据和表定义时，才生效

• enter single user mode node_id - 针对 SQL 节点，指定节点 ID 后进入到单用户模式。show 命令的输出可以看到单用户模式

• exit single user mode - 针对 SQL 节点，退出单用户模式并启用所有的 SQL 节点

• prompt [string] - 变更终端提示符。示例如下：

  ndb_mgm> PROMPT mgm#1:
  mgm#1: SHOW
  Cluster Configuration
  ...
  mgm#1: PROMPT mymgm >
  mymgm > PROMPT 'mymgm:'
  'mymgm:' PROMPT  mymgm:
  mymgm: PROMPT
  ndb_mgm> 

• quit 或 exit - 退出交互终端

• node_id report report-type - 针对数据节点，获取节点的报告信息。report-type 可以是：BackupStatus、MemoryUsage、EventLog。例如，获取所有数据节点的内存使用信息报告：

  ndb_mgm> all report memoryusage

• help - 帮助信息

• help command - 打印具体交互命令的帮助信息

• shutdown - 关闭所有的数据节点与管理节点（不会关闭任何 SQL 节点）

• node_id start - 针对数据节点，将指定的 node_id 或所有数据节点联机在线

• node_id status - 针对数据节点，查看指定的 node_id 或所有数据节点的状态

• node_id stop [-a] [-f] - 针对数据节点，将指定的 node_id 或所有数据节点停止

• node_id restart [-n] [-i] [-a] [-f] - 针对数据节点，重启指定的 node_id 或者所有数据节点

• start backup [backup_id] [encryption_option] [wait_option] [snapshot_option] - 创建备份。相关选项说明如下：

  encryption_option:
  ENCRYPT [PASSWORD=password]
  
  password:
  {'password_string' | "password_string"}
  
  wait_option:
  WAIT {STARTED | COMPLETED} | NOWAIT
  
  snapshot_option:
  SNAPSHOTSTART | SNAPSHOTEND

  创建备份是连续的，因此有独一无二的备份标识符（也就是 backup_id），它是一个大于等于 1 的整数。backup_id 选项是可选的，若忽略，则自动使用可用的值。通常而言，创建备份建议使用密码进行加密。

赞赏