项目迁移工具

本文涉及功能使用门槛较高。若您有相关实际使用场景，建议联系帆软技术支持，获取使用帮助、反馈功能相关建议和评价。

技术支持联系方式：前往「服务」，选择「在线支持」、电话「400-811-8890」。

1.1 版本

1.2 应用场景

相比于普通Tomcat工程，运维平台部署的帆软项目，升级和维护成本较低。

运维平台提供界面化功能「项目迁移」，帮助用户将原非运维平台部署的Tomcat工程，迁移至运维平台部署的项目。

具体流程如下图所示：

迁移，是使用运维平台，将原非运维平台部署的待迁移工程，迁移到运维平台部署的目标工程。

因此需要有：运维平台、非运维平台部署的待迁移工程、运维平台新部署的目标工程

2.1 优先自查

为了防止浪费新项目的服务器资源，请优先自查以下内容，确保可以使用本文功能进行迁移。

2.2 备份待迁移工程

下文的操作可能会对原有的待迁移工程，进行升级、配置更改、文件拷贝等操作。

以防万一，请在操作前对待迁移工程进行整体备份，包括工程本身、外接配置库。

操作步骤请参见 工程备份还原方案 3.1节。

2.3 准备运维平台和新项目

此时可以部署运维平台、使用运维平台部署目标工程、使用运维平台对接原待迁移工程

此时，管理员登录运维平台，可以看到项目管理界面，已成功接入待迁移工程和目标工程。

请确保两个工程都存活可用。

2.4 备份目标项目

为了防止迁移失败，目标项目出现改动，导致项目无法启动，建议对目标项目进行备份。

1）管理员登录运维平台，选择目标项目，点击「维护>备份管理」。

2）点击「开始备份」，设置备份的名称，点击「确定」，即可开始手动备份该项目。

2.5 停止数据管道任务（FDL）

如为FineDataLink项目，请在迁移前，暂停所有数据管道任务，否则可能导致数据丢失.

管理员登录 FineDataLink，点击「运维中心>管道任务>任务管理」，全选所有任务，点击「批量暂停」。

2.6 调整负载分配（FDL）

如为FineDataLink项目，请在迁移前，将内存都分配给数据服务，避免数据开发任务启动。

1）管理员登录 FineDataLink，点击「管理系统>智能运维>负载管理>负载分配」，请务必记录下当前内存分配与并发控制。

2）点击「编辑」，将实时任务与数据管道内存调整为0，将并发控制全部调整给数据管道。

3）点击「保存」后生效。

规范性检查，是对迁移项目和目标项目之间是否适配等情况进行逐一检查。

1）管理员登录运维平台，点击「维护中心>项目迁移」，点击「规范性检查」。

2）输入相关工程信息，点击「开始检查」。

工程信息如下表所示：

3）点击「开始检查」，请耐心等待，检查完毕后，会输出「工程规范性」检查结果。

下文将针对各类检查常见问题给出解决方案。请逐一优化后再次执行检查，直到完全符合迁移要求。

3.1 新老工程文件读写权限检测

检查内容：

检查迁移项目和目标项目中，各个服务器SSH连接信息中，所填写的用户是否有足够读写权限

解决方法：

1）优先建议使用超管root用户进行迁移操作

即上文规范性检查和下节项目迁移中，填写的SSH连接信息中的用户使用超管root用户

2）如使用普通用户，请确保用户有工程所在目录的读写权限

可根据检查结果中标注的权限不足目录，逐一进行赋权操作

3.2 新老工程版本一致性检查

检查内容：

检查工程「管理系统>注册管理>版本信息」中的版本号，精确到各个模块的各个 JAR 包日期

解决方法：

• 如待迁移工程版本较低，请升级待迁移工程到目标工程版本

请参考「FineBI小版本升级」/「FineReport小版本升级」/「FineDataLink小版本升级」文档，升级待迁移工程至指定版本

• 如目标工程版本较低，请升级目标工程到待迁移工程版本

请参考「外网升级运维项目」/「内网升级项目」文档，升级目标工程至指定版本

3.3 老工程定制内容检查

检查内容：

1）检查待迁移项目/webroot/WEB-INF/plugins目录中，是否存在非官方插件

2）检查待迁移项目/webroot/WEB-INF/lib中，是否存在自定义JAR和驱动

3）检查待迁移项目/webroot/WEB-INF/customLib中，是否存在自定义JAR和驱动

4）检查待迁移项目/webroot下，迁移后所有无法持久化挂载出来的目录的所有内容

解决方法：

1）建议评估迁移对此部分内容的影响，不确保迁移后相关定制内容仍能生效

2）建议对相关内容进行备份，并在迁移结束后手动检查，不确保迁移时能对此部分定制内容进行迁移

3.4 新老工程网络联通性检查

检查内容：

• 检查待迁移工程，可连通目标项目所在服务器对应目录

• 如目标项目为集群工程，检查待迁移工程是否安装了「MinIO资源仓库」插件

• 如目标项目为集群工程，检查待迁移工程，可连通目标项目的文件服务器

解决方法：

请根据检查报告中指出的风险项，开通相关网络端口，确保网络连通。

3.5 待迁移文件数量检查

检查内容：

对待迁移项目的工程目录文件数量和磁盘大小进行逐一确认。

解决方法：

无需解决，此检查主要用于评估迁移规模和耗时时间。

上文规范性检查通过后，即可正式进入项目迁移环节。

1）管理员登录运维平台，点击「维护中心>项目迁移」，点击「项目迁移」。

2）输入相关工程信息，点击「开始迁移」。

工程信息如下表所示：

3）点击「开始迁移」后，即可耐心等待运维平台自动执行以下操作。

• 运维平台自动再次检查新老工程和配置库和组件之间的网络连通性，确保支持迁移

• 依次完成：配置迁移、对接组件、切换BI抽取路径为新工程容器内路径

• 拷贝文件，会记录拷贝断点情况，方便后续排查，支持手动中断文件拷贝。

5.1 检查迁移文件情况

文件迁移完成后，输出文件传输结果，可在「迁移记录」中进行下载。

请认真查看文件传输结果，防止存在文件迁移失败的情况，自行手动拷贝即可。

5.2 关闭/重启原工程

迁移成功后，原工程处于启动状态，用户需要关闭/重启原工程，确保切换配置，以防新老工程处于同一配置

• 如选择沿用「迁移项目」配置库和组件：

请参考 关闭或重启FineBI工程 / 关闭或重启FineReport工程 / 关闭或重启FineDataLink工程文档，关闭原工程所有工程节点，以免多工程使用同一组件导致异常

• 如选择使用「目标项目」配置库和组件：

请参考 关闭或重启FineBI工程 / 关闭或重启FineReport工程 文档，重启原工程所有工程节点，以防新老工程处于同一配置库。

请参考 关闭或重启FineDataLink工程 文档，关闭原工程所有工程节点，切勿启动原FineDataLink工程，以防任务重复执行。

5.3 启动新工程

请务必先执行5.2节，关闭/重启原工程，再启动新工程。

迁移成功后，新工程处于关闭状态，请手动启动新工程。

用户登录运维平台，点击「运维管理>项目管理」，点击新工程项目后的「组件管理」按钮。

找到bi-web/bi6/fr/fdl组件，点击组件后的「启动」按钮，即可启动该集群所有工程节点。如下图所示：

5.4 新工程注册

全新注册：容器化工程请使用 注册新项目 方式进行注册。

授权迁移：用户也可弃用原工程，将原工程的授权迁移到新工程。

1）参考 授权迁移插件 的使用步骤，向商务索要一个授权迁移插件，销毁原非容器化工程的旧授权。

2）找到原非容器化工程%BI_HOME%/webroot/WEB-INF/resources文件夹下的销毁凭证。

3）向商务索要注册镜像文件fanruan_license_server.tar，并参考 注册新项目 进行授权。

     请在邮件中附上第三步获取的销毁凭证。并注明是「非容器化工程迁移容器化工程」

5.5 数据抽取（BI）

注：仅FineBI工程需要执行本节操作。

1）管理员登录新工程，点击「公共数据>全局更新」。

2）执行「立即全局更新」，即可抽取最新数据，并存放到正确的存储路径中。

5.6 调整负载分配（FDL）

请将负载分配，重新调整至2.6节调整前的状态，确保任务可恢复执行。

1）管理员登录 FineDataLink，点击「管理系统>智能运维>负载管理>负载分配」

2）点击「编辑」，将内存与并发恢复至2.6节原始状态。

3）点击「保存」后生效。

5.7 启动数据管道任务（FDL）

管理员登录 FineDataLink，点击「运维中心>管道任务>任务管理」。

筛选出运行状态为「暂停运行」的任务，可全选所有任务，点击「批量启动」。

注：请注意甄别是否均为需要启动的任务。