产品定价 立即试用
社区版
入门 文档 指南 安装 架构 API 常见问题
目录

旧版升级说明

要更新到新的ThingsBoard版本,请参阅以下 CE and PE 升级说明

升级到 1.0.3

以下步骤适用于ThingsBoard 1.0, 1.0.1 and 1.0.2版本。

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v1.0.3/thingsboard-1.0.3.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v1.0.3/thingsboard-1.0.3.rpm

升级ThingsBoard服务

1
sudo dpkg -i thingsboard-1.0.3.deb
1
sudo rpm -Uvh thingsboard-1.0.3.rpm

数据库升级

仅从1.0 or 1.0.1版本升级时需要执行此步骤。 请按照以下说明更新您的单节点实例:

下载升级脚本:

1
2
wget https://raw.githubusercontent.com/thingsboard/thingsboard.github.io/master/docs/user-guide/install/resources/1.0.3/upgrade_1.0_1.0.2.sh
wget https://raw.githubusercontent.com/thingsboard/thingsboard.github.io/master/docs/user-guide/install/resources/1.0.3/system_widgets_1.0_1.0.2.cql

运行主脚本:

1
2
chmod +x upgrade_1.0_1.0.2.sh
./upgrade_1.0_1.0.2.sh

启动服务

1
sudo service thingsboard start

升级到 1.1.0

以下步骤适用于ThingsBoard 1.0.3版本。

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v1.1/thingsboard-1.1.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v1.1/thingsboard-1.1.rpm

升级ThingsBoard服务

1
sudo dpkg -i thingsboard-1.1.deb
1
sudo rpm -Uvh thingsboard-1.1.rpm

数据库升级

请按照以下说明更新您的单节点实例:

下载升级脚本:

1
2
wget https://raw.githubusercontent.com/thingsboard/thingsboard.github.io/master/docs/user-guide/install/resources/1.1.0/upgrade_1.0.3_1.1.0.sh
wget https://raw.githubusercontent.com/thingsboard/thingsboard.github.io/master/docs/user-guide/install/resources/1.1.0/system_widgets_1.0.3_1.1.0.cql

运行主脚本:

1
2
chmod +x upgrade_1.0.3_1.1.0.sh
./upgrade_1.0.3_1.1.0.sh

启动服务

1
$ sudo service thingsboard start

升级到 1.2.0

以下步骤适用于ThingsBoard 1.1.0版本。

Ubuntu/CentOS

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v1.2/thingsboard-1.2.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v1.2/thingsboard-1.2.rpm

升级ThingsBoard服务

1
sudo dpkg -i thingsboard-1.2.deb
1
sudo rpm -Uvh thingsboard-1.2.rpm

数据库升级

下载升级脚本:

1
2
wget https://raw.githubusercontent.com/thingsboard/thingsboard.github.io/master/docs/user-guide/install/resources/1.2.0/upgrade_1.1.0_1.2.0.sh
wget https://raw.githubusercontent.com/thingsboard/thingsboard.github.io/master/docs/user-guide/install/resources/1.2.0/system_widgets.cql

运行主脚本:

1
2
chmod +x upgrade_1.1.0_1.2.0.sh
./upgrade_1.1.0_1.2.0.sh

启动服务

1
sudo service thingsboard start

Windows

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-1.2.zip.

升级ThingsBoard服务

  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。
  • 运行ThingsBoard安装目录中的uninstall.bat卸载之前版本的ThingsBoard服务。

注意 以上脚本需要以管理员身份运行。

1
C:\thingsboard>uninstall.bat
  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。
  • 运行install.bat脚本将新版本的ThingsBoard安装为Windows服务。
1
C:\thingsboard>install.bat

数据库升级

1
upgrade_1.1.0_1.2.0.bat

启动服务

1
net start thingsboard

升级到 1.2.1

以下步骤适用于ThingsBoard 1.2.0版本。

Ubuntu/CentOS

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v1.2.1/thingsboard-1.2.1.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v1.2.1/thingsboard-1.2.1.rpm

升级ThingsBoard服务

1
sudo dpkg -i thingsboard-1.2.1.deb
1
sudo rpm -Uvh thingsboard-1.2.1.rpm

数据库升级

下载升级脚本:

1
2
3
wget https://raw.githubusercontent.com/thingsboard/thingsboard.github.io/master/docs/user-guide/install/resources/1.2.1/upgrade_1.2.0_1.2.1.sh
wget https://raw.githubusercontent.com/thingsboard/thingsboard.github.io/master/docs/user-guide/install/resources/1.2.1/schema_update.cql
wget https://raw.githubusercontent.com/thingsboard/thingsboard.github.io/master/docs/user-guide/install/resources/1.2.1/system_widgets.cql

运行主脚本:

1
2
chmod +x upgrade_1.2.0_1.2.mqtt-js-telemetry-data-as-object.sh
./upgrade_1.2.0_1.2.mqtt-js-telemetry-data-as-object.sh

启动服务

1
sudo service thingsboard start

Windows

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-1.2.1.zip.

升级ThingsBoard服务

  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。
  • 运行ThingsBoard安装目录中的uninstall.bat卸载之前版本的ThingsBoard服务。

注意 以上脚本需要以管理员身份运行。

1
C:\thingsboard>uninstall.bat
  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。
  • 运行install.bat脚本将新版本的ThingsBoard安装为Windows服务。
1
C:\thingsboard>install.bat

数据库升级

1
upgrade_1.2.0_1.2.1.bat

启动服务

1
net start thingsboard

升级到 1.2.2

以下步骤适用于ThingsBoard 1.2.1版本。

Ubuntu/CentOS

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v1.2.2/thingsboard-1.2.2.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v1.2.2/thingsboard-1.2.2.rpm

升级ThingsBoard服务

1
sudo dpkg -i thingsboard-1.2.2.deb
1
sudo rpm -Uvh thingsboard-1.2.2.rpm

数据库升级

下载升级脚本:

1
2
wget https://raw.githubusercontent.com/thingsboard/thingsboard.github.io/master/docs/user-guide/install/resources/1.2.2/upgrade_1.2.1_1.2.2.sh
wget https://raw.githubusercontent.com/thingsboard/thingsboard.github.io/master/docs/user-guide/install/resources/1.2.2/system_widgets.cql

运行主脚本:

1
2
chmod +x upgrade_1.2.1_1.2.2.sh
./upgrade_1.2.1_1.2.2.sh

启动服务

1
sudo service thingsboard start

Windows

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-1.2.2.zip.

升级ThingsBoard服务

  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。
  • 运行ThingsBoard安装目录中的uninstall.bat卸载之前版本的ThingsBoard服务。

注意 以上脚本需要以管理员身份运行。

1
C:\thingsboard>uninstall.bat
  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。
  • 运行install.bat脚本将新版本的ThingsBoard安装为Windows服务。
1
C:\thingsboard>install.bat

数据库升级

1
upgrade_1.2.1_1.2.2.bat

启动服务

1
net start thingsboard

升级到 1.2.3

以下步骤适用于ThingsBoard 1.2.2版本。

Ubuntu/CentOS

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v1.2.3/thingsboard-1.2.3.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v1.2.3/thingsboard-1.2.3.rpm

升级ThingsBoard服务

1
sudo dpkg -i thingsboard-1.2.3.deb
1
sudo rpm -Uvh thingsboard-1.2.3.rpm

数据库升级

下载升级脚本:

1
2
3
wget https://raw.githubusercontent.com/thingsboard/thingsboard.github.io/master/docs/user-guide/install/resources/1.2.3/upgrade_1.2.2_1.2.3.sh
wget https://raw.githubusercontent.com/thingsboard/thingsboard.github.io/master/docs/user-guide/install/resources/1.2.3/schema_update.cql
wget https://raw.githubusercontent.com/thingsboard/thingsboard.github.io/master/docs/user-guide/install/resources/1.2.3/system_widgets.cql

运行主脚本:

1
2
chmod +x upgrade_1.2.2_1.2.3.sh
./upgrade_1.2.2_1.2.3.sh

启动服务

1
sudo service thingsboard start

Windows

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-1.2.3.zip.

升级ThingsBoard服务

  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。
  • 运行ThingsBoard安装目录中的uninstall.bat卸载之前版本的ThingsBoard服务。

注意 以上脚本需要以管理员身份运行。

1
C:\thingsboard>uninstall.bat
  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。
  • 运行install.bat脚本将新版本的ThingsBoard安装为Windows服务。
1
C:\thingsboard>install.bat

数据库升级

1
upgrade_1.2.2_1.2.3.bat

启动服务

1
net start thingsboard

升级到 1.3.0

以下步骤适用于ThingsBoard 1.2.3版本。

Ubuntu/CentOS

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v1.3/thingsboard-1.3.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v1.3/thingsboard-1.3.rpm

升级ThingsBoard服务

1
sudo dpkg -i thingsboard-1.3.deb
1
sudo rpm -Uvh thingsboard-1.3.rpm

注意: 安装程序将提示您合并ThingsBoard配置。建议选择合并选项以确保不会覆盖之前的所有参数。 请确保将database.type参数值(在/etc/thingsboard/conf/thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:

1
2
database:
    type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

执行升级脚本:

1
sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=1.2.3 

启动服务

1
sudo service thingsboard start

Windows

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-1.3.zip.

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
net stop thingsboard
  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。
  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。
  • 请确保将database.type参数值(在<ThingsBoard安装目录>\conf\thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:
1
2
  database:
      type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql
  • 运行upgrade.bat脚本将ThingsBoard升级到新版本。

注意 以上脚本需要以管理员身份运行。

1
C:\thingsboard>upgrade.bat --fromVersion=1.2.3

启动服务

1
net start thingsboard

升级到 1.3.1

以下步骤适用于ThingsBoard 1.3.0版本。

Ubuntu/CentOS

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v1.3.1/thingsboard-1.3.1.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v1.3.1/thingsboard-1.3.1.rpm

升级ThingsBoard服务

1
sudo dpkg -i thingsboard-1.3.1.deb
1
sudo rpm -Uvh thingsboard-1.3.1.rpm

注意: 安装程序可能会提示您合并ThingsBoard配置。建议选择合并选项以确保不会覆盖之前的所有参数。
请确保将database.type参数值(在/etc/thingsboard/conf/thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:

1
2
database:
    type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

执行升级脚本:

1
sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=1.3.0 

启动服务

1
sudo service thingsboard start

Windows

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-1.3.1.zip.

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
net stop thingsboard
  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。
  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。
  • 请确保将database.type参数值(在<ThingsBoard安装目录>\conf\thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:
1
2
  database:
      type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql
  • 运行upgrade.bat脚本将ThingsBoard升级到新版本。

注意 以上脚本需要以管理员身份运行。

1
C:\thingsboard>upgrade.bat --fromVersion=1.3.0

启动服务

1
net start thingsboard

升级到 1.4.0

以下步骤适用于ThingsBoard 1.3.1版本。

Ubuntu/CentOS

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v1.4/thingsboard-1.4.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v1.4/thingsboard-1.4.rpm

升级ThingsBoard服务

1
sudo dpkg -i thingsboard-1.4.deb
1
sudo rpm -Uvh thingsboard-1.4.rpm

注意: 安装程序将提示您合并ThingsBoard配置。建议选择合并选项以确保不会覆盖之前的所有参数。 请确保将database.type参数值(在/etc/thingsboard/conf/thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:

1
2
database:
    type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

执行升级脚本:

1
sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=1.3.1

启动服务

1
sudo service thingsboard start

Windows

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-1.4.zip.

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
net stop thingsboard
  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。
  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。
  • 请确保将database.type参数值(在<ThingsBoard安装目录>\conf\thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:
1
2
  database:
      type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql
  • 运行upgrade.bat脚本将ThingsBoard升级到新版本。

注意 以上脚本需要以管理员身份运行。

1
C:\thingsboard>upgrade.bat --fromVersion=1.3.1

启动服务

1
net start thingsboard

升级到 2.0.0

以下步骤适用于ThingsBoard 1.4.0版本。

Ubuntu/CentOS

信息提示

重要说明


请注意:升级过程中,旧版规则和插件将从您的 ThingsBoard 实例中完全移除

旧规则和插件的功能由新版规则引擎组件(规则链与规则节点)取代。

若已配置规则或插件,请在升级前使用导出功能进行备份。 升级后需重新配置规则链以恢复原有业务逻辑。

详见新版规则引擎文档。

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.0/thingsboard-2.0.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.0/thingsboard-2.0.rpm

升级ThingsBoard服务

1
sudo dpkg -i thingsboard-2.0.deb
1
sudo rpm -Uvh thingsboard-2.0.rpm

注意: 安装程序将提示您合并ThingsBoard配置。建议选择合并选项以确保不会覆盖之前的所有参数。 请确保将database.type参数值(在/etc/thingsboard/conf/thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:

1
2
database:
    type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

执行升级脚本:

1
sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=1.4.0 

启动服务

1
sudo service thingsboard start

Windows

信息提示

重要说明


请注意:升级过程中,旧版规则和插件将从您的 ThingsBoard 实例中完全移除

旧规则和插件的功能由新版规则引擎组件(规则链与规则节点)取代。

若已配置规则或插件,请在升级前使用导出功能进行备份。 升级后需重新配置规则链以恢复原有业务逻辑。

详见新版规则引擎文档。

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-2.0.zip.

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
net stop thingsboard
  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。
  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。
  • 请确保将database.type参数值(在<ThingsBoard安装目录>\conf\thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:
1
2
  database:
      type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql
  • 运行upgrade.bat脚本将ThingsBoard升级到新版本。

注意 以上脚本需要以管理员身份运行。

1
C:\thingsboard>upgrade.bat --fromVersion=1.4.0

启动服务

1
net start thingsboard

升级到 2.0.1

以下步骤适用于ThingsBoard 2.0.0版本。

Ubuntu/CentOS

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.0.1/thingsboard-2.0.1.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.0.1/thingsboard-2.0.1.rpm

升级ThingsBoard服务

1
sudo dpkg -i thingsboard-2.0.1.deb
1
sudo rpm -Uvh thingsboard-2.0.1.rpm

注意: 安装程序将提示您合并ThingsBoard配置。建议选择合并选项以确保不会覆盖之前的所有参数。 请确保将database.type参数值(在/etc/thingsboard/conf/thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:

1
2
database:
    type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

启动服务

1
sudo service thingsboard start

Windows

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-2.0.1.zip.

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
net stop thingsboard
  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。
  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。
  • 请确保将database.type参数值(在<ThingsBoard安装目录>\conf\thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:
1
2
  database:
      type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

启动服务

1
net start thingsboard

升级到 2.0.2

以下步骤适用于ThingsBoard 2.0.1版本。

Ubuntu/CentOS

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.0.2/thingsboard-2.0.2.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.0.2/thingsboard-2.0.2.rpm

升级ThingsBoard服务

1
sudo dpkg -i thingsboard-2.0.2.deb
1
sudo rpm -Uvh thingsboard-2.0.2.rpm

注意: 安装程序将提示您合并ThingsBoard配置。建议选择合并选项以确保不会覆盖之前的所有参数。
请确保将database.type参数值(在/etc/thingsboard/conf/thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:

1
2
database:
    type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

启动服务

1
sudo service thingsboard start

Windows

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-2.0.2.zip.

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
net stop thingsboard
  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。
  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。
  • 请确保将database.type参数值(在<ThingsBoard安装目录>\conf\thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:
1
2
  database:
      type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

启动服务

1
net start thingsboard

升级到 2.0.3

以下步骤适用于ThingsBoard 2.0.2版本。

Ubuntu/CentOS

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.0.3/thingsboard-2.0.3.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.0.3/thingsboard-2.0.3.rpm

升级ThingsBoard服务

1
sudo dpkg -i thingsboard-2.0.3.deb
1
sudo rpm -Uvh thingsboard-2.0.3.rpm

注意: 安装程序将提示您合并ThingsBoard配置。建议选择合并选项以确保不会覆盖之前的所有参数。 请确保将database.type参数值(在/etc/thingsboard/conf/thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:

1
2
database:
    type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

启动服务

1
sudo service thingsboard start

Windows

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-2.0.3.zip.

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
net stop thingsboard
  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。
  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。
  • 请确保将database.type参数值(在<ThingsBoard安装目录>\conf\thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:
1
2
  database:
      type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

启动服务

1
net start thingsboard

升级到 2.1.0

以下步骤适用于ThingsBoard 2.0.3版本。

Ubuntu/CentOS

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.1/thingsboard-2.1.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.1/thingsboard-2.1.rpm

升级ThingsBoard服务

1
sudo dpkg -i thingsboard-2.1.deb
1
sudo rpm -Uvh thingsboard-2.1.rpm

注意: 安装程序将提示您合并ThingsBoard配置。建议选择合并选项以确保不会覆盖之前的所有参数。 请确保将database.type参数值(在/etc/thingsboard/conf/thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:

1
2
database:
    type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

启动服务

1
sudo service thingsboard start

Windows

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-2.1.zip.

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
net stop thingsboard
  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。
  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。
  • 请确保将database.type参数值(在<ThingsBoard安装目录>\conf\thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:
1
2
  database:
      type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

启动服务

1
net start thingsboard

升级到 2.2.0

以下步骤适用于ThingsBoard 2.1.0, 2.1.1, 2.1.2 and 2.1.3版本。

Ubuntu/CentOS

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.2/thingsboard-2.2.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.2/thingsboard-2.2.rpm

升级ThingsBoard服务

1
sudo dpkg -i thingsboard-2.2.deb
1
sudo rpm -Uvh thingsboard-2.2.rpm

注意: 安装程序将提示您合并ThingsBoard配置。建议选择合并选项以确保不会覆盖之前的所有参数。
请确保将database.entities.typedatabase.ts.type参数值(在/etc/thingsboard/conf/thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:

1
2
3
4
5
    database:
      entities:
        type: "${DATABASE_ENTITIES_TYPE:cassandra}" # cassandra OR sql
      ts:
        type: "${DATABASE_TS_TYPE:cassandra}" # cassandra OR sql (for hybrid mode, only this value should be cassandra)

执行升级脚本:

1
sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=2.0.0 

启动服务

1
sudo service thingsboard start

Windows

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-2.2.zip.

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
net stop thingsboard
  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。
  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。
  • 请确保将database.entities.typedatabase.ts.type参数值(在<ThingsBoard安装目录>\conf\thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:
1
2
3
4
5
  database:
    entities:
      type: "${DATABASE_ENTITIES_TYPE:cassandra}" # cassandra OR sql
    ts:
      type: "${DATABASE_TS_TYPE:cassandra}" # cassandra OR sql (for hybrid mode, only this value should be cassandra)
  • 运行upgrade.bat脚本将ThingsBoard升级到新版本。

注意 以上脚本需要以管理员身份运行。

1
C:\thingsboard>upgrade.bat --fromVersion=2.0.0

启动服务

1
net start thingsboard

升级到 2.3.0

以下步骤适用于ThingsBoard 2.2.0版本。

Ubuntu/CentOS

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.3/thingsboard-2.3.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.3/thingsboard-2.3.rpm

升级ThingsBoard服务

1
sudo dpkg -i thingsboard-2.3.deb
1
sudo rpm -Uvh thingsboard-2.3.rpm

注意: 安装程序将提示您合并ThingsBoard配置。建议选择合并选项以确保不会覆盖之前的所有参数。
请确保将database.entities.typedatabase.ts.type参数值(在/etc/thingsboard/conf/thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:

1
2
3
4
5
    database:
      entities:
        type: "${DATABASE_ENTITIES_TYPE:cassandra}" # cassandra OR sql
      ts:
        type: "${DATABASE_TS_TYPE:cassandra}" # cassandra OR sql (for hybrid mode, only this value should be cassandra)

执行升级脚本

1
sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=2.2.0 

启动服务

1
sudo service thingsboard start

Windows

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-2.3.zip.

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
net stop thingsboard
  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。
  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。
  • 请确保将database.entities.typedatabase.ts.type参数值(在<ThingsBoard安装目录>\conf\thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:
1
2
3
4
5
  database:
    entities:
      type: "${DATABASE_ENTITIES_TYPE:cassandra}" # cassandra OR sql
    ts:
      type: "${DATABASE_TS_TYPE:cassandra}" # cassandra OR sql (for hybrid mode, only this value should be cassandra)
  • 运行upgrade.bat脚本将ThingsBoard升级到新版本。

注意 以上脚本需要以管理员身份运行。

1
C:\thingsboard>upgrade.bat --fromVersion=2.2.0

启动服务

1
net start thingsboard

升级到 2.4.0

以下步骤适用于ThingsBoard 2.3.1版本。

Ubuntu/CentOS

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.4/thingsboard-2.4.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.4/thingsboard-2.4.rpm

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
$ sudo service thingsboard stop
1
sudo dpkg -i thingsboard-2.4.deb
1
sudo rpm -Uvh thingsboard-2.4.rpm

注意: 安装程序将提示您合并ThingsBoard配置。建议选择合并选项以确保不会覆盖之前的所有参数。
请确保将database.entities.typedatabase.ts.type参数值(在/etc/thingsboard/conf/thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:

1
2
3
4
5
    database:
      entities:
        type: "${DATABASE_ENTITIES_TYPE:cassandra}" # cassandra OR sql
      ts:
        type: "${DATABASE_TS_TYPE:cassandra}" # cassandra OR sql (for hybrid mode, only this value should be cassandra)

执行升级脚本:

1
sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=2.3.1 

启动服务

文档信息图标

若将 Redis 用于缓存,在启动 ThingsBoard 前需清空所有已存储的 key。

连接到您的 Redis 实例(或 container/pod,视部署方式而定),执行:

redis-cli flushall

注意:仅当 Redis 专门用于 ThingsBoard 时可使用此命令。若其他应用也使用 Redis,需定位 ThingsBoard 使用的数据库并仅清空该库。默认数据库 index 为 0,可通过 ThingsBoard 环境变量 REDIS_DB 配置。

redis-cli

select 0

flushdb

1
sudo service thingsboard start

Windows

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-2.4.zip.

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
net stop thingsboard
  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。

  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。
  • 请确保将database.entities.typedatabase.ts.type参数值(在<ThingsBoard安装目录>\conf\thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:
1
2
3
4
5
  database:
    entities:
      type: "${DATABASE_ENTITIES_TYPE:cassandra}" # cassandra OR sql
    ts:
      type: "${DATABASE_TS_TYPE:cassandra}" # cassandra OR sql (for hybrid mode, only this value should be cassandra)
  • 运行upgrade.bat脚本将ThingsBoard升级到新版本。

注意 以上脚本需要以管理员身份运行。

1
C:\thingsboard>upgrade.bat --fromVersion=2.3.1

启动服务

文档信息图标

若将 Redis 用于缓存,在启动 ThingsBoard 前需清空所有已存储的 key。

连接到您的 Redis 实例(或 container/pod,视部署方式而定),执行:

redis-cli flushall

注意:仅当 Redis 专门用于 ThingsBoard 时可使用此命令。若其他应用也使用 Redis,需定位 ThingsBoard 使用的数据库并仅清空该库。默认数据库 index 为 0,可通过 ThingsBoard 环境变量 REDIS_DB 配置。

redis-cli

select 0

flushdb

1
net start thingsboard

升级到 2.4.1

以下步骤适用于ThingsBoard 2.4.0版本。

Ubuntu/CentOS

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.4.1/thingsboard-2.4.1.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.4.1/thingsboard-2.4.1.rpm

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
$ sudo service thingsboard stop
1
sudo dpkg -i thingsboard-2.4.1.deb
1
sudo rpm -Uvh thingsboard-2.4.1.rpm

注意: 安装程序将提示您合并ThingsBoard配置。建议选择合并选项以确保不会覆盖之前的所有参数。
请确保将database.entities.typedatabase.ts.type参数值(在/etc/thingsboard/conf/thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:

1
2
3
4
5
    database:
      entities:
        type: "${DATABASE_ENTITIES_TYPE:cassandra}" # cassandra OR sql
      ts:
        type: "${DATABASE_TS_TYPE:cassandra}" # cassandra OR sql (for hybrid mode, only this value should be cassandra)

执行升级脚本:

1
sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=2.4.0 

启动服务

文档信息图标

若将 Redis 用于缓存,在启动 ThingsBoard 前需清空所有已存储的 key。

连接到您的 Redis 实例(或 container/pod,视部署方式而定),执行:

redis-cli flushall

注意:仅当 Redis 专门用于 ThingsBoard 时可使用此命令。若其他应用也使用 Redis,需定位 ThingsBoard 使用的数据库并仅清空该库。默认数据库 index 为 0,可通过 ThingsBoard 环境变量 REDIS_DB 配置。

redis-cli

select 0

flushdb

1
sudo service thingsboard start

Windows

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-2.4.1.zip.

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
net stop thingsboard
  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。
  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。
  • 请确保将database.entities.typedatabase.ts.type参数值(在<ThingsBoard安装目录>\conf\thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:
1
2
3
4
5
  database:
    entities:
      type: "${DATABASE_ENTITIES_TYPE:cassandra}" # cassandra OR sql
    ts:
      type: "${DATABASE_TS_TYPE:cassandra}" # cassandra OR sql (for hybrid mode, only this value should be cassandra)
  • 运行upgrade.bat脚本将ThingsBoard升级到新版本。

注意 以上脚本需要以管理员身份运行。

1
C:\thingsboard>upgrade.bat --fromVersion=2.4.0

启动服务

文档信息图标

若将 Redis 用于缓存,在启动 ThingsBoard 前需清空所有已存储的 key。

连接到您的 Redis 实例(或 container/pod,视部署方式而定),执行:

redis-cli flushall

注意:仅当 Redis 专门用于 ThingsBoard 时可使用此命令。若其他应用也使用 Redis,需定位 ThingsBoard 使用的数据库并仅清空该库。默认数据库 index 为 0,可通过 ThingsBoard 环境变量 REDIS_DB 配置。

redis-cli

select 0

flushdb

1
net start thingsboard

升级到 2.4.2.1

以下步骤适用于ThingsBoard 2.4.1 and 2.4.2版本。

Ubuntu/CentOS

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.4.2.1/thingsboard-2.4.2.1.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.4.2.1/thingsboard-2.4.2.1.rpm

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
$ sudo service thingsboard stop
1
sudo dpkg -i thingsboard-2.4.2.1.deb
1
sudo rpm -Uvh thingsboard-2.4.2.1.rpm

注意: 安装程序将提示您合并ThingsBoard配置。建议选择合并选项以确保不会覆盖之前的所有参数。
请确保将database.entities.typedatabase.ts.type参数值(在/etc/thingsboard/conf/thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:

1
2
3
4
5
    database:
      entities:
        type: "${DATABASE_ENTITIES_TYPE:cassandra}" # cassandra OR sql
      ts:
        type: "${DATABASE_TS_TYPE:cassandra}" # cassandra OR sql (for hybrid mode, only this value should be cassandra)

执行升级脚本:

1
sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=2.4.1 

启动服务

文档信息图标

若将 Redis 用于缓存,在启动 ThingsBoard 前需清空所有已存储的 key。

连接到您的 Redis 实例(或 container/pod,视部署方式而定),执行:

redis-cli flushall

注意:仅当 Redis 专门用于 ThingsBoard 时可使用此命令。若其他应用也使用 Redis,需定位 ThingsBoard 使用的数据库并仅清空该库。默认数据库 index 为 0,可通过 ThingsBoard 环境变量 REDIS_DB 配置。

redis-cli

select 0

flushdb

1
sudo service thingsboard start

Windows

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-2.4.2.1.zip.

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
net stop thingsboard
  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。
  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。
  • 请确保将database.entities.typedatabase.ts.type参数值(在<ThingsBoard安装目录>\conf\thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:
1
2
3
4
5
  database:
    entities:
      type: "${DATABASE_ENTITIES_TYPE:cassandra}" # cassandra OR sql
    ts:
      type: "${DATABASE_TS_TYPE:cassandra}" # cassandra OR sql (for hybrid mode, only this value should be cassandra)
  • 运行upgrade.bat脚本将ThingsBoard升级到新版本。

注意 以上脚本需要以管理员身份运行。

1
C:\thingsboard>upgrade.bat --fromVersion=2.4.1

启动服务

文档信息图标

若将 Redis 用于缓存,在启动 ThingsBoard 前需清空所有已存储的 key。

连接到您的 Redis 实例(或 container/pod,视部署方式而定),执行:

redis-cli flushall

注意:仅当 Redis 专门用于 ThingsBoard 时可使用此命令。若其他应用也使用 Redis,需定位 ThingsBoard 使用的数据库并仅清空该库。默认数据库 index 为 0,可通过 ThingsBoard 环境变量 REDIS_DB 配置。

redis-cli

select 0

flushdb

1
net start thingsboard

升级到 2.4.3

以下步骤适用于ThingsBoard 2.4.2 and 2.4.2.1版本。

Ubuntu/CentOS

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.4.3/thingsboard-2.4.3.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.4.3/thingsboard-2.4.3.rpm

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
$ sudo service thingsboard stop
1
sudo dpkg -i thingsboard-2.4.3.deb
1
sudo rpm -Uvh thingsboard-2.4.3.rpm

注意: 安装程序将提示您合并ThingsBoard配置。建议选择合并选项以确保不会覆盖之前的所有参数。
请确保将database.entities.typedatabase.ts.type参数值(在/etc/thingsboard/conf/thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:

1
2
3
4
5
    database:
      entities:
        type: "${DATABASE_ENTITIES_TYPE:cassandra}" # cassandra OR sql
      ts:
        type: "${DATABASE_TS_TYPE:cassandra}" # cassandra OR sql (for hybrid mode, only this value should be cassandra)

执行升级脚本:

1
sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=2.4.2

启动服务

文档信息图标

若将 Redis 用于缓存,在启动 ThingsBoard 前需清空所有已存储的 key。

连接到您的 Redis 实例(或 container/pod,视部署方式而定),执行:

redis-cli flushall

注意:仅当 Redis 专门用于 ThingsBoard 时可使用此命令。若其他应用也使用 Redis,需定位 ThingsBoard 使用的数据库并仅清空该库。默认数据库 index 为 0,可通过 ThingsBoard 环境变量 REDIS_DB 配置。

redis-cli

select 0

flushdb

1
sudo service thingsboard start

Windows

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-2.4.3.zip.

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
net stop thingsboard
  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。

  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。
  • 请确保将database.entities.typedatabase.ts.type参数值(在<ThingsBoard安装目录>\conf\thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:
1
2
3
4
5
  database:
    entities:
      type: "${DATABASE_ENTITIES_TYPE:cassandra}" # cassandra OR sql
    ts:
      type: "${DATABASE_TS_TYPE:cassandra}" # cassandra OR sql (for hybrid mode, only this value should be cassandra)
  • 运行upgrade.bat脚本将ThingsBoard升级到新版本。

注意 以上脚本需要以管理员身份运行。

1
C:\thingsboard>upgrade.bat --fromVersion=2.4.2

启动服务

文档信息图标

若将 Redis 用于缓存,在启动 ThingsBoard 前需清空所有已存储的 key。

连接到您的 Redis 实例(或 container/pod,视部署方式而定),执行:

redis-cli flushall

注意:仅当 Redis 专门用于 ThingsBoard 时可使用此命令。若其他应用也使用 Redis,需定位 ThingsBoard 使用的数据库并仅清空该库。默认数据库 index 为 0,可通过 ThingsBoard 环境变量 REDIS_DB 配置。

redis-cli

select 0

flushdb

1
net start thingsboard

升级到 2.5

以下步骤适用于ThingsBoard 2.4.3版本。

Ubuntu/CentOS

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.5/thingsboard-2.5.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.5/thingsboard-2.5.rpm

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
$ sudo service thingsboard stop
1
sudo dpkg -i thingsboard-2.5.deb
1
sudo rpm -Uvh thingsboard-2.5.rpm

注意: 如果使用PostgreSQL数据库,从2.4.3升级到2.5版本时需要将PostgreSQL服务升级到11.x版本。

请参考以下指南了解如何在对应平台上升级PostgreSQL服务:

注意: 安装程序将提示您合并ThingsBoard配置。建议选择合并选项以确保不会覆盖之前的所有参数。
请确保将database.entities.typedatabase.ts.type参数值(在/etc/thingsboard/conf/thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:

1
2
3
4
5
6
7
8
  database:
    ts_max_intervals: "${DATABASE_TS_MAX_INTERVALS:700}" # Max number of DB queries generated by single API call to fetch telemetry records
    entities:
      type: "${DATABASE_ENTITIES_TYPE:sql}" # cassandra OR sql
    ts:
      type: "${DATABASE_TS_TYPE:sql}" # cassandra, sql, or timescale (for hybrid mode, DATABASE_TS_TYPE value should be cassandra, or timescale)
  
  # note: timescale works only with postgreSQL database for DATABASE_ENTITIES_TYPE.

注意: 如果您使用PostgreSql(Sql)存储时间序列数据,在执行升级脚本之前需要进入PostgreSQL终端(psql)并按以下说明操作:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
  # Connect to thingsboard database:
  \c thingsboard
  
  # Execute the next commands:
  
  # Update ts_kv table constraints:
  ALTER TABLE ts_kv DROP CONSTRAINT IF EXISTS ts_kv_unq_key;
  ALTER TABLE ts_kv DROP CONSTRAINT IF EXISTS ts_kv_pkey;
  ALTER TABLE ts_kv ADD CONSTRAINT ts_kv_pkey PRIMARY KEY (entity_type, entity_id, key, ts);
  
  # Update ts_kv_latest table constraints:
  ALTER TABLE ts_kv_latest DROP CONSTRAINT IF EXISTS ts_kv_latest_unq_key;
  ALTER TABLE ts_kv_latest DROP CONSTRAINT IF EXISTS ts_kv_latest_pkey;
  ALTER TABLE ts_kv_latest ADD CONSTRAINT ts_kv_latest_pkey PRIMARY KEY (entity_type, entity_id, key);
  
  # exit psql terminal 
  \q

最后,执行升级脚本:

1
sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=2.4.3

启动服务

文档信息图标

若将 Redis 用于缓存,在启动 ThingsBoard 前需清空所有已存储的 key。

连接到您的 Redis 实例(或 container/pod,视部署方式而定),执行:

redis-cli flushall

注意:仅当 Redis 专门用于 ThingsBoard 时可使用此命令。若其他应用也使用 Redis,需定位 ThingsBoard 使用的数据库并仅清空该库。默认数据库 index 为 0,可通过 ThingsBoard 环境变量 REDIS_DB 配置。

redis-cli

select 0

flushdb

1
sudo service thingsboard start

Windows

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-2.5.zip.

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
net stop thingsboard
  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。
  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。
  • 请注意,如果使用PostgreSQL数据库,从旧版本升级到新版本时需要将PostgreSQL服务升级到11.x版本。
  • 请确保将database.entities.typedatabase.ts.type参数值(在<ThingsBoard安装目录>\conf\thingsboard.yml文件中)设置为”cassandra”而不是”sql”以升级Cassandra数据库:
1
2
3
4
5
6
7
8
  database:
    ts_max_intervals: "${DATABASE_TS_MAX_INTERVALS:700}" # Max number of DB queries generated by single API call to fetch telemetry records
    entities:
      type: "${DATABASE_ENTITIES_TYPE:sql}" # cassandra OR sql
    ts:
      type: "${DATABASE_TS_TYPE:sql}" # cassandra, sql, or timescale (for hybrid mode, DATABASE_TS_TYPE value should be cassandra, or timescale)
  
  # note: timescale works only with postgreSQL database for DATABASE_ENTITIES_TYPE.

注意: 如果您使用PostgreSql(Sql)存储时间序列数据,在执行升级脚本之前需要访问psql终端。登录psql终端后,请按以下说明操作:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
  # Connect to thingsboard database:
  \c thingsboard
  
  # Execute the next commands:
  
  # Update ts_kv table constraints:
  ALTER TABLE ts_kv DROP CONSTRAINT IF EXISTS ts_kv_unq_key;
  ALTER TABLE ts_kv DROP CONSTRAINT IF EXISTS ts_kv_pkey;
  ALTER TABLE ts_kv ADD CONSTRAINT ts_kv_pkey PRIMARY KEY (entity_type, entity_id, key, ts);
  
  # Update ts_kv_latest table constraints:
  ALTER TABLE ts_kv_latest DROP CONSTRAINT IF EXISTS ts_kv_latest_unq_key;
  ALTER TABLE ts_kv_latest DROP CONSTRAINT IF EXISTS ts_kv_latest_pkey;
  ALTER TABLE ts_kv_latest ADD CONSTRAINT ts_kv_latest_pkey PRIMARY KEY (entity_type, entity_id, key);
  
  # exit psql terminal 
  \q
  • 最后,运行upgrade.bat脚本将ThingsBoard升级到新版本。

注意 以上脚本需要以管理员身份运行。

1
C:\thingsboard>upgrade.bat --fromVersion=2.4.3

启动服务

文档信息图标

若将 Redis 用于缓存,在启动 ThingsBoard 前需清空所有已存储的 key。

连接到您的 Redis 实例(或 container/pod,视部署方式而定),执行:

redis-cli flushall

注意:仅当 Redis 专门用于 ThingsBoard 时可使用此命令。若其他应用也使用 Redis,需定位 ThingsBoard 使用的数据库并仅清空该库。默认数据库 index 为 0,可通过 ThingsBoard 环境变量 REDIS_DB 配置。

redis-cli

select 0

flushdb

1
net start thingsboard

升级到 2.5.1

以下步骤适用于ThingsBoard 2.4.3+版本。

Ubuntu/CentOS

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.5.1/thingsboard-2.5.1.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.5.1/thingsboard-2.5.1.rpm

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
$ sudo service thingsboard stop
1
sudo dpkg -i thingsboard-2.5.1.deb
1
sudo rpm -Uvh thingsboard-2.5.1.rpm

注意: 如果使用PostgreSQL数据库,升级ThingsBoard时需要将PostgreSQL服务升级到11.x版本。

请参考以下指南了解如何在对应平台上升级PostgreSQL服务:

注意: 安装程序将提示您合并ThingsBoard配置。建议选择合并选项以确保不会覆盖之前的所有参数。

最后,执行升级脚本并指定您之前的ThingsBoard版本:

1
sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=2.4.3

启动服务

文档信息图标

若将 Redis 用于缓存,在启动 ThingsBoard 前需清空所有已存储的 key。

连接到您的 Redis 实例(或 container/pod,视部署方式而定),执行:

redis-cli flushall

注意:仅当 Redis 专门用于 ThingsBoard 时可使用此命令。若其他应用也使用 Redis,需定位 ThingsBoard 使用的数据库并仅清空该库。默认数据库 index 为 0,可通过 ThingsBoard 环境变量 REDIS_DB 配置。

redis-cli

select 0

flushdb

1
sudo service thingsboard start

Windows

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-2.5.1.zip.

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
net stop thingsboard
  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。
  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。
  • 请注意,如果使用PostgreSQL数据库,从旧版本升级到新版本时需要将PostgreSQL服务升级到11.x版本。

  • 最后,运行upgrade.bat脚本将ThingsBoard升级到新版本。

注意 以上脚本需要以管理员身份运行。

1
C:\thingsboard>upgrade.bat --fromVersion=2.4.3

启动服务

文档信息图标

若将 Redis 用于缓存,在启动 ThingsBoard 前需清空所有已存储的 key。

连接到您的 Redis 实例(或 container/pod,视部署方式而定),执行:

redis-cli flushall

注意:仅当 Redis 专门用于 ThingsBoard 时可使用此命令。若其他应用也使用 Redis,需定位 ThingsBoard 使用的数据库并仅清空该库。默认数据库 index 为 0,可通过 ThingsBoard 环境变量 REDIS_DB 配置。

redis-cli

select 0

flushdb

1
net start thingsboard

升级到 2.5.2

Ubuntu/CentOS

注意:以下升级步骤适用于ThingsBoard 2.5.1版本。要升级到2.5.2版本,您需要先upgrade to 2.5.1 first.

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.5.2/thingsboard-2.5.2.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.5.2/thingsboard-2.5.2.rpm

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
$ sudo service thingsboard stop
1
sudo dpkg -i thingsboard-2.5.2.deb
1
sudo rpm -Uvh thingsboard-2.5.2.rpm

注意: 如果使用PostgreSQL数据库,升级ThingsBoard时需要将PostgreSQL服务升级到11.x版本。

请参考以下指南了解如何在对应平台上升级PostgreSQL服务:

注意: 安装程序将提示您合并ThingsBoard配置。建议选择合并选项以确保不会覆盖之前的所有参数。

启动服务

文档信息图标

若将 Redis 用于缓存,在启动 ThingsBoard 前需清空所有已存储的 key。

连接到您的 Redis 实例(或 container/pod,视部署方式而定),执行:

redis-cli flushall

注意:仅当 Redis 专门用于 ThingsBoard 时可使用此命令。若其他应用也使用 Redis,需定位 ThingsBoard 使用的数据库并仅清空该库。默认数据库 index 为 0,可通过 ThingsBoard 环境变量 REDIS_DB 配置。

redis-cli

select 0

flushdb

1
sudo service thingsboard start

Windows

注意:以下升级步骤适用于ThingsBoard 2.5.1版本。要升级到2.5.2版本,您需要先upgrade to 2.5.1 first.

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-2.5.2.zip.

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
net stop thingsboard
  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。

  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。
  • 请注意,如果使用PostgreSQL数据库,从旧版本升级到新版本时需要将PostgreSQL服务升级到11.x版本。

  • 最后,运行upgrade.bat脚本将ThingsBoard升级到新版本。

注意 以上脚本需要以管理员身份运行。

1
C:\thingsboard>upgrade.bat --fromVersion=2.4.3

启动服务

文档信息图标

若将 Redis 用于缓存,在启动 ThingsBoard 前需清空所有已存储的 key。

连接到您的 Redis 实例(或 container/pod,视部署方式而定),执行:

redis-cli flushall

注意:仅当 Redis 专门用于 ThingsBoard 时可使用此命令。若其他应用也使用 Redis,需定位 ThingsBoard 使用的数据库并仅清空该库。默认数据库 index 为 0,可通过 ThingsBoard 环境变量 REDIS_DB 配置。

redis-cli

select 0

flushdb

1
net start thingsboard

升级到 2.5.3

Ubuntu/CentOS

注意:以下升级步骤适用于ThingsBoard 2.5.2版本。要升级到2.5.3版本,您需要先upgrade to 2.5.2 first.

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.5.3/thingsboard-2.5.3.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.5.3/thingsboard-2.5.3.rpm

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
$ sudo service thingsboard stop
1
sudo dpkg -i thingsboard-2.5.3.deb
1
sudo rpm -Uvh thingsboard-2.5.3.rpm

注意: 安装程序将提示您合并ThingsBoard配置。建议选择合并选项以确保不会覆盖之前的所有参数。

启动服务

文档信息图标

若将 Redis 用于缓存,在启动 ThingsBoard 前需清空所有已存储的 key。

连接到您的 Redis 实例(或 container/pod,视部署方式而定),执行:

redis-cli flushall

注意:仅当 Redis 专门用于 ThingsBoard 时可使用此命令。若其他应用也使用 Redis,需定位 ThingsBoard 使用的数据库并仅清空该库。默认数据库 index 为 0,可通过 ThingsBoard 环境变量 REDIS_DB 配置。

redis-cli

select 0

flushdb

1
sudo service thingsboard start

Windows

注意:以下升级步骤适用于ThingsBoard 2.5.2版本。要升级到2.5.3版本,您需要先upgrade to 2.5.2 first.

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-2.5.3.zip.

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
net stop thingsboard
  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。

  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。

启动服务

文档信息图标

若将 Redis 用于缓存,在启动 ThingsBoard 前需清空所有已存储的 key。

连接到您的 Redis 实例(或 container/pod,视部署方式而定),执行:

redis-cli flushall

注意:仅当 Redis 专门用于 ThingsBoard 时可使用此命令。若其他应用也使用 Redis,需定位 ThingsBoard 使用的数据库并仅清空该库。默认数据库 index 为 0,可通过 ThingsBoard 环境变量 REDIS_DB 配置。

redis-cli

select 0

flushdb

1
net start thingsboard

升级到 2.5.4

Ubuntu/CentOS

注意:以下升级步骤适用于ThingsBoard 2.5.3版本。要升级到2.5.4版本,您需要先upgrade to 2.5.3 first.

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.5.4/thingsboard-2.5.4.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.5.4/thingsboard-2.5.4.rpm

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
$ sudo service thingsboard stop
1
sudo dpkg -i thingsboard-2.5.4.deb
1
sudo rpm -Uvh thingsboard-2.5.4.rpm

注意: 安装程序将提示您合并ThingsBoard配置。建议选择合并选项以确保不会覆盖之前的所有参数。

启动服务

文档信息图标

若将 Redis 用于缓存,在启动 ThingsBoard 前需清空所有已存储的 key。

连接到您的 Redis 实例(或 container/pod,视部署方式而定),执行:

redis-cli flushall

注意:仅当 Redis 专门用于 ThingsBoard 时可使用此命令。若其他应用也使用 Redis,需定位 ThingsBoard 使用的数据库并仅清空该库。默认数据库 index 为 0,可通过 ThingsBoard 环境变量 REDIS_DB 配置。

redis-cli

select 0

flushdb

1
sudo service thingsboard start

Windows

注意:以下升级步骤适用于ThingsBoard 2.5.3版本。要升级到2.5.4版本,您需要先upgrade to 2.5.3 first.

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-2.5.4.zip.

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
net stop thingsboard
  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。

  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。

启动服务

文档信息图标

若将 Redis 用于缓存,在启动 ThingsBoard 前需清空所有已存储的 key。

连接到您的 Redis 实例(或 container/pod,视部署方式而定),执行:

redis-cli flushall

注意:仅当 Redis 专门用于 ThingsBoard 时可使用此命令。若其他应用也使用 Redis,需定位 ThingsBoard 使用的数据库并仅清空该库。默认数据库 index 为 0,可通过 ThingsBoard 环境变量 REDIS_DB 配置。

redis-cli

select 0

flushdb

1
net start thingsboard

升级到 2.5.5

Ubuntu/CentOS

注意:以下升级步骤适用于ThingsBoard 2.5.4版本。要升级到2.5.5版本,您需要先upgrade to 2.5.4 first.

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.5.5/thingsboard-2.5.5.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.5.5/thingsboard-2.5.5.rpm

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
$ sudo service thingsboard stop
1
sudo dpkg -i thingsboard-2.5.5.deb
1
sudo rpm -Uvh thingsboard-2.5.5.rpm

注意: 安装程序将提示您合并ThingsBoard配置。建议选择合并选项以确保不会覆盖之前的所有参数。

启动服务

文档信息图标

若将 Redis 用于缓存,在启动 ThingsBoard 前需清空所有已存储的 key。

连接到您的 Redis 实例(或 container/pod,视部署方式而定),执行:

redis-cli flushall

注意:仅当 Redis 专门用于 ThingsBoard 时可使用此命令。若其他应用也使用 Redis,需定位 ThingsBoard 使用的数据库并仅清空该库。默认数据库 index 为 0,可通过 ThingsBoard 环境变量 REDIS_DB 配置。

redis-cli

select 0

flushdb

1
sudo service thingsboard start

Windows

注意:以下升级步骤适用于ThingsBoard 2.5.4版本。要升级到2.5.5版本,您需要先upgrade to 2.5.4 first.

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-2.5.5.zip.

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
net stop thingsboard
  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。
  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。

启动服务

文档信息图标

若将 Redis 用于缓存,在启动 ThingsBoard 前需清空所有已存储的 key。

连接到您的 Redis 实例(或 container/pod,视部署方式而定),执行:

redis-cli flushall

注意:仅当 Redis 专门用于 ThingsBoard 时可使用此命令。若其他应用也使用 Redis,需定位 ThingsBoard 使用的数据库并仅清空该库。默认数据库 index 为 0,可通过 ThingsBoard 环境变量 REDIS_DB 配置。

redis-cli

select 0

flushdb

1
net start thingsboard

升级到 2.5.6

Ubuntu/CentOS

注意:以下升级步骤适用于ThingsBoard 2.5.5版本。要升级到2.5.6版本,您需要先upgrade to 2.5.5 first.

下载ThingsBoard安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.5.6/thingsboard-2.5.6.deb
1
wget https://github.com/thingsboard/thingsboard/releases/download/v2.5.6/thingsboard-2.5.6.rpm

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
$ sudo service thingsboard stop
1
sudo dpkg -i thingsboard-2.5.6.deb
1
sudo rpm -Uvh thingsboard-2.5.6.rpm

注意: 安装程序将提示您合并ThingsBoard配置。建议选择合并选项以确保不会覆盖之前的所有参数。

启动服务

文档信息图标

若将 Redis 用于缓存,在启动 ThingsBoard 前需清空所有已存储的 key。

连接到您的 Redis 实例(或 container/pod,视部署方式而定),执行:

redis-cli flushall

注意:仅当 Redis 专门用于 ThingsBoard 时可使用此命令。若其他应用也使用 Redis,需定位 ThingsBoard 使用的数据库并仅清空该库。默认数据库 index 为 0,可通过 ThingsBoard 环境变量 REDIS_DB 配置。

redis-cli

select 0

flushdb

1
sudo service thingsboard start

Windows

注意:以下升级步骤适用于ThingsBoard 2.5.5版本。要升级到2.5.6版本,您需要先upgrade to 2.5.5 first.

下载ThingsBoard安装包

下载Windows版ThingsBoard安装包: thingsboard-windows-2.5.6.zip.

升级ThingsBoard服务

  • 如果ThingsBoard服务正在运行,请先停止它。
1
net stop thingsboard
  • 备份之前的ThingsBoard配置,配置位于<ThingsBoard安装目录>\conf(例如C:\thingsboard\conf)。

  • 删除ThingsBoard安装目录。
  • 将安装包解压到ThingsBoard安装目录。
  • 将旧的ThingsBoard配置文件(来自第一步的备份)与新配置文件进行比较。

启动服务

文档信息图标

若将 Redis 用于缓存,在启动 ThingsBoard 前需清空所有已存储的 key。

连接到您的 Redis 实例(或 container/pod,视部署方式而定),执行:

redis-cli flushall

注意:仅当 Redis 专门用于 ThingsBoard 时可使用此命令。若其他应用也使用 Redis,需定位 ThingsBoard 使用的数据库并仅清空该库。默认数据库 index 为 0,可通过 ThingsBoard 环境变量 REDIS_DB 配置。

redis-cli

select 0

flushdb

1
net start thingsboard

下一步