Documentation Home
MySQL 8.3 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 40.8Mb
PDF (A4) - 40.9Mb
Man Pages (TGZ) - 294.0Kb
Man Pages (Zip) - 409.0Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb
Excerpts from this Manual

MySQL 8.3 Reference Manual  /  ...  /  Defining an NDB Cluster Management Server

25.4.3.5 定义 NDB 集群管理服务器

[ndb_mgmd] 部分用于配置管理服务器的行为。如果使用多个管理服务器,可以在 [ndb_mgmd default] 部分中指定通用参数。[mgm][mgm default] 是旧的别名,用于向后兼容。

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

Note

如果既没有 ExecuteOnComputer 也没有 HostName 参数,则默认值为 localhost

  • Id

    Version (or later) NDB 8.3.0
    Type or units 无符号整数
    Default [...]
    Range 1 - 255
    Restart Type

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

    每个集群节点都有一个唯一的身份。对于管理节点,这是一个介于 1 到 255 之间的整数值,包括两端。这 ID 用于所有内部集群消息来寻址节点,因此必须对每个 NDB 集群节点唯一,不管节点类型。

    Note

    数据节点 ID 必须小于 145。如果您计划部署大量数据节点,建议将管理节点(和 API 节点)的节点 ID 限制在 144 以上。

    使用 Id 参数来标识管理节点现在已弃用,建议使用 NodeId。虽然 Id 仍然支持向后兼容,但现在生成警告,并且可能在未来 NDB 集群版本中删除。

  • NodeId

    Version (or later) NDB 8.3.0
    Type or units 无符号整数
    Default [...]
    Range 1 - 255
    Restart Type

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

    每个集群节点都有一个唯一的身份。对于管理节点,这是一个介于 1 到 255 之间的整数值,包括两端。这 ID 用于所有内部集群消息来寻址节点,因此必须对每个 NDB 集群节点唯一,不管节点类型。

    Note

    数据节点 ID 必须小于 145。如果您计划部署大量数据节点,建议将管理节点(和 API 节点)的节点 ID 限制在 144 以上。

    NodeId 是标识管理节点的首选参数名称。虽然旧的 Id 仍然支持向后兼容,但现在弃用并生成警告,并且可能在未来 NDB 集群版本中删除。

  • ExecuteOnComputer

    Version (or later) NDB 8.3.0
    Type or units 名称
    Default [...]
    Range ...
    Deprecated 是 (NDB 7.5)
    Restart Type

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

    这指的是在 config.ini 文件的 [computer] 部分中设置的 Id。

    Important

    该参数已弃用,并且可能在未来版本中删除。请使用 HostName 参数代替。

  • PortNumber

    Version (or later) NDB 8.3.0
    Type or units 无符号整数
    Default 1186
    Range 0 - 64K
    Restart Type

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

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

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

  • 主机名

    Version (or later) NDB 8.3.0
    Type or units 名称或IP地址
    Default [...]
    Range ...
    Restart Type

    节点重启: 需要集群的 滚动重启。(NDB 8.3.0)

    指定这个参数定义管理节点所在的计算机的主机名。使用 HostName 指定一个不同于 localhost 的主机名。

  • LocationDomainId

    Version (or later) NDB 8.3.0
    Type or units 整数
    Default 0
    Range 0 - 16
    Restart Type

    系统重启: 需要集群的完全关闭和重启。(NDB 8.3.0)

    将管理节点分配给特定的 可用性域(也称为可用性区域)内的云环境中。通过告知 NDB 哪些节点在哪些可用性域中,性能可以在云环境中以以下方式改善:

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

    • 不同可用性域之间的节点通信保证使用 NDB 传输器的 WAN 支持,而不需要手动干预。

    • 传输器的组号可以基于哪个可用性域被使用,以便 SQL 和其他 API 节点与同一个可用性域中的本地数据节点通信。

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

    LocationDomainId 取一个介于 0 和 16 之间的整数值,包括 0,使用 0 与不设置参数相同。

  • LogDestination

    Version (or later) NDB 8.3.0
    Type or units {CONSOLE|SYSLOG|FILE}
    Default FILE: filename=ndb_nodeid_cluster.log, maxsize=1000000, maxfiles=6
    Range ...
    Restart Type

    节点重启: 需要集群的 滚动重启。(NDB 8.3.0)

    该参数指定集群日志信息的目标位置。有三个选项—CONSOLESYSLOGFILE,其中 FILE 是默认值:

    • CONSOLE 将日志输出到 stdout

      CONSOLE
    • SYSLOG 将日志发送到 syslog 设施,可能的值是 authauthprivcrondaemonftpkernlprmailnewssysloguseruucplocal0local1local2local3local4local5local6

      Note

      并不是每个操作系统都支持所有设施。

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

      • filename: 日志文件的名称。

        默认日志文件名用于这种情况是 ndb_nodeid_cluster.log

      • maxsize: 文件的最大大小(以字节为单位),文件达到该大小时日志将滚动到一个新文件中。当这种情况发生时,旧日志文件将被重命名为 .N,其中 N 是下一个未使用的文件名。

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

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

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

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

    CONSOLE;SYSLOG:facility=local0;FILE:filename=/var/log/mgmd
  • 仲裁排名

    Version (or later) NDB 8.3.0
    Type or units 0-2
    Default
    Range 0 - 2
    Restart Type

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

    该参数用于定义哪些节点可以作为仲裁者。只有管理节点和 SQL 节点可以作为仲裁者。仲裁排名可以取以下值:

    • 0:节点永远不作为仲裁者。

    • 1:节点具有高优先级,即它优先于低优先级节点作为仲裁者。

    • 2:表示低优先级节点,仅在高优先级节点不可用时作为仲裁者。

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

    您可以完全禁用仲裁,方法是将所有管理和 SQL 节点的 仲裁排名 设置为 0,或者在 [ndbd default] 部分的 config.ini 全局配置文件中设置 仲裁 参数。设置 仲裁 将忽略 仲裁排名 的任何设置。

  • 仲裁延迟

    Version (or later) NDB 8.3.0
    Type or units 毫秒
    Default 0
    Range 0 - 4294967039 (0xFFFFFEFF)
    Restart Type

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

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

  • 数据目录

    Version (or later) NDB 8.3.0
    Type or units 路径
    Default .
    Range ...
    Restart Type

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

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

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

  • 端口号统计

    Version (or later) NDB 8.3.0
    Type or units 无符号整数
    Default [...]
    Range 0 - 64K
    Restart Type

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

    该参数指定了从 NDB 集群管理服务器获取统计信息的端口号。它没有默认值。

  • WAN

    Version (or later) NDB 8.3.0
    Type or units 布尔值
    Default false
    Range true, false
    Restart Type

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

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

  • 心跳线程优先级

    Version (or later) NDB 8.3.0
    Type or units 字符串
    Default [...]
    Range ...
    Restart Type

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

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

    设置该参数的语法如下所示:

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

    设置此参数时,必须指定策略。这是 FIFO(先进先出)或 RR(轮询)。策略值后面可以选择性地跟随优先级(一个整数)。

  • ExtraSendBufferMemory

    Version (or later) NDB 8.3.0
    Type or units 字节
    Default 0
    Range 0 - 32G
    Restart Type

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

    该参数指定了在 addition to 任何使用 TotalSendBufferMemorySendBufferMemory 或两者设置的 transporter 发送缓冲区内存。

  • RequireTls

    Version (or later) NDB 8.3.0
    Type or units 布尔值
    Default false
    Range ...
    Added NDB
    Restart Type

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

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

  • TotalSendBufferMemory

    Version (or later) NDB 8.3.0
    Type or units 字节
    Default 0
    Range 256K - 4294967039 (0xFFFFFEFF)
    Restart Type

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

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

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

  • HeartbeatIntervalMgmdMgmd

    Version (or later) NDB 8.3.0
    Type or units 毫秒
    Default 1500
    Range 100 - 4294967039 (0xFFFFFEFF)
    Restart Type

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

    指定用于确定另一个管理节点是否与该节点保持联系的心跳间隔时间。管理节点在等待大约 1600 ms 后,才会宣布连接死亡;因此,默认设置为 1500 毫秒的间隔。

Note

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

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

重启类型。 本节中的参数描述使用的重启类型信息显示在以下表格中:

表 25.8 NDB 集群重启类型

Symbol Restart Type Description
N 节点 可以使用滚动重启(参阅 第 25.6.5 节,“执行 NDB 集群滚动重启”)更新参数
S 系统 所有集群节点必须完全关闭,然后重新启动,以便更改该参数
I 初始 数据节点必须使用 --initial 选项重新启动