项目迁移工具

目标项目必须是运维平台部署的项目，即：

• 支持运维平台部署/非运维平台部署的项目迁移至运维平台部署的项目

• 不支持运维平台部署/非运维平台部署的项目迁移至非运维平台部署的项目

注意事项：

• 非运维平台部署的项目，如需迁移至运维平台部署，可能会存在一些兼容影响。请务必先提前确认以下兼容问题，再考虑是否进行项目迁移：迁移前兼容须知

原因说明：

• 为什么目标项目不支持非运维平台部署：相比于传统部署方式，运维平台部署的项目具有隔离性、可移植性、灵活性、可伸缩性和可控性等优点，可大幅降低企业的维护成本和资源成本。因此仅支持迁移到运维平台部署的目标项目

1）信创项目迁移至非信创项目

• 不支持本文项目迁移工具

2）非信创项目迁移至信创/非信创项目

• 支持运维平台部署的所有待迁移项目

• 非运维平台部署的待迁移项目，必须部署在 Linux/Windows 服务器的 Tomcat 中间件中，不支持其他中间件

3）信创项目迁移至信创项目

• 支持运维平台部署的所有待迁移项目

• 非运维平台部署的待迁移项目，必须部署在 Linux/Windows 服务器的 宝蓝德/东方通 中间件中，不支持其他中间件

原因说明：

• 为什么不支持信创迁移非信创：信创相关功能的定制化开发，转为非信创项目后，无法确保迁移后项目正常运行。

• 为什么仅支持指定中间件：运维平台部署的项目，均使用tomcat/宝兰德/东方通中间件，为了确保迁移后项目正常运行，不存在兼容问题，因此必须满足上文列出的中间件要求。

1）待迁移项目为 FineBI 项目

• 支持迁移到 FineBI 项目

• 不支持迁移到 FineReport/FineDataLink 项目

2）待迁移项目为 FineReport 项目

• 支持迁移到 FineReport/FineBI项目

• 不支持迁移到 FineDataLink 项目

3）待迁移项目为 FineDataLink 项目

• 暂不支持本文项目迁移工具

• 待迁移项目主应用版本必须在 FineBI6.0 / FineReport11.0.6 及以上

• 支持同版本项目迁移：例如FineReport11.5.3迁移至FineReport11.5.3、FineBI7.1.2迁移至FineBI7.1.2
  

• 支持低版本项目迁移至高版本项目（包括小版本和跨大版本）：例如FineReport11.5.1迁移至FineReport11.5.3、FineBI6.0.17迁移至FineBI7.0.3

• 不支持高版本项目迁移至低版本项目，例如FineBI6.1.8迁移至FineBI6.1.7

解决方案：

• 如果非运维平台部署的待迁移项目版本过低，请参考「非容器化FineBI6.0.x小版本升级指南 / FineReport小版本升级」文档升级

• 如果目标项目版本低于待迁移项目，请参考「外网升级运维项目 / 内网升级运维项目」文档，升级目标项目，建议升级到最新版本

支持迁移到单机/集群项目

2）待迁移项目为集群项目

支持迁移到集群项目

不支持迁移到单机项目

注意事项：

• 此处所指的单机/集群，不是fr/bi应用数量，而是项目是否属于集群架构（是否对接了状态服务、文件服务等集群组件）

• 待迁移项目和目标项目的fr/bi应用数量不一致，不影响项目迁移

对于待部署/已部署好的运维平台和项目。请检查对应服务器的网络互通

1）项目与运维平台（任何迁移方式都必须满足）

• 运维平台所在服务器，必须与待迁移项目所在服务器网络互通

• 运维平台所在服务器，必须与目标项目所在服务器网络互通

以上两点必须满足。如果无法满足，请通过准备两个运维平台来满足，然后使用「导入导出迁移」方式

2）项目与项目（「自动传输迁移>直连传输迁移」必须满足）

• 目标项目所在服务器，需要可以通过ssh访问待迁移项目所在服务器

• 目标项目所在服务器，需要可以通过ssh访问待迁移项目的文件服务器（如果有）

• 请准备待迁移项目的任一节点的ssh连接信息，所准备的用户必须有读权限

以上两点如果无法满足，会导致「自动传输迁移」时的文件传输路径出现变化，，自动启用「中转传输迁移」而非「直连传输迁移」方案，从而导致迁移耗时和难度增加。因此强烈建议满足该要求

• 直连传输迁移：迁移项目—SSH传输文件—>目标项目
  

• 中转传输迁移：迁移项目—压缩文件、传输压缩包—>运维平台—传输压缩包—>目标项目—解压

3）项目可用磁盘（「自动传输迁移>中转传输迁移」和「导出导入迁移」必须满足）

• 待迁移项目每一个应用组件外挂目录/工程webroot所在磁盘目录，剩余可用磁盘空间必须大于50G（确保有足够空间存放导出或压缩的迁移文件包）
  

• 目标项目每一个应用组件外挂目录所在磁盘目录，剩余可用磁盘空间必须大于50G（确保有足够空间存放导入或压缩的迁移文件包）

4）运维平台可用磁盘（「自动传输迁移>中转传输迁移」必须满足）

• 运维平台ops外挂目录所在磁盘目录，剩余可用磁盘空间必须大于50G（确保有足够空间存放压缩的迁移文件包）

1）尚未部署运维平台

请参考文档部署运维平台：部署运维平台

注意：信创版项目，需要部署信创版运维平台，不可与普通版运维平台对接

2）已部署运维平台

本文基于最新版运维平台的项目迁移工具提供具体迁移方案。

历史版本的项目迁移工具方案可能不满足一些适用项目的迁移，使用方式也不尽相同。

请务必在迁移前，将运维平台升级至最新版本。

升级方法请参考：外网升级运维平台、内网升级运维平台

目标项目必须是运维平台部署的项目，不支持非运维平台部署的项目

• 如果尚未部署目标项目，请参考文档部署：部署新项目

• 如果已部署目标项目，建议参考「外网升级运维项目 / 内网升级运维项目」文档，将目标项目升级到最新版本

请参考文档，将运维平台与待迁移项目对接：接入已有项目

注意：信创版项目，需要与信创版运维平台对接，不可与普通版运维平台对接

检测要求：目标项目必须启用了外接数据库作为配置库

解决方案：请参考文档「集群管理」为项目配置外接配置库

检测要求：待迁移项目和目标项目所使用的配置库，必须满足以下数据库类型和版本要求

• 非信创版：配置库支持范围

• 信创版：外接配置库支持范围

解决方案：请参考文档「集群管理」为项目更换符合要求的外接配置库

检测要求：若待迁移项目和目标项目使用了MySQL配置库，必须使用 utf8mb3 字符集编码

原因说明：

• 待迁移项目和目标项目所使用的配置库，字符集编码应当保持一致，否则可能导致迁移后乱码

• 帆软配置库字符集编码仅支持为 utf8mb3（别称utf8），不支持 utf8mb4 编码

解决方案：

• 若待迁移项目使用了 utf8mb4 编码，请联系帆软技术支持协助查找并修改配置库中的四字节字符，以确保不影响迁移到 utf8mb3 编码的目标项目配置库

• 若目标项目使用了 utf8mb4 编码，请参考文档「集群管理」为项目更换符合要求的外接配置库

• 待迁移项目和目标项目所使用的配置库，排序规则应当保持一致，否则可能导致迁移后数据查询、文件引用等操作不匹配，从而影响项目正常运行

• 帆软配置库排序规则仅支持大小写敏感，不支持不区分大小写

解决方案：

• 若待迁移项目的排序规则为不区分大小写，请联系帆软技术支持协助修改，以确保不影响迁移到大小写敏感的目标项目配置库

• 若目标项目的排序规则为不区分大小写，请参考文档「集群管理」为项目更换符合要求的外接配置库

检测要求：待迁移项目和目标项目所使用的配置库用户，必须有配置库的完整DDL权限（数据库结构的创建、修改和删除等权限），以满足配置表架构调整、配置信息调整等诉求

解决方案：请自行根据所使用的配置库类型，查阅对应数据库帮助文档，为数据库用户配置DDL权限

迁移工具会帮助用户迁移一些必要文件，无需用户手动迁移。

一定会迁移的目录如下：

• 工程/webroot下的：help

• 工程/webroot/WEB-INF下的：resources、lib、classes、dpworks、config、plugins、customlib

可选迁移的目录如下（使用迁移工具时界面可选，不选就不迁移）：

此类目录如果不使用迁移工具迁移，应当在迁移工具执行完毕后，手动将文件从待迁移工程，上传到目标项目的每一个工程节点的外挂目录的对应文件夹内

• 工程/webroot/WEB-INF下的：reportlets、schedule、assets（不包括temp_attach）、assets/temp_attach

内容说明：

待迁移项目webroot和webroot/WEB-INF下，有一些用户自定义创建的文件夹，即为「迁移范围外的目录」，均需用户自行迁移。

• 检测报告中将列出待迁移项目/webroot下所有用户自定义文件夹中的文件数量和文件大小

• 检测报告中将列出待迁移项目/webroot/WEB-INF下所有用户自定义文件夹中的文件数量和文件大小

建议操作：

1）请在迁移前对待迁移工程评估并执行：

• 在不影响模板调用资源的情况下，将迁移范围外的目录，合并到webroot/help文件夹中

2）如无法在迁移前合并至help文件夹，请在迁移工具执行完毕后：

• 通过「开发者模式」对目标项目新增对应挂载目录

• 自行手动将待迁移工程的迁移范围外的目录，迁移至目标项目每个工程节点的对应外挂目录

内容说明：

待迁移项目webroot和webroot/WEB-INF下，有一些虽然是帆软应用默认创建的文件夹，但无需迁移。不迁移目录包括（如不存在则不在迁移报告中列出）：

• 工程/webroot下的：upm、scripts、logs、backup

• 工程/webroot/WEB-INF下的：embed、cache、assist、local、spark_temp、treasures

建议操作：

原则上此类目录不应当迁移/没必要迁移（日志、缓存、回退等文件），请自行评估迁移影响和必要性

例如embed文件夹，如果手动进行了迁移，会导致迁移项目和目标项目在迁移后同时对接同一个外接配置库，从而导致项目运行异常

如果其中有自定义存放的资源文件，请参照迁移范围外的目录的处理方式进行处理。

1）请在迁移前对待迁移工程评估并执行：

• 在不影响模板调用资源的情况下，将迁移范围外的目录，合并到webroot/help文件夹中

2）如无法在迁移前合并至help文件夹，请在迁移工具执行完毕后：

• 通过「开发者模式」对目标项目新增对应挂载目录

• 自行手动将待迁移工程的迁移范围外的目录，迁移至目标项目每个工程节点的对应外挂目录

内容说明：

非官方提供的jar，即为非帆软官方提供的定制功能JAR包，或第三方驱动包，默认不迁移。

• 检测报告中将列出待迁移项目/webroot/WEB-INF/lib下，存在的非帆软提供的官方JAR包

• 检测报告中将列出待迁移项目/webroot/WEB-INF/customlib下，存在的非帆软提供的官方JAR包

建议操作：

1）请在迁移前评估迁移对此部分内容的影响，帆软无法确保迁移后相关JAR仍能生效

2）请在迁移工具执行完毕后，手动将上述列出的所有非官方提供的JAR包，上传到目标项目的每个工程节点的外挂目录的customlib文件夹中

3）请在目标项目启动后，依次确认每个非官方提供的JAR包功能是否生效

内容说明：

静态资源，即js、css、html等文件，一般被模板文件引用。

• 检测报告中将列出待迁移项目/webroot下的js、css、html等静态资源

• 检测报告中将列出待迁移项目/webroot/WEB-INF下的js、css、html等静态资源

建议操作：

1）请在迁移前评估迁移对此部分内容的影响，帆软无法确保迁移后，模板中的引用路径是否发生变化

2）请在目标项目启动后，依次确认对应模板是否仍可正常预览和使用

内容说明：

非市场插件，即此类插件中，不存在帆软官方签名，可能是第三方定制插件。

检测报告中将列出待迁移项目/webroot/WEB-INF/plugins下的自定义插件

建议操作：

1）请在迁移前评估迁移对此部分内容的影响，帆软无法确保迁移后插件仍可生效。

2）请在目标项目启动后，依次确认对应插件功能是否正常。

帆软项目的servlet默认为webroot/decision

用户可能由于短域名访问、基于安全考虑更改工程名等因素，修改了默认servlet

检测报告中将列出待迁移项目的servlet

建议操作：

1）如果用户自定义了待迁移项目的「decision」

• 必须在迁移前登录待迁移项目，在「管理系统>系统管理>常规」中，将servlet路径名修改为「decision」

2）如果用户自定义了待迁移项目的「webroot」

• 迁移工具会在迁移过程中，自动将目标项目的工程名调整到与待迁移项目一致

• 后续用户可通过「开发者模式」再次变更访问路径

如使用「自动传输迁移>中转传输迁移」和「导出导入迁移」：

待迁移项目每一个应用组件外挂目录/工程webroot所在磁盘目录，剩余可用磁盘空间必须大于50G，以确保有足够空间存放导出或压缩的迁移文件包

如果不迁移，会导致工程中所有FineReport模板都丢失

如果不迁移，定时任务挂载到决策平台的结果报表无法访问

作用：FineReport模板备份文件、通用的共享持久化目录

• 如果工程未使用FineReport模板，或不需要回退历史开发的FineReport模板，则无需迁移其中的VCS文件夹

• 其他文件夹是工程正常运行所需要的文件，如不迁移会影响工程正常使用

作用：FineBI数据表相关信息、FineReport读写缓存存储路径

• 对于FineBI项目：该文件夹中存放着工程Excel原始文件信息，不迁移会导致原始Excel丢失

• 对于FineReport项目：该文件夹中存放着工程读写（图片）缓存，不迁移会导致模板设置的背景图片预览为空

如果不迁移，会导致工程中所有FineReport模板都丢失

如果不迁移，定时任务挂载到决策平台的结果报表无法访问

作用：FineReport模板备份文件、通用的共享持久化目录

• 如果工程未使用FineReport模板，或不需要回退历史开发的FineReport模板，则无需迁移其中的VCS文件夹

• 其他文件夹是工程正常运行所需要的文件，如不迁移会影响工程正常使用

作用：FineBI数据表相关信息、FineReport读写缓存存储路径

• 对于FineBI项目：该文件夹中存放着工程Excel原始文件信息，不迁移会导致原始Excel丢失

• 对于FineReport项目：该文件夹中存放着工程读写（图片）缓存，不迁移会导致模板设置的背景图片预览为空