2.1 环境准备：集群环境准备

2.2 Linux环境（推荐）：Linux 系统部署集群

2.3 Linux环境（推荐）：Linux系统自动化部署集群

2.4 Windows环境：Windows 系统部署集群

选择管理系统>智能运维>集群配置，即可进入集群配置，前端可以配置状态服务器、文件一致性模式、缓存模式、通信协议，以及对部分集群参数进行配置。

状态服务器和文件服务器配置时，IP尽量使用内网IP。

配置之前请检查各服务器系统时间是否一致，不一致可能会导致集群不可用及同步问题，调整方法：Linux 系统如何配置各个节点的时间一致性？

3.1 状态服务器

状态服务器，点击开启按钮，即可在弹窗中选择缓存系统并编辑，如图所示：

3.1.1 选择 Redis 单机

选择「Redis 单机」时，配置信息的值，如下表所示：

3.1.2 选择 Redis 集群

选择「Redis集群」后，我们可以手动添加或者删除host，主机、端口、密码填写规则同单机。

如果配置Redis密码，则要求Redis各个节点使用统一的密码。

配置完毕后，点击「测试连接并保存」，若无异常则可保存成功。

3.2 文件一致设置

文件一致性包含 assets、reportlets、resources、schedule、dashboards、treasures、../backup 这些文件夹，当我们使用节点间自动同步时，这些文件夹会为了保持一致性会自动同步。当我们使用文件服务器时，各个节点将从文件服务器中读取这些文件内容。 

3.2.1 节点间自动同步

若不使用文件服务器，则文件一致设置默认为「节点间自动同步」，如下图所示：

节点间自动同步不适用于多节点，否则会因节点间通信问题影响使用，建议仅两个节点时使用。

3.2.2 文件服务器共享

选择「文件服务器共享」时，可以配置连接文件服务器，目前支持FTP、SFTP、HDFS、共享外部目录（NAS\NFS等）作为文件服务器。

HDFS和共享外部目录均为插件的形式，需要安装插件方可配置使用。

1） FTP、SFTP 协议

配置完成的界面：

注1：要求使用启动中的 FTP/SFTP 服务器，账号须具备配置路径的读写权限。

注2：如果是 SFTP 密钥登录，无需要用户名密码，不填即可，但要点击密码后面的图标上传密钥文件。

注3：按照文档部署的FTP服务，Linux系统填写绝对路径，如用户名为ftpuser，那么路径为/home/ftpuser/WEB-INF，Windows系统填写相对路径 /WEB-INF即可。

2） HDFS 协议

HDFS 作为文件服务器，可以保证模板等资源文件分布式存储，实现高可用。详细查看插件使用文档 HDFS 资源仓库 。

不管使用哪种服务作为文件服务器，配置完毕后，点击「测试连接并保存」，若无异常则可保存成功。

3.2.3 其他说明

a、文件服务器模式下，若集群第一个节点启动过程中尝试连接文件服务器失败，则自动切换至节点间同步模式，确保工程可以正常启动，并进行异常通知；

b、使用文件服务器时，想要手动增删改模板都需要在文件服务器下进行操作， 节点下的assets、reportlets、resources、schedule、dashboards、treasures、../backup是没有作用的；

c、从文件服务器切换至节点间同步时，需要重启集群工程所有节点方可生效，若不重启则不生效。

3.3 缓存模式

前端可选择“主动缓存”、“被动缓存”、“关闭缓存”，选择后立即生效。

注：节点间同步模式下无法关闭缓存，单机时默认关闭缓存，也不建议开启。

3.4 通信协议

TCP 和 UDP 是常用的网络传输协议，默认选用 TCP 协议。开启集群状态下可以切换集群通信协议，不过重启工程后方可生效。

注：如果开启集群后只显示本工程的节点，请更换集群连接方式，并重启各节点工程。

注：阿里云、AWS 等云服务器不允许 UDP 组播方式，集群连接方式请选择 TCP。

4.1 开关集群

4.1.1 开启集群

状态服务器和外置数据库是开启集群的前置条件，若未配置外置数据库，则参考文档进行配置：配置外接数据库。

未配置无法开启的弹窗提示：

配置完毕正常开启的弹窗提示：

4.1.2 关闭集群

当我们成功开启集群并使用时，若想关闭集群，可以直接点击按钮就行关闭，不过关闭状态在重启后方可生效。

4.3 节点管理

4.3.1 重启工程出现第一个节点

当我们开启集群按钮，并重启工程后，可以看到节点管理界面出现一个节点，并且当我们选用的是「节点间自动同步」时，第一个加入集群的节点会作为文件同步基准节点，若选用的是「文件服务器共享」，则不会出现文件同步基准节点标签。

需要强调的是：

a、选用的是「节点间自动同步」时，如果想手动变更节点下的资源文件（assets、reportlets、resources、schedule、dashboards、treasures、../backup ），则需要在基准节点下进行变更，增删改动作会自动同步至其他非基准节点。对应非基准节点下的资源文件变动操作，不会生效。

b、基准节点一旦选出后，默认不会变动。若想重置基准节点，可以关闭集群并重启工程后，再开启集群，基准节点即可重置，重置逻辑还是选择集群开启后第一个加入集群的节点为基准节点。

4.3.2 增加其他节点

当第一个节点出现后，我们就可以将第一个节点的工程包（webroot）拷贝到其他服务器下，然后启动这些服务器，新的节点就会加入节点管理了，如下图：

注：一个工程即一个节点信息。

使用 Tomcat、Weblogic 容器时，集群开启后可以自动识别容器端口，对于 WAS 集群，暂时不支持自动识别端口，需要在集群配置页面修改每个节点的端口号。

鼠标划到节点信息处，右上角出现编辑按钮，点击可编辑修改节点名称、IP 及端口信息，如下图所示：

4.4 同步文件按钮

集群管理界面下，开启集群并检测到节点后，才出现该按钮，为保证平台、设计器、节点间文件同步，用户直接在资源文件夹中手动新增 / 修改 / 删除模板文件后请进行手动同步，以其他方式发生的文件变动均可自动同步。如下图所示：

至此集群配置就设置成功了。

5.1 异常状态

5.1.1 节点宕机

1）事件：某一节点因各种异常，脱离集群环境，此时给用户发送提醒。

2）检测场景：当节点宕机事件发生后立刻提醒。如需事前提醒，请开启 智能检测 功能。

3）推送模板：节点 #NodeID#，非正常脱离集群环境。请重启该节点，加入集群。

4）日志记录：节点宕机异常情况会记录在环境运行的 fanruan.log 里。每个节点的 fanruan.log 里均记录该条异常情况。

5.1.2 节点时间不一致

对集群环境来说，节点间系统时间不一致会导致很多问题，比如同步等方面，最终导致系统不可用。针对节点时间，在不一致时给用户发送提醒。

1）事件：以任意节点 1 为基准。节点 1 获取的其他节点系统时间-节点1本地系统时间-网路传输延时>1 秒，此时系统判定节点时间不一致

2）检测场景：

• 集群开启时：做时间一致性检测，不一致不能开启集群。消息推送。（开启时若只有一个节点，不做检测）

• 集群新增节点时：做时间一致性检测。新节点不一致时，无法加入集群环境。消息推送。

• 集群运行时：每隔 1 小时自动巡检一次。若事件不一致，消息推送。

3）推送模板：系统检测到，节点 #NodeID# 的系统时间与其他节点不一致。请配置时间服务器，实现节点时间的自动同步。超链—时间服务器帮助文档。

4）日志记录：节点时间不一致异常情况会记录在环境运行的 fanruan.log 里。每个节点的 fanruan.log 里均记录该条异常情况。

5.1.3 节点 JAR 一致性检测

1）事件：新加入集群节点所含的全部 JAR 包与集群按加入时间排序第一个节点的 JAR 包做一致性检测，并且识别手动更改 JAR 包的不一致情况。

2）检测场景：新节点工程启动并请求加入集群时，进行节点 JAR 一致性检测。

• JAR 一致：正常启动，并加入集群环境。刷新节点管理页面即可。

• JAR 不一致：正常启动，并加入集群环境。刷新节点管理页面，在集群节点管理页面，异常节点背景异常显示，节点名异常显示，鼠标放置在该节点上时显示异常信息。同时进行异常消息推送。如下图所示：

3）异常分类：

4）推送模板：节点 #NodeName# ，与节点 #node1name# 的 jar 包不一致，将影响集群工程的稳定性，请前往集群节点管理页面查看详细异常信息，并及时处理。

5）日志记录：节点时间不一致异常情况会记录在环境运行的 fanruan.log 里。每个节点的 fanruan.log 里均记录该条异常情况。

5.2 设置

开启异常检测提醒功能，点击设置提醒方式，比如勾选短信提醒、平台消息、邮件提醒，设置完成后点击保存即可。默认全部开启，如下图所示：

5.3 收到的提醒

1）短信

注：需要开启短信平台，详细点击短信

2）平台消息

3）邮件提醒

注：需要配置邮件服务器，详细点击邮箱

1）JAR 包目前不能同步，升级 。

2）在平台上安装的插件可以自动同步，在插件目录 plugins 下手动放置的插件包不会自动同步，需要在各个节点都手动操作放置。

3）集群推荐使用私有云的授权方式，不用关心维护多个节点 license。

4）各个节点存储自己的日志（方便某节点出错快速找到其原因）。