JetLinks 物联网基础平台（2.x）

# 项目在本地环境安装的时候镜像总是拉取不下来？

  • IDEA：File->Settings->Maven->User settings->选自己安装的maven里的settings.xml
  • Local repository:使用默认的
  • 查看settings.xml里的mirrors节点，将mirror节点注释。
  • 删除repository里的jar包，maven视图栏里reimport/refresh

# 项目在启动时报类缺失或者找不到？

  • 查看java文件引入类是否报错？
  • 报错的话，将pro及standalone两个仓库切至develop分支，并更新代码及子模块
  • maven视图栏找到root节点的模块 执行clean
  • maven视图栏选择蓝色闪电图标并执行install/package
  • 保证mvn命令可执行的情况下，执行以下命令
mvn clean package -Dmaven.test.skip=true

# 项目在docker-compose拉取镜像时偶尔报出ERROR异常

  • 系统要求JDK 1.8.0_2xx
  • ubantu 18.0.x系统
  • 自行配置国内镜像仓库地址

# 项目使用jar包方式在服务器使用jar命令启动时报如下错误

jar部署错误截图 设置application.yml内的参数，参数如下

spring.reactor.debug-agent.enabled=false

# 启动报elasticsearch节点无法进入

进入jetlinks挂载目录data文件夹内，进入data文件夹，找到elasticsearch目录 执行以下命令中任意一个即可

chmod 777 -R elasticsearch
chmod 755 -R elasticsearch

# 若启动时只有jetlinks的banner显示

修改yml内logging.level.org.jetlinks的日志显示级别是debug

docker logs -f [serviceName]
#具体的serviceName可通过docker-compose images 命令查看

# 启动无故失败

使用down命令清除docker-compose编排的挂载目录、网络以及缓存等消息，再重启

docker-compose down
docker-compose up -d

自行在mysql数据库里创建jetlinks的数据库，表可不建，项目会在启动时自己创建表结构以及初始化部分数据。

# 项目启动报以下错误

摄像头网关截图

查看日志启动时使用的profiles 修改启动类项目下的application以及profile指定激活的application文件里的

 easyorm.dialect
 easyorm.default-schema

改成对应的数据库方言
例：使用embedded环境
默认数据库方言h2
如使用mysql：则需要指定dialect为mysql
default-schema也需要改成创建的数据库名

# 数据库切换至mysql后项目启动时报"Operator called default onErrorDropped",下拉至底部抛出"Caused by: javax.net.ssl.SSLHandshakeException: No appropriate protocol (protocol is disabled or cipher suites are inappropriate)"

查看数据库是否开启SSL

show global variables like '%ssl%';
+---------------+-----------------+
| Variable_name | Value           |
+---------------+-----------------+
| have_openssl  | YES             |
| have_ssl      | YES             |    #已经开启了SSL
| ssl_ca        | ca.pem          |
| ssl_capath    |                 |
| ssl_cert      | server-cert.pem |
| ssl_cipher    |                 |
| ssl_crl       |                 |
| ssl_crlpath   |                 |
| ssl_key       | server-key.pem  |
+---------------+-----------------+

如果开启了ssl 可以在连接地址中加入ssl=false【r2dbc协议参数】参数指定关闭ssl连接; 项目启动时如报警告时区未设置，加上serverTimezone=GMT参数。

# 项目启动发现某些资源访问404

根据https://github.com/jetlinks-v2/jetlinks-pro下 的操作步骤一步一步拉取代码
不要跳过更新代码！！！
更改的代码也不要提交到jetlinks的代码仓库，请自行建立代码托管仓库！！！

执行完成更新代码第二步后，将jetlinks-pro及jetlinks-standalone项目的分支切换至develop 摄像头网关截图

勾选需要的模块
基础必选模块：build、x86_64

# 设备无法连接上jetlinks平台

  • 网络组件host建议填入0.0.0.0
  • 端口：查看docker-compose.yml里的预留端口 默认预留的8100-8110端口 填入预留的端口，如需更多端口请自定义后重启项目即可
  • 仍然不能接入，查看云服务器：如阿里云，检查安全组内是否开放了预留端口
  • 再尝试使用emqx socket_tool等工具连接

# 视频网关如何配置？

视频网关配置

# 关于集群下的mqtt客户端组件无法共享订阅问题？

  1. 集群下的服务器要分配不同的server-id
  2. 网络组件->独立配置->填写不同的服务ip/域名、clientId
  3. 推送消息时topic无需带“/”

# 关于设备->运行状态无法自动刷新需要手动刷新问题。

  1. F12查看console报错原因
  2. 提示connection failed
  3. 9000代理后端端口不正确
  4. 修改前端API_BASE_PATH路径
  5. docker方式启动指定-e 参数

# 自定义的消息协议为什么点击方法调用返回超时？

  1. 自定义的协议jar包是否有这个功能？
  2. 自定义的协议jar包是否上传至jetlinks平台重新发布？
  3. 自定义协议是否使用了正确的下发消息类型？ 如： 调用设备功能需使用：FunctionInvokeMessage
    设备属性读取需使用：ReadPropertyMessage
    ...

# 如何使用podman部署？

podman大部分兼容docker，并且可以直接使用docker镜像、命令非常相似 podman默认的镜像库为国外的，可以使用国内的镜像地址来镜像加速。

←