iotkit-parent/README.md

6.6 KiB
Executable File
Raw Blame History

logo

介绍

此仓库为铱塔智联(openiita)物联网平台开源项目。 铱塔智联开源平台是一个开源的物联网基础开发平台,提供了物联网及相关业务开发的常见基础功能, 能帮助你快速搭建自己的物联网相关业务平台。

系统包含了品类、物模型、消息转换、通讯组件mqtt/EMQX通讯组件、小度音箱接入组件、onenet Studio接入组件、modbus透传接入、云端低代码设备开发、设备管理、设备分组、规则引擎、第三方平台接入、数据流转http/mqtt/kafka、数据可视化、报警中心等模块和智能家居APP小程序

低配服务器万级设备接入能力

服务器配置: 1台2核2G(阿里云突发性能实例)跑主程序、1台2核4G(阿里云突发性能实例)跑TDengine和RocketMq

程序配置使用内置H2数据库和内置mqtt

设备接入情况接入4千台网关+8千台子设备其中4千台子设备每10秒上报一条数据

稳定运行后设备在线并正常上报和下发、CPU占用未超过50%、界面操作没有卡顿

低学习门槛

1、零配置一键运行小白也会用

2、低环境要求不需要额外安装软件

3、平民级代码没有形式化的分层和过度封装简单易懂

主流数据库支持

关系型数据库理论上支持所有实现了标准SQL的数据库 DB2、H2、HSQLDB、MariaDB、Microsoft SQL Server、MySQL、Oracle、Postgres

时序数据库elasticsearch、TDEngine

K-V数据库redis

消息总线支持

Vertx event-bus内置、RocketMQ通过扩展模块可接入其它任意消息中间件。

系统生态

前端项目:

OPENIITA/iita-iot-web-admin

演示地址: 点击访问

系统截图

输入图片说明

软件架构

软件架构说明 本系统采用springboot、jpa、vertx、redis、H2、mysql、elasticsearch、TDEngine、RocketMq、sa-token等框架和第三方软件中间件采用模块化无侵入集成非常容易扩展和替换。

默认使用内置的redis、h2数据库、es时序数据库和vertx消息总线以减小启动难度可实现 零配置一键启动 程序在第一次启动的时候会使用data/init目录的示例数据进行初始化。

管理员账号密码admin/admin123

注: es版本为7.15.2mysql版本为8.0+

H2数据库切换为mysql方法其它数据库同理

1、删掉.init、iotkit.mv.db、iotkit.trace.db文件

2、将iot-data-serviceImpl-rdb/pom.xml中的mysql驱动注释放开

3、application.yml 注释掉内置H2数据库打开mysql配置注释先建好库

es切换为TDengine(版本3.x)方法

1、删掉.init和关系数据库数据

2、注释掉iot-starter/pom.xml中的 iot-temporal-serviceImpl-es并打开iot-td-temporal-service的注释

3、注解掉iot-starter下application.xml中的elasticsearch配置并打开td-datasource配置

消息总线切换为RocketMq方法

1、注释掉iot-starter/pom.xml中的 iot-message-event-bus并打开iot-message-rocketmq的注释

2、application.xml中打开rocketmq配置

运行步骤

1、安装jdk11

2、clone代码(核心库,主项目库,插件库)在idea中导入项目

3、先install核心库在主项目库的iot-starter模块的Application类上右键运行

4、若出现报错可能是数据没有初始化完或重复初始化把项目根目录下.init文件和data/iotkit.xx文件删除后重启

5、插件使用说明见插件使用说明

在配置好相应的jdk11环境后推荐使用idea拉取代码等待项目加载完成以后先在Terminal里执行mvn clean install然后在idea的maven操作框上点击下刷新 1

然后就点击启动,看到如下所示日志即表示启动成功:

image-20230702174747305

后端常见问题以及处理方式

1、数据初始化不成功

删除以下标红的几个文件以及文件夹后,重复下上面启动项目的操作:

image-20230702173852342

切换成外置中间件数据库时,也注意删除相关库以及数据。

2、提示找不到QTbxxxxx类

在Terminal里执行mvn clean install再刷新下这个出现的原因是因为采用了querydsl插件打包时会生成相关的类有可能idea的扫描不及时导致未识别到

111

3启动提示xxMapperxxx类bean重复

处理办法同2一样原因也类似采用了mapstruct plus插件打包时候会生成对应类的getset方法工具类可能idea的扫描不及时导致未识别到

服务器部署

执行maven打包在iot-starter模块中将打包后的iot-starter.xx.zip上传到服务器
解压后先执行: java -jar lib/iot-start.xxx.jar确认成功后续可使用 bin/start.sh或bin/start.bat启动。

文档

http://iotkit-open-source.gitee.io/document/

捐助与支持

如果您觉得我的开源软件对你有所帮助请关注、star、fork 😘

如果我的开源软件应用到您的商业项目中,请务必通知到我,因为得到用户的认可是支撑开源的动力。

交流QQ群: 940575749

微信群(添加我微信备注"进群"):

输入图片说明