- Prepare for upgrading ThingsBoard Edge
- Upgrading to 3.6.0EDGE
- Upgrading to 3.5.1.1EDGE
- Upgrading to 3.5.1EDGE
- Upgrading to 3.5.0EDGE
- Upgrading to 3.4.3EDGE
- Upgrading to 3.4.1EDGE
- Upgrading to 3.4EDGE
- Upgrading to 3.3.4.1EDGE
Rules of Compatibility Between ThingsBoard Edge and ThingsBoard Server Versions:
- ThingsBoard Edge version X.Y.Z is compatible with ThingsBoard Server version X.Y.Z and subsequent versions.
- ThingsBoard Edge version X.Y.Z is NOT compatible with ThingsBoard Server versions prior to X.Y.Z.
Example: ThingsBoard Edge version 3.3.4.1 is compatible with ThingsBoard server version 3.3.4.1 and later versions (3.4.0, 3.4.1, …). However, ThingsBoard Edge version 3.4.0 is NOT compatible with ThingsBoard server version 3.3.4.1 or earlier versions (3.3.4, 3.3.3, …). In such a case, ThingsBoard Server 3.3.4.1 or an earlier version should first be upgraded to ThingsBoard Server 3.4.0 or a later version.
Please ensure that the ThingsBoard Server is updated to the latest version before proceeding.
Prepare for upgrading ThingsBoard Edge
Ubuntu/CentOS
Stop ThingsBoard Edge service:
1
sudo systemctl stop tb-edge
Backup Database
Make a backup of the database before upgrading.
Make sure you have enough space to place a backup of the database
Check database size
1
sudo -u postgres psql -c "SELECT pg_size_pretty( pg_database_size('tb_edge') );"
Check free space
1
df -h /
If there is enough free space - make a backup.
1
sudo -Hiu postgres pg_dump tb_edge > tb_edge.sql.bak
Check backup file created successfully.
Docker (Linux or Mac OS)
Set the terminal in the directory which contains the docker-compose.yml file and execute the following command to stop and remove currently running TB Edge container:
1
2
docker compose stop
docker compose rm mytbedge
If you still rely on Docker Compose as docker-compose (with a hyphen) here is the list of the above commands:
docker-compose stop
docker-compose rm mytbedge
Backup Database
Make a copy of the database folder before upgrading:
1
sudo cp -r ~/.mytb-edge-data/db ~/.mytb-edge-db-BACKUP
Windows
Stop ThingsBoard Edge service:
1
net stop tb-edge
Backup Database
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 3.6.0EDGE
Please make sure that ThingsBoard Server version is 3.6.0 or above before updating ThingsBoard Edge to this version.
If ThingsBoard Server version is below 3.6.0, please follow upgrade ThingsBoard server upgrade instructions first.
Ubuntu/CentOS
NOTE: These steps are applicable for ThingsBoard Edge 3.5.1.1EDGE version.
ThingsBoard Edge package download
|
|
ThingsBoard Edge service upgrade
- Stop ThingsBoard Edge service if it is running.
1
sudo service tb-edge stop
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:
1
sudo /usr/share/tb-edge/bin/install/upgrade.sh --fromVersion=3.5.1
Start the service
1
sudo service tb-edge start
Docker (Linux or Mac OS)
NOTE: These steps are applicable for ThingsBoard Edge 3.5.1.1EDGE version.
Execute the following command to pull 3.6.0EDGE image:
1
docker pull thingsboard/tb-edge:3.6.0EDGE
Set the terminal in the directory which contains the docker-compose.yml file and execute the following command to stop and remove currently running TB Edge container (if it’s still running):
1
2
docker compose stop
docker compose rm mytbedge
Create docker compose file for ThingsBoard Edge upgrade process:
1
nano docker-compose-upgrade.yml
Add the following lines to the yml file:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
version: '3.0'
services:
mytbedge:
restart: on-failure
image: "thingsboard/tb-edge:3.6.0EDGE"
environment:
SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/tb-edge
volumes:
- ~/.mytb-edge-data:/data
- ~/.mytb-edge-logs:/var/log/tb-edge
entrypoint: upgrade-tb-edge.sh
postgres:
restart: always
image: "postgres:12"
ports:
- "5432"
environment:
POSTGRES_DB: tb-edge
POSTGRES_PASSWORD: postgres
volumes:
- ~/.mytb-edge-data/db:/var/lib/postgresql/data
Execute the following command to start upgrade process:
1
docker compose -f docker-compose-upgrade.yml up
Once upgrade process successfully completed, exit from the docker-compose shell by this combination:
1
Ctrl + C
Execute the following command to stop TB Edge upgrade container:
1
docker compose -f docker-compose-upgrade.yml stop
Modify ‘main’ docker compose (docker-compose.yml) file for ThingsBoard Edge and update version of the image:
1
nano docker-compose.yml
1
2
3
4
5
6
version: '3.0'
services:
mytbedge:
restart: always
image: "thingsboard/tb-edge:3.6.0EDGE"
...
Make sure your image is the set to tb-edge-3.6.0EDGE.
Execute the following commands to up this docker compose directly:
1
2
docker compose up -d
docker compose logs -f mytbedge
Windows
NOTE: These steps are applicable for ThingsBoard Edge 3.5.1.1EDGE version.
ThingsBoard Edge package download
Download ThingsBoard Edge package for Windows: tb-edge-windows-3.6.zip.
ThingsBoard Edge service upgrade
- Stop ThingsBoard Edge service if it is running:
1
net stop tb-edge
-
Make a backup of 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:
1
C:\tb-edge>upgrade.bat --fromVersion=3.5.1
Start the service
1
net start tb-edge
Upgrading to 3.5.1.1EDGE
Please make sure that ThingsBoard Server version is 3.5.1 or above before updating ThingsBoard Edge to this version.
If ThingsBoard Server version is below 3.5.1, please follow upgrade ThingsBoard server upgrade instructions first.
Ubuntu/CentOS
NOTE: These steps are applicable for ThingsBoard Edge 3.5.1EDGE version.
ThingsBoard Edge package download
|
|
ThingsBoard Edge service upgrade
- Stop ThingsBoard Edge service if it is running.
1
sudo service tb-edge stop
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.
Start the service
1
sudo service tb-edge start
Docker (Linux or Mac OS)
NOTE: These steps are applicable for ThingsBoard Edge 3.5.1EDGE version.
Execute the following command to pull 3.5.1.1EDGE image:
1
docker pull thingsboard/tb-edge:3.5.1.1EDGE
Set the terminal in the directory which contains the docker-compose.yml file and execute the following command to stop and remove currently running TB Edge container (if it’s still running):
1
2
docker compose stop
docker compose rm mytbedge
Modify docker compose (docker-compose.yml) file for ThingsBoard Edge and update version of the image:
1
nano docker-compose.yml
1
2
3
4
5
6
version: '3.0'
services:
mytbedge:
restart: always
image: "thingsboard/tb-edge:3.5.1.1EDGE"
...
Make sure your image is the set to tb-edge-3.5.1.1EDGE.
Execute the following commands to up this docker compose directly:
1
2
docker compose up -d
docker compose logs -f mytbedge
Windows
NOTE: These steps are applicable for ThingsBoard Edge 3.5.1EDGE version.
ThingsBoard Edge package download
Download ThingsBoard Edge package for Windows: tb-edge-windows-3.5.1.1.zip.
ThingsBoard Edge service upgrade
- Stop ThingsBoard Edge service if it is running:
1
net stop tb-edge
-
Make a backup of 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.
Start the service
1
net start tb-edge
Upgrading to 3.5.1EDGE
Please make sure that ThingsBoard Server version is 3.5.1 or above before updating ThingsBoard Edge to this version.
If ThingsBoard Server version is below 3.5.1, please follow upgrade ThingsBoard server upgrade instructions first.
Ubuntu/CentOS
NOTE: These steps are applicable for ThingsBoard Edge 3.5.0EDGE version.
ThingsBoard Edge package download
|
|
ThingsBoard Edge service upgrade
- Stop ThingsBoard Edge service if it is running.
1
sudo service tb-edge stop
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:
1
sudo /usr/share/tb-edge/bin/install/upgrade.sh --fromVersion=3.5.0
Start the service
1
sudo service tb-edge start
Docker (Linux or Mac OS)
NOTE: These steps are applicable for ThingsBoard Edge 3.5.0EDGE version.
Execute the following command to pull 3.5.1EDGE image:
1
docker pull thingsboard/tb-edge:3.5.1EDGE
Set the terminal in the directory which contains the docker-compose.yml file and execute the following command to stop and remove currently running TB Edge container (if it’s still running):
1
2
docker compose stop
docker compose rm mytbedge
Create docker compose file for ThingsBoard Edge upgrade process:
1
nano docker-compose-upgrade.yml
Add the following lines to the yml file:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
version: '3.0'
services:
mytbedge:
restart: on-failure
image: "thingsboard/tb-edge:3.5.1EDGE"
environment:
SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/tb-edge
volumes:
- ~/.mytb-edge-data:/data
- ~/.mytb-edge-logs:/var/log/tb-edge
entrypoint: upgrade-tb-edge.sh
postgres:
restart: always
image: "postgres:12"
ports:
- "5432"
environment:
POSTGRES_DB: tb-edge
POSTGRES_PASSWORD: postgres
volumes:
- ~/.mytb-edge-data/db:/var/lib/postgresql/data
Execute the following command to start upgrade process:
1
docker compose -f docker-compose-upgrade.yml up
Once upgrade process successfully completed, exit from the docker-compose shell by this combination:
1
Ctrl + C
Execute the following command to stop TB Edge upgrade container:
1
docker compose -f docker-compose-upgrade.yml stop
Modify ‘main’ docker compose (docker-compose.yml) file for ThingsBoard Edge and update version of the image:
1
nano docker-compose.yml
1
2
3
4
5
6
version: '3.0'
services:
mytbedge:
restart: always
image: "thingsboard/tb-edge:3.5.1EDGE"
...
Make sure your image is the set to tb-edge-3.5.1EDGE.
Execute the following commands to up this docker compose directly:
1
2
docker compose up -d
docker compose logs -f mytbedge
Windows
NOTE: These steps are applicable for ThingsBoard Edge 3.5.0EDGE version.
ThingsBoard Edge package download
Download ThingsBoard Edge package for Windows: tb-edge-windows-3.5.1.zip.
ThingsBoard Edge service upgrade
- Stop ThingsBoard Edge service if it is running:
1
net stop tb-edge
-
Make a backup of 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:
1
C:\tb-edge>upgrade.bat --fromVersion=3.5.0
Start the service
1
net start tb-edge
Upgrading to 3.5.0EDGE
Please make sure that ThingsBoard Server version is 3.5.0 or above before updating ThingsBoard Edge to this version.
If ThingsBoard Server version is below 3.5.0, please follow upgrade ThingsBoard server upgrade instructions first.
Ubuntu/CentOS
NOTE: These steps are applicable for ThingsBoard Edge 3.4.3EDGE version.
ThingsBoard Edge package download
|
|
ThingsBoard Edge service upgrade
- Stop ThingsBoard Edge service if it is running.
1
sudo service tb-edge stop
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:
1
sudo /usr/share/tb-edge/bin/install/upgrade.sh --fromVersion=3.4.3
Start the service
1
sudo service tb-edge start
Docker (Linux or Mac OS)
NOTE: These steps are applicable for ThingsBoard Edge 3.4.3EDGE version.
Execute the following command to pull 3.5.0EDGE image:
1
docker pull thingsboard/tb-edge:3.5.0EDGE
Set the terminal in the directory which contains the docker-compose.yml file and execute the following command to stop and remove currently running TB Edge container (if it’s still running):
1
2
docker compose stop
docker compose rm mytbedge
Create docker compose file for ThingsBoard Edge upgrade process:
1
nano docker-compose-upgrade.yml
Add the following lines to the yml file:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
version: '3.0'
services:
mytbedge:
restart: on-failure
image: "thingsboard/tb-edge:3.5.0EDGE"
environment:
SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/tb-edge
volumes:
- ~/.mytb-edge-data:/data
- ~/.mytb-edge-logs:/var/log/tb-edge
entrypoint: upgrade-tb-edge.sh
postgres:
restart: always
image: "postgres:12"
ports:
- "5432"
environment:
POSTGRES_DB: tb-edge
POSTGRES_PASSWORD: postgres
volumes:
- ~/.mytb-edge-data/db:/var/lib/postgresql/data
Execute the following command to start upgrade process:
1
docker compose -f docker-compose-upgrade.yml up
Once upgrade process successfully completed, exit from the docker-compose shell by this combination:
1
Ctrl + C
Execute the following command to stop TB Edge upgrade container:
1
docker compose -f docker-compose-upgrade.yml stop
Modify ‘main’ docker compose (docker-compose.yml) file for ThingsBoard Edge and update version of the image:
1
nano docker-compose.yml
1
2
3
4
5
6
version: '3.0'
services:
mytbedge:
restart: always
image: "thingsboard/tb-edge:3.5.0EDGE"
...
Make sure your image is the set to tb-edge-3.5.0EDGE.
Execute the following commands to up this docker compose directly:
1
2
docker compose up -d
docker compose logs -f mytbedge
Windows
NOTE: These steps are applicable for ThingsBoard Edge 3.4.3EDGE version.
ThingsBoard Edge package download
Download ThingsBoard Edge package for Windows: tb-edge-windows-3.5.zip.
ThingsBoard Edge service upgrade
- Stop ThingsBoard Edge service if it is running:
1
net stop tb-edge
-
Make a backup of 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:
1
C:\tb-edge>upgrade.bat --fromVersion=3.4.3
Start the service
1
net start tb-edge
Upgrading to 3.4.3EDGE
Please make sure that ThingsBoard Server version is 3.4.3 or above before updating ThingsBoard Edge to this version.
If ThingsBoard Server version is below 3.4.3, please follow upgrade ThingsBoard server upgrade instructions first.
Ubuntu/CentOS
NOTE: These steps are applicable for ThingsBoard Edge 3.4.1EDGE version.
ThingsBoard Edge package download
|
|
ThingsBoard Edge service upgrade
- Stop ThingsBoard Edge service if it is running.
1
sudo service tb-edge stop
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:
1
sudo /usr/share/tb-edge/bin/install/upgrade.sh --fromVersion=3.4.1
Start the service
1
sudo service tb-edge start
Docker (Linux or Mac OS)
NOTE: These steps are applicable for ThingsBoard Edge 3.4.1EDGE version.
Execute the following command to pull 3.4.3EDGE image:
1
docker pull thingsboard/tb-edge:3.4.3EDGE
Set the terminal in the directory which contains the docker-compose.yml file and execute the following command to stop and remove currently running TB Edge container (if it’s still running):
1
2
docker compose stop
docker compose rm mytbedge
Create docker compose file for ThingsBoard Edge upgrade process:
1
nano docker-compose-upgrade.yml
Add the following lines to the yml file:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
version: '3.0'
services:
mytbedge:
restart: on-failure
image: "thingsboard/tb-edge:3.4.3EDGE"
environment:
SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/tb-edge
volumes:
- ~/.mytb-edge-data:/data
- ~/.mytb-edge-logs:/var/log/tb-edge
entrypoint: upgrade-tb-edge.sh
postgres:
restart: always
image: "postgres:12"
ports:
- "5432"
environment:
POSTGRES_DB: tb-edge
POSTGRES_PASSWORD: postgres
volumes:
- ~/.mytb-edge-data/db:/var/lib/postgresql/data
Execute the following command to start upgrade process:
1
docker compose -f docker-compose-upgrade.yml up
Once upgrade process successfully completed, exit from the docker-compose shell by this combination:
1
Ctrl + C
Execute the following command to stop TB Edge upgrade container:
1
docker compose -f docker-compose-upgrade.yml stop
Modify ‘main’ docker compose (docker-compose.yml) file for ThingsBoard Edge and update version of the image:
1
nano docker-compose.yml
1
2
3
4
5
6
version: '3.0'
services:
mytbedge:
restart: always
image: "thingsboard/tb-edge:3.4.3EDGE"
...
Make sure your image is the set to tb-edge-3.4.3EDGE.
Execute the following commands to up this docker compose directly:
1
2
docker compose up -d
docker compose logs -f mytbedge
Windows
NOTE: These steps are applicable for ThingsBoard Edge 3.4.1EDGE version.
ThingsBoard Edge package download
Download ThingsBoard Edge package for Windows: tb-edge-windows-3.4.3.zip.
ThingsBoard Edge service upgrade
- Stop ThingsBoard Edge service if it is running:
1
net stop tb-edge
-
Make a backup of 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:
1
C:\tb-edge>upgrade.bat --fromVersion=3.4.1
Start the service
1
net start tb-edge
Upgrading to 3.4.1EDGE
Please make sure that ThingsBoard Server version is 3.4.1 or above before updating ThingsBoard Edge to this version.
If ThingsBoard Server version is below 3.4.1, please follow upgrade ThingsBoard server upgrade instructions first.
Ubuntu/CentOS
NOTE: These steps are applicable for ThingsBoard Edge 3.4.0EDGE version.
ThingsBoard Edge package download
|
|
ThingsBoard Edge service upgrade
- Stop ThingsBoard Edge service if it is running.
1
sudo service tb-edge stop
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:
1
sudo /usr/share/tb-edge/bin/install/upgrade.sh --fromVersion=3.4.0
Start the service
1
sudo service tb-edge start
Docker (Linux or Mac OS)
NOTE: These steps are applicable for ThingsBoard Edge 3.4.0EDGE version.
Execute the following command to pull 3.4.1EDGE image:
1
docker pull thingsboard/tb-edge:3.4.1EDGE
Set the terminal in the directory which contains the docker-compose.yml file and execute the following command to stop and remove currently running TB Edge container (if it’s still running):
1
2
docker-compose stop
docker-compose rm mytbedge
Create docker compose file for ThingsBoard Edge upgrade process:
1
nano docker-compose-upgrade.yml
Add the following lines to the yml file:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
version: '3.0'
services:
mytbedge:
restart: on-failure
image: "thingsboard/tb-edge:3.4.1EDGE"
environment:
SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/tb-edge
volumes:
- ~/.mytb-edge-data:/data
- ~/.mytb-edge-logs:/var/log/tb-edge
entrypoint: upgrade-tb-edge.sh
postgres:
restart: always
image: "postgres:12"
ports:
- "5432"
environment:
POSTGRES_DB: tb-edge
POSTGRES_PASSWORD: postgres
volumes:
- ~/.mytb-edge-data/db:/var/lib/postgresql/data
Execute the following command to start upgrade process:
1
docker-compose -f docker-compose-upgrade.yml up
Once upgrade process successfully completed, exit from the docker-compose shell by this combination:
1
Ctrl + C
Execute the following command to stop TB Edge upgrade container:
1
docker-compose -f docker-compose-upgrade.yml stop
Modify ‘main’ docker compose (docker-compose.yml) file for ThingsBoard Edge and update version of the image:
1
nano docker-compose.yml
1
2
3
4
5
6
version: '3.0'
services:
mytbedge:
restart: always
image: "thingsboard/tb-edge:3.4.1EDGE"
...
Make sure your image is the set to tb-edge-3.4.1EDGE.
Execute the following command to up this docker compose directly:
1
docker-compose up
Windows
NOTE: These steps are applicable for ThingsBoard Edge 3.4.0EDGE version.
ThingsBoard Edge package download
Download ThingsBoard Edge package for Windows: tb-edge-windows-3.4.1.zip.
ThingsBoard Edge service upgrade
- Stop ThingsBoard Edge service if it is running:
1
net stop tb-edge
-
Make a backup of 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:
1
C:\tb-edge>upgrade.bat --fromVersion=3.4.0
Start the service
1
net start tb-edge
Upgrading to 3.4EDGE
Please make sure that ThingsBoard Server version is 3.4 or above before updating ThingsBoard Edge to this version.
If ThingsBoard Server version is below 3.4, please follow upgrade ThingsBoard server upgrade instructions first.
Ubuntu/CentOS
NOTE: These steps are applicable for ThingsBoard Edge 3.3.4.1EDGE version.
ThingsBoard Edge package download
|
|
ThingsBoard Edge service upgrade
- Stop ThingsBoard Edge service if it is running.
1
sudo service tb-edge stop
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:
1
sudo /usr/share/tb-edge/bin/install/upgrade.sh --fromVersion=3.3.4.1
Start the service
1
sudo service tb-edge start
Docker (Linux or Mac OS)
NOTE: These steps are applicable for ThingsBoard Edge 3.3.4.1EDGE version.
Execute the following command to pull 3.4.0EDGE image:
1
docker pull thingsboard/tb-edge:3.4.0EDGE
Set the terminal in the directory which contains the docker-compose.yml file and execute the following command to stop and remove currently running TB Edge container (if it’s still running):
1
2
docker-compose stop
docker-compose rm mytbedge
Create docker compose file for ThingsBoard Edge upgrade process:
1
nano docker-compose-upgrade.yml
Add the following lines to the yml file:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
version: '3.0'
services:
mytbedge:
restart: on-failure
image: "thingsboard/tb-edge:3.4.0EDGE"
environment:
SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/tb-edge
volumes:
- ~/.mytb-edge-data:/data
- ~/.mytb-edge-logs:/var/log/tb-edge
entrypoint: upgrade-tb-edge.sh
postgres:
restart: always
image: "postgres:12"
ports:
- "5432"
environment:
POSTGRES_DB: tb-edge
POSTGRES_PASSWORD: postgres
volumes:
- ~/.mytb-edge-data/db:/var/lib/postgresql/data
Execute the following command to start upgrade process:
1
docker-compose -f docker-compose-upgrade.yml up
Once upgrade process successfully completed, exit from the docker-compose shell by this combination:
1
Ctrl + C
Execute the following command to stop TB Edge upgrade container:
1
docker-compose -f docker-compose-upgrade.yml stop
Modify ‘main’ docker compose (docker-compose.yml) file for ThingsBoard Edge and update version of the image:
1
nano docker-compose.yml
1
2
3
4
5
6
version: '3.0'
services:
mytbedge:
restart: always
image: "thingsboard/tb-edge:3.4.0EDGE"
...
Make sure your image is the set to tb-edge-3.4.0EDGE.
Execute the following command to up this docker compose directly:
1
docker-compose up
Windows
NOTE: These steps are applicable for ThingsBoard Edge 3.3.4.1EDGE version.
ThingsBoard Edge package download
Download ThingsBoard Edge package for Windows: tb-edge-windows-3.4.zip.
ThingsBoard Edge service upgrade
- Stop ThingsBoard Edge service if it is running:
1
net stop tb-edge
-
Make a backup of 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:
1
C:\tb-edge>upgrade.bat --fromVersion=3.3.4.1
Start the service
1
net start tb-edge
Upgrading to 3.3.4.1EDGE
Please make sure that ThingsBoard Server version is 3.3.4.1 or above before updating ThingsBoard Edge to this version.
If ThingsBoard Server version is below 3.3.4.1, please follow upgrade ThingsBoard server upgrade instructions first.
Ubuntu/CentOS
NOTE: These steps are applicable for ThingsBoard Edge 3.3.4EDGE version.
ThingsBoard Edge package download
|
|
ThingsBoard Edge service upgrade
- Stop ThingsBoard Edge service if it is running.
1
sudo service tb-edge stop
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:
1
sudo /usr/share/tb-edge/bin/install/upgrade.sh --fromVersion=3.3.4
Start the service
1
sudo service tb-edge start
Docker (Linux or Mac OS)
NOTE: These steps are applicable for ThingsBoard Edge 3.3.4EDGE version.
Execute the following command to pull 3.3.4.1EDGE image:
1
docker pull thingsboard/tb-edge:3.3.4.1EDGE
Set the terminal in the directory which contains the docker-compose.yml file and execute the following command to stop and remove currently running TB Edge container (if it’s still running):
1
2
docker-compose stop
docker-compose rm mytbedge
Create docker compose file for ThingsBoard Edge upgrade process:
1
nano docker-compose-upgrade.yml
Add the following lines to the yml file:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
version: '3.0'
services:
mytbedge:
restart: on-failure
image: "thingsboard/tb-edge:3.3.4.1EDGE"
environment:
SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/tb-edge
volumes:
- ~/.mytb-edge-data:/data
- ~/.mytb-edge-logs:/var/log/tb-edge
entrypoint: upgrade-tb-edge.sh
postgres:
restart: always
image: "postgres:12"
ports:
- "5432"
environment:
POSTGRES_DB: tb-edge
POSTGRES_PASSWORD: postgres
volumes:
- ~/.mytb-edge-data/db:/var/lib/postgresql/data
Execute the following command to start upgrade process:
1
docker-compose -f docker-compose-upgrade.yml up
Once upgrade process successfully completed, exit from the docker-compose shell by this combination:
1
Ctrl + C
Execute the following command to stop TB Edge upgrade container:
1
docker-compose -f docker-compose-upgrade.yml stop
Modify ‘main’ docker compose (docker-compose.yml) file for ThingsBoard Edge and update version of the image:
1
nano docker-compose.yml
1
2
3
4
5
6
version: '3.0'
services:
mytbedge:
restart: always
image: "thingsboard/tb-edge:3.3.4.1EDGE"
...
Make sure your image is the set to tb-edge-3.3.4.1EDGE.
Execute the following command to up this docker compose directly:
1
docker-compose up
Windows
NOTE: These steps are applicable for ThingsBoard Edge 3.3.4EDGE version.
ThingsBoard Edge package download
Download ThingsBoard Edge package for Windows: tb-edge-windows-3.3.4.1.zip.
ThingsBoard Edge service upgrade
- Stop ThingsBoard Edge service if it is running:
1
net stop tb-edge
-
Make a backup of 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:
1
C:\tb-edge>upgrade.bat --fromVersion=3.3.4
Start the service
1
net start tb-edge
