佳木斯档案软件本地化部署与数据迁移实操指南
一、环境准备与基础安装
佳木斯档案软件标准版通常基于Java环境与关系型数据库运行。以下是部署前必须完成的准备工作。
1.1 服务器环境配置
操作系统建议使用CentOS 7.9或Ubuntu 20.04 LTS。以CentOS为例，执行以下命令进行基础环境配置：
更新系统并安装必要工具：
``` yum update -y yum install -y wget vim net-tools unzip ```关闭防火墙与SELinux以确保服务正常访问：
``` systemctl stop firewalld systemctl disable firewalld setenforce 0 sed -i 's/SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config ```1.2 安装Java运行环境
佳木斯档案软件V5.2版本要求JDK版本为1.8。使用以下命令安装OpenJDK：
``` yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel ```验证安装是否成功：
``` java -version ```预期输出应包含"1.8.0"版本信息。
1.3 安装MySQL数据库
使用官方Yum仓库安装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 ```获取初始root密码并修改：
``` grep 'temporary password' /var/log/mysqld.log mysql -uroot -p ```在MySQL命令行中执行：
``` ALTER USER 'root'@'localhost' IDENTIFIED BY 'YourNewPassword123!'; FLUSH PRIVILEGES; ```二、软件部署与初始化
2.1 获取软件安装包
从佳木斯档案软件官方获取最新安装包。假设安装包名为jms-archive-v5.2.zip，上传至服务器/opt目录。
解压安装包：
``` cd /opt unzip jms-archive-v5.2.zip ```解压后应包含以下关键目录：webapp（前端应用）、service（后端服务）、config（配置文件）、sql（数据库脚本）。
2.2 数据库初始化
创建专用数据库与用户：
``` mysql -uroot -p CREATE DATABASE jms_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'archive_user'@'localhost' IDENTIFIED BY 'Archive@Pass456'; GRANT ALL PRIVILEGES ON jms_archive. TO 'archive_user'@'localhost'; FLUSH PRIVILEGES; EXIT; ```导入初始数据表结构：
``` mysql -uarchive_user -p jms_archive < /opt/jms-archive-v5.2/sql/init_tables.sql mysql -uarchive_user -p jms_archive < /opt/jms-archive-v5.2/sql/init_data.sql ```2.3 配置文件修改
进入配置目录并修改主配置文件：
``` cd /opt/jms-archive-v5.2/config vim application.properties ```找到以下关键配置项并修改为实际值：
``` 数据库连接配置 spring.datasource.url=jdbc:mysql://localhost:3306/jms_archive?useUnicode=true&characterEncoding=utf8&useSSL=false spring.datasource.username=archive_user spring.datasource.password=Archive@Pass456 服务器端口配置 server.port=8080 文件存储路径（确保目录存在且有写入权限） file.upload.path=/opt/jms-archive-data/uploads ```保存并退出。创建文件存储目录并授权：
``` mkdir -p /opt/jms-archive-data/uploads chmod -R 755 /opt/jms-archive-data ```2.4 启动后端服务
进入服务目录并启动Java应用：
``` cd /opt/jms-archive-v5.2/service nohup java -jar archive-service-5.2.jar > service.log 2>&1 & ```验证服务是否启动成功：
``` tail -f service.log ```当看到"Started Application in XX seconds"日志时，表示服务已正常启动。
2.5 部署前端应用
安装Nginx作为Web服务器：
``` yum install -y nginx ```将前端文件复制到Nginx默认目录：
``` cp -r /opt/jms-archive-v5.2/webapp/ /usr/share/nginx/html/ ```配置Nginx代理后端API：
``` vim /etc/nginx/conf.d/archive.conf ```
添加以下配置内容：
``` server { listen 80; server_name localhost; root /usr/share/nginx/html; index index.html index.htm; location / { try_files $uri $uri/ /index.html; } location /api/ { proxy_pass http://localhost:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } } ```重启Nginx服务：
``` systemctl restart nginx systemctl enable nginx ```三、数据迁移与导入
3.1 旧系统数据导出
如果从旧版系统迁移，首先需要导出数据。旧版系统通常提供数据导出功能，或直接备份数据库。
对于MySQL数据库的旧系统，使用mysqldump导出数据：
``` mysqldump -u旧用户 -p 旧数据库名 > old_data.sql ```导出的SQL文件需要转换为V5.2版本兼容的格式。佳木斯档案软件提供数据转换工具，执行：
``` cd /opt/jms-archive-v5.2/tools java -jar data-converter.jar old_data.sql converted_data.sql ```3.2 数据导入新系统
将转换后的数据导入新数据库：
``` mysql -uarchive_user -p jms_archive < converted_data.sql ```对于文件附件迁移，将旧系统的上传文件目录复制到新系统的存储路径：
``` cp -r /path/to/old/uploads/ /opt/jms-archive-data/uploads/ ```3.3 数据完整性验证
登录系统管理后台（默认地址：http://服务器IP/admin，初始账号：admin，密码：admin123），检查以下关键数据：
- 档案目录结构：检查分类是否完整
- 用户与权限：验证用户账号与角色权限
- 文件关联：随机抽查档案条目，确认附件可正常预览
执行数据库一致性检查：
``` mysql -uarchive_user -p jms_archive -e "SELECT COUNT() as total_records FROM archive_records;" ```四、系统配置与优化
4.1 基础参数配置
登录管理后台，进入"系统设置"菜单，配置以下关键参数：
- 机构信息：填写完整的机构名称、编码
- 存储策略：设置文件分卷大小（建议2048MB）
- 备份策略：启用自动备份，设置每日02:00执行
4.2 用户与权限配置
创建部门结构：
- 进入"组织管理" → "部门管理"
- 点击"新增"，按实际组织架构创建部门树
- 为每个部门设置负责人
配置角色权限：
- 进入"角色管理"，系统预置"档案管理员"、"普通用户"等角色
- 点击角色名称，勾选对应的功能权限
- 保存后立即生效
4.3 定期维护任务设置
创建数据库备份脚本：
``` vim /opt/scripts/backup_mysql.sh ```添加以下内容：
``` !/bin/bash BACKUP_DIR="/opt/backups/mysql" DATE=$(date +%Y%m%d_%H%M%S) mysqldump -uarchive_user -pArchive@Pass456 jms_archive | gzip > $BACKUP_DIR/jms_archive_$DATE.sql.gz find $BACKUP_DIR -name ".sql.gz" -mtime +30 -delete ```设置定时任务，每天凌晨2点执行备份：
``` crontab -e ```添加以下行：
``` 0 2 /bin/bash /opt/scripts/backup_mysql.sh ```五、故障排查与常见问题
5.1 服务无法启动
检查Java进程是否正常运行：
``` ps -ef | grep java ```查看应用日志定位问题：
``` tail -100 /opt/jms-archive-v5.2/service/service.log ```常见错误及解决方案：
- 端口被占用：修改application.properties中的server.port
- 数据库连接失败：检查数据库服务状态及连接参数
- 内存不足：调整JVM参数，在启动命令中添加-Xms512m -Xmx1024m
5.2 文件上传失败
检查存储目录权限：
``` ls -ld /opt/jms-archive-data/uploads ```应为drwxr-xr-x权限。如权限不对，执行：
``` chown -R nginx:nginx /opt/jms-archive-data chmod -R 755 /opt/jms-archive-data ```检查Nginx上传大小限制，修改/etc/nginx/nginx.conf：
``` client_max_body_size 2G; ```重启Nginx生效。
5.3 页面访问缓慢
优化数据库查询，为常用查询字段添加索引：
``` mysql -uarchive_user -p jms_archive CREATE INDEX idx_archive_code ON archive_records(archive_code); CREATE INDEX idx_create_time ON archive_records(create_time); ```调整JVM参数提升性能，修改启动命令为：
``` nohup java -Xms1024m -Xmx2048m -XX:+UseG1GC -jar archive-service-5.2.jar > service.log 2>&1 & ```完成以上所有步骤后，佳木斯档案软件已完全部署并配置完成。通过浏览器访问http://服务器IP即可使用系统。首次登录后务必修改默认管理员密码，并根据实际业务需求配置档案分类模板与工作流程。
相关文章
