立即试用 商务报价
Edge PE
安装 > 安装说明 > CentOS/RHEL (RPM)

本页目录

Installing ThingsBoard Edge on CentOS/RHEL Server

This guide describes how to install ThingsBoard Edge on RHEL/CentOS 7/8.

Prerequisites

ThingsBoard Cloud server

To start using ThingsBoard Edge you need to have ThingsBoard PE server that supports edge functionality up and running.

The easiest way is to use ThingsBoard Cloud server.
The alternative option is to install ThingsBoard Professional Edition server that supports edge functionality on-premise. Please visit Install PE to install 3.3 version or higher of server that supports edge functionality.

Edge provision on cloud

Additionally, you will need to provision ThingsBoard Edge on cloud server. Please follow Step 1 first if you skipped it.

Once ThingsBoard Edge provisioned on cloud server please follow installation steps below.

Edge hardware requirements

Hardware requirements depend on an amount of devices connected to the edge and GUI usage locally.

To run ThingsBoard Edge without heavily usage of GUI (local dashboards, device management etc.) and relatively small amount of devices (under 100) on a single machine you will need at least 1GB of RAM.

To run ThingsBoard Edge with heavily usage of GUI (local dashboards, device management etc.) and with 100+ devices on a single machine we recommend having at least 4GB of RAM.

Pre-installation step

Before continue to installation execute the following commands in order to install necessary tools:

1
2
sudo yum install -y nano wget
sudo yum install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

Step 1. Install Java 11 (OpenJDK)

ThingsBoard服务运行在Java 11请按照以下说明安装OpenJDK 11:

1
sudo yum install java-11-openjdk

使用以下命令设置默认版本是OpenJDK 11:

1
sudo update-alternatives --config java

可以使用以下命令检查安装:

1
java -version

命令输出结果:

1
2
3
openjdk version "11.0.xx"
OpenJDK Runtime Environment (...)
OpenJDK 64-Bit Server VM (build ...)

Step 2. Configure PostgreSQL

ThingsBoard Edge uses PostgreSQL database as a local storage.

Instructions listed below will help you to install PostgreSQL.

1
2
# Update your system
sudo yum update

For CentOS 7:

1
2
3
4
5
6
7
8
9
10
11
12
# Install the repository RPM (for CentOS 7):
sudo yum -y install https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpm
# Install packages
sudo yum -y install epel-release yum-utils
sudo yum-config-manager --enable pgdg12
sudo yum install postgresql12-server postgresql12
# Initialize your PostgreSQL DB
sudo /usr/pgsql-12/bin/postgresql-12-setup initdb
sudo systemctl start postgresql-12
# Optional: Configure PostgreSQL to start on boot
sudo systemctl enable --now postgresql-12

For CentOS 8:

1
2
3
4
5
6
7
8
9
10
11
# Install the repository RPM (for CentOS 8):
sudo yum -y install https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm
# Install packages
sudo dnf -qy module disable postgresql
sudo dnf -y install postgresql12 postgresql12-server
# Initialize your PostgreSQL DB
sudo /usr/pgsql-12/bin/postgresql-12-setup initdb
sudo systemctl start postgresql-12
# Optional: Configure PostgreSQL to start on boot
sudo systemctl enable --now postgresql-12

创建一个新用户或为主用户设置密码

1
2
3
4
sudo su - postgres
psql
\password
\q

Then, press “Ctrl+D” to return to main user console.

After configuring the password, edit the pg_hba.conf to use MD5 authentication with the postgres user.

Edit pg_hba.conf file:

1
sudo nano /var/lib/pgsql/12/data/pg_hba.conf

Locate the following lines:

1
2
# IPv4 local connections:
host    all             all             127.0.0.1/32            ident

Replace ident with md5:

1
host    all             all             127.0.0.1/32            md5

Finally, you should restart the PostgreSQL service to initialize the new configuration:

1
sudo systemctl restart postgresql-12.service

Connect to the database to create ThingsBoard Edge DB:

1
psql -U postgres -d postgres -h 127.0.0.1 -W

Execute create database statement

1
2
CREATE DATABASE tb_edge;
\q

Step 3. ThingsBoard Edge service installation

Download installation package.

1
wget https://dist.thingsboard.io/tb-edge-3.5.1pe.rpm

Go to the download repository and install ThingsBoard Edge service

1
sudo rpm -Uvh tb-edge-3.5.1pe.rpm

Step 4. Configure ThingsBoard Edge

Edit ThingsBoard Edge configuration file

1
sudo nano /etc/tb-edge/conf/tb-edge.conf

Update the following lines in the configuration file. Don’t forget to replace:

  • “PUT_YOUR_POSTGRESQL_PASSWORD_HERE” with your real postgres user password.
  • “PUT_YOUR_CLOUD_IP” with an IP address of the machine where ThingsBoard PE server is running:

    NOTE: thingsboard.cloud uses SSL protocol for edge communication. Please uncomment export CLOUD_RPC_SSL_ENABLED=true as well.

    • Use localhost in case edge is running on the same machine where cloud instance is running.
    • Use X.X.X.X IP address in case edge is connecting to the cloud instance in the same network or in the docker.
  • “PUT_YOUR_EDGE_KEY_HERE” and “PUT_YOUR_EDGE_SECRET_HERE” with Edge key and secret respectively (edge credentials you can find in cloud instance):
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# UNCOMMENT NEXT LINES AND PUT YOUR CLOUD CONNECTION SETTINGS:
# export CLOUD_ROUTING_KEY=PUT_YOUR_EDGE_KEY_HERE
# export CLOUD_ROUTING_SECRET=PUT_YOUR_EDGE_SECRET_HERE

# UNCOMMENT NEXT LINES IF EDGE CONNECTS TO PE 'THINGSBOARD.CLOUD' SERVER:
# export CLOUD_RPC_HOST=thingsboard.cloud
# export CLOUD_RPC_SSL_ENABLED=true

# UNCOMMENT NEXT LINES IF YOU CHANGED DEFAULT CLOUD RPC HOST/PORT SETTINGS:
# export CLOUD_RPC_HOST=PUT_YOUR_CLOUD_IP
# export CLOUD_RPC_PORT=7070

# UNCOMMENT NEXT LINES IF YOU ARE RUNNING EDGE ON THE SAME MACHINE WHERE THINGSBOARD SERVER IS RUNNING:
# export HTTP_BIND_PORT=18080
# export MQTT_BIND_PORT=11883
# export COAP_BIND_PORT=15683
# export LWM2M_ENABLED=false

# export INTEGRATIONS_RPC_PORT=19090

# UNCOMMENT NEXT LINES IF YOU HAVE CHANGED DEFAULT POSTGRESQL DATASOURCE SETTINGS:
# export SPRING_DATASOURCE_URL=jdbc:postgresql://localhost:5432/tb_edge
# export SPRING_DATASOURCE_USERNAME=postgres
# export SPRING_DATASOURCE_PASSWORD=PUT_YOUR_POSTGRESQL_PASSWORD_HERE

If ThingsBoard Edge is going to be running on the same machine where ThingsBoard PE server is running you’ll need to update additional configuration parameters to avoid port collision.

Please uncomment next parameters in ThingsBoard Edge configuration file (/etc/tb-edge/conf/tb-edge.conf):
export HTTP_BIND_PORT=18080
export MQTT_BIND_PORT=11883
export COAP_BIND_PORT=15683
export LWM2M_ENABLED=false


export INTEGRATIONS_RPC_PORT=19090

Please make sure ports above are not used by any other application.

Step 5. Run installation script

Once ThingsBoard Edge is installed and configured please execute the following install script:

1
sudo /usr/share/tb-edge/bin/install/install.sh

Step 6. Restart ThingsBoard Edge service

1
sudo service tb-edge restart

Step 7. Open ThingsBoard Edge UI

Once started, you will be able to open ThingsBoard Edge UI using the following link http://localhost:8080.

Use next Edge UI URL if during installation process you set HTTP_BIND_PORT to 18080:

http://localhost:18080

Please use your tenant credentials from local cloud instance or ThingsBoard Cloud to log in to the ThingsBoard Edge.

Troubleshooting

ThingsBoard Edge logs are stored in the following directory:

1
/var/log/tb-edge

You can issue the following command in order to check if there are any errors on the service side:

1
cat /var/log/tb-edge/tb-edge.log | grep ERROR

Start edge service:

1
sudo service tb-edge start

Stop edge service:

1
sudo service tb-edge stop

Restart edge service:

1
sudo service tb-edge restart

Check status of ThingsBoard Edge service:

1
sudo service tb-edge status

Next Steps

Congratulations! You have successfully provisioned, installed and connected ThingsBoard Edge to ThingsBoard server.

You can continue with Getting started guide to get the basic knowledge of ThingsBoard Edge or you can jump directly to more advanced topics: