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

ThingsBoard CE v3.3.x Ubuntu升级说明

将 ThingsBoard CE 升级到 3.3.4.1

文档信息图标

注意:

本升级步骤适用于 ThingsBoard 版本 3.3.4。 要升级到 3.3.4.1,需先升级到 3.3.4

下载 ThingsBoard 安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v3.3.4.1/thingsboard-3.3.4.1.deb

ThingsBoard 服务升级

  • 若 ThingsBoard 服务正在运行,请先停止。
1
sudo service thingsboard stop
1
sudo dpkg -i thingsboard-3.3.4.1.deb
文档信息图标

注意:
安装包可能会提示合并 ThingsBoard 配置。建议选择合并选项,以确保先前参数不会被覆盖。

启动服务

1
sudo service thingsboard start

将 ThingsBoard CE 升级到 3.3.4

文档信息图标

注意:

本升级步骤适用于 ThingsBoard 版本 3.3.3。 要升级到 3.3.4,需先升级到 3.3.3

下载 ThingsBoard 安装包

1
wget https://github.com/thingsboard/thingsboard/releases/download/v3.3.4/thingsboard-3.3.4.deb

ThingsBoard 服务升级

  • 若 ThingsBoard 服务正在运行,请先停止。
1
sudo service thingsboard stop
1
sudo dpkg -i thingsboard-3.3.4.deb
文档信息图标

注意:
安装包可能会提示合并 ThingsBoard 配置。建议选择合并选项,以确保先前参数不会被覆盖。

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

启动服务

1
sudo service thingsboard start

Upgrading ThingsBoard CE to 3.3.3

NOTE: These upgrade steps are applicable for ThingsBoard version 3.3.2. In order to upgrade to 3.3.3 you need to upgrade to 3.3.2 first.

文档信息图标

升级至 ThingsBoard 3.3.3 前的重要提示

ThingsBoard UI 已迁移至 Angular 12。您需要在 Angular 12 上重新构建自定义部件和规则节点(使用 UI 的部分)。

ThingsBoard package download

1
wget https://github.com/thingsboard/thingsboard/releases/download/v3.3.3/thingsboard-3.3.3.deb

ThingsBoard service upgrade

  • Stop ThingsBoard service if it is running.
1
$ sudo service thingsboard stop
1
sudo dpkg -i thingsboard-3.3.3.deb

NOTE: Package installer may ask you to merge your thingsboard configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.

Execute regular upgrade script:

1
2
# Execute regular upgrade script
$ sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=3.3.2

Start the service

1
$ sudo service thingsboard start

Upgrading ThingsBoard CE to 3.3.2

NOTE: These upgrade steps are applicable for ThingsBoard version 3.3.1. In order to upgrade to 3.3.2 you need to upgrade to 3.3.1 first.

ThingsBoard package download

1
wget https://github.com/thingsboard/thingsboard/releases/download/v3.3.2/thingsboard-3.3.2.deb

ThingsBoard service upgrade

  • Stop ThingsBoard service if it is running.
1
$ sudo service thingsboard stop
1
sudo dpkg -i thingsboard-3.3.2.deb

NOTE: Package installer may ask you to merge your thingsboard configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten. Please make sure that you set database.ts.type parameter value (in the file /etc/thingsboard/conf/thingsboard.yml) to “cassandra” instead of “sql” if you are using Cassandra database for timeseries data:

1
2
3
4
database:
  ts_max_intervals: "${DATABASE_TS_MAX_INTERVALS:700}" # Max number of DB queries generated by single API call to fetch telemetry records
  ts:
    type: "${DATABASE_TS_TYPE:sql}" # cassandra, sql, or timescale (for hybrid mode, DATABASE_TS_TYPE value should be cassandra, or timescale)

Execute regular upgrade script:

1
2
# Execute regular upgrade script
$ sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=3.3.1

Start the service

文档信息图标

若将 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

Upgrading ThingsBoard CE to 3.3.1

NOTE: These upgrade steps are applicable for ThingsBoard version 3.3.0. In order to upgrade to 3.3.1 you need to upgrade to 3.3.0 first.

ThingsBoard package download

1
wget https://github.com/thingsboard/thingsboard/releases/download/v3.3.1/thingsboard-3.3.1.deb

ThingsBoard service upgrade

  • Stop ThingsBoard service if it is running.
1
$ sudo service thingsboard stop
1
sudo dpkg -i thingsboard-3.3.1.deb

NOTE: Package installer may ask you to merge your thingsboard configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten. Please make sure that you set database.ts.type parameter value (in the file /etc/thingsboard/conf/thingsboard.yml) to “cassandra” instead of “sql” if you are using Cassandra database for timeseries data:

1
2
3
4
  database:
    ts_max_intervals: "${DATABASE_TS_MAX_INTERVALS:700}" # Max number of DB queries generated by single API call to fetch telemetry records
    ts:
      type: "${DATABASE_TS_TYPE:sql}" # cassandra, sql, or timescale (for hybrid mode, DATABASE_TS_TYPE value should be cassandra, or timescale)

Execute regular upgrade script:

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

Start the service

文档信息图标

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

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

redis-cli flushall

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

redis-cli

select 0

flushdb

文档信息图标

若将 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

Upgrading ThingsBoard CE to 3.3

NOTE: These upgrade steps are applicable for ThingsBoard version 3.2.2. In order to upgrade to 3.3 you need to upgrade to 3.2.2 first.

ThingsBoard package download

1
wget https://github.com/thingsboard/thingsboard/releases/download/v3.3/thingsboard-3.3.deb

ThingsBoard service upgrade

  • Stop ThingsBoard service if it is running.
1
$ sudo service thingsboard stop
1
sudo dpkg -i thingsboard-3.3.deb

NOTE: Package installer will ask you to merge your thingsboard configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten. Please make sure that you set database.ts.type parameter value (in the file /etc/thingsboard/conf/thingsboard.yml) to “cassandra” instead of “sql” if you are using Cassandra database for timeseries data:

1
2
3
4
  database:
    ts_max_intervals: "${DATABASE_TS_MAX_INTERVALS:700}" # Max number of DB queries generated by single API call to fetch telemetry records
    ts:
      type: "${DATABASE_TS_TYPE:sql}" # cassandra, sql, or timescale (for hybrid mode, DATABASE_TS_TYPE value should be cassandra, or timescale)

NOTE: If you were using MQTT over SSL instead of default MQTT, please make sure you have a proper configuration (thingsboard.conf and/or thingsboard.yml) of ports/addresses:

/etc/thingsboard/conf/thingsboard.conf

1
2
3
4
5
6
export MQTT_SSL_ENABLED=true
export MQTT_SSL_BIND_ADDRESS=0.0.0.0
export MQTT_SSL_BIND_PORT=8883

export MQTT_BIND_ADDRESS=0.0.0.0
export MQTT_BIND_PORT=1883

/etc/thingsboard/conf/thingsboard.yml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
transport:

. . .

  # Local MQTT transport parameters
  mqtt:
    # Enable/disable mqtt transport protocol.
    enabled: "${MQTT_ENABLED:true}"
    bind_address: "${MQTT_BIND_ADDRESS:0.0.0.0}"
    bind_port: "${MQTT_BIND_PORT:1883}"

. . .

    ssl:
      # Enable/disable SSL support
      enabled: "${MQTT_SSL_ENABLED:true}"
      # MQTT SSL bind address
      bind_address: "${MQTT_SSL_BIND_ADDRESS:0.0.0.0}"
      # MQTT SSL bind port
      bind_port: "${MQTT_SSL_BIND_PORT:8883}"

Execute regular upgrade script:

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

Start the service

文档信息图标

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

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

redis-cli flushall

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

redis-cli

select 0

flushdb

文档信息图标

若将 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