C/S版档案管理系统本地与跨网段全链路实操升级指南

一、升级前核心前置准备

1. 环境与数据备份（必做）

第一步：关闭所有已连接的客户端与服务端进程。

• 服务端关闭方式：打开任务管理器→详细信息→查找类似“ArchiveServer.exe”“档案中心.exe”的进程→右键结束进程树
• 客户端关闭方式：通知所有用户正常退出，避免残留事务锁

第二步：全量备份三要素：

• 服务端程序根目录：右键根文件夹→发送到→压缩(zipped)文件夹，命名为“档案服务端-原版本号-日期.zip”
• 数据库数据：
  • MySQL/MariaDB：打开cmd/powershell，执行mysqldump -u root -p --single-transaction --default-character-set=utf8mb4 数据库名 > 原版本号-日期-数据库名.sql，输入密码后等待结束（注：密码输入时无显示，直接回车）
  • SQL Server：打开SSMS→选中目标数据库→右键→任务→备份→备份类型选“完整”→目标选“磁盘”→点击“添加”指定路径→确定后执行
• 系统配置文件：单独复制“server.config”“client.config”“db.config”到专门的“升级备份-配置”文件夹

2. 升级包校验

若您的档案软件为正规厂商产品，通过官方指定渠道下载对应操作系统（Windows Server/Windows 10+/11）的完整C/S升级包，获取MD5/SHA256校验值（厂商会附在下载页或邮件）。

Windows校验方式：打开powershell，进入升级包所在目录，执行Get-FileHash 升级包名称.zip -Algorithm SHA256，对比输出的哈希值与官方提供的是否一致。

二、本地单机/局域网服务端升级

1. 服务端替换部署

• 解压校验通过的升级包，确保目录结构清晰（如含bin、conf、lib子文件夹）
• 将备份的“db.config”“server.config”覆盖到升级包的conf文件夹（不要复制其他原配置，避免兼容性冲突）
• 删除原服务端程序根目录下的所有文件与文件夹（已做备份，放心操作）
• 将升级包conf、bin、lib等所有子文件夹及根目录文件，完整复制到原服务端根目录

2. 服务端数据库迁移（如有提示）

正规C/S升级包通常自带数据库自动迁移工具，打开原服务端根目录下的“bin/db_migrate.exe”：

• 输入原备份前的数据库连接信息（与db.config一致）
• 点击“检测并执行迁移脚本”
• 等待工具输出“迁移成功，无错误”后关闭；若有警告但无错误，可联系厂商确认后继续，有错误必须恢复备份

3. 服务端启动与验证

• 以管理员身份运行原服务端根目录下的“bin/ArchiveServer.exe”或服务注册工具
• 若用服务注册工具：打开后点击“重新注册服务”→启动服务→查看“服务状态”显示“正在运行”
• 打开浏览器，输入服务端本地IP（如http://127.0.0.1:8080）或厂商指定的管理后台地址，用原管理员账号登录，查看系统版本号是否更新成功，测试档案上传、查询、借阅基本功能

三、跨网段客户端升级

1. 准备共享分发环境（仅第一次需要）

在局域网内找一台稳定的Windows机器（推荐与服务端同网段），创建共享文件夹：

• 新建文件夹命名为“档案C/S客户端-最新版本号”
• 解压升级包的客户端部分，将所有文件放入共享文件夹
• 右键共享文件夹→属性→共享→高级共享→勾选“共享此文件夹”→权限→添加“Everyone”→权限级别设为“读取”→确定保存
• 记录共享路径，例如“\\192.168.1.100\档案C/S客户端-最新版本号”

2. 单客户端批量升级工具部署（若厂商提供）

正规厂商的升级包通常含“ClientUpdater.exe”批量升级工具：

• 将“ClientUpdater.exe”复制到共享文件夹
• 在共享文件夹内新建“client_upgrade.config”文本文件，输入以下可直接复制的配置内容： ```xml C:\Program Files\档案管理系统 \\192.168.1.100\档案C/S客户端-最新版本号 原完整版本号 新完整版本号 ```

3. 跨网段/外网客户端手动升级（通用兜底方案）

若无批量工具或用户不在局域网内：

• 通知用户通过官方外网下载链接或管理员发送的加密压缩包获取最新客户端（压缩包需附加厂商提供的解压密码）
• 用户操作步骤：
  1. 关闭原客户端，结束残留进程
  2. 解压最新客户端压缩包
  3. 找到原客户端根目录下的“user.config”（仅用户个人配置，如默认查询时间、字体大小），复制到桌面
  4. 卸载原客户端（或直接删除原根目录，前提已卸载残留服务）
  5. 安装或复制最新客户端到原路径
  6. 将桌面的“user.config”覆盖到新客户端根目录
  7. 打开新客户端，输入原服务端IP:端口（跨网段需提前确保防火墙开放服务端端口，如8080、3306/1433），登录验证

四、常见卡壳问题快速排查

1. 服务端启动失败

• 检查端口占用：打开cmd执行netstat -ano | findstr "8080"，若有结果，查看最后一列PID，任务管理器结束对应进程或修改server.config的端口号
• 检查配置文件编码：确保db.config、server.config为UTF-8无BOM编码（用记事本打开→另存为→编码选UTF-8无BOM，覆盖原文件）
• 查看日志文件：原服务端根目录下的“logs/server_error.log”，根据日志提示修复

2. 客户端连接失败

• 跨网段检查：关闭服务端与客户端的防火墙（测试用，通过后需添加规则）→ping服务端IP：打开cmd执行ping 192.168.1.100，能通再执行telnet 192.168.1.100 8080（telnet需先在Windows功能中开启）
• 版本不匹配：确保服务端与客户端版本完全一致