文档首页
MySQL 8.4 参考手册
相关文档 下载本手册
PDF (US Ltr) - 39.9Mb
PDF (A4) - 40.0Mb
手册页 (TGZ) - 258.5Kb
手册页 (Zip) - 365.5Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


MySQL 8.4 参考手册  /  ...  /  定义 NDB Cluster 管理服务器

25.4.3.5 定义 NDB Cluster 管理服务器

使用 [ndb_mgmd] 部分配置管理服务器的行为。如果使用多个管理服务器,您可以在 [ndb_mgmd default] 部分中指定所有管理服务器共有的参数。 [mgm][mgm default] 是这些参数的旧别名,为了向后兼容而保留。

以下列表中的所有参数都是可选的,如果省略,则假定其默认值。

注意

如果 ExecuteOnComputerHostName 参数都不存在,则假定两者都为默认值 localhost

  • Id

    版本(或更高版本) NDB 8.4.0
    类型或单位 无符号
    默认值 [...]
    范围 1 - 255
    重启类型

    初始系统重启: 需要完全关闭集群,从 备份 中擦除并恢复集群文件系统,然后重启集群。(NDB 8.4.0)

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

    注意

    数据节点 ID 必须小于 145。如果您计划部署大量数据节点,最好将管理节点(和 API 节点)的节点 ID 限制为大于 144 的值。

    使用 Id 参数识别管理节点已过时,现在建议使用 NodeId。尽管 Id 继续为了向后兼容而保留,但现在会生成警告,并且可能会在 NDB Cluster 的未来版本中删除。

  • NodeId

    版本(或更高版本) NDB 8.4.0
    类型或单位 无符号
    默认值 [...]
    范围 1 - 255
    重启类型

    初始系统重启: 需要完全关闭集群,从 备份 中擦除并恢复集群文件系统,然后重启集群。(NDB 8.4.0)

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

    注意

    数据节点 ID 必须小于 145。如果您计划部署大量数据节点,最好将管理节点(和 API 节点)的节点 ID 限制为大于 144 的值。

    NodeId 是识别管理节点时首选的参数名称。尽管旧的 Id 继续为了向后兼容而保留,但现在已过时,使用时会生成警告;它也可能会在 NDB Cluster 的未来版本中删除。

  • ExecuteOnComputer

    版本(或更高版本) NDB 8.4.0
    类型或单位 名称
    默认值 [...]
    范围 ...
    已过时 是(在 NDB 7.5 中)
    重启类型

    系统重启: 需要完全关闭并重启集群。(NDB 8.4.0)

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

    重要

    此参数已过时,并且可能会在未来版本中删除。请改用 HostName 参数。

  • PortNumber

    版本(或更高版本) NDB 8.4.0
    类型或单位 无符号
    默认值 1186
    范围 0 - 64K
    重启类型

    系统重启: 需要完全关闭并重启集群。(NDB 8.4.0)

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

  • 此节点的节点 ID 只能提供给明确请求它的连接。请求 任何 节点 ID 的管理服务器不能使用此节点 ID。当在同一主机上运行多个管理服务器时,可以使用此参数,并且 HostName 不足以区分各个进程。适用于测试。

  • HostName

    版本(或更高版本) NDB 8.4.0
    类型或单位 名称或 IP 地址
    默认值 [...]
    范围 ...
    重启类型

    节点重启: 需要对集群进行 滚动重启。(NDB 8.4.0)

    指定此参数定义管理节点所在的计算机的主机名。使用 HostName 指定除 localhost 以外的主机名。

  • LocationDomainId

    版本(或更高版本) NDB 8.4.0
    类型或单位 整数
    默认值 0
    范围 0 - 16
    重启类型

    系统重启: 需要完全关闭并重启集群。(NDB 8.4.0)

    将管理节点分配到云中的特定 可用性域(也称为可用性区域)。通过告知 NDB 哪个节点位于哪个可用性域中,可以在云环境中通过以下方式提高性能

    • 如果请求的数据未在同一节点上找到,则可以将读取操作定向到同一可用性域中的另一个节点。

    • 不同可用性域之间的节点之间的通信保证使用 NDB 传输器的 WAN 支持,无需任何进一步的手动干预。

    • 传输器的组号可以基于所用的可用性域,这样 SQL 和其他 API 节点也可以在可能的情况下与同一可用性域中的本地数据节点通信。

    • 仲裁器可以选择没有数据节点的可用性域,或者,如果没有这样的可用性域,可以选择第三个可用性域。

    LocationDomainId 接受 0 到 16(含)范围内的整数值,其中 0 为默认值;使用 0 等同于未设置此参数。

  • LogDestination

    版本(或更高版本) NDB 8.4.0
    类型或单位 {CONSOLE|SYSLOG|FILE}
    默认值 FILE: filename=ndb_nodeid_cluster.log, maxsize=1000000, maxfiles=6
    范围 ...
    重启类型

    节点重启: 需要对集群进行 滚动重启。(NDB 8.4.0)

    此参数指定发送集群日志信息的位置。在这方面有三种选择 - CONSOLESYSLOGFILE - 其中 FILE 为默认值

    • CONSOLE 将日志输出到 stdout

      CONSOLE
    • SYSLOG 将日志发送到 syslog 设施,可能的值之一为 authauthprivcrondaemonftpkernlprmailnewssysloguseruucplocal0local1local2local3local4local5local6local7

      注意

      并非所有操作系统都支持所有设施。

      SYSLOG:facility=syslog
    • FILE 将集群日志输出管道化到同一台机器上的一个常规文件。可以指定以下值

      • filename:日志文件的名称。

        在这种情况下,使用的默认日志文件名是 ndb_nodeid_cluster.log

      • maxsize:文件在日志记录滚动到新文件之前可以增长到的最大大小(以字节为单位)。发生这种情况时,将通过在文件名末尾追加 .N 来重命名旧日志文件,其中 N 是此名称尚未使用的下一个数字。

      • maxfiles:日志文件的最大数量。

      FILE:filename=cluster.log,maxsize=1000000,maxfiles=6

      FILE 参数的默认值为 FILE:filename=ndb_node_id_cluster.log,maxsize=1000000,maxfiles=6,其中 node_id 是节点的 ID。

    可以指定以分号分隔的多个日志目标,如下所示

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

    版本(或更高版本) NDB 8.4.0
    类型或单位 0-2
    默认值 1
    范围 0 - 2
    重启类型

    节点重启: 需要对集群进行 滚动重启。(NDB 8.4.0)

    此参数用于定义哪些节点可以充当仲裁器。只有管理节点和 SQL 节点可以充当仲裁器。 ArbitrationRank 可以取以下值之一

    • 0:该节点永远不会用作仲裁器。

    • 1:该节点具有高优先级;也就是说,它比低优先级节点更优先用作仲裁器。

    • 2:表示低优先级节点,仅当具有更高优先级的节点不可用于此目的时才会用作仲裁器。

    通常,管理服务器应通过将 ArbitrationRank 设置为 1(管理节点的默认值)并将其为所有 SQL 节点设置为 0(SQL 节点的默认值)来配置为仲裁器。

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

  • ArbitrationDelay

    版本(或更高版本) NDB 8.4.0
    类型或单位 毫秒
    默认值 0
    范围 0 - 4294967039 (0xFFFFFEFF)
    重启类型

    节点重启: 需要对集群进行 滚动重启。(NDB 8.4.0)

    一个整数值,导致管理服务器对仲裁请求的响应延迟该数量的毫秒。默认情况下,此值为 0;通常无需更改它。

  • DataDir

    版本(或更高版本) NDB 8.4.0
    类型或单位 路径
    默认值 .
    范围 ...
    重启类型

    节点重启: 需要对集群进行 滚动重启。(NDB 8.4.0)

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

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

  • PortNumberStats

    版本(或更高版本) NDB 8.4.0
    类型或单位 无符号
    默认值 [...]
    范围 0 - 64K
    重启类型

    节点重启: 需要对集群进行 滚动重启。(NDB 8.4.0)

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

  • Wan

    版本(或更高版本) NDB 8.4.0
    类型或单位 布尔值
    默认值 false
    范围 true, false
    重启类型

    节点重启: 需要对集群进行 滚动重启。(NDB 8.4.0)

    使用 WAN TCP 设置作为默认值。

  • HeartbeatThreadPriority

    版本(或更高版本) NDB 8.4.0
    类型或单位 字符串
    默认值 [...]
    范围 ...
    重启类型

    节点重启: 需要对集群进行 滚动重启。(NDB 8.4.0)

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

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

    HeartbeatThreadPriority = policy[, priority]
    
    policy:
      {FIFO | RR}

    设置此参数时,必须指定策略。它可以是 FIFO(先进先出)或 RR(循环轮询)之一。策略值之后可以选择跟上优先级(一个整数)。

  • ExtraSendBufferMemory

    版本(或更高版本) NDB 8.4.0
    类型或单位 字节
    默认值 0
    范围 0 - 32G
    重启类型

    节点重启: 需要对集群进行 滚动重启。(NDB 8.4.0)

    此参数指定要分配的传输器发送缓冲区内存量,除此之外,还可能已使用 TotalSendBufferMemorySendBufferMemory 或两者设置。

  • RequireTls

    版本(或更高版本) NDB 8.4.0
    类型或单位 布尔值
    默认值 false
    范围 ...
    重启类型

    节点重启: 需要对集群进行 滚动重启。(NDB 8.4.0)

    如果将此参数设置为 true,则客户端在连接到此管理节点后,必须使用 TLS 进行身份验证,然后才能将连接用于其他任何操作。

  • TotalSendBufferMemory

    版本(或更高版本) NDB 8.4.0
    类型或单位 字节
    默认值 0
    范围 256K - 4294967039 (0xFFFFFEFF)
    重启类型

    节点重启: 需要对集群进行 滚动重启。(NDB 8.4.0)

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

    如果设置此参数,则其允许的最小值为 256KB;0 表示未设置此参数。有关更多详细信息,请参见 第 25.4.3.14 节,“配置 NDB 集群发送缓冲区参数”

  • HeartbeatIntervalMgmdMgmd

    版本(或更高版本) NDB 8.4.0
    类型或单位 毫秒
    默认值 1500
    范围 100 - 4294967039 (0xFFFFFEFF)
    重启类型

    节点重启: 需要对集群进行 滚动重启。(NDB 8.4.0)

    指定心跳消息之间的间隔,用于确定另一个管理节点是否与该节点保持联系。管理节点在 3 个间隔后等待,以宣布连接已断开;因此,默认设置 1500 毫秒会导致管理节点等待大约 1600 毫秒,然后才会超时。

注意

在管理节点配置中进行更改后,必须对集群执行滚动重启,才能使新配置生效。

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

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

表 25.8 NDB 集群重启类型

符号 重启类型 说明
N 节点 可以使用滚动重启更新此参数(请参见 第 25.6.5 节,“执行 NDB 集群的滚动重启”
S 系统 所有集群节点必须完全关闭,然后重启,才能使此参数的更改生效
I 初始 数据节点必须使用 --initial 选项重启