集群模式

从部署机器区分，集群分为单机集群和多机集群；从是否启用高可用区分，集群分为普通集群和高可用集群。

DolphinDB 集群包括 4 种类型节点：数据节点（data node），计算节点（compute node），代理节点（agent）和控制节点（controller）。其配置文件存放在config目录中，主要包含以下配置文件（所有配置文件的第一行不可为空行）：

controller.cfg: 控制节点的配置文件
agent.cfg: 代理节点的配置文件
cluster.cfg: 数据节点的配置文件。单节点参数配置一节中的所有配置参数适用于集群中的数据节点，必须在 cluster.cfg 中配置。
cluster.nodes: 集群成员信息文件

普通集群

参考教程：单机集群部署教程 , 多机集群部署教程

注意：多服务器环境下，控制节点所在服务器必须包含controller.cfg, cluster.cfg, cluster.nodes 3种配置文件。代理节点必须包含 agent.cfg 文件。

在 cluster.cfg 中，可以使用以下4种方式指定配置参数的值：

1. 使用节点的别名。节点的别名在 cluster.nodes 中定义。

$ nodeA.volumes = /DFSRoot/nodeA
$ nodeB.volumes = /DFSRoot/nodeB

2. 使用别名和通配符(“%” 和 “?”)。”?” 表示单个字符，”%” 表示0，1或多个字符。

$ %8821.volumes = /DFSRoot/data8821
$ %8822.volumes = /DFSRoot/data8822
$ DFSnode?.maxMemSize=16

3. 使用宏变量 <ALIAS>。<ALIAS> 会自动替换对应节点的节点别名。例如：对于具有两个数据节点 nodeA 和 nodeB 的集群：

$ volumes = /DFSRoot/<ALIAS>

相当于：

$ nodeA.volumes = /DFSRoot/nodeA
$ nodeB.volumes = /DFSRoot/nodeB

4. 集群中的所有节点使用相同的参数值：

// for Windows
$ maxConnections=64
// for Linux
$ maxConnections=512
$ maxMemSize=12

需要注意：

前3种适用于相同的参数在不同节点中具有不同的配置值的情况；
第4种适用于所有节点配置相同的参数值；
以第1种方式配置指定路径时，不能使用宏变量，否则控制节点无法启动。例如，不能配置为 nodeA.volumes = /DFSRoot/<ALIAS>。

DolphinDB 提供了默认的 clusterDemo 文件夹存储对应的集群文件、默认的启动脚本（win：startController.bat, startAgent.bat；linux: startController.sh, startAgent.sh）和关机脚本（win: stopAll.bat; linux: stopAll.sh）。这些脚本仅对默认配置生效，用户可参考这些启动脚本中的命令，根据场景进行调整。

注意：集群环境下，关机脚本将关闭整个集群，参考安全关机。对单个节点的重启操作，建议在 web 集群管理器进行操作，具体操作可参考基于 web 的集群管理。

高可用集群

参考教程：DolphinDB 高可用集群部署教程

集群的高可用主要体现在数据高可用（多副本机制）、元数据高可用（控制节点高可用）、客户端高可用（API 指定多个数据节点 site，支持断连切换）。

对于高可用集群，配置文件 cluster.cfg 和 cluster.node 由 raft 组统一管理，它们仅作为集群第一次启动时的配置来源。集群启动后，修改 cluster.cfg 和 cluster.node 里的配置项将不会生效。必须通过 web 或 API 接口修改配置项，web 或 API 端会自动将修改同步到集群中的所有配置文件。