锦中融合门户系统安装部署手册

## 简介
（1）本系统为锦中集团内部产品-《锦中融合门户系统》，该手册请勿外泄！
（2）系统采用锦中内部框架 ObjectPlus、Saber 编写，数据库可使用 MySQL、达梦数据库。
（3）本系统支持 Windows 环境及 Linux 环境下运行，建议在 Linux 环境下运行。
## 1.安装环境要求
### 服务器端硬件最低配置（性能低，不推荐）
至少需要一台服务器（数据库和应用安装在同一台服务器上）
CPU：2.40GHz或以上，至少需要2核
内存：4G
硬盘：可用空间 80G以上
其它方面无特殊要求
最低要求仅供演示使用
### 服务器端硬件建议配置
建议两台服务器，数据库和应用各一台服务器。

应用服务器建议配置如下：
CPU：2.40GHz或以上，建议8核
内存：16G
硬盘：可用空间 200G以上

数据库服务器建议配置如下：
CPU：2.40GHz或以上，建议8核
内存：16G
硬盘：可用空间 500G以上
其它方面无特殊要求，建议根据使用用户数量酌情增减
### 服务器端软件配置要求
**操作系统：**Ubuntu 20.04.1 （或以上版本）
**Java：**jdk17 (或以上版本)、 openjdk17 (或以上版本)
**Nginx：** 1.18 （或以上版本）
**数据库：** MySQL 8.0（或以上版本），或达梦 8
**其它：**
**Redis** 6.0 （或以上版本）
**powerjob** 4.3.9
### 用户端软件配置要求
浏览器：Chrome、Firefox、Safari、Edge 等 chrome 内核的浏览器常规版本均可
## 2.安装步骤（Ubuntu服务器，数据库和应用各一台服务器）
### 基础环境安装
#### JDK 安装
[JDK安装教程](https://blog.csdn.net/qq_42557044/article/details/124935468 "JDK安装教程")
#### MySql 8 安装
[MySql 8 安装教程](https://blog.csdn.net/weixin_48088839/article/details/143756554 "MySql 8 安装")
#### Redis 安装
[Redis 安装教程](https://www.cnblogs.com/xiaobug/p/16007895.html "Redis 安装教程")
#### Nginx 安装
[Nginx 安装教程](https://blog.csdn.net/weixin_41302755/article/details/123175079 "Nginx 安装教程")
#### minio 安装
[minio安装教程](https://www.cnblogs.com/500m/p/17110733.html)
#### License 申请( http://app.jzkg.cn )
锦中智慧学工管理系统，是收费软件系统，需要有License才能正常部署。在您部署之前，应从官方获得正版的License。如果您还没有License，想先部署、测试的话，那么可以在部署之前，先到官方在线申请免费使用3天的License，在线申请url为：http://app.jzkg.cn 。

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

申请成功后，您将得到文件：license.xml，将这个文件放到：与jar文件同级目录jzconfig下面即可。假设您的jar文件的路径为/home/jzjt/rhmh.jar，则将license.xml放在/home/jzjt/jzconfig/license.xml ，注意Linux系统区分大小写，默认license.xml 均小写。
### 数据库初始化
#### PowerJob数据库初始化
1.创建 PowerJob 数据库（如：rhmh_job）
#### 系统数据库初始化
1.创建 融合门户 数据库（如：rhmh）
2.执行数据库初始化脚本 mysql.sql
### 部署powerjob服务
本系统使用powerjob作为任务调度平台。
启动jar包是powerjob-server-starter-4.3.9.jar
Powerjob有对应的数据库表，只需要为其建立对应的数据库即可（如：rhmh_job），表结构会在项目启动时自动创建。
**修改配置文件**，数据库连接修改为 powerjob 的数据库，如PowerJob数据库初始化时建立的（rhmh_job数据库）
![](/media/202503/2025-03-11_183847_064393.png)
**将powerjob-server-starter-4.3.9.ja上传到服务器上，并将配置文件 application.properties 放在同级别目录下。**

#### 配置 powerjob 服务
目录下新建文件 /etc/systemd/system/powerjob.service，写入以下配置
```shell
[Unit]
Description=power job application
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/jdk-17.0.14/bin/java（java安装的绝对路径） -Duser.timezone=Asia/Shanghai -jar /home/jzjt/powerjob/powerjob-server-starter-4.3.9.jar（jar包绝对路径） --spring.config.additional-location=/home/jzjt/powerjob/application.properties（外部配置文件绝对路径）
PrivateTmp=true

[Install]
WantedBy=multi-user.target
```
#### 启动 powerjob 服务
```shell
sudo systemctl daemon-reload # 通知 systemd 重新加载其配置文件
sudo systemctl enable powerjob # 永久开启 powerjob（启用开机自启）
sudo systemctl start powerjob # 启动 powerjob
```
或者不配置 powerjob 服务，在 powerjob-server-starter-4.3.9.jar 目录下，运行以下命令，启动项目。注意：application.properties需要与jar包在同层目录下。启动时会读取到
```shell
nohup java -Duser.timezone=Asia/Shanghai -jar powerjob-server-starter-4.3.9.jar > /dev/null 2>&1 &
```

### 部署系统后端服务
1、将rhmh.jar、application.yml上传到服务器 如：/home/jzjt/rhmh下（参考）
2、修改 application.yml 对应配置信息
**如：**
**Redis相关配置**
![](/media/202503/2025-03-12_134139_421452.png)
**关系型数据库相关配置**
![](/media/202503/2025-03-12_134338_571444.png)
**注意：**不同类型数据库有不同的驱动、不同的url前缀，如达梦：url: jdbc:dm//xxx:xxx ，这里是mysql
**数据库标识配置** （为了适配达梦数据库，如果使用达梦数据库，把注释打开，配置 database-id: dm）
![](/media/202503/2025-03-12_135343_765977.png)
**powerjob配置** powerjob 启动后默认端口为7700，初次部署powerjob可访问服务器ip:7700， 进行应用注册，将注册的应用名称填入app-name配置项中
![](/media/202503/2025-03-12_140110_090239.png)
**minio配置**
注意：在融合门户系统中有对象存储模块，填写新增表单保存即可。其中配置minio所需的访问key和秘钥可以在minio控制台进行配置。可以不在minio中创建punlic桶，填入想要保存的空间名称即可，系统在使用时会自动进行创建桶

**创建访问key和秘钥的方式：**minio 启动后 控制台 默认端口为7000，访问服务器ip:7000， 进行key和秘钥的创建
![](/media/202503/2025-03-12_143440_643724.png)
minio 启动后 资源访问的 默认端口为 9000
![](/media/202503/2025-03-12_135909_455936.png)
**License配置** 修改为自己存放License的目录即可
![](/media/202503/2025-03-12_150058_624117.png)
#### 执行启动脚本（保证配置文件与rhmh.jar在同一目录下，且在rhmh.jar下执行该命令）
```shell
nohup java -jar --add-opens java.base/java.lang=ALL-UNNAMED -Dfile.encoding=UTF-8 -Duser.timezone=Asia/Shanghai rhmh.jar --spring.profiles.active=prod > /dev/null 2>&1 &
```
#### 也可创建/etc/systemd/system/rhmh.service 文件，填入对应的配置，使用systemctl start rhmh 命令对融合门户后台进行启动，ExecStart如下
```shell
ExecStart=/usr/local/jdk-17.0.14/bin/java（java安装的绝对路径） --add-opens java.base/java.lang=ALL-UNNAMED -Dfile.encoding=UTF-8 -Duser.timezone=Asia/Shanghai -jar /home/jzjt/rhmh/rhmh.jar --spring.profiles.active=prod --spring.config.additional-location=/home/jzjt/rhmh/application.yml（外部配置文件绝对路径）
```
### 部署系统前端站点服务
代码文件：dist.zip
上传dist.zip文件到服务器
#### 执行解压命令
1、将打好的前端包dist.zip上传到服务器，比如上传到 /home/jzjt/ 目录下
2、在当前 /home/jzjt/ 目录下使用unzip -o ./dist.zip -d ./dist/ 命令将压缩包解压
3、将 config.js 拷贝到dist/目录下
![](/media/202503/2025-03-12_142824_811044.png)
#### 配置nginx代理
```shell
http{
.....
.....
server {
                listen       80;   // 填写你的监听端口
                server_name  192.168.1.114;   // 你的服务器ip地址
                location / {
                        root /home/jzjt/dist;
                        index  index.html;
                        try_files $uri $uri/ /index.html;
                }

location /api/ {
                        proxy_pass   http://127.0.0.1:8034;
                        proxy_set_header Host $host;
                        proxy_set_header X-Real-IP $remote_addr;
                        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
                        proxy_set_header X-Forwarded-Proto $scheme;

rewrite ^/api/(.*) /$1 break;
                        index  index.html index.htm;
                }
        }
}
```
### 其他说明：
1、系统默认登录账号为：admin，默认密码为：**www.jzkg.cn** ，如遇密码错误，可将数据库中 blade_user 表的 password 列改为 10688ef64e1d14f0e86facaa220212cb8cedb2b0 ，则密码自动重置为 **www.jzkg.cn**
2、后端启动时，需要**先启动** powerjob 并且 powerjob 中注册的有应用，将 powerjob 中存在的应用名称填入融合门户系统对应配置文件的 powerjob 配置项对应位置，即可启动融合门户系统后台
3、剩余配置，如前端config.js配置，后端融合门户配置，可参考接入统一身份认证系统手册