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

• 将 ThingsBoard CE 升级到 3.3.4.1
  • 下载 ThingsBoard 安装包
  • ThingsBoard 服务升级
  • 启动服务
• 将 ThingsBoard CE 升级到 3.3.4
  • 下载 ThingsBoard 安装包
  • ThingsBoard 服务升级
  • 启动服务
• Upgrading ThingsBoard CE to 3.3.3
  • ThingsBoard package download
  • ThingsBoard service upgrade
  • Start the service
• Upgrading ThingsBoard CE to 3.3.2
  • ThingsBoard package download
  • ThingsBoard service upgrade
  • Start the service
• Upgrading ThingsBoard CE to 3.3.1
  • ThingsBoard package download
  • ThingsBoard service upgrade
  • Start the service
• Upgrading ThingsBoard CE to 3.3
  • ThingsBoard package download
  • ThingsBoard service upgrade
  • Start the service

将 ThingsBoard CE 升级到 3.3.4.1

注意：

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

下载 ThingsBoard 安装包

下载 Windows 版 ThingsBoard 安装文件：thingsboard-windows-3.3.4.1.zip。

ThingsBoard 服务升级

• 若 ThingsBoard 服务正在运行，请先停止。

1
net stop thingsboard

• 备份位于 <ThingsBoard 安装目录>\conf 的先前 ThingsBoard 配置（例如 C:\thingsboard\conf）。

• 删除 ThingsBoard 安装目录。

• 将安装压缩包解压到 ThingsBoard 安装目录。

• 将第一步备份的旧 ThingsBoard 配置文件与新配置进行比较和合并。

启动服务

1
net start thingsboard

将 ThingsBoard CE 升级到 3.3.4

注意：

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

下载 ThingsBoard 安装包

下载 Windows 版 ThingsBoard 安装文件：thingsboard-windows-3.3.4.zip。

ThingsBoard 服务升级

• 若 ThingsBoard 服务正在运行，请先停止。

1
net stop thingsboard

• 备份位于 <ThingsBoard 安装目录>\conf 的先前 ThingsBoard 配置（例如 C:\thingsboard\conf）。

• 删除 ThingsBoard 安装目录。

• 将安装压缩包解压到 ThingsBoard 安装目录。

• 将第一步备份的旧 ThingsBoard 配置文件与新配置进行比较和合并。

注意：
上述脚本应以管理员身份执行。

执行常规升级脚本：

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

启动服务

1
net start thingsboard

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

Download ThingsBoard installation archive for Windows: thingsboard-windows-3.3.3.zip.

ThingsBoard service upgrade

• Stop ThingsBoard service if it is running.

1
net stop thingsboard

• Make a backup of previous ThingsBoard configuration located in <ThingsBoard install dir>\conf (for ex. C:\thingsboard\conf).

• Remove ThingsBoard install dir.
• Unzip installation archive to ThingsBoard install dir.

• Compare and merge your old ThingsBoard configuration files (from the backup you made in the first step) with new ones.

• Finally, run upgrade.bat script to upgrade ThingsBoard to the new version.

NOTE Scripts listed above should be executed using Administrator Role.

Execute regular upgrade script:

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

Start the service

1
net start thingsboard

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

Download ThingsBoard installation archive for Windows: thingsboard-windows-3.3.2.zip.

ThingsBoard service upgrade

• Stop ThingsBoard service if it is running.

1
net stop thingsboard

• Make a backup of previous ThingsBoard configuration located in <ThingsBoard install dir>\conf (for ex. C:\thingsboard\conf).

• Remove ThingsBoard install dir.
• Unzip installation archive to ThingsBoard install dir.
• Compare your old ThingsBoard configuration files (from the backup you made in the first step) with new ones.
• Please make sure that you set database.ts.type parameter value (in the file <ThingsBoard install dir>\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)

• Finally, run upgrade.bat script to upgrade ThingsBoard to the new version.

NOTE Scripts listed above should be executed using Administrator Role.

Execute regular upgrade script:

1
C:\thingsboard>upgrade.bat --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
net start thingsboard

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

Download ThingsBoard installation archive for Windows: thingsboard-windows-3.3.1.zip.

ThingsBoard service upgrade

• Stop ThingsBoard service if it is running.

1
net stop thingsboard

• Make a backup of previous ThingsBoard configuration located in <ThingsBoard install dir>\conf (for ex. C:\thingsboard\conf).

• Remove ThingsBoard install dir.
• Unzip installation archive to ThingsBoard install dir.
• Compare your old ThingsBoard configuration files (from the backup you made in the first step) with new ones.
• Please make sure that you set database.ts.type parameter value (in the file <ThingsBoard install dir>\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)

• Finally, run upgrade.bat script to upgrade ThingsBoard to the new version.

NOTE Scripts listed above should be executed using Administrator Role.

Execute regular upgrade script:

1
C:\thingsboard>upgrade.bat --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
net start thingsboard

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

Download ThingsBoard installation archive for Windows: thingsboard-windows-3.3.zip.

ThingsBoard service upgrade

• Stop ThingsBoard service if it is running.

1
net stop thingsboard

• Make a backup of previous ThingsBoard configuration located in <ThingsBoard install dir>\conf (for ex. C:\thingsboard\conf).

• Remove ThingsBoard install dir.
• Unzip installation archive to ThingsBoard install dir.
• Compare your old ThingsBoard configuration files (from the backup you made in the first step) with new ones.
• Please make sure that you set database.ts.type parameter value (in the file <ThingsBoard install dir>\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)

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

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}"

• Finally, run upgrade.bat script to upgrade ThingsBoard to the new version.

NOTE Scripts listed above should be executed using Administrator Role.

Execute regular upgrade script:

1
C:\thingsboard>upgrade.bat --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
net start thingsboard