提示:本文涉及功能使用门槛较高。若您有相关实际使用场景，建议联系帆软技术支持，获取使用帮助、反馈功能相关建议和评价。
技术支持联系方式：前往「服务」，选择「在线支持」、电话「400-811-8890」。
1. 概述
1.1 版本
| 运维平台版本 | 功能变更 |
|---|---|
| V2.5.0 | - |
| V2.6.0 | 支持Tomcat集群迁移容器化集群 |
| V2.9.0 | 取消中间态配置库步骤，降低迁移成本 |
| V2.13.0 | 支持迁移FineDataLink项目 |
1.2 应用场景
相比于普通Tomcat工程，运维平台部署的帆软项目，升级和维护成本较低。
运维平台提供界面化功能「项目迁移」，帮助用户将原非运维平台部署的Tomcat工程，迁移至运维平台部署的项目。
具体流程如下图所示：
2. 前置步骤
迁移，是使用运维平台，将原非运维平台部署的待迁移工程，迁移到运维平台部署的目标工程。
因此需要有：运维平台、非运维平台部署的待迁移工程、运维平台新部署的目标工程
2.1 优先自查
为了防止浪费新项目的服务器资源，请优先自查以下内容，确保可以使用本文功能进行迁移。
| 检查内容 | 说明 |
|---|---|
| 工程主应用类型 | 原 FineBI 工程，仅支持迁移到 FineBI 项目，不支持迁移到 FineReport/FineDataLink 项目 原 FineReport 工程，仅支持迁移到 FineReport 项目，不支持迁移到 FineBI/FineDataLink 项目 原 FineDataLink 工程，仅支持迁移到 FineDataLink 项目，不支持迁移到FineBI/FineReport项目 |
| 工程节点个数 | 如待迁移工程类型为单机，支持迁移到 单机/集群 项目中 如待迁移工程类型为集群，仅支持迁移到 集群 项目中 |
| 工程部署方式 | 待迁移工程必须部署在 Tomcat 中间件中，不支持其他中间件 支持迁移到运维平台部署的项目中，不支持使用该功能迁移到其他非运维平台部署的项目 |
| 工程版本要求 | 待迁移工程版本至少在 FineBI6.0 / FineReport11.0.6 /FineDataLink4.1 及以上，不支持更低版本 待迁移工程需要允许升级，需要和之后部署的目标工程保持在同一版本，精确到JAR包日期 |
| 迁移兼容说明 | 非运维平台部署的工程，如需迁移至运维平台部署，可能会存在一些兼容影响。 请务必先提前确认以下兼容问题，再进行工程迁移：迁移前兼容须知 |
2.2 备份待迁移工程
下文的操作可能会对原有的待迁移工程，进行升级、配置更改、文件拷贝等操作。
以防万一，请在操作前对待迁移工程进行整体备份，包括工程本身、外接配置库。
操作步骤请参见 工程备份还原方案 3.1节。
2.3 准备运维平台和新项目
此时可以部署运维平台、使用运维平台部署目标工程、使用运维平台对接原待迁移工程
| 步骤 | 说明 |
|---|---|
| 准备运维平台和目标项目所在服务器 | 请在准备服务器时，确保网络互通
|
| 部署运维平台和目标项目 | 请参考以下文档部署运维平台和目标工程 可在部署新项目时，联系帆软技术支持，获取与原有待迁移工程同版本的镜像包 |
| 运维平台对接待迁移工程 | 请参考以下文档，让运维平台与非运维平台部署的待迁移工程对接成功 |
此时，管理员登录运维平台，可以看到项目管理界面，已成功接入待迁移工程和目标工程。
请确保两个工程都存活可用。
2.4 备份目标项目
为了防止迁移失败，目标项目出现改动，导致项目无法启动，建议对目标项目进行备份。
1）管理员登录运维平台，选择目标项目，点击「维护>备份管理」。
2）点击「开始备份」，设置备份的名称，点击「确定」，即可开始手动备份该项目。
2.5 停止数据管道任务（FDL）
如为FineDataLink项目，请在迁移前，暂停所有数据管道任务，否则可能导致数据丢失.
管理员登录 FineDataLink，点击「运维中心>管道任务>任务管理」，全选所有任务，点击「批量暂停」。
2.6 调整负载分配（FDL）
如为FineDataLink项目，请在迁移前，将内存都分配给数据服务，避免数据开发任务启动。
1）管理员登录 FineDataLink，点击「管理系统>智能运维>负载管理>负载分配」，请务必记录下当前内存分配与并发控制。
2）点击「编辑」，将实时任务与数据管道内存调整为0，将并发控制全部调整给数据管道。
3）点击「保存」后生效。
3. 规范性检查
规范性检查，是对迁移项目和目标项目之间是否适配等情况进行逐一检查。
1）管理员登录运维平台，点击「维护中心>项目迁移」，点击「规范性检查」。
2）输入相关工程信息，点击「开始检查」。
工程信息如下表所示：
| 配置 | 说明 |
|---|---|
| 迁移项目 | 支持选择项目管理中，非运维平台部署的、可用的项目 |
| 目标项目 | 支持选择项目管理中，运维平台部署的、可用的项目 |
| SSH连接信息 | 填写迁移项目和目标项目中，各个工程节点的相关服务器信息 请手动填写这些工程节点所在服务器的相关信息，包括服务器IP、端口、用户、密码 建议使用超管root用户，如使用普通用户，至少确保用户有工程所在目录的读写权限 注：填写完成后，点击「确认」，工具需要逐一检查连接信息是否正确，所以需要一段时间，请耐心等待。 |
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 待迁移文件数量检查
检查内容：
对待迁移项目的工程目录文件数量和磁盘大小进行逐一确认。
解决方法：
无需解决，此检查主要用于评估迁移规模和耗时时间。
4. 项目迁移
上文规范性检查通过后，即可正式进入项目迁移环节。
1）管理员登录运维平台，点击「维护中心>项目迁移」，点击「项目迁移」。
2）输入相关工程信息，点击「开始迁移」。
工程信息如下表所示：
| 配置 | 说明 |
|---|---|
| 迁移项目 | 即项目管理中，需要迁移的非运维平台部署的项目 |
| 目标项目 | 即项目管理中，即将迁入的运维平台部署的项目 |
| 项目设置 | 选择迁移后，目标项目所使用的配置库、文件服务、状态服务、帆软内网关等组件使用哪个（如为单机项目，仅指配置库） 支持两种选择：
注1：如需沿用「迁移项目」组件，务必确保原项目配置了外接配置库等组件，否则无法沿用 注2：如沿用「迁移项目」组件，「目标项目」将直接连接「迁移项目」的所有相关组件。迁移完成后不要启用「迁移项目」，以免多工程使用同一组件导致异常 |
| SSH连接信息 | 即迁移项目和目标项目中，各个工程节点用于迁移的相关服务器信息 请务必使用上文通过规范性检查的相关用户 |
| 迁移范围设置 | 1）「迁移配置」强制勾选，即迁移工程配置库相关信息 2）「迁移文件」支持自定义勾选，默认勾选 如勾选该项，在迁移时，运维平台会帮助用户迁移工程文件 如不勾选该项，在迁移结束后，用户需要自行迁移工程文件，文件内容可参考：
|
3）点击「开始迁移」后，即可耐心等待运维平台自动执行以下操作。
运维平台自动再次检查新老工程和配置库和组件之间的网络连通性，确保支持迁移
依次完成：配置迁移、对接组件、切换BI抽取路径为新工程容器内路径
拷贝文件，会记录拷贝断点情况，方便后续排查，支持手动中断文件拷贝。
5. 迁移后操作
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，点击「运维中心>管道任务>任务管理」。
筛选出运行状态为「暂停运行」的任务，可全选所有任务，点击「批量启动」。
注：请注意甄别是否均为需要启动的任务。
