先决条件
本指南介绍了如何在Ubuntu Server 14.04 LTS上安装ThingsBoard。硬件要求取决于选择的数据库和连接到系统的设备数量。要在一台机器上运行ThingsBoard和PostgreSQL,您将至少需要1Gb RAM。要在单台计算机上运行ThingsBoard和Cassandra,您至少需要8Gb RAM。
步骤1.安装Java 8(OpenJDK)
ThingsBoard服务正在Java 8上运行。请按照以下说明安装OpenJDK 8:
1 | sudo apt update |
请不要忘记将操作系统配置为默认使用OpenJDK 8。您可以使用以下命令配置哪个版本是默认版本:
1 | sudo update-alternatives --config java |
您可以使用以下命令检查安装:
1 | java -version |
预期的命令输出为:
1 | openjdk version "1.8.0_xxx" |
第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 | sudo apt-get update |
一旦安装了PostgreSQL,您可能想要创建一个新用户或为主要用户设置密码。以下说明将有助于为主要PostgreSQL用户设置密码
1 | sudo su - postgres |
然后,按“ Ctrl + D”返回主用户控制台并连接到数据库以创建Thingsboard DB:
1 | psql -U postgres -d postgres -h 127.0.0.1 -W |
ThingsBoard配置
编辑ThingsBoard配置文件
1 | sudo nano /etc/thingsboard/conf/thingsboard.conf |
将以下行添加到配置文件。不要忘记用您的真实postgres用户密码**替换** “ PUT_YOUR_POSTGRESQL_PASSWORD_HERE” :
1 | # DB Configuration |
步骤4. [可选]慢速计算机的内存更新(1GB RAM)
编辑ThingsBoard配置文件
1 | sudo nano /etc/thingsboard/conf/thingsboard.conf |
将以下行添加到配置文件。
1 | # Update ThingsBoard memory usage and restrict it to 256MB in /etc/thingsboard/conf/thingsboard.conf |
步骤5.运行安装脚本
安装ThingsBoard服务并更新数据库配置后,您可以执行以下脚本:
1 | # --loadDemo option will load demo data: users, devices, assets, rules, widgets. |
步骤6.启动ThingsBoard服务
执行以下命令以启动ThingsBoard:
1 | sudo service thingsboard start |
启动后,您将可以使用以下链接打开Web UI:
1 | http://localhost:8080/ |
如果在执行安装脚本期间指定了–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 | /var/log/thingsboard |
您可以发出以下命令以检查后端是否有任何错误:
1 | cat /var/log/thingsboard/thingsboard.log | grep ERROR |