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 官网

相关推荐
Ealrang15 分钟前
Linux分区总结
运维
凭君语未可41 分钟前
MySQL中COUNT(*)、COUNT(1)和COUNT(字段名)的深度剖析与实战应用
数据库·mysql
江湖有缘1 小时前
【Docker管理工具】部署Docker管理面板DweebUI
运维·docker·容器
z人间防沉迷k1 小时前
MySQL事务和索引原理
数据库·笔记·sql·mysql
TGITCIC1 小时前
数据基座觉醒！大数据+AI如何重构企业智能决策金字塔（下）
大数据·大数据ai·大模型落地·大模型大数据·ai与大数据结合·大数据集成ai·企业ai
z人间防沉迷k1 小时前
字符串索引、幻读的解决方法
数据库·sql·mysql
xiaohezi1 小时前
Milvus 向量数据库快速入门（人话版）
数据库
shangjg31 小时前
Kafka ACK机制详解：数据可靠性与性能的权衡之道
java·数据库·分布式·后端·kafka
linux行者1 小时前
Linux 资源限制(进程级，用户级，系统级)
linux·运维·服务器
岁忧2 小时前
LeetCode 高频 SQL 50 题（基础版）之 【聚合函数】部分
数据库·sql·leetcode
热门推荐
01KGG转MP3工具|非KGM文件|解密音频02YOLOv8入门 | 重要性能衡量指标、训练结果评价及分析及影响mAP的因素【发论文关注的指标】03从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑04【无人机】无人机通信模块，无人机图数传模块的介绍，数传，图传，图传数传一体电台，05【SpeedAI科研小助手】2分钟极速解决知网维普重复率、AIGC率过高，一键全文降！文件格式不变，公式都保留的！06DeepSeek各版本说明与优缺点分析07【HarmonyOS】HUAWEI DevEco Studio 下载地址汇总08Coze扣子平台完整体验和实践（附国内和国际版对比）09组基轨迹建模 GBTM的介绍与实现（Stata 或 R）10《模拟器过检测教程：Nox、雷电、Mumu、逍遥模拟器 Magisk、LSposed 框架安装与隐藏应用配置》