先决条件
本指南介绍了如何在Ubuntu Server 14.04 LTS上安装ThingsBoard。硬件要求取决于选择的数据库和连接到系统的设备数量。要在一台机器上运行ThingsBoard和PostgreSQL,您将至少需要1Gb RAM。要在单台计算机上运行ThingsBoard和Cassandra,您至少需要8Gb RAM。
步骤1.安装Java 8(OpenJDK)
ThingsBoard服务正在Java 8上运行。请按照以下说明安装OpenJDK 8:
1 2
| sudo apt update sudo apt install openjdk-8-jdk
|
请不要忘记将操作系统配置为默认使用OpenJDK 8。您可以使用以下命令配置哪个版本是默认版本:
1
| sudo update-alternatives --config java
|
您可以使用以下命令检查安装:
预期的命令输出为:
1 2 3
| openjdk version "1.8.0_xxx" OpenJDK Runtime Environment (...) OpenJDK 64-Bit Server VM (build ...)
|
第2步。ThingsBoard服务安装
下载安装包。
1
| wget https://github.com/thingsboard/thingsboard/releases/download/v2.4.3/thingsboard-2.4.3.deb
|
将ThingsBoard作为服务安装
1
| sudo dpkg -i thingsboard-2.4.3.deb
|
步骤3.配置ThingsBoard数据库
ThingsBoard能够使用SQL或混合数据库(PostgreSQL+Cassandra)方法。本机测试数据量不大,选择PostgreSQL。
PostgreSQL安装
下面列出的说明将帮助您安装PostgreSQL。
1 2 3
| sudo apt-get update sudo apt-get install postgresql postgresql-contrib sudo service postgresql start
|
一旦安装了PostgreSQL,您可能想要创建一个新用户或为主要用户设置密码。以下说明将有助于为主要PostgreSQL用户设置密码
1 2 3 4
| sudo su - postgres psql \password \q
|
然后,按“ Ctrl + D”返回主用户控制台并连接到数据库以创建Thingsboard DB:
1 2 3
| psql -U postgres -d postgres -h 127.0.0.1 -W CREATE DATABASE thingsboard; \q
|
ThingsBoard配置
编辑ThingsBoard配置文件
1
| sudo nano /etc/thingsboard/conf/thingsboard.conf
|
将以下行添加到配置文件。不要忘记用您的真实postgres用户密码**替换** “ PUT_YOUR_POSTGRESQL_PASSWORD_HERE” :
1 2 3 4 5 6 7 8
| # DB Configuration export DATABASE_ENTITIES_TYPE=sql export DATABASE_TS_TYPE=sql export SPRING_JPA_DATABASE_PLATFORM=org.hibernate.dialect.PostgreSQLDialect export SPRING_DRIVER_CLASS_NAME=org.postgresql.Driver export SPRING_DATASOURCE_URL=jdbc:postgresql://localhost:5432/thingsboard export SPRING_DATASOURCE_USERNAME=postgres export SPRING_DATASOURCE_PASSWORD=PUT_YOUR_POSTGRESQL_PASSWORD_HERE
|
步骤4. [可选]慢速计算机的内存更新(1GB RAM)
编辑ThingsBoard配置文件
1
| sudo nano /etc/thingsboard/conf/thingsboard.conf
|
将以下行添加到配置文件。
1 2
| # Update ThingsBoard memory usage and restrict it to 256MB in /etc/thingsboard/conf/thingsboard.conf export JAVA_OPTS="$JAVA_OPTS -Xms256M -Xmx256M"
|
步骤5.运行安装脚本
安装ThingsBoard服务并更新数据库配置后,您可以执行以下脚本:
1 2
| # --loadDemo option will load demo data: users, devices, assets, rules, widgets. sudo /usr/share/thingsboard/bin/install/install.sh --loadDemo
|
步骤6.启动ThingsBoard服务
执行以下命令以启动ThingsBoard:
1
| sudo service thingsboard start
|
启动后,您将可以使用以下链接打开Web UI:
如果在执行安装脚本期间指定了–loadDemo,则可以使用以下默认凭据:
- Systen管理员:sysadmin@thingsboard.org / sysadmin
- 租户管理员:tenant@thingsboard.org / tenant
- 客户用户:customer@thingsboard.org / customer
您始终可以在帐户资料页面中更改每个帐户的密码。
请等待90秒以启动Web UI。这仅适用于具有1-2 CPU或1-2 GB RAM的慢速计算机。
测试
1
| curl -v -X POST -d "[{\"temperature\": 25},{\"humidity\":60}]" http://localhost:8080/api/v1/DHT11_DEMO_TOKEN/telemetry --header "Content-Type:application/json"
|
安装后步骤
配置HAProxy以启用HTTPS
您可能要使用HAProxy配置HTTPS访问。如果您在云端托管ThingsBoard并为您的实例分配了有效的DNS名称,则可以这样做。请按照本指南安装HAProxy并使用Let’s Encrypt生成有效的SSL证书。
故障排除
ThingsBoard日志存储在以下目录中:
您可以发出以下命令以检查后端是否有任何错误:
1
| cat /var/log/thingsboard/thingsboard.log | grep ERROR
|