项目迁移工具

独立功能，用于迁移 Swift 日志数据，支持断点续传

此功能不在本文中描述，详情请参见：Swift日志迁移ElasticSearch

目标项目必须为运维平台部署。各组合的支持情况如下：

非运维平台部署的待迁移项目迁移至运维平台部署时，可能存在兼容影响。迁移前须先确认兼容问题，详见：迁移前兼容须知

运维平台部署具有隔离性、可移植性、灵活性、可伸缩性和可控性等优势，可降低维护成本和资源成本，因此仅支持迁移到运维平台部署的目标项目。

中间件要求取决于待迁移项目的信创类型和部署方式：

信创项目的定制化功能在转为非信创项目后无法确保正常运行，因此不支持信创迁移至非信创。

运维平台部署的项目均使用 Tomcat/宝兰德/东方通中间件。为确保迁移后不存在兼容问题，非运维平台部署的待迁移项目必须使用上述对应中间件。

待迁移项目主应用版本须满足最低版本要求，且目标项目版本不低于待迁移项目版本。

• 最低版本要求：FineBI 6.0、FineReport 11.0.6 及以上。

FineDataLink

• 版本范围要求：FineDataLink 4.2.19.2~4.2.X，或 FineDataLink 5.0.12.2 以上。

版本映射关系由运维平台自动获取。若在「自动传输迁移」中选不到目标项目，通常说明该版本组合不在支持范围内，或缺少迁移镜像。

版本不满足时的处理

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

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

此处单机/集群指项目是否采用集群架构（是否对接了状态服务、文件服务等集群组件），而非 FineBI/FineReport/FineDataLink 的应用数量。待迁移项目与目标项目的应用数量不一致，不影响迁移。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1）尚未部署运维平台

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

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

注2：如使用「导出导入迁移」方式，准备了两个运维平台，请确保两个运维平台的版本号完全一致，否则可能无法成功导入。

2）已部署运维平台

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

请参考文档将将运维平台升级至最新版本：外网升级运维平台、内网升级运维平台

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

注2：如使用「导出导入迁移」方式，准备了两个运维平台，请确保两个运维平台的版本号完全一致，否则可能无法成功导入。

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

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

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

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

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

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

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

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

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

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

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

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

原因说明：

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

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

解决方案：

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

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

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

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

解决方案：

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

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

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

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

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

一定会迁移的目录如下：

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

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

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

• 工程/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、help

• 工程/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读写缓存存储路径

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

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

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

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

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

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

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

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

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

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