Skip to content

upgrade-edge-to-4.0 #2019

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
May 16, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions _config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -84,11 +84,11 @@ release:
pe_full_ver: 4.0.1PE
wd_examples_commit: v4.0.1
# >>> EDGE
edge_ver: 3.9.1
edge_tag: v3.9.1
edge_full_ver: 3.9.1EDGE
pe_edge_ver: 3.9.1pe
pe_edge_full_ver: 3.9.1EDGEPE
edge_ver: 4.0.1
edge_tag: v4.0.1
edge_full_ver: 4.0.1EDGE
pe_edge_ver: 4.0.1pe
pe_edge_full_ver: 4.0.1EDGEPE
# <<< EDGE
ce_flutter_app_ver: 1.6.0
pe_flutter_app_ver: 1.6.0
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v4.0/tb-edge-4.0.1.rpm
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
sudo rpm -Uvh tb-edge-4.0.1.rpm
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v4.0/tb-edge-4.0.1.deb
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
sudo dpkg -i tb-edge-4.0.1.deb
108 changes: 108 additions & 0 deletions docs/user-guide/install/edge/upgrade-instructions.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,20 @@ description: ThingsBoard Edge upgrade instructions
</li>
</ul>
</li>
<li>
<a href="#upgrading-to-401" id="markdown-toc-upgrading-to-401">Upgrading to 4.0.1EDGE</a>
<ul>
<li>
<a href="#ubuntucentosrpi-401" id="markdown-toc-ubuntucentos-401">Ubuntu/CentOS/Raspberry Pi</a>
</li>
<li>
<a href="#docker-linux-mac-401" id="markdown-toc-docker-linux-mac-401">Docker (Linux or Mac OS)</a>
</li>
<li>
<a href="#windows-401" id="markdown-toc-windows-401">Windows</a>
</li>
</ul>
</li>
<li>
<a href="#upgrading-to-391" id="markdown-toc-upgrading-to-391">Upgrading to 3.9.1EDGE</a>
<ul>
Expand Down Expand Up @@ -277,6 +291,100 @@ net stop tb-edge
Launch the "pgAdmin" software and login as superuser (postgres).
Open your server and create backup of database **tb_edge** using 'Backup Dialog' functionality of "pgAdmin".

## Upgrading to 4.0.1EDGE {#upgrading-to-401}

{% assign serverVersion = "4.0.1" %}
{% assign updateServerLink = "#upgrading-to-4.0.1" %}
{% include templates/edge/install/compatibility-warning-version.md %}

### Ubuntu/CentOS/Raspberry Pi {#ubuntucentosrpi-40}

**NOTE**: These steps are applicable for ThingsBoard Edge 3.9.1EDGE version.

#### ThingsBoard Edge package download

{% capture tabspec %}tb-edge-download-4-0-1
tb-edge-download-4-0-1-ubuntu,Ubuntu/Raspberry Pi,shell,resources/4.1/tb-edge-ubuntu-download.sh,/docs/user-guide/install/edge/resources/4.1/tb-edge-ubuntu-download.sh
tb-edge-download-4-0-1-centos,CentOS,shell,resources/4.1/tb-edge-centos-download.sh,/docs/user-guide/install/edge/resources/4.1/tb-edge-centos-download.sh{% endcapture %}
{% include tabs.html %}

#### ThingsBoard Edge service upgrade

* Stop ThingsBoard Edge service if it is running.

```bash
sudo service tb-edge stop
```
{: .copy-code}

{% capture tabspec %}tb-edge-installation-4-0-1
tb-edge-installation-4-0-1-ubuntu,Ubuntu/Raspberry Pi,shell,resources/4.1/tb-edge-ubuntu-installation.sh,/docs/user-guide/install/edge/resources/4.1/tb-edge-ubuntu-installation.sh
tb-edge-installation-4-0-1-centos,CentOS,shell,resources/4.1/tb-edge-centos-installation.sh,/docs/user-guide/install/edge/resources/4.1/tb-edge-centos-installation.sh{% endcapture %}
{% include tabs.html %}

**NOTE:** Package installer may ask you to merge your tb-edge configuration. It is preferred to use **merge option** to make sure that all your previous parameters will not be overwritten.

Execute regular upgrade script:

```bash
sudo /usr/share/tb-edge/bin/install/upgrade.sh
```
{: .copy-code}

#### Start the service

```bash
sudo service tb-edge start
```
{: .copy-code}

### Docker (Linux or Mac OS) {#docker-linux-mac-401}

{% assign versionName = "4.0.1EDGE" %}
{% assign previousVersion = "3.9.1EDGE" %}

{% include templates/edge/user-guide/start-upgrade.md %}

### Windows {#windows-401}

**NOTE**: These steps are applicable for ThingsBoard Edge 3.9.1EDGE version.

#### ThingsBoard Edge package download

Download ThingsBoard Edge package for Windows: [tb-edge-windows-4.0.1.zip](https://github.com/thingsboard/thingsboard-edge/releases/download/v4.0.1/tb-edge-windows-4.0.1.zip).

#### ThingsBoard Edge service upgrade

* Stop ThingsBoard Edge service if it is running:

```text
net stop tb-edge
```
{: .copy-code}

* Make a backup of the previous ThingsBoard Edge configuration located in *\<ThingsBoard Edge install dir\>\conf* (for example: *C:\tb-edge\conf*).

* Extract ThingsBoard Edge package.

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

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

**NOTE** Scripts listed below should be executed using Administrator Role.

Execute regular upgrade script:

```text
C:\tb-edge>upgrade.bat
```

#### Start the service

```text
net start tb-edge
```
{: .copy-code}

## Upgrading to 3.9.1EDGE {#upgrading-to-391}

{% assign serverVersion = "3.9.1" %}
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
wget https://dist.thingsboard.io/tb-edge-4.0.1pe.rpm
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
sudo rpm -Uvh tb-edge-4.0.1pe.rpm
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
wget https://dist.thingsboard.io/tb-edge-4.0.1pe.deb
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
sudo dpkg -i tb-edge-4.0.1pe.deb
108 changes: 108 additions & 0 deletions docs/user-guide/install/pe/edge/upgrade-instructions.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,20 @@ description: ThingsBoard PE Edge upgrade instructions
</li>
</ul>
</li>
<li>
<a href="#upgrading-to-401" id="markdown-toc-upgrading-to-401">Upgrading to 4.0.1EDGEPE</a>
<ul>
<li>
<a href="#ubuntucentosrpi-401" id="markdown-toc-ubuntucentos-401">Ubuntu/CentOS/Raspberry Pi</a>
</li>
<li>
<a href="#docker-linux-mac-401" id="markdown-toc-docker-linux-mac-401">Docker (Linux or Mac OS)</a>
</li>
<li>
<a href="#windows-401" id="markdown-toc-windows-401">Windows</a>
</li>
</ul>
</li>
<li>
<a href="#upgrading-to-391" id="markdown-toc-upgrading-to-391">Upgrading to 3.9.1EDGEPE</a>
<ul>
Expand Down Expand Up @@ -279,6 +293,100 @@ net stop tb-edge
Launch the "pgAdmin" software and login as superuser (postgres).
Open your server and create backup of database **tb_edge** using 'Backup Dialog' functionality of "pgAdmin".

## Upgrading to 4.0.1EDGEPE {#upgrading-to-401}

{% assign serverVersion = "4.0.1PE" %}
{% assign updateServerLink = "#upgrading-to-401pe" %}
{% include templates/edge/install/compatibility-warning-version.md %}

### Ubuntu/CentOS/Raspberry Pi {#ubuntucentosrpi-401}

**NOTE**: These steps are applicable for ThingsBoard Edge 3.9.1EDGEPE version.

#### ThingsBoard Edge package download

{% capture tabspec %}tb-edge-pe-download-4-0-1
tb-edge-pe-download-4-0-1-ubuntu,Ubuntu/Raspberry Pi,shell,resources/4.1/tb-edge-ubuntu-download.sh,/docs/user-guide/install/pe/edge/resources/4.1/tb-edge-ubuntu-download.sh
tb-edge-pe-download-4-0-1-centos,CentOS,shell,resources/4.1/tb-edge-centos-download.sh,/docs/user-guide/install/pe/edge/resources/4.1/tb-edge-centos-download.sh{% endcapture %}
{% include tabs.html %}

#### ThingsBoard Edge service upgrade

* Stop ThingsBoard Edge service if it is running.

```bash
sudo service tb-edge stop
```
{: .copy-code}

{% capture tabspec %}tb-edge-pe-installation-4-0-1
tb-edge-pe-installation-4-0-1-ubuntu,Ubuntu/Raspberry Pi,shell,resources/4.1/tb-edge-ubuntu-installation.sh,/docs/user-guide/install/pe/edge/resources/4.1/tb-edge-ubuntu-installation.sh
tb-edge-pe-installation-4-0-1-centos,CentOS,shell,resources/4.1/tb-edge-centos-installation.sh,/docs/user-guide/install/pe/edge/resources/4.1/tb-edge-centos-installation.sh{% endcapture %}
{% include tabs.html %}

**NOTE:** Package installer may ask you to merge your tb-edge configuration. It is preferred to use **merge option** to make sure that all your previous parameters will not be overwritten.

Execute regular upgrade script:

```bash
sudo /usr/share/tb-edge/bin/install/upgrade.sh
```
{: .copy-code}

#### Start the service

```bash
sudo service tb-edge start
```
{: .copy-code}

### Docker (Linux or Mac OS) {#docker-linux-mac-401}

{% assign versionName = "4.0.1EDGEPE" %}
{% assign previousVersion = "3.9.1EDGEPE" %}

{% include templates/edge/user-guide/start-upgrade-pe.md %}

### Windows {#windows-401}

**NOTE**: These steps are applicable for ThingsBoard Edge 4.0.1EDGEPE version.

#### ThingsBoard Edge package download

Download ThingsBoard Edge package for Windows: [tb-edge-windows-4.0.1pe.zip](https://dist.thingsboard.io/tb-edge-windows-4.0.1pe.zip).

#### ThingsBoard Edge service upgrade

* Stop ThingsBoard Edge service if it is running:

```text
net stop tb-edge
```
{: .copy-code}

* Make a backup of the previous ThingsBoard Edge configuration located in *\<ThingsBoard Edge install dir\>\conf* (for example: *C:\tb-edge\conf*).

* Extract ThingsBoard Edge package.

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

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

**NOTE** Scripts listed below should be executed using Administrator Role.

Execute regular upgrade script:

```text
C:\tb-edge>upgrade.bat
```

#### Start the service

```text
net start tb-edge
```
{: .copy-code}

## Upgrading to 3.9.1EDGEPE {#upgrading-to-391}

{% assign serverVersion = "3.9.1PE" %}
Expand Down