18.4.3.5 定义 NDB Cluster 管理服务器

MySQL 8.0 参考手册 / 第 23 章 MySQL NDB Cluster 8.0 / 23.4 NDB Cluster的配置 / 23.4.3 NDB Cluster 配置文件 / 18.4.3.5 定义 NDB Cluster 管理服务器

18.4.3.5 定义 NDB Cluster 管理服务器

该[ndb_mgmd]部分用于配置管理服务器的行为。如果使用多个管理服务器，您可以在一个[ndb_mgmd default]部分中指定对所有服务器通用的参数。 [mgm]并且[mgm default] 是这些的旧别名，支持向后兼容。

以下列表中的所有参数都是可选的，如果省略则采用它们的默认值。

笔记

如果参数ExecuteOnComputer和 HostName参数都不存在，则localhost两者都采用默认值。

Id

版本（或更高版本）	新开发银行 7.3.1
类型或单位	未签名
默认	[...]
范围	1 - 255
重启类型	是（新开发银行 7.3.1）

集群中的每个节点都有唯一的标识。对于管理节点，这由 1 到 255（含）范围内的整数值表示。所有内部集群消息都使用此 ID 来寻址节点，因此无论节点类型如何，每个 NDB Cluster 节点都必须是唯一的。

笔记

数据节点 ID 必须小于 49。如果您计划部署大量数据节点，最好将管理节点（和 API 节点）的节点 ID 限制为大于 48 的值。

不推荐使用Id参数来标识管理节点，而推荐使用 NodeId。尽管 Id继续支持向后兼容，但它现在会生成警告，并且在 NDB Cluster 的未来版本中可能会被删除。

NodeId

版本（或更高版本）	新开发银行 7.3.1
类型或单位	未签名
默认	[...]
范围	1 - 255
重启类型	是（新开发银行 7.3.1）

笔记

数据节点 ID 必须小于 49。如果您计划部署大量数据节点，最好将管理节点（和 API 节点）的节点 ID 限制为大于 48 的值。

NodeId是识别管理节点时使用的首选参数名称。Id尽管继续支持旧版本以实现向后兼容性，但现在已弃用并在使用时生成警告；它也可能在未来的 NDB Cluster 版本中被删除。

ExecuteOnComputer

版本（或更高版本）	新开发银行 7.3.1
类型或单位	姓名
默认	[...]
范围	...
弃用	是（在 NDB 7.5 中）
重启类型	S（NDB 7.3.1）

这是指在文件的一部分中Id定义的其中一台计算机的集合。 [computer]config.ini

PortNumber

版本（或更高版本）	新开发银行 7.3.1
类型或单位	未签名
默认	1186
范围	0 - 64K
重启类型	S（NDB 7.3.1）

这是管理服务器侦听配置请求和管理命令的端口号。

HostName

版本（或更高版本）	新开发银行 7.3.1
类型或单位	名称或 IP 地址
默认	[...]
范围	...
重启类型	N（NDB 7.3.1）

指定此参数可定义管理节点所在计算机的主机名。要指定以外的主机名localhost，此参数或 ExecuteOnComputer是必需的。

LogDestination

版本（或更高版本）	新开发银行 7.3.1
类型或单位	{控制台\|系统日志\|文件}
默认	文件：文件名=ndb_nodeid_cluster.log，最大大小=1000000，最大文件=6
范围	...
重启类型	N（NDB 7.3.1）

此参数指定将集群日志记录信息发送到哪里。在这方面有三个选项— CONSOLE、 SYSLOG和 FILE—FILE 是默认选项：

CONSOLE将日志输出到 stdout：
```
CONSOLE
```
SYSLOG将日志发送到 syslog设施，可能的值是auth, authpriv, cron, daemon, ftp, kern, lpr, mail, news, syslog, user, uucp, local0, local1, local2, local3, local4, local5,local6或之一local7。

笔记

并非每个操作系统都必须支持每个设施。
```
SYSLOG:facility=syslog
```
FILE将集群日志输出通过管道传输到同一台机器上的常规文件。可以指定以下值：
- filename：日志文件的名称。
  在 NDB Cluster 7.3 及更高版本中，在这种情况下使用的默认日志文件名称是（在某些旧版本中，日志文件的默认名称，如果在没有设置的情况下指定，则为.）。 ndb_nodeid_cluster.logFILEfilenamelogger.log
- maxsize：在日志记录滚动到新文件之前文件可以增长到的最大大小（以字节为单位）。发生这种情况时，旧日志文件会通过附加 .N到文件名来重命名，其中N是尚未与该名称一起使用的下一个数字。
- maxfiles：日志文件的最大数量。
```
FILE:filename=cluster.log,maxsize=1000000,maxfiles=6
```
FILE 参数的默认值为，其中是节点的 ID。 FILE:filename=ndb_node_id_cluster.log,maxsize=1000000,maxfiles=6node_id

可以指定多个用分号分隔的日志目的地，如下所示：

CONSOLE;SYSLOG:facility=local0;FILE:filename=/var/log/mgmd

ArbitrationRank

版本（或更高版本）	新开发银行 7.3.1
类型或单位	0-2
默认	1个
范围	0 - 2
重启类型	N（NDB 7.3.1）

该参数用于定义哪些节点可以充当仲裁者。只有管理节点和 SQL 节点可以成为仲裁者。ArbitrationRank可以采用以下值之一：

0: 该节点从不用作仲裁员。
1：该节点具有高优先级；也就是说，它更适合作为低优先级节点的仲裁者。
2：表示低优先级节点，仅当具有较高优先级的节点不可用于该目的时才用作仲裁器。

通常，管理服务器应配置为仲裁器，方法是将其设置ArbitrationRank 为 1（管理节点的默认值），所有 SQL 节点的设置为 0（SQL 节点的默认值）。

ArbitrationRank您可以通过在所有管理和 SQL 节点上设置为 0 或通过在全局配置文件的部分中设置Arbitration 参数来完全禁用仲裁。设置会导致忽略任何设置。[ndbd default]config.iniArbitrationArbitrationRank

ArbitrationDelay

版本（或更高版本）	新开发银行 7.3.1
类型或单位	毫秒
默认	0
范围	0 - 4294967039 (0xFFFFFEFF)
重启类型	N（NDB 7.3.1）

一个整数值，它会导致管理服务器对仲裁请求的响应延迟该毫秒数。默认情况下，该值为 0；通常不需要更改它。

DataDir

版本（或更高版本）	新开发银行 7.3.1
类型或单位	小路
默认	.
范围	...
重启类型	N（NDB 7.3.1）

这指定放置来自管理服务器的输出文件的目录。这些文件包括集群日志文件、进程输出文件和守护进程的进程 ID (PID) 文件。（对于日志文件，可以通过设置FILE参数覆盖此位置， LogDestination如本节前面所述。）

此参数的默认值是ndb_mgmd所在的目录。

PortNumberStats

版本（或更高版本）	新开发银行 7.3.1
类型或单位	未签名
默认	[...]
范围	0 - 64K
重启类型	N（NDB 7.3.1）

此参数指定用于从 NDB Cluster 管理服务器获取统计信息的端口号。它没有默认值。

Wan

版本（或更高版本）	新开发银行 7.3.1
类型或单位	布尔值
默认	错误的
范围	真假
重启类型	N（NDB 7.3.1）

默认使用 WAN TCP 设置。

HeartbeatThreadPriority

版本（或更高版本）	新开发银行 7.3.1
类型或单位	细绳
默认	[...]
范围	...
重启类型	N（NDB 7.3.1）

为管理节点和API节点设置心跳线程的调度策略和优先级。

设置此参数的语法如下所示：

HeartbeatThreadPriority = policy[, priority]

policy:
  {FIFO | RR}

设置该参数时，必须指定策略。这是FIFO（先进先出）或 RR（循环法）之一。策略值后面可选择优先级（整数）。

ExtraSendBufferMemory

版本（或更高版本）	新开发银行 7.3.1
类型或单位	字节
默认	0
范围	0 - 32克
重启类型	N（NDB 7.3.1）

TotalSendBufferMemory此参数指定要分配的传输器发送缓冲区内存量，以及使用、 SendBufferMemory或两者设置的任何内存量。

TotalSendBufferMemory

版本（或更高版本）	新开发银行 7.3.1
类型或单位	字节
默认	0
范围	256K - 4294967039 (0xFFFFFEFF)
重启类型	N（NDB 7.3.1）

此参数用于确定要在此节点上分配的内存总量，用于所有已配置传输器之间的共享发送缓冲区内存。

如果设置了该参数，其最小允许值为256KB；0 表示该参数未设置。有关更多详细信息，请参阅第 18.4.3.12 节，“配置 NDB Cluster 发送缓冲区参数”。

HeartbeatIntervalMgmdMgmd

版本（或更高版本）	新开发银行 7.3.3
类型或单位	毫秒
默认	1500
范围	100 - 4294967039 (0xFFFFFEFF)
添加	新开发银行 7.3.3
重启类型	N（NDB 7.3.1）

指定用于确定另一个管理节点是否正在与该管理节点联系的心跳消息之间的间隔。管理节点在这些时间间隔中的 3 个之后等待以声明连接已死；因此，默认设置 1500 毫秒会导致管理节点在超时前等待大约 1600 毫秒。

NDB 7.3.3 中添加了此参数。（漏洞 #16426805）

MaxNoOfSavedEvents

版本（或更高版本）	新开发银行 7.3.1
类型或单位	未签名
默认	100
范围	0 - 4294967039 (0xFFFFFEFF)
重启类型	N（NDB 7.3.1）

不曾用过。

笔记

在对管理节点的配置进行更改后，需要执行集群的滚动重启以使新配置生效。

要将新的管理服务器添加到正在运行的 NDB Cluster，还需要在修改任何现有 config.ini文件后对所有集群节点执行滚动重启。有关使用多个管理节点时出现的问题的更多信息，请参阅第 18.2.7.10 节，“与多个 NDB Cluster 节点相关的限制”。

重启类型。 本节参数说明所使用的重启类型信息如下表所示：

表 18.7 NDB Cluster 重启类型

象征	重启类型	描述
否	节点	可以使用滚动重启更新参数（请参阅第 18.6.5 节，“执行 NDB Cluster 的滚动重启”）
小号	系统	所有集群节点必须完全关闭，然后重新启动，以影响此参数的更改
我	最初的	必须使用该 `--initial`选项重新启动数据节点