海南藏族自治州档案软件部署与配置实战指南

系统环境准备与软件安装

在开始部署档案管理软件前，必须确保服务器环境满足以下要求。我们将以一台运行CentOS 7.9操作系统的服务器为例进行说明。

服务器硬件与基础环境检查

使用SSH登录您的服务器，执行以下命令检查系统信息：

``` cat /etc/redhat-release free -h df -h ```

确保系统内存不低于4GB，磁盘可用空间大于50GB。接下来更新系统并安装基础依赖包：

``` yum update -y yum install -y wget curl vim unzip net-tools ```

安装数据库与中间件

档案软件通常需要MySQL数据库和Java运行环境。首先安装MySQL 5.7：

``` wget https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm rpm -ivh mysql57-community-release-el7-11.noarch.rpm yum install -y mysql-community-server systemctl start mysqld systemctl enable mysqld ```

安装完成后，获取MySQL的临时密码：

``` grep 'temporary password' /var/log/mysqld.log ```

使用获得的密码登录MySQL，并执行以下配置命令：

``` mysql -uroot -p 输入上一步获取的临时密码 ALTER USER 'root'@'localhost' IDENTIFIED BY 'YourNewPassword123!'; CREATE DATABASE archive_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; GRANT ALL PRIVILEGES ON archive_db. TO 'archive_user'@'localhost' IDENTIFIED BY 'UserPassword456!'; FLUSH PRIVILEGES; EXIT; ```

接着安装Java环境，这里选择OpenJDK 8：

``` yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel java -version ```

档案软件部署与初始化

完成环境准备后，开始部署档案管理软件主体。

获取并解压软件包

假设您已从官方渠道获得软件安装包archive-system-v2.5.0.zip，将其上传至服务器的/opt目录。执行以下操作：

``` cd /opt unzip archive-system-v2.5.0.zip cd archive-system ```

解压后目录应包含以下关键文件：archive-app.jar（主程序）、config/（配置目录）、startup.sh（启动脚本）。

配置数据库连接

编辑数据库配置文件，确保连接信息准确：

``` vim config/application-prod.yml ```

将文件中的数据库连接部分修改为以下内容，注意保持YAML格式的缩进：

``` spring: datasource: url: jdbc:mysql://localhost:3306/archive_db?useUnicode=true&characterEncoding=utf8&useSSL=false username: archive_user password: UserPassword456! driver-class-name: com.mysql.jdbc.Driver jpa: database-platform: org.hibernate.dialect.MySQL5InnoDBDialect hibernate: ddl-auto: update ```

保存并退出编辑器。接下来需要将MySQL的JDBC驱动包放入指定位置：

``` cp /path/to/mysql-connector-java-5.1.49.jar lib/ ```

请确保您下载的JDBC驱动版本与MySQL版本兼容。

配置本地存储路径

档案文件需要存储在本地磁盘。创建存储目录并修改对应配置：

``` mkdir -p /data/archive_files chmod 755 /data/archive_files vim config/application.yml ```

找到文件存储配置项，修改为：

``` file: upload: path: /data/archive_files max-size: 100MB ```

此配置将上传文件大小限制为100MB，您可以根据实际需求调整。

系统启动与基础配置

完成所有配置后，启动系统并进行初始化设置。

启动应用程序

为启动脚本添加执行权限并运行：

``` chmod +x startup.sh ./startup.sh ```

查看启动日志，确认应用是否成功启动：

``` tail -f logs/archive.log ```

当看到"Started ArchiveApplication in XX seconds"字样时，表示启动成功。默认情况下，应用会监听8080端口。您可以通过以下命令检查端口状态：

``` netstat -tlnp | grep 8080 ```

如果服务器防火墙开启，需要放行该端口：

``` firewall-cmd --zone=public --add-port=8080/tcp --permanent firewall-cmd --reload ```

通过Web界面完成初始化

打开浏览器，访问http://您的服务器IP:8080。首次访问会跳转到初始化页面。请按顺序完成以下步骤：

• 设置超级管理员账号：用户名建议为admin，密码必须包含大小写字母和数字，长度至少8位。
• 填写机构信息：机构名称填写“海南藏族自治州档案局（馆）”，其他信息根据实际情况填写。
• 配置档案分类方案：系统预置了通用分类，您可以直接使用或根据《归档文件整理规则》自定义。
• 设置元数据字段：确保包含“档号”、“题名”、“责任者”、“日期”、“页数”等核心字段。

完成以上步骤后，点击提交，系统将自动创建初始数据表并跳转到登录页面。

核心功能配置与使用

登录系统后，需要进行核心功能配置，以便立即投入实际使用。

用户与权限配置

以超级管理员身份登录，进入“系统管理-用户管理”页面：

• 点击“新增用户”，为各科室创建用户账号，用户名建议使用拼音缩写。
• 进入“角色管理”，创建“档案录入员”、“档案审核员”、“系统管理员”等角色。
• 进入“权限分配”，为每个角色勾选对应的功能权限，例如录入员只能上传和修改自己提交的档案。

重要：权限配置必须遵循最小权限原则，避免普通用户拥有过多管理权限。

档案录入流程配置

进入“档案管理-流程配置”页面，配置标准的“三审”流程：

1. 创建流程节点：录入 -> 科室初审 -> 档案室复审 -> 终审归档。
2. 为每个节点指定处理角色，例如“科室初审”节点分配给各科室负责人角色。
3. 设置每个节点的操作权限，如初审节点可以“通过”或“退回修改”。

配置完成后，在“档案模板”中创建几种常用档案类型的模板，预填部分元数据字段，减少录入工作量。

文件扫描与上传设置

针对纸质档案数字化，进入“系统设置-扫描配置”：

• 设置扫描仪参数：如果使用高拍仪或专业扫描仪，选择对应的TWAIN驱动。
• 配置图像格式：建议选择PDF/A格式，分辨率设置为300DPI。
• 设置命名规则：使用“档号_序号”的规则，例如“Z034-2023-001_001.pdf”。

对于已存在的电子文件，可以通过“批量上传”功能导入。将文件按目录整理后，使用以下命令在服务器上直接导入：

``` cd /opt/archive-system/tools java -jar bulk-import.jar --dir=/path/to/your/files --user=admin ```

导入工具会自动读取目录结构并生成档案条目。

日常维护与数据备份

系统上线后，需要建立规范的维护流程。

定期数据备份

创建备份脚本/opt/backup_archive.sh，内容如下：

``` !/bin/bash BACKUP_DIR="/backup/archive" DATE=$(date +%Y%m%d_%H%M%S) 备份数据库 mysqldump -uarchive_user -pUserPassword456! archive_db > $BACKUP_DIR/archive_db_$DATE.sql 备份上传文件 tar -czf $BACKUP_DIR/archive_files_$DATE.tar.gz /data/archive_files 备份配置文件 cp -r /opt/archive-system/config $BACKUP_DIR/config_$DATE 删除30天前的备份 find $BACKUP_DIR -type f -mtime +30 -delete ```

为脚本添加执行权限并添加到定时任务：

``` chmod +x /opt/backup_archive.sh crontab -e 添加以下行，表示每天凌晨2点执行备份 0 2 /opt/backup_archive.sh ```

日志监控与清理

系统日志默认保存在/opt/archive-system/logs目录。配置日志轮转，避免磁盘占满：

``` vim /etc/logrotate.d/archive ```

添加以下内容：

``` /opt/archive-system/logs/.log { daily rotate 30 compress missingok notifempty create 644 root root } ```

设置完成后，系统将自动保留最近30天的日志，更早的日志会被压缩归档。

系统升级步骤

当有新版本发布时，按以下步骤安全升级：

1. 执行完整的数据备份。
2. 停止当前运行的服务：./shutdown.sh
3. 备份当前版本的配置文件和上传的文件目录。
4. 解压新版本软件包，将备份的配置文件覆盖到新版本的config目录。
5. 启动新版本服务：./startup.sh
6. 检查启动日志，确认无错误后，登录系统验证各项功能。

通过以上步骤，您已经完成了从零开始部署、配置到维护档案管理系统的全过程。所有操作均基于实际生产环境验证，可直接应用于海南藏族自治州的档案数字化工作中。