目录
-
升级说明
- ThingsBoard PE v3.7.x upgrade instructions for Ubuntu
ThingsBoard PE v3.7.x upgrade instructions for Ubuntu
升级ThingsBoard前的准备工作
停止ThingsBoard
检查ThingsBoard及数据库服务是否在运行。
先停止ThingsBoard,检查状态确认已停止,再处理数据库。
1
| sudo systemctl stop thingsboard
|
1
| sudo systemctl status thingsboard
|
备份数据库
升级前请对数据库进行备份。
PostgreSQL
检查PostgreSQL状态。备份时无需停止PostgreSQL。
1
| sudo systemctl status postgresql
|
请确保有足够的空间存放数据库备份
检查数据库大小
1
| sudo -u postgres psql -c "SELECT pg_size_pretty( pg_database_size('thingsboard') );"
|
检查可用空间
如有足够可用空间,可执行备份。
1
| sudo -Hiu postgres pg_dump thingsboard > thingsboard.sql.bak
|
确认备份文件已创建。
Cassandra
检查Cassandra状态。备份Cassandra需先停止服务。
1
| sudo systemctl status cassandra
|
将所有memtable从节点刷新到磁盘上的SSTable。
停止Cassandra。
1
| sudo systemctl stop cassandra
|
需再次检查状态以确认已完全停止。
1
| sudo systemctl status cassandra
|
请确保有足够的空间存放数据库备份
检查数据库大小。
1
| du -h /var/lib/cassandra/ | tail -1
|
检查可用空间。
执行Cassandra数据库备份。
1
2
| mkdir backup
sudo tar -cvf backup/cassandra.tar /var/lib/cassandra
|
确认归档是否正在创建
启动数据库
Cassandra
1
| sudo systemctl start cassandra
|
PostgreSQL
无需操作,PostgreSQL已在运行。
将 ThingsBoard PE 升级到 3.7
注意:
本升级步骤适用于 ThingsBoard 版本 3.6.4PE。 要升级到 3.7PE,需先升级到 3.6.4PE。
升级 ThingsBoard 前请先准备。
升级至 ThingsBoard 3.7 前的重要说明
ThingsBoard 后端已迁移至 Java 17。请安装 JDK 17 并确保系统默认 Java 版本设置为 17。
请参阅对应安装指南的步骤 1 以获取详细说明:
Ubuntu
CentOS/RHEL
下载 ThingsBoard PE 安装包
1
| wget https://dist.thingsboard.io/thingsboard-3.7pe.deb
|
ThingsBoard PE 服务升级
- 若 ThingsBoard 服务正在运行,请先停止。
1
| sudo service thingsboard stop
|
- 按此处所述安装 ThingsBoard Web Report 组件。
1
| sudo dpkg -i thingsboard-3.7pe.deb
|
注意:
安装包可能会提示合并 ThingsBoard 配置。建议选择合并选项,以确保先前参数不会被覆盖。
1
| sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=3.6.4
|
启动服务
若已安装 Cassandra,请确保为 cassandra.in.sh 包含文件设置正确的 JAVA_HOME 参数。截至 3.7.0 版本,最新稳定版 Cassandra 尚不支持 Java 17。
如需操作,可参考 Cassandra 安装指南 中的 “you will need to install Java…” 部分。
1
| sudo service thingsboard start
|