TDengine 运维——巡检工具（安装工具）

TDengine （老段）2025-05-31 9:38

背景

TDengine 的安装包自带安装脚本，但无法基于集群进行自动化安装部署，本文档旨在说明如何使用安装工具进行 TDengine 的集群式安装部署。

安装工具支持功能

安装方式 详细说明
单节点安装部署 单节点环境安装部署 TDengine
集群安装部署 集群环境安装部署 TDengine
指定机器安装部署 指定集群中特定节点安装部署 TDengine
普通升级 单节点或集群关闭服务后升级 TDengine，仅推荐测试使用
滚动升级 单节点或集群不停服务升级 TDengine，仅推荐测试使用

工具使用方法

安装功能

工具支持通过 help 参数查看支持的语法

install 复制代码 
./taosinstall install --help

Usage: taosinstall install [OPTIONS]

  Install Database

Options:
  -m, --model [local|ssh]  connection model, default: local
  -f, --config TEXT        Full path of test config file  [required]
  -b, --backend BOOLEAN    Run process in backend. default: False
  -cm, --check-md5 BOOLEAN  check md5 of package, default is True
  -l, --list TEXT          list of test hostnames, Separate with commas. None
                           by default
  -w, --workers INTEGER    concurrency, default is 50
  -sh, --set-hostname      set hostname
  -si, --set-ips           set ips to /etc/hosts
  --help                   Show this message and exit
参数详细说明
  • model：安装工具运行模式，分为 local 和 ssh。安装环境的多节点间支持 SSH 通信，可选择 ssh 模式，在任意节点上运行安装工具，会依次对所有节点环境完成安装操作。反之，节点间不支持 SSH 通信时，可选择 local 模式，仅对工具运行所在机器完成安装操作，默认为 local 模式。
  • config：安装工具加载的配置文件，其具体配置方式详见 配置文件使用说明 章节。不配置 config 参数时配置文件默认路径为工具运行当前目录。
  • backend：后台运行安装工具，选择 True 后安装工具在自动在后台运行，默认为 False。
  • check-md5: 安装前检查安装包的 MD5 值，默认为 True.
  • workers：集群安装部署时的并发数量，会影响同时向多节点服务文件的并发数，需根据机器资源情况调整，默认是 50。
  • list：指定部署 TDengine 的机器，前提是配置文件中指定的 firstep 安装完成并服务运行部正常，该参数是预留给安装中断后继续安装剩余节点的场景使用，默认值为 None。
  • set-hostname：根据配置文件的 FQDN 更新集群节点的 hostname。不配置则不更新 hostname。
  • set-ips：根据配置文件的 FQDN 对应 IP 更新集群节点的 /etc/hosts。不配置则不更新 hosts 文件。
  • version：打印安装工具版本信息。
安装流程

💡 Note: 在安装前需确认 TDengine 各服务对应的配置文件中预设定参数是否配置正确，特别是数据和日志路径等信息。

No 安装步骤 详细说明
1 检查 MD5 检查安装包的 MD5 值（可选项）
2 复制安装包 复制安装包到集群个节点（local 安装模式跳过该步骤）
3 安装 TDengine 安装 TDengine
4 更新 taos 配置 基于预配置的 taosd 参数更新 taos.cfg，除了预配置的静态参数，还动态更新 firstEp、secondEp、fqdn、minReservedMemorySize
5 启动 taosd 服务 通过 sytstemctl 启动 taosd 服务
6 更新 taosadapter 配置 基于预配置的 taosadapter 参数更新 taosadapter.toml
7 启动 taosadapter 服务 通过 sytstemctl 启动 taosadapter 服务
8 创建集群所有 dnode 数据库初始化 dnode
9 创建 mnode 在 firstEp、secondEp 和 node3 上创建 monde（local 安装模式跳过该步骤）
10 更新 taosadapter 的 instanceId 更新 taosadapter 的 instanceId 并重启 taosadapter 服务
11 更新 taoskeeper 配置 基于预配置的 taoskeeper 参数更新 taoskeeper.toml 并更新 instanceId
12 启动 taoskeeper 服务 通过 sytstemctl 启动 taoskeeper 服务
13 更新 taosx 配置 基于预配置的 taosx 参数更新 taosx.toml 并更新 instanceId
14 启动 taosx 服务 通过 sytstemctl 启动 taosx 服务
15 更新 taos-explorer 配置 基于预配置的 taos-explorer 参数更新 explorer.toml 并更新 instanceId
16 启动 taos-explorer 服务 通过 sytstemctl 启动 taos-explorer 服务
17 创建监控用户 数据库创建 monitor 用户
18 更新 taoskeeper 配置 更新 taoskeeper 配置文件中连接数据库的用户为 monitor
19 启动 taoskeeper 服务 通过 sytstemctl 启动 taoskeeper 服务

升级功能

工具支持通过 help 参数查看支持的语法

upgrade 复制代码 
./taosinstall upgrade --help

Usage: taosinstall upgrade [OPTIONS]

  Upgrade Database

Options:
  -m, --model [local|ssh]  connection model, default: local
  -f, --config TEXT        Full path of test config file  [required]
  -b, --backend BOOLEAN    Run process in backend. default: False
  -l, --list TEXT          list of test hostnames, Separate with commas. default: None
  -r, --rolling-upgrade    Rolling upgrade Database
  --help                   Show this message and exit
参数详细说明
  • model：安装工具运行模式，分为 local 和 ssh。安装环境的多节点间支持 SSH 通信，可选择 ssh 模式，在任意节点上运行安装工具，会依次对所有节点环境完成安装操作。反之，节点间不支持 SSH 通信时，可选择 local 模式，仅对工具运行所在机器完成安装操作，默认为 local 模式。
  • config：安装工具加载的配置文件，其具体配置方式详见 配置文件使用说明 章节。不配置 config 参数时配置文件默认路径为工具运行当前目录。
  • backend：后台运行安装工具，选择 True 后安装工具在自动在后台运行，默认为 False。
  • list：指定部署 TDengine 的机器，前提是配置文件中指定的 firstep 安装完成并服务运行部正常，该参数是预留给安装中断后继续安装剩余节点的场景使用，默认值为 None。
  • rolling-upgrade：滚动不停服升级，目前仅推荐测试环境使用。默认为普通停服升级
  • version：打印安装工具版本信息。
升级流程

💡 Note: 由于客户现场环境复杂，在启停服务过程可能遇到不可预期的问题，目前升级功能仅推荐在测试环境使用，比如验证版本升级。若在业务环境使用需要提前评估其风险。

停服升级

停服升级会先停止所有节点的所有数据库服务，然后按照 firstEp、secondEp、dnode3...的顺序依次进行升级和重启服务操作

No 安装步骤 详细说明
1 复制安装包 复制安装包到集群各节点（local 安装模式跳过该步骤）
2 停止服务 停止 taosd、taosadapter、taoskeeper、taosx 和 taos-explorer 服务
3 更新版本 更新 TDengine 到指定版本
4 启动 taosd 服务 通过 sytstemctl 启动 taosd 服务
5 启动 taosadapter 服务 通过 sytstemctl 启动 taosadapter 服务
6 启动 taoskeeper 服务 通过 sytstemctl 启动 taoskeeper 服务
7 启动 taosx 服务 通过 sytstemctl 启动 taosx 服务
8 启动 taos-explorer 服务 通过 sytstemctl 启动 taos-explorer 服务
滚动升级

按照非 monde 所在节点、mnode 为 follower 节点和 monde 为 leader 节点的顺序依次进行升级和重启服务操作

No 安装步骤 详细说明
1 复制安装包 复制安装包到集群个节点（local 安装模式跳过该步骤）
2 停止服务 停止 taosd、taosadapter、taoskeeper、taosx 和 taos-explorer 服务
3 更新版本 更新 TDengine 到指定版本
4 启动 taosd 服务 通过 sytstemctl 启动 taosd 服务
5 启动 taosadapter 服务 通过 sytstemctl 启动 taosadapter 服务
6 启动 taoskeeper 服务 通过 sytstemctl 启动 taoskeeper 服务
7 启动 taosx 服务 通过 sytstemctl 启动 taosx 服务
8 启动 taos-explorer 服务 通过 sytstemctl 启动 taos-explorer 服务

配置文件使用说明

💡 Note: 支持密码登录和免密登录两种方式，配置免密登录时包括运行安装工具的当前节点也要配置免密

配置方法

复制代码 
cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys

配置文件参数说明

config 复制代码 
########################################################
#                                                      #
#                  Configuration                       #
#                                                      #
########################################################

# 安装部署 TDengine 的环境信息，支持免密登录和 SSH 登录两种方式，当环境配置了免密登录后可不用配置 password 信息
[test_env]
# 节点间通过 SSH 协议访问
firstep=192.168.0.1||fqdn=tdengine1||username=root||password=123456||port=22
secondep=192.168.0.2||fqdn=tdengine2||username=root||password=123456||port=22
dnode3=192.168.0.3||fqdn=tdengine3||username=root||username=123456||port=22

# 节点间配置免密登录，包括运行安装工具的当前节点也要配置免密！！！
# firstep=192.168.0.1||fqdn=tdengine1||username=root||port=22
# secondep=192.168.0.2||fqdn=tdengine2||username=root||port=22
# dnode3=192.168.0.3||fqdn=tdengine3||username=root||port=22

# TDengine 安装包在本地所在全路径
[local_pack]
package=/path_to_file/TDengine-enterprise-3.3.x.x-Linux-x64.tar.gz
md5 = 317f88bf13aa21706ae8c2d4f919d30f

# oem 版本的版本名称，默认不使用
# [oem]
# version=prodb

# TDegine 的 Restful 连接信息
[database]
username=root
password=taosdata
port=6030
rest_port=6041

# taosd 预配置文件, 该文件中配置会覆盖到所有 dnode 上对应配置文件
[taos_cfg]
cfg_file=taos.cfg

# taoskeeper的预配置文件, 该文件中配置会覆盖到所有 dnode 上对应配置文件
[taoskeeper_cfg]
cfg_file=taoskeeper.toml

# taosadapter 的预配置文件, 该文件中配置会覆盖到所有 dnode 上对应配置文件
[taosadapter_cfg]
cfg_file=taosadapter.toml

# taosx 的预配置文件, 该文件中配置会覆盖到所有 dnode 上对应配置文件
[taosx_cfg]
cfg_file=taosx.toml

# explorer 的预配置文件, 该文件中配置会覆盖到所有 dnode 上对应配置文件
[taosexplorer_cfg]
cfg_file=explorer.toml

# 监控用户 monitor 的配置信息
[monitor_user]
username=monitor
password=Taosmonitor_125#

应用示例

在工具所在节点安装数据库

复制代码 
./taosinstall install -m local

在集群所有节点安装数据库

复制代码 
./taosinstall install -m ssh

指定配置文件并在集群所有节点安装数据库

复制代码 
./taosinstall install -m ssh -f /path_to_file/install.cfg

在集群指定节点安装数据库

复制代码 
./taosinstall install -m ssh -l server1,server2...

停服升级数据库

复制代码 
./taosinstall upgrade -m ssh

滚动升级数据库

复制代码 
./taosinstall upgrade -m ssh -r

访问官网

更多内容欢迎访问 TDengine 官网

相关推荐
优秀1351 小时前
JDBC
数据库
狐凄3 小时前
Python实例题：基于边缘计算的智能物联网系统
python·物联网·边缘计算
@十八子德月生3 小时前
第十章——8天Python从入门到精通【itheima】-99~101-Python基础综合案例-数据可视化（案例介绍=JSON格式+pyecharts简介）
大数据·python·信息可视化·pycharm·echarts·数据可视化
tiger1193 小时前
大学专业解读——电气，自动化，仪器
运维·自动化·高考·电气·专业·仪器
穆易青5 小时前
2025.06.20【pacbio】|使用Snakemake构建可重复的PacBio全基因组甲基化分析流程
java·运维·服务器
网硕互联的小客服5 小时前
高并发下分布式数据库性能下降的解决方法
数据库·分布式
远方16096 小时前
59-Oracle 10046事件-知识准备
大数据·数据库·sql·oracle·database
努力成为DBA的小王6 小时前
CVE-2024-6387漏洞、CVE-2025-26465漏洞、CVE-2025-26466漏洞 一口气全解决
运维·服务器
静听山水6 小时前
PostgreSQL/Hologres 外部数据包装器系统表 pg_foreign_data_wrapper 详解
数据库·postgresql
神洛华7 小时前
SQL Server基础语句1：基础查询、数据筛选 / 排序 、分组聚合
数据库·sql
热门推荐
01KGG转MP3工具|非KGM文件|解密音频02扣子（coze）实战|我用扣子搭建了一个自动分析小红薯笔记内容的AI应用|详细步骤拆解03Coze扣子平台完整体验和实践（附国内和国际版对比）0438、基于卷积神经网络(CNN)的车牌自动识别系统(matlab)05DeepSeek各版本说明与优缺点分析06从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑07C# 项目：导线计算 / 坐标转换 / 曲线放样 / 水准网 / 导线网平差08AI Agent | Coze 插件使用指南：从功能解析到实操步骤09YOLOv8入门 | 重要性能衡量指标、训练结果评价及分析及影响mAP的因素【发论文关注的指标】10jdk21下载、安装（Windows、Linux、macOS）