物联网后端数据可视化消息队列【免费下载链接】thingsboardAll-in-one IoT Platform - Device management, data collection, processing and visualization.项目地址https://gitcode.com/GitHub_Trending/th/thingsboard点击查看免费下载本篇技术指南围绕 ThingsBoard Edge 在 Ubuntu Server 上通过.deb安装包完成版本升级的完整流程展开覆盖「升级前准备 → 下载安装新包 → 数据库升级 → 启动服务」四大环节并结合仓库中生成这些升级指令的后端源码说明指令模板的占位符替换与升级路径判定机制。读完本文你将掌握从备份数据库到完成 Edge 版本升级的端到端实操方法并能理解升级指引在系统内部是如何被动态生成与裁剪的。一、升级指令从哪来模板文件与运行时渲染本文所依据的核心文档是仓库中的 Ubuntu 升级指令模板。它本身是一份带占位符的 Markdown 模板实际展示给运维人员的升级指引由后端服务在运行时动态渲染#### Upgrading to ${TB_EDGE_VERSION}EDGEPE ThingsBoard Edge package download: wget https://dist.thingsboard.io/tb-edge-${TB_EDGE_TAG}pe.deb Install package: sudo dpkg -i tb-edge-${TB_EDGE_TAG}pe.deb ${UPGRADE_DB}模板中的三个关键占位符含义如下占位符含义替换来源${TB_EDGE_VERSION}升级目标版本号DefaultEdgeUpgradeInstructionsService中按目标 Edge 版本注入${TB_EDGE_TAG}目标版本的 tag不带pe后缀通过getTagVersion(edgeVersion)生成${UPGRADE_DB}数据库升级步骤内容可能为空由版本图version graph判断该版本是否需要更新数据库在 DefaultEdgeUpgradeInstructionsService.java 的getLinuxUpgradeInstructions方法中系统会读取ubuntu/instructions.md模板逐一完成占位符替换${TB_EDGE_TAG}被替换为getTagVersion(edgeVersion)${TB_EDGE_VERSION}与${FROM_TB_EDGE_VERSION}分别被替换为升级目标版本与当前版本而${UPGRADE_DB}则根据该版本是否需要执行数据库迁移来决定填充完整步骤还是替换为空字符串。仓库中同一目录下还有 CentOS 升级指令模板其流程完全一致只是安装包格式从.deb换成了.rpm安装命令从sudo dpkg -i换成了sudo rpm -Uvh。这说明 Ubuntu 与 CentOS 的升级链路共享同一套准备/启动流程模板仅包管理与安装命令不同。二、升级前准备停止服务与备份数据库升级操作的第一步来自 upgrade_preparing.md该模板在执行安装前会插入到升级指引的最前面。1. 停止 ThingsBoard Edge 服务在下载新版本安装包之前必须先停止正在运行的 Edge 服务sudo systemctl stop tb-edge2. 检查数据库大小与磁盘空间备份前要确认磁盘有足够空间容纳数据库备份。先查看tb_edge数据库的当前大小sudo -u postgres psql -c SELECT pg_size_pretty( pg_database_size(tb_edge) );再查看根分区的可用空间df -h /3. 执行数据库备份确认空间充足后使用pg_dump将整个tb_edge数据库导出为备份文件sudo -Hiu postgres pg_dump tb_edge tb_edge.sql.bak生成后务必检查备份文件是否创建成功、大小是否合理。升级前做好数据库备份是这套指引中不可跳过的安全步骤一旦升级过程中出现问题可以通过该备份恢复。三、下载并安装新版 .deb 安装包准备工作完成后进入 Ubuntu 升级指令模板 的核心步骤。首先从官方分发站点下载目标版本的安装包wget https://dist.thingsboard.io/tb-edge-${TB_EDGE_TAG}pe.deb在实际渲染后的指引中${TB_EDGE_TAG}会被替换为具体版本号例如3.8.0最终下载的即为tb-edge-3.8.0pe.deb。随后用dpkg安装该包sudo dpkg -i tb-edge-${TB_EDGE_TAG}pe.debdpkg -i会完成软件包的解析与安装将 ThingsBoard Edge 的服务脚本、配置目录/etc/tb-edge/conf/、可执行脚本/usr/share/tb-edge/bin/等安装到位。四、数据库升级upgrade.sh 与 --fromVersion 参数升级指引中的${UPGRADE_DB}占位符在这一步被展开为完整的数据库升级说明其内容来自 upgrade_db.md。首先是一个重要提示包安装程序可能询问是否合并merge你的 tb-edge 配置推荐选择 merge 选项以确保之前的所有配置参数如云端连接密钥、端口配置等不会被覆盖。随后执行常规升级脚本并显式传入当前版本号sudo /usr/share/tb-edge/bin/install/upgrade.sh --fromVersion${FROM_TB_EDGE_VERSION}${FROM_TB_EDGE_VERSION}会被替换为 Edge 当前运行的版本号。该脚本基于--fromVersion参数确定从哪个版本开始执行数据库 schema 迁移逐级应用升级 SQL仓库application/src/main/data/upgrade/下保存了各版本的升级脚本将数据库结构对齐到新版本。从源码逻辑看是否执行这一步由版本图version graph中的isRequiresUpdateDb标志决定getLinuxUpgradeInstructions 方法会判断edgeUpgradeInfo.isRequiresUpdateDb()为true时把upgrade_db.md的内容拼接到指引中为false时则直接替换为空字符串——即某些小版本升级不需要迁移数据库指引中就不会出现这一步。五、启动服务并验证升级结果数据库升级完成后指引末尾会追加 start_service.md 的内容启动 ThingsBoard Edge 服务sudo systemctl start tb-edge在部分发行版上也可使用sudo service tb-edge start这是同一服务管理机制的封装形式。启动后可以结合 Ubuntu 安装指引 中的验证思路确认服务状态通过java -version确认 OpenJDK 25 环境正常ThingsBoard Edge 运行在 Java 25 上且要求 Ubuntu 22.04 LTS 或更新版本然后打开 Edge Web 界面http://localhost:8080若修改过 HTTP 绑定端口则为http://localhost:18080使用 ThingsBoard 租户凭证登录确认 Edge 已成功连接到云端并显示新版本号。六、升级可用性判定Edge 如何决定是否提示升级这套指令并非每次都无条件生成其触发条件同样定义在 DefaultEdgeUpgradeInstructionsService.java 的isUpgradeAvailable方法中系统会读取 Edge 设备SERVER_SCOPE属性中的版本键EDGE_VERSION_ATTR_KEY仅当 Edge 当前版本不低于3.6.0且低于平台ThingsBoard Server当前版本时才判定存在可用升级满足条件后getUpgradeInstructions根据用户在 UI 上选择的升级方式docker/ubuntu/centos分派到不同的模板组装逻辑并通过版本图逐级串联中间版本最后把「准备 → 下载安装 → 数据库升级如需→ 启动服务」拼接成一份完整的 Markdown 指引返回给前端展示。七、升级操作要点小结备份优先先停服、查磁盘空间、pg_dump导出tb_edge确认备份成功后再动手。包管理Ubuntu 使用wgetsudo dpkg -i tb-edge-${TB_EDGE_TAG}pe.deb若提示配置合并选择 merge 保留既有参数。数据库迁移执行sudo /usr/share/tb-edge/bin/install/upgrade.sh --fromVersion当前版本无需迁移数据库的版本指引会自动省略此步。启动验证sudo systemctl start tb-edge后通过 Web 界面登录确认版本与连接状态。版本约束Edge 版本须不低于 3.6.0 才会触发升级提示Java 25 环境要求 Ubuntu 22.04 LTS 及以上。以上流程与命令均可在仓库中溯源验证模板文件位于 upgrade/ubuntu/instructions.md配套的准备、数据库升级与启动模板分别位于 upgrade_preparing.md、upgrade_db.md 与 start_service.md指令的运行时组装逻辑见 DefaultEdgeUpgradeInstructionsService.java。赞分享物联网后端数据可视化消息队列【免费下载链接】thingsboardAll-in-one IoT Platform - Device management, data collection, processing and visualization.项目地址https://gitcode.com/GitHub_Trending/th/thingsboard点击查看免费下载相关推荐uni-app createMapContext 地图上下文 API 完整指南从创建到动态操控 map 组件uni app createMapContext 地图上下文 API 完整指南从创建到动态操控 map 组件 uni.createMapContext 是 u物联网后端数据可视化消息队列ThingsBoard Edge Docker 数据库升级完整指南upgrade_db 配置模板解析与升级流程实战ThingsBoard Edge Docker 数据库升级完整指南upgrade_db 配置模板解析与升级流程实战 本文以 ThingsBoard 开源仓库中物联网后端数据可视化消息队列ThingsBoard Edge 基于 Docker 的版本升级实战指南从准备工作到数据库迁移全流程ThingsBoard Edge 基于 Docker 的版本升级实战指南从准备工作到数据库迁移全流程 本文以 ThingsBoard 仓库中 Edge 的 D物联网后端数据可视化消息队列上一篇MiddyAWS Lambda的时尚Node.js中间件引擎下一篇Fitty完美自适应文本缩放解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考