当前位置： 首页 > news >正文

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

news 来源：原创 2025/6/15 1:10:21

在这里插入图片描述

背景

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

安装工具支持功能

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

工具使用方法

安装功能

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

./taosinstall install --helpUsage: taosinstall install [OPTIONS]Install DatabaseOptions:-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. Noneby 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 参数查看支持的语法

./taosinstall upgrade --helpUsage: taosinstall upgrade [OPTIONS]Upgrade DatabaseOptions:-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

配置文件参数说明

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

相关文章：

  • Oracle 临时表空间详解
  • Dynamics 365 Business Central AI Sales Order Agent Copilot
  • Deepseek应用技巧-Dify本地化搭建合同审批助手
  • 【面板数据】上市公司供应链网络地位数据（2001-2024年）
  • solidworks报错-只有合并特征才能被阵列。如果恰当，请选择实体的阵列
  • 解释k8s种ConfigMap和Secret的作用，如何在Pod中挂载环境变
  • 时间序列噪声模型分析软件推荐与使用经验
  • [9-1] USART串口协议 江协科技学习笔记（13个知识点）
  • 基于生产-消费模式，使用Channel进行文件传输（Tcp方式）
  • Rocky Linux上安装Go
  • 66常用控件_QTableWidget的使用
  • Win11安装Dify
  • APM32微控制器键盘PCB设计实战教程
  • Scratch节日 | 拯救屈原 | 端午节
  • WPF的布局核心：网格布局（Grid）
  • 数学概念解释数据集（200条）收集分享，为AI智能体应用助力~
  • MVCC 原理与并发控制实现
  • 长安链智能合约命令解析（全集）
  • LeetCode 3373.连接两棵树后最大目标节点数目 II：脑筋急转弯+广度优先搜索(黑白染色法)
  • ArkUI（方舟UI框架）介绍
  • 安康做企业网站的/seo页面内容优化
  • 梅州网站建/搜狗提交入口网址
  • 大连做企业网站哪家好/宜兴网站建设
  • 安全等级保护每个网站必须做吗/百度应用app
  • 下列关于网站开发中网页上传/网络销售挣钱吗
  • 快速提升网站权重/深圳seo优化排名