运维文档

# V5产品升级上线指导大纲

2026年4月更新

PS：本文档适合于V5产品升级。如客户是A8 350升级，则建议参考关联手册 (opens new window)做升级。

# 前提

不是所有历史版本都支持升级程序一键升级，在做升级规划时，请先看看 《产品升级/转版/转库路线图 (opens new window)》 做好升级规划，再参考本手册进行后续操作。

如需专业的项目升级运维交付模板，可通过如下通路下载：协同云 → 赋能中心 → 知识中心 → 实施交付中心 → 揭榜挂帅 → 项目全生命周期运维交付提效解决方案

相关培训视频详见：协同云 → 赋能中心 → 致远学院 → 搜索“V5升级升迁 转信创的方法策略” 或 [云文档在线视频] (opens new window)

# 一、核心准则

1、 升级变化： 梳理并提前需告知客户升级变化和配合点

2、模拟升级： 跨版本正式升级前必须做测试模拟升级测试，避免未经验证突发意外！

3、提前部署： 在线编辑预览等不涉及升级的扩展服务提前部署验证好，升级后直接连通上线！

4、发起护航： 测试通过后~正式升级前，可发起技术服务支持申请护航，有BUG研发及时处理！

5、多看手册： 升级手册一字不漏看完，写了环境和数据库核心要求都要做，别侥幸！

6、活用AI： 开放平台CoMi一搜里的搜索和AI日志分析工具实现问题自助排查解决！

7、必须备份： 升级必须养成备份习惯（升级前库/注册表、升级后库），无备份坚决不执行升级操作！

8、检查日志： 升级完必须先看升级日志，活用开放平台升级日志分析工具完成自查！

9、生产调优： 升级后JVM配置会被还原，一定要根据用户的在线人数配置合适的堆内存，避免高峰期卡顿！

10、 保持沟通： 操作过程中与客户保持定期持续沟通，如存在异常风险及时反馈

# 二、升级变化点梳理

在做升级规划前需要配合项目经理整理升级变化点，并提前告知客户，避免信息偏差：

  • 版本升级功能变化：每个版本的发版文档-功能清单-版本变化清单Excel中都有该版本（跟上版本对比）新的变化清单。操作手册中有新功能的详细使用说明。
  • 浏览器兼容性变化：随着技术革新，新版本对浏览器版本越来越高，每个版本的发版文档-产品功能清单Excel中的运行环境sheet页有浏览器兼容推荐。
  • 第三方系统适配变化：帆软报表、分析云报表、金格控件、OFD版式阅读器等在最新版本都有变化（甚至不再支持），需要评估新版本的替代方案和成本。

# 三、测试升级关键说明

模拟升级核心方法：取生产环境近期备份数据还原到测试数据库，取生产关键附件资源覆盖测试环境，测试环境程序版本保持与生产一致，做测试升级，检查升级日志，如有问题提前发现并解决。

2-1、准备合适的数据库版本：

2-2、准备与生产版本和BuildID相同的OA程序：

  • 取老版本安装程序部署一个与生产相同版本的测试环境，数据库连接改成上一步测试库
  • 必须拷贝生产的base/dee文件夹、base/resources文件夹和base/upload/2007文件夹，条件允许还应拷贝其它upload附件
  • 相同版本也存在不同BuildID[版本清单 (opens new window)]，取生产环境ApacheJetspeed/webapps/seeyon/WEB-INF/cfgHome/base/systemProperties.xml文件替换测试环境对应文件即可达到BuildID一致
  • 注册表BuildID也一定要与生产一致（可取生产注册表到测试环境）：
Windows注册表信息 HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SEEYON\A8
Linux系统注册信息 /root/.config/seeyoninstall_A8.info
★★★信创环境XinChuang安装的程序不产生注册表，信创环境不用管！

新手不建议直接拷贝完整生产程序到测试环境：拷贝过来忘记改数据库地址，就等于直接升级生产数据库了！

2-3、升级过程会遇到错误，需要检查解决：

  • 无论测试还是正式升级，都严格按照升级部署手册的执行步骤 (opens new window)进行操作，里面也有常见错误解决方案
  • 升级结束后一定要检查升级日志，升级部署手册详细写了升级日志获取方式和排查方法
  • 如果因为数据量大导致升级耗时1天以上往往是磁盘IO低导致（检查 iostat 是否跑满），更换高速固态硬盘能成倍提升升级速度

强烈推荐使用AI进行日志分析，通过开放平台CoMi一搜智能搜索-V5升级日志分析助手 上传日志，可以获取解决方案：

如自查升级日志还是没找到问题原因，可发起技术服务支持申请单支持（必须提供升级日志和AI分析出的LOG地址）

1775297848720.png

2-4、测试环境也需要加密狗：升级过程不需要加密狗，升级到新版本需要试用狗启动。

2-5、测试升级后启动可能会遇到问题，根据不同情况自行处理：

2-6、升级失败，回滚重升注意事项：绝对不要只回滚程序/或只回滚数据库，必须是数据库+程序版本+注册表（信创没有可忽略）三个指标同时回滚。回滚方法就是 【2-2、准备与生产版本和BuildID相同的OA程序】 章节重新来一遍！

2-7、做好充分的功能测试，邀请关键用户做新版本测试并签字确认。一些关键事项：

  • 如生产环境是HTTPS，则测试环境也必须用HTTPS，否则极易出现测试遗漏（尤其使用金山中台、文档通、数科、音视频项目）
  • 如老版本存在客开，提前做好升级客开代码准备

# 四、提前部署扩展服务

提前部署扩展服务思路：提前部署新版本全文检索、在线预览/在线编辑等一系列无需数据升级的服务，部署后先连接升级后的OA测试环境做功能验证，生产上线时再切回配置，可以极大提高生产上线效率。

思路很简单：提前部署扩展服务 → 配置测试环境OA → 测试功能 → 正式上线后配置正式环境OA

可提前部署的扩展服务包含并不仅限于：全文检索、音视频、文档通/数科/金山中台、Nginx等。

（如涉及服务迁移）建议提前将历史附件（如今年之前的附件）同步到新环境，随后再增量同步附件。全文检索可以提前重建历史附件的索引，避免正式上线重建过慢的问题。

提前完成生产环境加密狗认证：生产加密狗需要基于《协同新加密授权注册更新手册 (opens new window)》提前完成加密的认证更新！如果启动过程中遇到“指纹码过期”、“指纹认证不通过”，第一时间先调用《服务器迁移单》流程，清空加密指纹再重试。

# 五、发起正式升级护航

正式升级前几天，发起技术服务支持申请-升级升迁护航，总部和研发会进行生产环境上线的护航，处理升级过程中产生的BUG。

# 六、正式升级相关说明

正式升级核心要点：做好升级前备份、不要再犯测试升级发现的错误、做好JVM调优。

5-1、一定要按照《升级手册 (opens new window)》来操作（信创升级是另一份，开放平台自己找）：

5-2、升级过程会遇到错误，需要检查解决：

  • 升级结束后一定要检查升级日志，升级手册详细写了升级日志获取方式和排查方法
  • 强烈推荐使用AI进行日志分析，通过开放平台CoMi一搜智能搜索-V5升级日志分析助手 上传日志，可以获取解决方案
  • 以上都排查了，针对升级日志你还有疑惑，再联系升级升迁护航值班同事

5-3、正式升级后启动可能会遇到问题，根据不同情况自行处理：

  • 活用开放平台FAQ 和 CoMi一搜能解决很多问题
  • 如果是信创环境启动不了，同样可以取中间件日志到 开放平台CoMi一搜智能搜索 让AI智能体分析
  • 数据库层面也需要做好充分调优，尤其是达梦数据库一定要做定期的统计信息收集（否则到后面越用越慢）
  • 如果启动过程中遇到“指纹码过期”、“指纹认证不通过”，可以考虑先调用《服务器迁移单》流程清空加密指纹再重试。

5-4、升级OA后JVM会被还原成默认值，一定要做好JVM堆内存调整：

5-5、升级失败，在找到问题解决方案的前提下，回滚重升注意事项：绝对不要只回滚程序/或只回滚数据库，必须是数据库+程序版本+注册表（信创没有可忽略）三个指标同时回滚。测试升级章节和升级手册都有说回滚方法！

# 七、与客户保持沟通

测试升级阶段：产品测试需要邀请客户做关键业务测试

正式升级前：一定要协调客户的数据库管理员、网络维护人员到位，网络问题只有客户才能处理

正式升级阶段：如无法按时完成，必须提前反馈给客户，不要等到无法解决时才反馈

编撰人：zhengkejie、het、wangyxyf、xiey、admin

快速跳转

← V5相关服务部署模式及国产化替代说明 →