纳管集群

如果您已经部署了一套或几套 EMQX 集群，可以通过 ECP 的集群纳管功能管理已有集群。ECP 目前支持 EMQX v4 企业版（4.4.6 及以上）及 v5 企业版（5.6.0 及以上）的纳管。

ECP 纳管 EMQX 集群

1. 以系统/组织/项目管理员的身份登录 ECP。在工作台 -> 数据集成 -> 数据接入页面，在集群列表页点击纳管集群。

2. 按集群命名规则填写集群名称；1-200 个字符，并支持 空格、"-"、"_"。

3. 如果纳管的是 EMQX v5 集群，需要填写集群服务地址，即 EMQX dashboard 访问地址。也可以稍后通过“编辑”集群来设置集群服务地址。

4. 点击确认。此时集群列表会新增一个纳管的集群。

5. 在集群卡片或集群列表中，点击注册节点，将弹出集群注册引导页。

6. 在注册引导页，选择 CPU 架构，当前支持 AMD64、ARM、ARM64 三种架构；按照注册引导页的提示完成注册。

   

7. 登录到 EMQX 集群安装的虚机环境，按顺序执行注册引导页中的命令；

   # 下载 EMQX Agent 
   sudo curl -L -f --output /usr/local/bin/emqxee-agent https://[emqxee-agent]
   
   # 修改 Agent 权限
   sudo chmod +x /usr/local/bin/emqxee-agent
   
   # 启动 Agent
   sudo /usr/local/bin/emqxee-agent start
   
   # 注册到 ECP
   sudo /usr/local/bin/emqxee-agent register --url https://[ecp] --registration-token bf2779e5176446cd8e18fde81d826497

8. 回到 ECP 数据接入页，查看集群列表，可以看到被纳管的 EMQX 集群已被注册到 ECP 中，状态显示为运行中。

9. 如果纳管的是 v4 版本集群，集群正常运行后，在操作列将出现 进入Dashboard 按钮，点击后可访问集群的 dashboard。如果没有出现该按钮，请检查 ECP 配置文件中的 cluster.agent 是否配置正确并可被 agent 访问。

10. 如果纳管的是 v5 版本集群，正确设置集群服务地址后，在操作列将出现 进入Dashboard 按钮，点击即可在新窗口中直接查看集群的 dashboard。

集群状态

纳管的 EMQX 集群的状态如下：

状态	说明
已创建	新建集群，还未注册节点时的状态
注册中	注册节点过程中的中间状态
运行中	集群正常运行状态
删除中	删除集群后的中间状态
异常	集群未正常运行，或者 agent 无法访问集群，或者 agent 无法与 ECP 正常通信

如果集群状态显示为异常，可以点击异常状态查看原因。