综合档案管理系统在麒麟系统下的完整适配实操指南

一、环境基础信息检查与依赖安装

在开始部署之前，必须先确认当前麒麟系统的版本与CPU架构，这直接决定了JDK、数据库中间件的选型。档案管理系统通常对运行环境敏感，错误的架构依赖会导致服务无法启动。

1. 检查系统版本与架构

执行以下命令查看系统详细信息：

```bash cat /etc/.kyinfo uname -m ```

输出结果中，uname -m如果显示x86_64，请下载x86架构的安装包；如果显示aarch64，则必须使用ARM架构的包，两者不可混用。

2. 安装基础依赖工具

麒麟系统基于Linux内核，部分解压或网络工具需要手动预装，否则后续上传文件或解压war包会报错。执行：

```bash yum install -y vim unzip wget lrzsz net-tools ```

3. 关闭防火墙与SELinux

为了防止档案系统的内网通信端口被阻断，建议在测试环境直接关闭防火墙和SELinux。

```bash systemctl stop firewalld systemctl disable firewalld setenforce 0 sed -i 's/SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config ```

二、JDK 1.8环境安装与验证

综合档案管理系统大多基于Java开发，且旧系统往往强依赖JDK 1.8。麒麟系统虽然自带OpenJDK，但版本可能不匹配，建议手动安装Oracle JDK或华为毕昇JDK（ARM架构推荐）。

1. 创建安装目录并上传JDK包

```bash mkdir -p /usr/java cd /usr/java 使用rz命令上传本地下载好的 jdk-8uxxx-linux-x64.tar.gz 或 aarch64版本 rz ```

2. 解压并配置环境变量

```bash tar -zxvf jdk-8u333-linux-x64.tar.gz mv jdk1.8.0_333 jdk1.8 ```

编辑/etc/profile文件，在文件末尾追加以下内容：

```bash export JAVA_HOME=/usr/java/jdk1.8 export JRE_HOME=$JAVA_HOME/jre export CLASSPATH=.:$JAVA_HOME/lib:$JRE_HOME/lib export PATH=$JAVA_HOME/bin:$PATH ```

使配置生效并验证：

```bash source /etc/profile java -version ```

确保输出显示为1.8.0_xxx版本，且没有错误信息。

三、MySQL 8.0数据库部署与初始化

档案系统数据持久化通常使用MySQL。在麒麟V10上，推荐使用yum源直接安装MySQL 8.0社区版，需注意字符集必须设置为utf8mb4以支持档案中的特殊字符和附件。

1. 安装MySQL仓库并安装服务

```bash yum install -y https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm yum install -y mysql-server ```

2. 启动MySQL并获取临时密码

```bash systemctl start mysqld systemctl enable mysqld grep 'temporary password' /var/log/mysqld.log ```

3. 修改root密码与创建档案库

使用上一步获取的临时密码登录，并执行安全初始化。注意，MySQL 8.0默认密码策略较严，建议设置强密码。

```bash mysql -uroot -p 输入临时密码登录后，在mysql命令行内执行： ALTER USER 'root'@'localhost' IDENTIFIED BY 'Root@1234!'; CREATE DATABASE archives_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; CREATE USER 'arch_user'@'%' IDENTIFIED BY 'Arch@2024'; GRANT ALL PRIVILEGES ON archives_db. TO 'arch_user'@'%'; FLUSH PRIVILEGES; EXIT; ```

四、Tomcat中间件部署与优化

1. 安装Tomcat 9

创建应用目录并上传Tomcat压缩包。

```bash mkdir -p /opt/archives cd /opt/archives rz 上传 apache-tomcat-9.0.xx.tar.gz tar -zxvf apache-tomcat-9.0.xx.tar.gz mv apache-tomcat-9.0.xx tomcat ```

2. 配置Tomcat内存参数

档案系统扫描文件时消耗内存较大，需调整JVM参数。编辑/opt/archives/tomcat/bin/setenv.sh（若不存在则新建）：

```bash CATALINA_OPTS="$CATALINA_OPTS -server -Xms2g -Xmx2g -XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m -XX:+UseG1GC" ```

赋予执行权限：

```bash chmod +x /opt/archives/tomcat/bin/setenv.sh ```

3. 修改Server.xml编码与端口

编辑/opt/archives/tomcat/conf/server.xml，找到Connector标签，增加URIEncoding="UTF-8"防止中文文件名乱码。

```xml ```

五、档案系统核心配置文件修改

1. 部署WAR包

将档案系统的archives.war上传至/opt/archives/tomcat/webapps/目录，Tomcat会自动解压。

```bash cd /opt/archives/tomcat/webapps/ rm -rf ROOT 删除默认目录 rz 上传 archives.war mv archives.war ROOT.war 重命名为ROOT以便直接通过域名访问 ```

2. 修改数据库连接配置

进入解压后的目录，通常配置文件位于WEB-INF/classes/application.yml或jdbc.properties。以Spring Boot配置为例：

```bash cd /opt/archives/tomcat/webapps/ROOT/WEB-INF/classes/ vim application.yml ```

修改spring.datasource部分：

```yaml spring: datasource: url: jdbc:mysql://127.0.0.1:3306/archives_db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: arch_user password: Arch@2024 driver-class-name: com.mysql.cj.jdbc.Driver ```

3. 配置文件存储路径

档案系统涉及大量电子文件存储，默认路径可能在/tmp下，重启会丢失。必须修改为持久化目录。

```bash mkdir -p /data/archives/files chown -R root:root /data/archives/files chmod -R 755 /data/archives/files ```

在配置文件中找到file.upload.path或类似配置项并修改：

```yaml file: upload: path: /data/archives/files ```

六、中文字体与OFD预览适配

麒麟系统默认字体库可能与档案系统生成PDF或OFD预览所需的字体不匹配，导致生成出来的文件是乱码“方框”。必须手动安装Windows常用字体。

1. 上传字体文件

准备simhei.ttf（黑体）、simsun.ttc（宋体）、simkai.ttf（楷体）等字体文件。

```bash mkdir -p /usr/share/fonts/chinese cd /usr/share/fonts/chinese rz 上传上述ttf/ttc字体文件 ```

2. 生成字体索引并刷新缓存

```bash mkfontscale mkfontdir fc-cache -fv ```

执行fc-list :lang=zh查看是否包含刚上传的字体。如果输出中包含SimHei，说明配置成功。

七、Systemd服务守护配置

为了防止服务器重启后档案系统没有自动启动，建议配置Systemd服务管理，替代传统的startup.sh脚本。

1. 创建服务文件

```bash vim /etc/systemd/system/archives.service ```

2. 写入以下配置内容

注意：User和Group根据当前实际用户填写，通常是root。

```ini [Unit] Description=Archives Management System After=syslog.target network.target [Service] Type=forking Environment="JAVA_HOME=/usr/java/jdk1.8" Environment="CATALINA_HOME=/opt/archives/tomcat" Environment="CATALINA_BASE=/opt/archives/tomcat" Environment='CATALINA_OPTS=-Xms2g -Xmx2g -XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m' ExecStart=/opt/archives/tomcat/bin/startup.sh ExecStop=/opt/archives/tomcat/bin/shutdown.sh User=root Group=root Restart=always RestartSec=10 [Install] WantedBy=multi-user.target ```

3. 启动服务并验证

```bash systemctl daemon-reload systemctl start archives systemctl status archives ```

如果状态显示active (running)，说明服务启动成功。此时在浏览器输入http://服务器IP:8080即可访问综合档案管理系统。如果无法访问，请检查/opt/archives/tomcat/logs/catalina.out日志文件，根据报错信息排查数据库连接或内存溢出问题。