In order to update to new ThingsBoard releases, please follow these CE and PE instructions
Upgrading to 1.0.3
These steps are applicable for 1.0, 1.0.1 and 1.0.2 ThingsBoard versions.
ThingsBoard package download
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 service upgrade
1
| sudo dpkg -i thingsboard-1.0.3.deb
|
|
1
| sudo rpm -Uvh thingsboard-1.0.3.rpm
|
|
Database upgrade
This step is required only if you are upgrading from 1.0 or 1.0.1 versions.
Please use following instruction to update your single node instance:
Download upgrade scripts:
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
|
Launch main script:
1
2
| chmod +x upgrade_1.0_1.0.2.sh
./upgrade_1.0_1.0.2.sh
|
Start the service
1
| sudo service thingsboard start
|
Upgrading to 1.1.0
These steps are applicable for 1.0.3 ThingsBoard version.
ThingsBoard package download
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 service upgrade
1
| sudo dpkg -i thingsboard-1.1.deb
|
|
1
| sudo rpm -Uvh thingsboard-1.1.rpm
|
|
Database upgrade
Please use the following instruction to update your single node instance:
Download upgrade scripts:
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
|
Launch main script:
1
2
| chmod +x upgrade_1.0.3_1.1.0.sh
./upgrade_1.0.3_1.1.0.sh
|
Start the service
1
| $ sudo service thingsboard start
|
Upgrading to 1.2.0
These steps are applicable for 1.1.0 ThingsBoard version.
Ubuntu/CentOS
ThingsBoard package download
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 service upgrade
1
| sudo dpkg -i thingsboard-1.2.deb
|
|
1
| sudo rpm -Uvh thingsboard-1.2.rpm
|
|
Database upgrade
Download upgrade scripts:
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
|
Launch main script:
1
2
| chmod +x upgrade_1.1.0_1.2.0.sh
./upgrade_1.1.0_1.2.0.sh
|
Start the service
1
| sudo service thingsboard start
|
Windows
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-1.2.zip.
ThingsBoard service upgrade
- Make a backup of previous ThingsBoard configuration located in <ThingsBoard install dir>\conf (for ex. C:\thingsboard\conf).
- Uninstall the previous version of ThingsBoard service by running uninstall.bat located in ThingsBoard install dir.
NOTE Scripts listed above should be executed using Administrator Role.
1
| C:\thingsboard>uninstall.bat
|
- 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.
- Run install.bat script to install the new version of ThingsBoard as a Windows service.
1
| C:\thingsboard>install.bat
|
Database upgrade
- Download upgrade scripts to some folder:
- Execute upgrade_1.1.0_1.2.0.bat (NOTE This script should be executed using Administrative Role)
1
| upgrade_1.1.0_1.2.0.bat
|
Start the service
Upgrading to 1.2.1
These steps are applicable for 1.2.0 ThingsBoard version.
Ubuntu/CentOS
ThingsBoard package download
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 service upgrade
1
| sudo dpkg -i thingsboard-1.2.1.deb
|
|
1
| sudo rpm -Uvh thingsboard-1.2.1.rpm
|
|
Database upgrade
Download upgrade scripts:
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
|
Launch main script:
1
2
| chmod +x upgrade_1.2.0_1.2.1.sh
./upgrade_1.2.0_1.2.1.sh
|
Start the service
1
| sudo service thingsboard start
|
Windows
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-1.2.1.zip.
ThingsBoard service upgrade
- Make a backup of previous ThingsBoard configuration located in <ThingsBoard install dir>\conf (for ex. C:\thingsboard\conf).
- Uninstall the previous version of ThingsBoard service by running uninstall.bat located in ThingsBoard install dir.
NOTE Scripts listed above should be executed using Administrator Role.
1
| C:\thingsboard>uninstall.bat
|
- 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.
- Run install.bat script to install the new version of ThingsBoard as a Windows service.
1
| C:\thingsboard>install.bat
|
Database upgrade
- Download upgrade scripts to some folder:
- Execute upgrade_1.2.0_1.2.1.bat (NOTE This script should be executed using Administrative Role)
1
| upgrade_1.2.0_1.2.1.bat
|
Start the service
Upgrading to 1.2.2
These steps are applicable for 1.2.1 ThingsBoard version.
Ubuntu/CentOS
ThingsBoard package download
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 service upgrade
1
| sudo dpkg -i thingsboard-1.2.2.deb
|
|
1
| sudo rpm -Uvh thingsboard-1.2.2.rpm
|
|
Database upgrade
Download upgrade scripts:
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
|
Launch main script:
1
2
| chmod +x upgrade_1.2.1_1.2.2.sh
./upgrade_1.2.1_1.2.2.sh
|
Start the service
1
| sudo service thingsboard start
|
Windows
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-1.2.2.zip.
ThingsBoard service upgrade
- Make a backup of previous ThingsBoard configuration located in <ThingsBoard install dir>\conf (for ex. C:\thingsboard\conf).
- Uninstall the previous version of ThingsBoard service by running uninstall.bat located in ThingsBoard install dir.
NOTE Scripts listed above should be executed using Administrator Role.
1
| C:\thingsboard>uninstall.bat
|
- 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.
- Run install.bat script to install the new version of ThingsBoard as a Windows service.
1
| C:\thingsboard>install.bat
|
Database upgrade
- Download upgrade scripts to some folder:
- Execute upgrade_1.2.1_1.2.2.bat (NOTE This script should be executed using Administrative Role)
1
| upgrade_1.2.1_1.2.2.bat
|
Start the service
Upgrading to 1.2.3
These steps are applicable for 1.2.2 ThingsBoard version.
Ubuntu/CentOS
ThingsBoard package download
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 service upgrade
1
| sudo dpkg -i thingsboard-1.2.3.deb
|
|
1
| sudo rpm -Uvh thingsboard-1.2.3.rpm
|
|
Database upgrade
Download upgrade scripts:
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
|
Launch main script:
1
2
| chmod +x upgrade_1.2.2_1.2.3.sh
./upgrade_1.2.2_1.2.3.sh
|
Start the service
1
| sudo service thingsboard start
|
Windows
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-1.2.3.zip.
ThingsBoard service upgrade
- Make a backup of previous ThingsBoard configuration located in <ThingsBoard install dir>\conf (for ex. C:\thingsboard\conf).
- Uninstall the previous version of ThingsBoard service by running uninstall.bat located in ThingsBoard install dir.
NOTE Scripts listed above should be executed using Administrator Role.
1
| C:\thingsboard>uninstall.bat
|
- 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.
- Run install.bat script to install the new version of ThingsBoard as a Windows service.
1
| C:\thingsboard>install.bat
|
Database upgrade
- Download upgrade scripts to some folder:
- Execute upgrade_1.2.2_1.2.3.bat (NOTE This script should be executed using Administrative Role)
1
| upgrade_1.2.2_1.2.3.bat
|
Start the service
Upgrading to 1.3.0
These steps are applicable for 1.2.3 ThingsBoard version.
Ubuntu/CentOS
ThingsBoard package download
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 service upgrade
1
| sudo dpkg -i thingsboard-1.3.deb
|
|
1
| sudo rpm -Uvh thingsboard-1.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.type parameter value (in the file /etc/thingsboard/conf/thingsboard.yml) to “cassandra” instead of “sql” in order to upgrade your cassandra database:
1
2
| database:
type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql
|
Execute upgrade script:
1
| sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=1.2.3
|
Start the service
1
| sudo service thingsboard start
|
Windows
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-1.3.zip.
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
- 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.type parameter value (in the file <ThingsBoard install dir>\conf\thingsboard.yml) to “cassandra” instead of “sql” in order to upgrade your cassandra database:
1
2
| database:
type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql
|
- Run upgrade.bat script to upgrade ThingsBoard to the new version.
NOTE Scripts listed above should be executed using Administrator Role.
1
| C:\thingsboard>upgrade.bat --fromVersion=1.2.3
|
Start the service
Upgrading to 1.3.1
These steps are applicable for 1.3.0 ThingsBoard version.
Ubuntu/CentOS
ThingsBoard package download
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 service upgrade
1
| sudo dpkg -i thingsboard-1.3.1.deb
|
|
1
| sudo rpm -Uvh thingsboard-1.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.type parameter value (in the file /etc/thingsboard/conf/thingsboard.yml) to “cassandra” instead of “sql” in order to upgrade your cassandra database:
1
2
| database:
type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql
|
Execute upgrade script:
1
| sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=1.3.0
|
Start the service
1
| sudo service thingsboard start
|
Windows
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-1.3.1.zip.
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
- 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.type parameter value (in the file <ThingsBoard install dir>\conf\thingsboard.yml) to “cassandra” instead of “sql” in order to upgrade your cassandra database:
1
2
| database:
type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql
|
- Run upgrade.bat script to upgrade ThingsBoard to the new version.
NOTE Scripts listed above should be executed using Administrator Role.
1
| C:\thingsboard>upgrade.bat --fromVersion=1.3.0
|
Start the service
Upgrading to 1.4.0
These steps are applicable for 1.3.1 ThingsBoard version.
Ubuntu/CentOS
ThingsBoard package download
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 service upgrade
1
| sudo dpkg -i thingsboard-1.4.deb
|
|
1
| sudo rpm -Uvh thingsboard-1.4.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.type parameter value (in the file /etc/thingsboard/conf/thingsboard.yml) to “cassandra” instead of “sql” in order to upgrade your cassandra database:
1
2
| database:
type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql
|
Execute upgrade script:
1
| sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=1.3.1
|
Start the service
1
| sudo service thingsboard start
|
Windows
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-1.4.zip.
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
- 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.type parameter value (in the file <ThingsBoard install dir>\conf\thingsboard.yml) to “cassandra” instead of “sql” in order to upgrade your cassandra database:
1
2
| database:
type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql
|
- Run upgrade.bat script to upgrade ThingsBoard to the new version.
NOTE Scripts listed above should be executed using Administrator Role.
1
| C:\thingsboard>upgrade.bat --fromVersion=1.3.1
|
Start the service
Upgrading to 2.0.0
These steps are applicable for 1.4.0 ThingsBoard version.
Ubuntu/CentOS
|
Important note
Please note that during upgrade procedure old rules and plugins will be completely removed from your ThingsBoard instance.
Old rules and plugins functionality is replaced by new rule engine components (rule chains and rule nodes).
If you have configured rules or plugins you need to backup them using export function before performing upgrade.
After upgrade you will need to configure new rule chains in order to restore your application logic performed by old rules/plugins.
Please refer to new rule engine documentation for details.
|
ThingsBoard package download
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 service upgrade
1
| sudo dpkg -i thingsboard-2.0.deb
|
|
1
| sudo rpm -Uvh thingsboard-2.0.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.type parameter value (in the file /etc/thingsboard/conf/thingsboard.yml) to “cassandra” instead of “sql” in order to upgrade your cassandra database:
1
2
| database:
type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql
|
Execute upgrade script:
1
| sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=1.4.0
|
Start the service
1
| sudo service thingsboard start
|
Windows
|
Important note
Please note that during upgrade procedure old rules and plugins will be completely removed from your ThingsBoard instance.
Old rules and plugins functionality is replaced by new rule engine components (rule chains and rule nodes).
If you have configured rules or plugins you need to backup them using export function before performing upgrade.
After upgrade you will need to configure new rule chains in order to restore your application logic performed by old rules/plugins.
Please refer to new rule engine documentation for details.
|
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-2.0.zip.
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
- 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.type parameter value (in the file <ThingsBoard install dir>\conf\thingsboard.yml) to “cassandra” instead of “sql” in order to upgrade your cassandra database:
1
2
| database:
type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql
|
- Run upgrade.bat script to upgrade ThingsBoard to the new version.
NOTE Scripts listed above should be executed using Administrator Role.
1
| C:\thingsboard>upgrade.bat --fromVersion=1.4.0
|
Start the service
Upgrading to 2.0.1
These steps are applicable for 2.0.0 ThingsBoard version.
Ubuntu/CentOS
ThingsBoard package download
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 service upgrade
1
| sudo dpkg -i thingsboard-2.0.1.deb
|
|
1
| sudo rpm -Uvh thingsboard-2.0.1.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.type parameter value (in the file /etc/thingsboard/conf/thingsboard.yml) to “cassandra” instead of “sql” in order to upgrade your cassandra database:
1
2
| database:
type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql
|
Start the service
1
| sudo service thingsboard start
|
Windows
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-2.0.1.zip.
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
- 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.type parameter value (in the file <ThingsBoard install dir>\conf\thingsboard.yml) to “cassandra” instead of “sql” in order to upgrade your cassandra database:
1
2
| database:
type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql
|
Start the service
Upgrading to 2.0.2
These steps are applicable for 2.0.1 ThingsBoard version.
Ubuntu/CentOS
ThingsBoard package download
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 service upgrade
1
| sudo dpkg -i thingsboard-2.0.2.deb
|
|
1
| sudo rpm -Uvh thingsboard-2.0.2.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.type parameter value (in the file /etc/thingsboard/conf/thingsboard.yml) to “cassandra” instead of “sql” in order to upgrade your cassandra database:
1
2
| database:
type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql
|
Start the service
1
| sudo service thingsboard start
|
Windows
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-2.0.2.zip.
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
- 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.type parameter value (in the file <ThingsBoard install dir>\conf\thingsboard.yml) to “cassandra” instead of “sql” in order to upgrade your cassandra database:
1
2
| database:
type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql
|
Start the service
Upgrading to 2.0.3
These steps are applicable for 2.0.2 ThingsBoard version.
Ubuntu/CentOS
ThingsBoard package download
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 service upgrade
1
| sudo dpkg -i thingsboard-2.0.3.deb
|
|
1
| sudo rpm -Uvh thingsboard-2.0.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.type parameter value (in the file /etc/thingsboard/conf/thingsboard.yml) to “cassandra” instead of “sql” in order to upgrade your cassandra database:
1
2
| database:
type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql
|
Start the service
1
| sudo service thingsboard start
|
Windows
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-2.0.3.zip.
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
- 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.type parameter value (in the file <ThingsBoard install dir>\conf\thingsboard.yml) to “cassandra” instead of “sql” in order to upgrade your cassandra database:
1
2
| database:
type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql
|
Start the service
Upgrading to 2.1.0
These steps are applicable for 2.0.3 ThingsBoard version.
Ubuntu/CentOS
ThingsBoard package download
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 service upgrade
1
| sudo dpkg -i thingsboard-2.1.deb
|
|
1
| sudo rpm -Uvh thingsboard-2.1.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.type parameter value (in the file /etc/thingsboard/conf/thingsboard.yml) to “cassandra” instead of “sql” in order to upgrade your cassandra database:
1
2
| database:
type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql
|
Start the service
1
| sudo service thingsboard start
|
Windows
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-2.1.zip.
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
- 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.type parameter value (in the file <ThingsBoard install dir>\conf\thingsboard.yml) to “cassandra” instead of “sql” in order to upgrade your cassandra database:
1
2
| database:
type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql
|
Start the service
Upgrading to 2.2.0
These steps are applicable for 2.1.0, 2.1.1, 2.1.2 and 2.1.3 ThingsBoard versions.
Ubuntu/CentOS
ThingsBoard package download
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 service upgrade
1
| sudo dpkg -i thingsboard-2.2.deb
|
|
1
| sudo rpm -Uvh thingsboard-2.2.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.entities.type and database.ts.type parameters values (in the file /etc/thingsboard/conf/thingsboard.yml) to “cassandra” instead of “sql” in order to upgrade your cassandra database:
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)
|
Execute upgrade script:
1
| sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=2.0.0
|
Start the service
1
| sudo service thingsboard start
|
Windows
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-2.2.zip.
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
- 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.entities.type and database.ts.type parameters values (in the file <ThingsBoard install dir>\conf\thingsboard.yml) to “cassandra” instead of “sql” in order to upgrade your cassandra database:
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)
|
- Run upgrade.bat script to upgrade ThingsBoard to the new version.
NOTE Scripts listed above should be executed using Administrator Role.
1
| C:\thingsboard>upgrade.bat --fromVersion=2.0.0
|
Start the service
Upgrading to 2.3.0
These steps are applicable for 2.2.0 ThingsBoard version.
Ubuntu/CentOS
ThingsBoard package download
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 service upgrade
1
| sudo dpkg -i thingsboard-2.3.deb
|
|
1
| sudo rpm -Uvh thingsboard-2.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.entities.type and database.ts.type parameters values (in the file /etc/thingsboard/conf/thingsboard.yml) to “cassandra” instead of “sql” in order to upgrade your cassandra database:
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)
|
Execute upgrade script
1
| sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=2.2.0
|
Start the service
1
| sudo service thingsboard start
|
Windows
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-2.3.zip.
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
- 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.entities.type and database.ts.type parameters values (in the file <ThingsBoard install dir>\conf\thingsboard.yml) to “cassandra” instead of “sql” in order to upgrade your cassandra database:
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)
|
- Run upgrade.bat script to upgrade ThingsBoard to the new version.
NOTE Scripts listed above should be executed using Administrator Role.
1
| C:\thingsboard>upgrade.bat --fromVersion=2.2.0
|
Start the service
Next steps