科研管理系统部署手册

1## 简介
科研管理系统，采用Java、Vue开发，数据库采用Mysql。
（1）系统采用锦中内部框架 ObjectPlus、Saber 编写，数据库使用 Mysql，同时兼容达梦，中间件使用 Redis。
（2）本系统支持 Windows 环境及 Linux 环境下运行。
## 安装环境要求
### 硬件要求
服务器端硬件最低配置
至少需要一台服务器（MySql数据库和应用安装在同一台服务器上）

CPU：4.0GHz 或以上，至少需要 4 核
内存：8G
硬盘（可用空间）：200G以上
服务器端硬件建议配置
建议两台服务器，数据库和应用各一台服务器。

### 数据库服务器
CPU：2.40GHz或以上，4核或以上
内存：16G
硬盘（可用空间）：60G以上
应用服务器
CPU：2.40GHz或以上，4核或以上
内存：16G
硬盘（可用空间）：60G以上
服务器端软件配置要求
操作系统：

### Windows： Windows Server 2008 或以上版本

数据库：Mysql 5.7或以上版本（建议采用Mysql 8.0.28）

用户端软件配置要求
浏览器：Chrome、Firefox、Safari、Edge等chrome内核的浏览器常规版本均可。如：Edge 107.0.1418.52

操作系统：支持上述浏览器即可，对操作系统无特殊要求。

## 安装部署

### MySQL  8.0.28数据库安装
[MySQL安装](https://blog.csdn.net/weixin_43615570/article/details/124520999?ops_request_misc=&request_id=&biz_id=102&utm_term=Mysql%20%208.0.28%E6%95%B0%E6%8D%AE%E5%BA%93%E5%AE%89%E8%A3%85&utm_medium=distribute.pc_search_result.none-task-blog-2~blog~sobaiduweb~default-2-124520999.blog_rank_default&spm=1018.2226.3001.4450 "Redis安装")

### Redis安装
[Redis安装](https://blog.csdn.net/GoodburghCottage/article/details/128171319?ops_request_misc=%257B%2522request%255Fid%2522%253A%2522167869788516800186555955%2522%252C%2522scm%2522%253A%252220140713.130102334..%2522%257D&request_id=167869788516800186555955&biz_id=0&utm_medium=distribute.pc_search_result.none-task-blog-2~blog~top_positive~default-2-128171319-null-null.blog_rank_default&utm_term=redis%E5%AE%89%E8%A3%85&spm=1018.2226.3001.4450 "Redis安装")

### Java8安装
[Java8安装](https://blog.csdn.net/JunLeon/article/details/122623465?ops_request_misc=%257B%2522request%255Fid%2522%253A%2522167869805616800192263804%2522%252C%2522scm%2522%253A%252220140713.130102334..%2522%257D&request_id=167869805616800192263804&biz_id=0&utm_medium=distribute.pc_search_result.none-task-blog-2~all~top_positive~default-1-122623465-null-null.142^v73^insert_down2,201^v4^add_ask,239^v2^insert_chatgpt&utm_term=java8%E5%AE%89%E8%A3%85&spm=1018.2226.3001.4187 "Java8安装")

### Minio安装
[Minio安装](https://blog.csdn.net/m0_60215634/article/details/122560249 "Minio安装")

### Nginx安装
[Nginx安装](https://blog.csdn.net/SoulNone/article/details/127467569 "Nginx安装")

### License申请
锦中科研管理系统，是收费软件系统，需要有License才能正常部署。在您部署之前，应从官方获得正版的License。如果您还没有License，想先部署、测试的话，那么可以在部署之前，先到官方在线申请免费使用3天的License，在线申请url为：http://app.jzkg.cn

在申请License之前，需要先获得科研管理系统后端所在服务器的Ipv4地址（即Ip地址）、Ipv6地址和Mac物理地址。方法为在控制台中输入：ifconfig 命令即可看到。

申请成功后，您将得到文件：license.xml，将这个文件放到：与jar文件同级目录jzconfig下面即可。假设您的jar文件的路径为/data/keyan.jar，则将license.xml放在/data/keyan/jzconfig/license.xml ，注意Linux系统区分大小写，默认license.xml 均小写。 另外还需要在application.yml中配置license.xml的绝对路径。

### 后端部署
（1）将打包好的 jar 包上传至服务器指定文件夹中

（2）以后台运行方式启动即可
`````
nohup java -jar keyan.jar >/dev/null 2>&1 &
`````
（3）假设您的服务器Ip为：192.168.1.118 ，部署端口为8088 , 后端部署好之后，通过URL： http&#058;//192.168.1.118:8088/blade-auth/oauth/captcha 如果看到”key” 相关字样，则后端部署成功

### 配置文件注意事项
（1）自定义环境参数无需修改 jar 包中的配置文件，只需要将 application.yml 放在于 jar 包同级目录下，即可实现自定义。

（2）部署需要修改的配置清单：
```
server.port 端口号修改

spring.datasource.driver-class-name -> 数据库连接驱动修改
spring.datasource.url -> 数据库连接字符串修改
spring.datasource.username -> 数据库连接用户名修改
spring.datasource.password -> 数据库连接密码修改

spring.redis.host -> redis 连接ip修改
spring.redis.port -> redis 连接端口号修改
spring.redis.password -> redis 连接密码修改

oss.endpoint -> minio 连接字符串修改
oss.access-key -> minio 连接用户名修改
oss.secret-key -> minio 连接密码修改
oss.bucket-name -> minio 桶名称修改

blade.preview.enabled -> 演示模式是否启用（正式使用时应当保持false）
blade.dataSource -> 数据源切换，目前支持：mysql、dm，注意当数据库驱动为mysql时，这边应当配置为 mysql
blade.swagger.enabled -> 接口文档服务是否启用（正式使用时应当保持false）
blade.license -> License.xml地址配置
```
### 前端部署
假设您的前端访问域名为： http&#058;//ky.jzkg.cn 。
（1）可使用Nginx、Apache等任何静态文件服务器部署前端，确保可以在公网访问前端。
（2）在Linux系统上解压前端文件时，如果使用unzip命令的话，可采用 sudo unzip -O CP936 yourfrontfile.zip 命令。 由于前端文件中包含中文文件名称，-O CP936 参数可防止中文文件乱码。

### 其他部署
其它部署
（1）前端http&#058;//ky.jzkg.cn，访问后端api的路径默认前缀为：http&#058;//ky.jzkg.cn/api/ ，比如上文中的
http&#058;//192.168.1.118:8088/blade-auth/oauth/captcha ，应当能通过 http&#058;//ky.jzkg.cn/api/blade-auth/oauth/captcha 路径访问，以下为在Nginx上配置后端的相关代码：
```
server {
    listen       80;
    server_name  ky.jzkg.cn;
    location ^~/api {
    proxy_pass http://192.168.1.118:8088;
    rewrite "^/api/(.*)$" /$1 break;
    }
}
```

（2）科研系统的文件、图片存储采用MinIO，MinIO的访问默认采用9000端口，一般情况下，MinIO的访问路径应当为公网地址，如http&#058;//file.jzkg.cn， 不应采用内网地址，如http&#058;//192.168… 将MinIO的9000端口映射到外网路径的关键Nginx代码为：

```
server{
        listen 80;
        server_name file.jzkg.cn;
        location / {
                proxy_pass http://192.168.1.118:9000;
        }
}
```
### 其它说明
1. 系统默认登录账号为：sysadmin，默认密码为：www&#046;jzkg.cn，如遇密码错误，可将数据库中blade_user表的password列改为10688ef64e1d14f0e86facaa220212cb8cedb2b0，则密码自动重置为www&#046;jzkg.cn。
2. 安装包中准备有模拟数据，如有需要，可登录系统中在相应模块中导入模拟数据。
3. 移动端的访问路径为：http&#058;//{your host}/m ， 如：http&#058;//ky.jzkg.cn/m