ThingsBoard CE v3.3.x upgrade instructions for CentOS

• Upgrading ThingsBoard CE to 3.3.4.1
  • ThingsBoard package download
  • ThingsBoard service upgrade
  • Start the service
• Upgrading ThingsBoard CE to 3.3.4
  • ThingsBoard package download
  • ThingsBoard service upgrade
  • Start the service
• 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

Upgrading ThingsBoard CE to 3.3.4.1

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

ThingsBoard package download

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

ThingsBoard service upgrade

• Stop ThingsBoard service if it is running.

1
sudo service thingsboard stop

1
sudo rpm -Uvh thingsboard-3.3.4.1.rpm

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.

Start the service

1
sudo service thingsboard start

Upgrading ThingsBoard CE to 3.3.4

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

ThingsBoard package download

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

ThingsBoard service upgrade

• Stop ThingsBoard service if it is running.

1
sudo service thingsboard stop

1
sudo rpm -Uvh thingsboard-3.3.4.rpm

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
sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=3.3.3

Start the service

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.

Important note before upgrading to ThingsBoard 3.3.3

ThingsBoard UI was migrated to Angular 12. You need to re-build your custom widgets and rule nodes (which use UI) on Angular 12.

ThingsBoard package download

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

ThingsBoard service upgrade

• Stop ThingsBoard service if it is running.

1
$ sudo service thingsboard stop

1
sudo rpm -Uvh thingsboard-3.3.3.rpm

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.rpm

ThingsBoard service upgrade

• Stop ThingsBoard service if it is running.

1
$ sudo service thingsboard stop

1
sudo rpm -Uvh thingsboard-3.3.2.rpm

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

If you use Redis for caching, you need to flush all stored keys before starting the ThingsBoard.

Connect to your Redis instance (or container/pod, depending on your setup) and run the command:

redis-cli flushall

Please note that this command is applicable only if you use Redis exclusively for ThingsBoard. If other applications use Redis, you need to locate the ThingsBoard database and flush only that. The default database index is 0, configurable with REDIS_DB ThingsBoard environment value.

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.rpm

ThingsBoard service upgrade

• Stop ThingsBoard service if it is running.

1
$ sudo service thingsboard stop

1
sudo rpm -Uvh thingsboard-3.3.1.rpm

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

If you use Redis for caching, you need to flush all stored keys before starting the ThingsBoard.

Connect to your Redis instance (or container/pod, depending on your setup) and run the command:

redis-cli flushall

Please note that this command is applicable only if you use Redis exclusively for ThingsBoard. If other applications use Redis, you need to locate the ThingsBoard database and flush only that. The default database index is 0, configurable with REDIS_DB ThingsBoard environment value.

redis-cli

select 0

flushdb

If you use Redis for caching, you need to flush all stored keys before starting the ThingsBoard.

Connect to your Redis instance (or container/pod, depending on your setup) and run the command:

redis-cli flushall

Please note that this command is applicable only if you use Redis exclusively for ThingsBoard. If other applications use Redis, you need to locate the ThingsBoard database and flush only that. The default database index is 0, configurable with REDIS_DB ThingsBoard environment value.

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.rpm

ThingsBoard service upgrade

• Stop ThingsBoard service if it is running.

1
$ sudo service thingsboard stop

1
sudo rpm -Uvh thingsboard-3.3.rpm

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

If you use Redis for caching, you need to flush all stored keys before starting the ThingsBoard.

Connect to your Redis instance (or container/pod, depending on your setup) and run the command:

redis-cli flushall

Please note that this command is applicable only if you use Redis exclusively for ThingsBoard. If other applications use Redis, you need to locate the ThingsBoard database and flush only that. The default database index is 0, configurable with REDIS_DB ThingsBoard environment value.

redis-cli

select 0

flushdb

If you use Redis for caching, you need to flush all stored keys before starting the ThingsBoard.

Connect to your Redis instance (or container/pod, depending on your setup) and run the command:

redis-cli flushall

Please note that this command is applicable only if you use Redis exclusively for ThingsBoard. If other applications use Redis, you need to locate the ThingsBoard database and flush only that. The default database index is 0, configurable with REDIS_DB ThingsBoard environment value.

redis-cli

select 0

flushdb

1
sudo service thingsboard start