Thingsboard开源平台(一)2.软件安装

在Windows平台安装ThingsBoard

前言


ThingsBoard服务支持运行在多种操作平台,用户可以在Windows、Linux中安装使用,也可在云平台上部署应用,这里我们主要是入门学习的过程,所以选择在Windows上安装。

本篇文章介绍了如何在Windows计算机上安装ThingsBoard。 以下说明适用于Windows 10 / 8.1 / 8/7 32位/ 64位。 硬件要求取决于选择的数据库和连接到系统的设备数量。 要在一台机器上运行ThingsBoard和PostgreSQL,您将至少需要2Gb的RAM。 要在一台机器上运行ThingsBoard和Cassandra,您至少需要8Gb的RAM。
 

1、安装 java8(OpenJDK)

ThingsBoard服务运行在Java 8开发环境上。请先按照以下说明安装OpenJDK 8。

  • 访问Open JDK下载页面以下载最新的OpenJDK 8(LTS)MSI软件包。
  • 运行下载的MSI软件包,然后按照说明进行操作。 确保已选择“添加到PATH”和“设置JAVA_HOME变量”选项为“将安装在本地硬盘上”状态。

安装完成后,使用以下命令(使用命令提示符)检查安装:

java -version

命令输出结果应为:

C:\Users\User>java -version
openjdk version "1.8.0_212"
OpenJDK Runtime Environment (AdoptOpenJDK)(build 1.8.0_212-b04)
OpenJDK 64-Bit Server VM (AdoptOpenJDK)(build 25.212-b04, mixed mode)

 

2、下载ThingsBoard安装包

从GitHub网站下载并解压缩软件包。

https://github.com/thingsboard/thingsboard/releases/download/v3.0.1/thingsboard-windows-3.0.1.zip

注:假设将ThingsBoard软件包解压缩到默认位置:C:\Program Files (x86)\thingsboard
 

3、配置ThingsBoard数据库

官方文档中的介绍说明,ThingsBoard能够支持SQL数据库(PostgreSQL)或者混合数据库(PostgreSQL+Cassandra)的方式,ThingsBoard团队建议当负载 <5000 msg / sec 时使用PostgreSQL用于开发和生产环境,是一种经济高效的解决方案。我们在学习过程中也将PostgreSQL作为唯一数据源。下面是PostgreSQL具体的安装部署过程。

安装PostgreSQL 数据库

此处下载安装文件(PostgreSQL 11.7或更高版本),然后按照安装说明进行操作。

在PostgreSQL安装期间,将会提示输入超级用户(postgres)密码。 不要忘记此密码,稍后将使用。 为了简单起见,我们将其替换为“ postgres”。

创建ThingsBoard数据库

安装后,启动“ pgAdmin”软件并以超级用户(postgres)身份登录。 打开服务器,并使用所有者“ postgres”创建数据库“ thingsboard”。

修改ThingsBoard配置

如果已经把PostgreSQL超级用户密码指定为“ postgres”,则可以跳过此步骤。

以管理员用户身份打开记事本或其他编辑器(右键单击应用程序图标,然后选择“以管理员身份运行”)。
打开以下文件进行编辑(在文件选择对话框中选择“所有文件”而不是“文本文档”,编码为UTF-8):

C:\Program Files(x86)\thingsboard\conf\thingsboard.yml

并找到“#SQL DAO配置”代码块。 使用上面设置的postgres用户密码替换“ postgres”:

# SQL DAO Configuration
spring:
  data:
    jpa:
      repositories:
        enabled: "true"
  jpa:
    open-in-view: "false"
    hibernate:
      ddl-auto: "none"
    database-platform: "${SPRING_JPA_DATABASE_PLATFORM:org.hibernate.dialect.PostgreSQLDialect}"
  datasource:
    driverClassName: "${SPRING_DRIVER_CLASS_NAME:org.postgresql.Driver}"
    url: "${SPRING_DATASOURCE_URL:jdbc:postgresql://localhost:5432/thingsboard}"
    username: "${SPRING_DATASOURCE_USERNAME:postgres}"
    password: "${SPRING_DATASOURCE_PASSWORD:YOUR_POSTGRES_PASSWORD_HERE}"
    hikari:
      maximumPoolSize: "${SPRING_DATASOURCE_MAXIMUM_POOL_SIZE:5}"

 

4、设置ThingsBoard队列服务

ThingsBoard能够使用各种消息传递系统/代理来存储消息和ThingsBoard服务之间的通信。服务支持的队列实现有如下几种:

  • In Memory:In Memory队列实现是内置的和默认的。它对开发(PoC)环境很有用,不适用于生产部署或任何类型的集群部署。

  • Kafka:建议将Kafka用于生产部署。现在,该队列已在大多数ThingsBoard生产环境中使用。它对于本地和私有云部署都非常有用。如果想要独立于云提供商,这也很有用。但是,某些提供商也为Kafka提供了托管服务。例如,请参阅AWS MSK。

  • RabbitMQ:如果没有太多负载,并且已经有使用此邮件系统的经验,则建议使用RabbitMQ。

  • AWS SQS:AWS SQS是来自AWS的完全托管的消息队列服务。如果打算在AWS上部署ThingsBoard,则很有用。

  • Google Pub / Sub:Google Pub / Sub是Google提供的完全托管的消息队列服务。如果打算在Google Cloud上部署ThingsBoard,则很有用。

  • Azure Service Bus:Azure Service Bus是来自Azure的完全托管的消息队列服务。如果打算在Azure上部署ThingsBoard,则很有用。

这里我们使用内置的In Memory队列,默认情况下是启用的,无需其他配置步骤。
有关更多详细信息,请参见相应的体系结构页面规则引擎页面
 

5、执行安装脚本

以管理员身份启动Windows Shell(命令提示符)。 将目录更改为ThingsBoard安装目录。

执行install.bat脚本来把ThingsBoard作为Windows服务安装(或运行“ install.bat –loadDemo”以安装和添加演示数据)。 这意味着它将在系统启动时自动启动。 类似地,uninstall.bat将从Windows服务中删除ThingsBoard。 执行后输出应与此类似:

C:\Program Files (x86)\thingsboard>install.bat --loadDemo
Detecting Java version installed.
CurrentVersion 18
Java 1.8 found!
Installing thingsboard ...
...
ThingsBoard installed successfully!

 

6、启动ThingsBoard服务

现在开始启动ThingsBoard服务! 以管理员身份打开命令提示符并执行以下命令:

net start thingsboard

输出如下:

The ThingsBoard Server Application service is starting.
The ThingsBoard Server Application service was started successfully.

重新启动ThingsBoard服务,可以执行以下命令:

net stop thingsboard
net start thingsboard

启动后,可以使用以下链接打开Web UI,将会看到登录页面:

http://localhost:8080/

如果在安装脚本执行期间指定了 “–loadDemo”,则可以使用以下默认凭据登录:

  • Systen管理员:sysadmin@thingsboard.org / sysadmin
  • 租户管理员:tenant@thingsboard.org / tenant
  • 客户用户:customer@thingsboard.org / customer

版权声明:本文为Ls101624原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接和本声明。