马上体验
解决方案
客户
案例
合作伙伴
关于我们
报价 文档 指南

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

resources/1.0.3/thingsboard-ubuntu-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v1.0.3/thingsboard-1.0.3.deb
resources/1.0.3/thingsboard-centos-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v1.0.3/thingsboard-1.0.3.rpm

ThingsBoard service upgrade

resources/1.0.3/thingsboard-ubuntu-installation.sh
 
sudo dpkg -i thingsboard-1.0.3.deb
resources/1.0.3/thingsboard-centos-installation.sh
 
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
$ 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
$ chmod +x upgrade_1.0_1.0.2.sh
$ ./upgrade_1.0_1.0.2.sh

Start the service

$ sudo service thingsboard start

Upgrading to 1.1.0

These steps are applicable for 1.0.3 ThingsBoard version.

ThingsBoard package download

resources/1.1.0/thingsboard-ubuntu-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v1.1/thingsboard-1.1.deb
resources/1.1.0/thingsboard-centos-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v1.1/thingsboard-1.1.rpm

ThingsBoard service upgrade

Database upgrade

Please use the following instruction to update your single node instance:

# Download upgrade scripts
$ 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
$ chmod +x upgrade_1.0.3_1.1.0.sh
$ ./upgrade_1.0.3_1.1.0.sh

Start the service

$ sudo service thingsboard start

Upgrading to 1.2.0

These steps are applicable for 1.1.0 ThingsBoard version.

Ubuntu/CentOS

ThingsBoard package download

resources/1.2.0/thingsboard-ubuntu-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v1.2/thingsboard-1.2.deb
resources/1.2.0/thingsboard-centos-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v1.2/thingsboard-1.2.rpm

ThingsBoard service upgrade

Database upgrade

# Download upgrade scripts
$ 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
$ chmod +x upgrade_1.1.0_1.2.0.sh
$ ./upgrade_1.1.0_1.2.0.sh

Start the service

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

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.
C:\thingsboard>install.bat

Database upgrade

upgrade_1.1.0_1.2.0.bat

Start the service

net start thingsboard

Upgrading to 1.2.1

These steps are applicable for 1.2.0 ThingsBoard version.

Ubuntu/CentOS

ThingsBoard package download

resources/1.2.1/thingsboard-ubuntu-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v1.2.1/thingsboard-1.2.1.deb
resources/1.2.1/thingsboard-centos-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v1.2.1/thingsboard-1.2.1.rpm

ThingsBoard service upgrade

resources/1.2.1/thingsboard-ubuntu-installation.sh
 
sudo dpkg -i thingsboard-1.2.1.deb
resources/1.2.1/thingsboard-centos-installation.sh
 
sudo rpm -Uvh thingsboard-1.2.1.rpm

Database upgrade

# Download upgrade scripts
$ 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
$ chmod +x upgrade_1.2.0_1.2.1.sh
$ ./upgrade_1.2.0_1.2.1.sh

Start the service

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

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.
C:\thingsboard>install.bat

Database upgrade

upgrade_1.2.0_1.2.1.bat

Start the service

net start thingsboard

Upgrading to 1.2.2

These steps are applicable for 1.2.1 ThingsBoard version.

Ubuntu/CentOS

ThingsBoard package download

resources/1.2.2/thingsboard-ubuntu-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v1.2.2/thingsboard-1.2.2.deb
resources/1.2.2/thingsboard-centos-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v1.2.2/thingsboard-1.2.2.rpm

ThingsBoard service upgrade

resources/1.2.2/thingsboard-ubuntu-installation.sh
 
sudo dpkg -i thingsboard-1.2.2.deb
resources/1.2.2/thingsboard-centos-installation.sh
 
sudo rpm -Uvh thingsboard-1.2.2.rpm

Database upgrade

# Download upgrade scripts
$ 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
$ chmod +x upgrade_1.2.1_1.2.2.sh
$ ./upgrade_1.2.1_1.2.2.sh

Start the service

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

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.
C:\thingsboard>install.bat

Database upgrade

upgrade_1.2.1_1.2.2.bat

Start the service

net start thingsboard

Upgrading to 1.2.3

These steps are applicable for 1.2.2 ThingsBoard version.

Ubuntu/CentOS

ThingsBoard package download

resources/1.2.3/thingsboard-ubuntu-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v1.2.3/thingsboard-1.2.3.deb
resources/1.2.3/thingsboard-centos-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v1.2.3/thingsboard-1.2.3.rpm

ThingsBoard service upgrade

resources/1.2.3/thingsboard-ubuntu-installation.sh
 
sudo dpkg -i thingsboard-1.2.3.deb
resources/1.2.3/thingsboard-centos-installation.sh
 
sudo rpm -Uvh thingsboard-1.2.3.rpm

Database upgrade

# Download upgrade scripts
$ 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
$ chmod +x upgrade_1.2.2_1.2.3.sh
$ ./upgrade_1.2.2_1.2.3.sh

Start the service

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

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.
C:\thingsboard>install.bat

Database upgrade

upgrade_1.2.2_1.2.3.bat

Start the service

net start thingsboard

Upgrading to 1.3.0

These steps are applicable for 1.2.3 ThingsBoard version.

Ubuntu/CentOS

ThingsBoard package download

resources/1.3.0/thingsboard-ubuntu-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v1.3/thingsboard-1.3.deb
resources/1.3.0/thingsboard-centos-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v1.3/thingsboard-1.3.rpm

ThingsBoard service upgrade

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:

database:
    type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

# Execute upgrade script
$ sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=1.2.3

Start the service

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

    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.

C:\thingsboard>upgrade.bat --fromVersion=1.2.3

Start the service

net start thingsboard

Upgrading to 1.3.1

These steps are applicable for 1.3.0 ThingsBoard version.

Ubuntu/CentOS

ThingsBoard package download

resources/1.3.1/thingsboard-ubuntu-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v1.3.1/thingsboard-1.3.1.deb
resources/1.3.1/thingsboard-centos-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v1.3.1/thingsboard-1.3.1.rpm

ThingsBoard service upgrade

resources/1.3.1/thingsboard-ubuntu-installation.sh
 
sudo dpkg -i thingsboard-1.3.1.deb
resources/1.3.1/thingsboard-centos-installation.sh
 
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:

database:
    type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

# Execute upgrade script
$ sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=1.3.0

Start the service

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

    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.

C:\thingsboard>upgrade.bat --fromVersion=1.3.0

Start the service

net start thingsboard

Upgrading to 1.4.0

These steps are applicable for 1.3.1 ThingsBoard version.

Ubuntu/CentOS

ThingsBoard package download

resources/1.4.0/thingsboard-ubuntu-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v1.4/thingsboard-1.4.deb
resources/1.4.0/thingsboard-centos-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v1.4/thingsboard-1.4.rpm

ThingsBoard service upgrade

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:

database:
    type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

# Execute upgrade script
$ sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=1.3.1

Start the service

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

    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.

C:\thingsboard>upgrade.bat --fromVersion=1.3.1

Start the service

net start thingsboard

Upgrading to 2.0.0

These steps are applicable for 1.4.0 ThingsBoard version.

Ubuntu/CentOS


重要说明


请注意在升级过程中旧规则和插件将从您的ThingsBoard实例中完全删除。

旧的规则和插件功能被新的规则引擎组件（规则链和规则节点）取代。

如果已配置规则或插件，则需要在执行升级之前使用导出功能备份它们。 升级后，您将需要配置新的规则链，以还原由旧规则/插件执行的应用程序逻辑。

有关详细信息，请参阅新规则引擎文档。

ThingsBoard package download

resources/2.0.0/thingsboard-ubuntu-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v2.0/thingsboard-2.0.deb
resources/2.0.0/thingsboard-centos-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v2.0/thingsboard-2.0.rpm

ThingsBoard service upgrade

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:

database:
    type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

# Execute upgrade script
$ sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=1.4.0

Start the service

$ sudo service thingsboard start

Windows


重要说明


请注意在升级过程中旧规则和插件将从您的ThingsBoard实例中完全删除。

旧的规则和插件功能被新的规则引擎组件（规则链和规则节点）取代。

如果已配置规则或插件，则需要在执行升级之前使用导出功能备份它们。 升级后，您将需要配置新的规则链，以还原由旧规则/插件执行的应用程序逻辑。

有关详细信息，请参阅新规则引擎文档。

ThingsBoard package download

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

ThingsBoard service upgrade

  • Stop ThingsBoard service if it is running.
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:

    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.

C:\thingsboard>upgrade.bat --fromVersion=1.4.0

Start the service

net start thingsboard

Upgrading to 2.0.1

These steps are applicable for 2.0.0 ThingsBoard version.

Ubuntu/CentOS

ThingsBoard package download

resources/2.0.1/thingsboard-ubuntu-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v2.0.1/thingsboard-2.0.1.deb
resources/2.0.1/thingsboard-centos-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v2.0.1/thingsboard-2.0.1.rpm

ThingsBoard service upgrade

resources/2.0.1/thingsboard-ubuntu-installation.sh
 
sudo dpkg -i thingsboard-2.0.1.deb
resources/2.0.1/thingsboard-centos-installation.sh
 
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:

database:
    type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

Start the service

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

    database:
    type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

Start the service

net start thingsboard

Upgrading to 2.0.2

These steps are applicable for 2.0.1 ThingsBoard version.

Ubuntu/CentOS

ThingsBoard package download

resources/2.0.2/thingsboard-ubuntu-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v2.0.2/thingsboard-2.0.2.deb
resources/2.0.2/thingsboard-centos-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v2.0.2/thingsboard-2.0.2.rpm

ThingsBoard service upgrade

resources/2.0.2/thingsboard-ubuntu-installation.sh
 
sudo dpkg -i thingsboard-2.0.2.deb
resources/2.0.2/thingsboard-centos-installation.sh
 
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:

database:
    type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

Start the service

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

    database:
    type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

Start the service

net start thingsboard

Upgrading to 2.0.3

These steps are applicable for 2.0.2 ThingsBoard version.

Ubuntu/CentOS

ThingsBoard package download

resources/2.0.3/thingsboard-ubuntu-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v2.0.3/thingsboard-2.0.3.deb
resources/2.0.3/thingsboard-centos-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v2.0.3/thingsboard-2.0.3.rpm

ThingsBoard service upgrade

resources/2.0.3/thingsboard-ubuntu-installation.sh
 
sudo dpkg -i thingsboard-2.0.3.deb
resources/2.0.3/thingsboard-centos-installation.sh
 
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:

database:
    type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

Start the service

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

    database:
    type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

Start the service

net start thingsboard

Upgrading to 2.1.0

These steps are applicable for 2.0.3 ThingsBoard version.

Ubuntu/CentOS

ThingsBoard package download

resources/2.1.0/thingsboard-ubuntu-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v2.1/thingsboard-2.1.deb
resources/2.1.0/thingsboard-centos-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v2.1/thingsboard-2.1.rpm

ThingsBoard service upgrade

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:

database:
    type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

Start the service

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

    database:
    type: "${DATABASE_TYPE:cassandra}" # cassandra OR sql

Start the service

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

resources/2.2.0/thingsboard-ubuntu-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v2.2/thingsboard-2.2.deb
resources/2.2.0/thingsboard-centos-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v2.2/thingsboard-2.2.rpm

ThingsBoard service upgrade

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:

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

Start the service

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

    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.

C:\thingsboard>upgrade.bat --fromVersion=2.0.0

Start the service

net start thingsboard

Upgrading to 2.3.0

These steps are applicable for 2.2.0 ThingsBoard version.

Ubuntu/CentOS

ThingsBoard package download

resources/2.3.0/thingsboard-ubuntu-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v2.3/thingsboard-2.3.deb
resources/2.3.0/thingsboard-centos-download.sh
 
wget https://github.com/thingsboard/thingsboard/releases/download/v2.3/thingsboard-2.3.rpm

ThingsBoard service upgrade

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:

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

Start the service

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

    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.

C:\thingsboard>upgrade.bat --fromVersion=2.2.0

Start the service

net start thingsboard

Next steps

  • 入门指南 - 这些指南提供了ThingsBoard主要功能的快速概述。

  • 设备连接 - 了解如何根据您的连接方式或解决方案连接设备。

  • 数据看板 - 这些指南包含有关如何配置复杂的ThingsBoard仪表板的说明。

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

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

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

  • 高级功能 - 了解高级ThingsBoard功能。

  • 开发指南 - 了解ThingsBoard中的贡献和开发。