技术交流

学习资料
立即试用 商务报价
社区版
社区版 专业版 云服务 Edge Edge PE 网关 授权服务 Trendz分析 Mobile 应用程序 Mobile PE应用程序
Old Upgrade instructions
入门 文档 指南 安装 架构 API 常见问题

本页目录

Old Upgrade instructions

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

1

upgrade_1.1.0_1.2.0.bat

Start the service

1

net start thingsboard

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

1

upgrade_1.2.0_1.2.1.bat

Start the service

1

net start thingsboard

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

1

upgrade_1.2.1_1.2.2.bat

Start the service

1

net start thingsboard

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

1

upgrade_1.2.2_1.2.3.bat

Start the service

1

net start thingsboard

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

1

net start thingsboard

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

1

net start thingsboard

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

1

net start thingsboard

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

1

net start thingsboard

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

1

net start thingsboard

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

1

net start thingsboard

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

1

net start thingsboard

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

1

net start thingsboard

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

1

net start thingsboard

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

1

net start thingsboard

Next steps

  • 入门指南 - 快速学习ThingsBoard相关功能。

  • 连接设备 - 学习如何根据你的连接方式或解决方案连接设备。

  • 可 视 化 - 学习如何配置复杂的ThingsBoard仪表板说明。

  • 数据处理 - 学习如何使用ThingsBoard规则引擎。

  • 数据分析 - 学习如何使用规则引擎执行基本的分析任务。

  • 硬件样品 - 学习如何将各种硬件平台连接到ThingsBoard。

  • 高级功能 - 学习高级ThingsBoard功能。

  • 开发指南 - 学习ThingsBoard中的贡献和开发。


© 2023 作者：ThingsBoard 蜀ICP备19012996号-2