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

  • 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默认的镜像库为国外的,可以使用国内的镜像地址来镜像加速。