系统运维

# 致远协同管理软件服务器迁移手册

北京致远互联软件股份有限公司 2025年5月

# 前言

本手册对协同管理系统的服务器迁移相关事宜进行说明。如对手册存在疑问，可与致远互联的客户服务人员联系。

# 修订记录

修订内容 修订时间
增加非信创迁移到信创的场景，优化文档结构 2025-5-14

# 适用场景

本手册适用如下场景：

服务器迁移场景：老服务器数据迁移到新服务器

数据全量覆盖场景：正式服务器数据覆盖到测试服务器，或（未上线客户）测试服务器全部配置数据覆盖到正式服务器

重装系统场景：重装系统、重新部署、恢复数据

非信创迁移到信创场景：客户从非信创系统迁移到信创系统

# 常见问题现象

如果不按照手册进行操作，或跳过关键步骤操作，通常会出现如下问题：

1、登录系统直接异常

2、登录系统，个人空间页面空白

3、登录系统，空间栏目显示异常

4、登录系统，CAP4应用配置器页面显示异常

5、服务器迁移后一段时间，OA通过安装程序升级走的是全新安装步骤，没有走自动升级步骤

此类问题根本原因均是迁移内容不全导致，以下是完整迁移注意事项。

# 应用服务器迁移方案

针对协同主应用服务器，以下提供三种迁移场景，项目上根据项目特性选择使用哪种：

# 场景一：1比1全量拷贝

此方案适合场景：

  • 同操作系统迁移，比如都是Linux服务器，从LinuxA服务器迁移到LinuxB服务器

思路就是将A服务器与产品有关的所有东西都1比1拷贝到B服务器，路径、权限一切都保持一致。这种方案，您可以这样做：

1、导出原服务器的注册表，然后导入到新服务器

V5版本，Windows服务器位于 HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\SEEYON

V5版本，Linux服务器位于 /root/.config/seeyoninstall*.info

老A8 V3.50SP1，Windows服务器位于 HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ufida\a8installinfo

老A8 V3.50SP1，Linux服务器位于 /root/.config/seeyoninstall/a8installinfo.conf

注册表ID与版本映射关系字典表： https://open.seeyoncloud.com/#/faq/vuepressFile/v1/share?url=Z2ptZkplPjI5Og==

2、将整个产品目录文件1比1拷贝到新服务器，务必是拷贝到相同盘符相同路径位置，整个产品目录主要是下图这种结构：

1724727662704.png

如果文件过大，可以不用拷贝如下文件：

  • Logs文件夹（与ApacheJetspeed同级），这里存储的是安装、升级的日志
  • Backup文件夹（与ApacheJetspeed同级），这里存储的是安装、升级的备份文件
  • ApacheJetspeed\logs文件夹，这里存放中间件日志
  • ApacheJetspeed\logs_sy文件夹，这里存放应用日志

3、附件文件和resource公共资源文件一定要同步过去（否则会出现登录空间空白、查看文件提示不存在等问题）：

  • 附件文件必须迁移，默认存放于base/upload目录（与ApacheJetspeed同级），如独立存储了附件，可通过【系统管理员-系统分区管理】可视化查看附件存放目录或连接数据库查询SQL获取路径select path from ctp_partition;
  • 邮件相关配置需要迁移，默认存放于base/webmail目录（与ApacheJetspeed同级）
  • 公共资源文件必须迁移，默认存放于base/resources目录（与ApacheJetspeed同级），如独立存储了资源文件，可通过SeeyonConfig查找ctp.public.folder公共资源目录配置

1730127794666.png

4、数据库1比1同步，如果数据库也涉及迁移，则需要同步数据库

5、全面检查SeeyonConfig应用配置器配置信息，要确保原服务器的配置已经同步到新服务器，并且相关配置能适应新服务器的IP网络

6、确保新服务器文件读写权限正确：如果服务器迁移重装后，未给新服务器seeyon足够的读写权限，会出现读取不到配置文件、写入不了动态数据，从而导致系统各种莫名异常！

注意：

  • 更换了硬件服务器，则需要在新的应用服务器注册加密狗；
  • 重新安装原云联证书；
  • 若附件的存放路径变化了，需要修改分区设置，具体操作参照用户操作手册；
  • 若应用、数据库服务器IP地址改变，需修改协同应用配置器、协同相关插件中关于协同应用、数据库服务器地址的配置（如数据库连接地址、全文检索、在线预览、在线编辑等配置信息）

# 场景二：差异覆盖替换方案

此方案适合场景是：

  • 跨操作系统迁移，比如Windows迁移到Linux，一般是先在Linux全新安装OA，再做差异覆盖
  • A服务器向B服务器迁移，B服务器已经安装过相同版本的OA程序，此时只需要做差异覆盖更新即可。
  • 服务器重装也适合于此场景。

差异覆盖更新点包含如下：

1、（必做！必做！必做！必做！必做！90%问题都是这个产生的）需要拷贝base文件夹（与ApacheJetspeed同级）下的附件文件和resource公共资源文件一定要同步过去（否则会出现登录空间空白、查看文件提示不存在等问题）：

  • 附件文件必须迁移，默认存放于base/upload目录（与ApacheJetspeed同级），如独立存储了附件，可通过【系统管理员-系统分区管理】可视化查看附件存放目录，或通过连接数据库查询SQL获取路径select path from ctp_partition;
  • 邮件相关配置，默认存放于base/webmail目录（与ApacheJetspeed同级）
  • 公共资源文件必须迁移，默认存放于base/resources目录（与ApacheJetspeed同级），如独立存储了资源文件，可通过SeeyonConfig查找ctp.public.folder公共资源目录配置

1730127794666.png

2、数据库1比1同步，如果数据库也涉及迁移，则需要同步数据库

4、必须将代码文件1比1替换到新服务器，这里特指ApacheJetspeed/webapps下的所有文件，BUG补丁包、安全补丁包、客开补丁包都在里面，缺失会导致BUG反复、客开功能丢失等问题。

替换的意思不是覆盖哦，而是将新服务器的对应文件全部删除，只保留原服务器的文件

5、将ApacheJetspeed\lib下的文件替换到新服务器同级目录，这些是中间件所依赖的jar

替换的意思不是覆盖哦，而是将新服务器的对应文件全部删除，只保留原服务器的文件

6、全面检查SeeyonConfig应用配置器配置信息，要确保原服务器的配置已经同步到新服务器，并且相关配置能适应新服务器的IP网络

7、确保新服务器文件读写权限正确：如果服务器迁移重装后，未给新服务器seeyon足够的读写权限，会出现读取不到配置文件、写入不了动态数据，从而导致系统各种莫名异常！

8、最好把ApacheJetspeed\bin下修改过的文件拷贝过去，这里可能存放了JVM的自定义参数

1724729309038.png

注意：

  • 更换了硬件服务器，则需要在新的应用服务器注册加密狗；
  • 重新安装原云联证书；
  • 若附件的存放路径变化了，需要修改分区设置，具体操作参照用户操作手册；
  • 若应用、数据库服务器IP地址改变，需修改协同应用配置器、协同相关插件中关于协同应用、数据库服务器地址的配置（如数据库连接地址、全文检索、在线预览、在线编辑等配置信息）

# 场景三：非信创转信创迁移方案

此方案适合场景是：

  • 原系统是Windows或Linux非信创环境，使用标准产品默认的Tomcat中间件，现需要迁移到麒麟、统信之类的信创环境，使用东方通、金蝶等信创中间件

详细迁移步骤如下：

第一步，（如涉及升级需求，如A8+ 7.1SP1到A8-N 9.0SP1，需要先升级到A8+ 9.0SP1）非信创环境先升级到最新版本，启动登录一次，再转信创

第二步，（如涉及转版需求，如当前还是A8+ 9.0SP1，需要先转成A8-N 9.0SP1）非信创环境使用转版工具将产品转换为-N，此时非信创环境下程序和数据库会更新为-N系列

第三步，（如涉及集成信创数据库需求，如当前是MySQL数据库，需要转成信创达梦数据库）将转-N后的数据库交由信创数据库厂商进行迁移转库

以上步骤完成，确保非信创环境是A8-N版本，再进行迁移信创操作，迁移信创的主要动作如下：

  • 1）由于非信创Tomcat与信创中间件配置维护差异巨大，故程序和中间件配置不迁移，而是在信创环境部署同版本，手工重新配置参数
  • 2）附件、resources资源等文件需要迁移到信创，并按信创的配置放置到正确目录
  • 3）数据库根据实际情况处置，如涉及转信创数据库需求，交由信创厂商进行数据库迁移

详细步骤如下：

第四步，信创环境使用信创工具全新部署-N最新版本（此步可与第三步并行，甚至更早执行），按需打客开补丁和BUG补丁，先验证信创全新部署后功能是否可用；

第五步，将非信创附件等资源文件迁移到信创环境（此步越早越好，甚至可以在第一步之后就开始迁移）：

  • 附件文件必须迁移，默认存放于base/upload目录（与ApacheJetspeed同级），如独立存储了附件，可通过【系统管理员-系统分区管理】可视化查看附件存放目录，或连接数据库查询SQL获取路径select path from ctp_partition;
  • 邮件相关配置，默认存放于base/webmail目录（与ApacheJetspeed同级）
  • 公共资源文件必须迁移，默认存放于base/resources目录（与ApacheJetspeed同级），如独立存储了资源文件，可通过SeeyonConfig查找ctp.public.folder公共资源目录配置

第六步，（如涉及集成信创数据库需求）确保第三步信创数据库厂商已经完成数据的迁移转换，然后信创环境下的-N协同环境，中间件配置数据库连接为信创数据库地址，以上完成后更新-N加密授权并启动验证

注意：

  • 更换了硬件服务器，则需要在新的应用服务器注册加密狗；
  • 重新安装原云联证书；
  • 若附件的存放路径变化了，需要修改分区设置，具体操作参照用户操作手册；
  • 若应用、数据库服务器IP地址改变，需修改协同应用配置器、协同相关插件中关于协同应用、数据库服务器地址的配置（如数据库连接地址、全文检索、在线预览、在线编辑等配置信息）

以上是一套标准迁移步骤，实际生产迁移上线，可以采用并行模式提高迁移效率：

1、将第四步“信创环境部署产品”动作放在最前面，提前在信创环境部署协同主产品，以及全文检索、在线预览在线编辑等扩展服务，提前将所有配置调通。

2、随后只需要迁移数据库和附件到信创即可启动上线。

# 数据库服务器迁移

# PostgreSQL数据库迁移方案

  1. 在新服务器上安装PostgreSQL服务；
  2. 停止原、新协同的PostgreSQL服务；
  3. 备份原PostgreSQL数据库至新的PostgreSQL服务并恢复；
  4. 启动应用配置器，修改数据库链接至新数据库地址，参考“服务器端配置章节”；
  5. 启动新的PostgreSQL服务，启动协同；

# MySQL数据库迁移方案

  1. 在新服务器上安装MySQL服务；
  2. 停止原、新协同的MySQL服务；
  3. 备份原MySQL数据库至新的MySQL服务并恢复；
  4. 启动协同应用配置器，修改数据库链接至新数据库地址，参考“服务器端配置章节”；
  5. 启动新的MySQL服务，启动协同；

# SQLServer数据库迁移方案

# 本方案采用物理备份方式

  1. 物理备份原SQLServer数据库，备份过程参考本手册“SQLServer数据备份与恢复”章节；

  2. 将备份的数据文件拷贝至新的SQLServer数据库服务器上；

  3. 使用SQLServer的挂载功能，挂载备份的数据文件，如下图所示； 1725959673692.png

  4. 在弹出的Attach Database界面，使用“Add”按钮添加拷贝的备份数据文件，如下图所示， 选择数据文件； 1725959685268.png

    注意：挂载时必须保证新的SQLServer数据库上无重名数据库。

  5. 挂载数据库成功后，启动协同应用配置器，修改数据库链接至新服务器，参考“服务器端配置章节”；

# Oracle数据迁移方案

  1. 备份协同的Oracle数据库，备份方法参考本手册“Oracle数据备份与恢复”章节；
  2. 将备份好的数据文件恢复至新的Oracle数据库服务器，恢复方法参考本手册“Oracle数据备份与恢复”章节；
  3. 启动协同应用配置器，修改数据库链接至新服务器，参考“服务器端配置章节”；
    编撰人：het

快速跳转

← 协同系统升级指导手册 →