档案软件跨平台部署迁移全流程避坑实操零门槛快速落地

一、前置准备：3步扫清迁移障碍

1. 档案数据完整性校验

迁移前必须锁死旧系统的所有操作权限（仅保留系统管理员只读），防止数据实时变动导致校验失败。

• 用旧系统自带的校验工具导出元数据校验哈希表（一般支持MD5/SHA256）：
• 用旧系统自带的批量导出功能导出全量档案数据（元数据Excel/XML+电子文件压缩包，建议分卷压缩不超过2GB，避免传输损坏）：

2. 新环境资源适配

不管用Windows还是Linux，先查旧系统的技术栈清单（右键旧系统安装包→属性/详情，或查旧系统的配置文件application.properties/config.ini），确保新环境一致：

• 操作系统：旧Windows用Server 2016+，旧Linux用CentOS 7.9/Ubuntu 20.04+（版本差≤2）
• 数据库：MySQL5.7→MySQL5.7.44，Oracle11g→Oracle11gR2（大版本号必须一致，小版本号选最新稳定补丁）
• 中间件：Tomcat9.0→Tomcat9.0.85，Nginx1.20→Nginx1.20.2
• JDK：JDK8→OpenJDK8u402（优先选免费兼容版）

若必须升级技术栈，先联系档案软件厂商获取升级后的安装包和迁移适配文档（否则不要私自升级）。

3. 传输介质/网络准备

• 内网传输：用千兆网线直连，或用scp（Linux）/robocopy（Windows）命令（比U盘/移动硬盘快10倍以上）
• 外网传输：用百度网盘企业版/阿里云OSS（传输前加密压缩包，密码至少16位含大小写字母+数字+符号）

二、旧系统数据/配置导出全流程

1. 数据库全量备份

重点：先停止旧系统的所有服务（避免备份时出现脏数据）。

以最常用的MySQL5.7为例：

• Windows系统：打开cmd，进入MySQL安装目录的bin文件夹（默认C:\Program Files\MySQL\MySQL Server 5.7\bin）

```cmd mysqldump -u root -p --single-transaction --routines --triggers --databases 旧系统数据库名 > D:\旧档案数据库备份.sql ```

• Linux系统：

```bash mysqldump -u root -p --single-transaction --routines --triggers --databases 旧系统数据库名 > /root/old_archive_db.sql ```

输入密码后等待完成，检查备份文件大小是否合理（约为旧数据库表空间的1/3-1/2）。

2. 旧系统配置文件导出

• Tomcat部署：导出Tomcat/webapps/旧系统名/WEB-INF/classes下的application.properties/config.ini，以及Tomcat/conf下的server.xml（端口号、虚拟路径、SSL证书路径等配置都在这里）
• 电子文件存储路径：导出旧系统配置文件中指定的电子文件根目录（比如D:\archive_files或/var/archive_files）

三、新环境部署+数据/配置导入全流程

1. 新环境基础软件安装

以CentOS7.9为例，快速安装技术栈：

• 安装OpenJDK8u402：

```bash yum install -y java-1.8.0-openjdk-devel 验证安装 java -version 输出应为openjdk version "1.8.0_402" ```

• 安装MySQL5.7.44：

```bash 下载MySQL官方yum源 wget https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm 安装yum源 rpm -ivh mysql57-community-release-el7-11.noarch.rpm 导入MySQL GPG密钥（否则会报错） rpm --import https://repo.mysql.com/RPM-GPG-KEY-mysql-2022 安装MySQL yum install -y mysql-community-server 启动MySQL并设置开机自启 systemctl start mysqld systemctl enable mysqld 获取临时root密码 grep 'temporary password' /var/log/mysqld.log 登录MySQL修改root密码 mysql -u root -p 输入临时密码后执行 ALTER USER 'root'@'localhost' IDENTIFIED BY '你的复杂新密码'; FLUSH PRIVILEGES; EXIT; ```

• 安装Tomcat9.0.85：

```bash 下载Tomcat wget https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.85/bin/apache-tomcat-9.0.85.tar.gz 解压到/opt目录 tar -zxvf apache-tomcat-9.0.85.tar.gz -C /opt 重命名方便后续操作 mv /opt/apache-tomcat-9.0.85 /opt/tomcat9 ```

2. 数据库导入

• 先在新MySQL中创建和旧系统同名的空数据库：

```bash mysql -u root -p 输入新密码后执行 CREATE DATABASE 旧系统数据库名 DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; EXIT; ```

• 导入备份文件：

```bash mysql -u root -p 旧系统数据库名 < /root/old_archive_db.sql ```

输入密码后等待完成，登录新MySQL检查数据是否完整（执行SHOW TABLES; SELECT COUNT() FROM 核心表名;）。

3. 配置文件+电子文件导入

• 将旧系统的配置文件复制到新Tomcat的对应位置：

```bash 创建目录 mkdir -p /opt/tomcat9/webapps/旧系统名/WEB-INF/classes 复制application.properties/config.ini cp /root/备份路径/application.properties /opt/tomcat9/webapps/旧系统名/WEB-INF/classes/ 复制server.xml cp /root/备份路径/server.xml /opt/tomcat9/conf/ ```

• 将电子文件根目录复制到新系统的配置文件指定路径（注意修改权限）：

```bash 假设配置文件指定路径是/var/archive_files mkdir -p /var/archive_files 复制电子文件 cp -r /root/备份路径/archive_files/ /var/archive_files/ 修改权限为Tomcat用户可读写（默认Tomcat用tomcat用户，需先创建） useradd tomcat chown -R tomcat:tomcat /opt/tomcat9 /var/archive_files ```

4. 旧系统安装包部署到新Tomcat

将旧系统的war包或解压后的文件夹复制到新Tomcat的webapps目录：

• 如果是war包：直接复制，启动Tomcat会自动解压
• 如果是解压后的文件夹：直接复制到webapps下即可

然后启动新Tomcat：

```bash su - tomcat /opt/tomcat9/bin/startup.sh ```

四、迁移验证+收尾

1. 全流程验证

• 登录验证：用旧系统的系统管理员账号密码登录新系统
• 元数据验证：随机抽取100条不同类型的档案，核对元数据（题名、档号、责任者、日期等）是否和旧系统一致
• 电子文件验证：随机抽取100条不同格式（PDF、Word、图片、视频）的档案，核对电子文件是否能正常打开、预览、下载
• 功能验证：测试档案的新增、修改、删除、检索、借阅、归档等核心功能
• 性能验证：测试100人同时在线检索的响应时间（应≤3秒）

2. 收尾操作

• 验证通过后，解锁新系统的操作权限，给所有用户分配和旧系统一致的权限
• 旧系统保留30天只读权限，30天后确认无误再关闭
• 给新系统做首次全量备份（和前置准备的备份方式一致）