TDengine集群正确搭建步骤及1主3从节点离线问题如何解决

一、前置环境准备 #

• 所有节点关闭防火墙、SELinux，确保TCP/UDP 6030-6042端口段双向互通
• 所有节点配置唯一主机名，且在每个节点的/etc/hosts文件中添加集群所有节点的内网IP+对应主机名映射，确保各节点之间通过主机名可正常通信
• 所有节点安装完全相同版本的TDengine服务，禁止跨版本部署

二、标准集群搭建步骤 #

1. 主节点配置

• 编辑主节点taos.cfg配置文件：
  • firstEP参数填写主节点自身主机名:6030
  • fqdn参数填写主节点自身的主机名
  • 其余端口参数保持默认即可
• 清空主节点历史数据目录（默认路径为/var/lib/taos），执行systemctl start taosd启动taosd服务
• 执行taos命令进入taos shell，执行show dnodes确认主节点自身状态为ready

2. 工作节点配置

• 编辑每个工作节点的taos.cfg配置文件：
  • firstEP参数填写主节点的主机名:6030
  • fqdn参数填写当前工作节点自身的主机名
• 清空每个工作节点的历史数据目录，执行systemctl start taosd启动taosd服务
• 回到主节点的taos shell，依次执行create dnode "工作节点主机名:6030"添加3个工作节点

3. 集群验证
   主节点taos shell中执行show dnodes，所有节点的status列显示为ready即搭建成功

三、节点离线问题排查方案 #

优先检查以下常见漏配项：

• 端口连通性：TDengine集群内部心跳依赖UDP端口，仅开放TCP端口会导致节点心跳异常，可使用nc -zvU 目标节点主机名 6030命令验证UDP端口连通性，确保所有节点之间6030-6042端口段的TCP、UDP协议均双向互通
• 配置一致性：
  • 所有节点taos.cfg中的fqdn参数必须配置为当前节点自身的主机名，不可留空或填写其他节点地址
  • 所有节点的firstEP参数值必须完全一致，均为主节点的主机名:6030
• 节点注册规则：所有create dnode操作必须在主节点的taos shell执行，禁止在工作节点本地执行注册操作，且注册时填写的dnode地址必须与工作节点自身配置的fqdn:serverPort完全一致，大小写、端口不可出现偏差
• 数据目录权限：确认taos用户对TDengine数据目录有完整读写权限，可执行chown -R taos:taos /var/lib/taos修复权限后重启taosd服务

内容的提问来源于stack exchange，提问作者Jackson