实际上,ndb_mgm 管理客户端进程并不需要运行集群。它的价值在于提供一组命令来检查集群的状态,启动备份,以及执行其他管理功能。管理客户端使用 C API 访问管理服务器。高级用户也可以使用此 API 为类似于 ndb_mgm 所执行的任务编程专用管理进程。
要启动管理客户端,需要提供管理服务器的主机名和端口号。
$> ndb_mgm [host_name [port_num]]
例如:
$> ndb_mgm ndb_mgmd.mysql.com 1186
默认的主机名和端口号分别是 localhost
和 1186。
以下表格显示了可以与 ndb_mgm 一起使用的所有选项。表后还有更多描述。
--backup-password-from-stdin[=TRUE|FALSE]
命令行格式 --backup-password-from-stdin
此选项在使用
--execute "START BACKUP"
或类似命令创建备份时,允许从系统 shell (stdin
) 输入备份密码。使用此选项需要同时使用--execute
。-
命令行格式 --character-sets-dir=path
包含字符集的目录。
-
命令行格式 --connect-retries=#
类型 数值 默认值 3
最小值 0
最大值 4294967295
此选项指定在放弃之前(客户端总是至少尝试一次连接)在第一次尝试连接后重试连接的次数。每次尝试等待的时间长度由
--connect-retry-delay
设置。此选项与
--try-reconnect
选项同义,后者现已弃用。 -
命令行格式 --connect-retry-delay=#
类型 整数 默认值 5
最小值 0
最大值 5
尝试联系管理服务器之间等待的秒数。
-
命令行格式 --connect-string=connection_string
类型 字符串 默认值 [无]
与
--ndb-connectstring
相同。 -
命令行格式 --core-file
在发生错误时写入核心文件;用于调试。
-
命令行格式 --defaults-extra-file=path
类型 字符串 默认值 [无]
读取全局文件读取后的给定文件。
-
命令行格式 --defaults-file=path
类型 字符串 默认值 [无]
仅从给定文件读取默认选项。
-
命令行格式 --defaults-group-suffix=string
类型 字符串 默认值 [无]
也读取具有 concat(group, suffix) 的组。
-
命令行格式 --encrypt-backup
使用此选项时,所有备份都将被加密。为了在每次运行 ndb_mgm 时执行此操作,请将该选项放在
my.cnf
文件的[ndb_mgm]
部分。 --execute=
,command
-e
command
命令行格式 --execute=command
此选项可用于将命令从系统 shell 发送到 NDB Cluster 管理客户端。例如,以下任一命令等同于在管理客户端中执行
SHOW
$> ndb_mgm -e "SHOW" $> ndb_mgm --execute="SHOW"
这类似于
--execute
或-e
选项如何与 mysql 命令行客户端一起工作。参见 第 6.2.2.1 节“在命令行上使用选项”。注意如果要使用此选项传递的管理客户端命令包含任何空格字符,那么该命令必须用引号括起来。可以使用单引号或双引号。如果管理客户端命令不包含空格字符,则引号是可选的。
-
命令行格式 --help
显示帮助文本并退出。
-
命令行格式 --login-path=path
类型 字符串 默认值 [无]
从登录文件中读取给定路径。
-
命令行格式 --no-login-paths
跳过从登录路径文件读取选项。
-
命令行格式 --ndb-connectstring=connection_string
类型 字符串 默认值 [无]
设置连接到 ndb_mgmd 的连接字符串。语法:[
nodeid=
][id
;host=
]
[hostname
:
]。覆盖port
NDB_CONNECTSTRING
和my.cnf
中的条目。 -
命令行格式 --ndb-nodeid=#
类型 整数 默认值 [无]
设置此节点的节点 ID,覆盖由
--ndb-connectstring
设置的任何 ID。 -
命令行格式 --ndb-mgm-tls=level
类型 枚举 默认值 relaxed
有效值 relaxed
strict
设置连接到管理服务器所需的 TLS 支持级别;
relaxed
或strict
之一。relaxed
(默认)表示会尝试建立 TLS 连接,但不要求成功;strict
表示连接需要 TLS。 -
命令行格式 --ndb-mgmd-host=connection_string
类型 字符串 默认值 [无]
与
--ndb-connectstring
相同。 --ndb-optimized-node-selection
命令行格式 --ndb-optimized-node-selection
启用针对事务节点选择的优化。默认情况下已启用;使用
--skip-ndb-optimized-node-selection
禁用。-
命令行格式 --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-defaults
不要从除登录文件以外的任何选项文件读取默认选项。
-
命令行格式 --print-defaults
打印程序参数列表并退出。
-
命令行格式 --test-tls
使用 TLS 连接,然后退出。如果成功,输出类似于这里显示的内容。
>$ ndb_mgm --test-tls Connected to Management Server at: sakila:1186 >$
有关更多信息,参见 第 25.6.15 节“NDB Cluster 的 TLS 链接加密”。
-
命令行格式 --try-reconnect=#
已弃用 是 类型 数值 类型 整数 默认值 12
默认值 3
最小值 0
最大值 4294967295
如果与管理服务器的连接断开,节点将每 5 秒尝试重新连接到它,直到成功。通过使用此选项,可以将尝试次数限制为
number
,然后再放弃并报告错误。此选项已弃用,将在未来版本中删除。请改用
--connect-retries
。 -
命令行格式 --usage
显示帮助文本并退出;与
--help
相同。 -
命令行格式 --version
显示版本信息并退出。
有关使用 ndb_mgm 的更多信息,请参见 第 25.6.1 节“NDB Cluster 管理客户端中的命令”。