You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 

93 lines
3.3 KiB

# 安装,启动常见问题
## 使用docker启动UI后无法访问系统或者提示服务器内部错误
可能原因: docker启动UI时设置的`API_BASE_PATH`无法访问后台服务。
```shell script
$ docker run -it --rm -p 9000:80 -e "API_BASE_PATH=http://host.docker.internal:8848/" registry.cn-shenzhen.aliyuncs.com/jetlinks/jetlinks-ui-antd
```
需要将`API_BASE_PATH`修改为后台服务ip地址+端口。
修改`API_BASE_PATH`后仍未解决问题则可能是因为服务未正确启动,需要根据日志检查,查看日志: `docker-compose logs jetlinks`。
## 通过UI源码自行构建启动后无法访问系统或账号密码错误
大部分是因为前端代码中的代理后台地址配置错误
![ui代理地址](images/ui-api.png)
**修改上图中target为后台服务ip+端口即可**。
## 使用docker启动所有环境后无法访问系统或者提示服务器内部错误
可能原因: docker启动UI时设置的`API_BASE_PATH`无法访问后台服务。
```yaml
ui:
image: registry.cn-shenzhen.aliyuncs.com/jetlinks/jetlinks-ui-antd:1.1.1-RELEASE
container_name: jetlinks-ce-ui
ports:
- 9000:80
environment:
- "API_BASE_PATH=http://jetlinks:8848/" #API根路径
volumes:
- "jetlinks-volume:/usr/share/nginx/html/upload"
links:
- jetlinks:jetlinks
```
查看项目目录docker/run-all下docker-compose.yml文件中ui的环境变量`API_BASE_PATH`,端口是否与后台服务端口一致,否则改之。
## 错误日志: elasticsearch: Name or Service not know
`elasticsearch`未正确启动,使用命令`docker-compose logs elasticsearch`查看日志,根据日志提示解决.
## 更换数据库
目前平台支持mysql、mssql、oracle、postgres数据库。
更换数据库(此处以mysql为例)需要注意的事项:
1. 更换数据库地址
```yaml
r2dbc:
url: r2dbc:mysql://localhost:3306/jetlinks
```
2.将application.yml中的数据库方言替换为目标方言,如:
```yaml
easyorm:
default-schema: jetlinks # 数据库默认的schema
dialect: mysql #数据库方言
```
::: warning 注意:
在mysql中此处default-schema应修改为mysql中存在的数据库名称,
如第一步url中数据库名为jetlinks,default-schema也应为jetlinks。
:::
若出现以下警告,应考虑mysql是否已创建相应库。
![mysql-connection-warning](images/mysql-connection-warning.png)
## maven依赖问题
大部分是因为配置了全局私服,在setting.xml文件中取消即可。
## 协议发布失败或出现不支持的协议:xxx
大部分原因是后台配置的文件上传路径错误。
修改配置/jetlinks-standalone/src/main/resources/application.yml:
```yaml
file:
upload:
static-file-path: ./static/upload
static-location: http://localhost:${server.port}/upload
```
::: tip 注意:
localhost应为部署平台服务的ip地址
:::
若为docker启动的平台,则修改/docker/run-all/docker-compose.yml文件下的环境变量:
```yaml
jetlinks:
image: registry.cn-shenzhen.aliyuncs.com/jetlinks/jetlinks-standalone:1.0-SNAPSHOT
volumes:
- "jetlinks-volume:/static/upload" # 持久化上传的文件
environment:
# - "JAVA_OPTS=-Xms4g -Xmx18g -XX:+UseG1GC"
- "hsweb.file.upload.static-location=http://127.0.0.1:8848/upload" #上传的静态文件访问根地址,为ui的地址.
```