1. 概述编辑
1.1 版本
| 工程版本 | 功能变更 |
|---|---|
FineReport11.0 FineBI6.0 | - |
1.2 应用场景
相比于普通集群工程，容器化部署的工程，升级和维护成本较低。
本文方案帮助用户将原有非容器化部署的FineBI集群工程，迁移为容器化部署的集群工程。
只迁移FineBI工程，仍使用原有集群组件（状态服务器、文件服务器、外接数据库等）。
迁移后，原工程无法再启动使用。
注：全文以FineBI作为演示。FineReport迁移步骤基本一致，仅需要两个点：
1）拷贝文件时，FineReport和FineBI需要拷贝的文件不完全相同，注意文档中的表格即可。
2）使用运维平台启停容器时，FineReport关闭的是fr组件，FineBI关闭的是bi6组件。
2. 原非容器化工程准备编辑
2.1 备份原非容器化工程
在进行工程迁移前，为避免迁移失败，导致工程文件丢失无法回退等问题，请务必对原非容器化工程进行备份后再进行后续操作。
1）请先使用前端 备份还原 功能对工程进行备份。
2）再直接对原非容器化工程的webroot进行整体备份。
2.2 记录原工程外接库信息
管理员登录原工程，点击「管理系统>系统管理>常规>外接数据库」。
记录下外接数据库的相关信息。确保外接数据库与待安装的新工程环境互通。
2.3 记录原工程集群信息
管理员登录原工程，点击「管理系统>智能运维>集群配置」。
记录下状态服务器和文件服务器的相关信息。确保状态服务器、文件服务器与待安装的新工程环境互通。
2.4 销毁授权
由于迁移后原工程无法再启动使用，因此如需迁移原工程授权，需要提前销毁授权。
1）参考 授权迁移插件 的使用步骤，向商务索要一个授权迁移插件，销毁原非容器化工程的旧授权。
2）找到原非容器化工程%BI_HOME%/webroot/WEB-INF/resources文件夹下的销毁凭证并存储好。
2.5 关闭原工程
请参考「 关闭或重启FineBI工程 / 关闭或重启FineReport工程 」文档，关闭原非容器化集群下的每个工程节点。
3. 新容器化工程准备编辑
3.1 部署运维平台
容器化FineBI工程，需要通过运维平台部署。因此用户需要先部署一个FineOps运维平台。
详情请参见：部署运维平台
3.2 部署新容器化工程
进行迁移前，用户需要先通过运维平台部署一个容器化集群工程。详情请参见：部署新项目-FineBI、部署新项目-FineReport
注1：在「项目设置」时，取消勾选部署「MinIO、MySQL、Redis」组件，在下方输入2.2和2.3节获取的文件服务器、状态服务器、外接数据库信息。
注2：在「节点配置」时，请记录下FineBI工程的挂载路径，用户可自定义路径。这是工程文件的存放路径，后面步骤中需要用到。
3.3 确认新工程服务器剩余磁盘空间
1）检查原非容器化工程的大小。
2）根据原工程大小，适度扩大新容器化工程所在服务器节点剩余磁盘空间，建议大于原工程的两倍。
3.4 关闭新容器化工程
用户登录运维平台，点击「运维管理>项目管理」，点击新容器化部署的工程项目后的「组件管理」按钮。
找到bi6组件，点击「停止」按钮，即可关闭新容器化集群的全部工程节点。如下图所示：
4. 迁移工程编辑
4.1 拷贝工程文件
将原非容器化工程的必要文件，拷贝到容器化集群的各个节点中。
1）请提前检查原非容器化部署的工程，是否配置了外挂目录、是否配置共享文件服务器，确保拷贝到正确的文件。
2）新容器化工程外挂文件所在位置，为 3.2 节记录的挂载路径。
3）将以下文件，从原非容器化部署的工程，拷贝到新容器集群的各个节点中：
注1：请勿直接拷贝整个webroot文件夹到容器化工程的外挂目录，部分文件不可以被覆盖。
注2：请勿使用2.1节备份的文件，而是使用原工程最终的文件进行拷贝操作。
FineBI需要拷贝的文件
| 原非容器化工程目录 | 新容器化工程外挂目录 | 说明 |
|---|---|---|
| %Tomcat_HOME%/logs | %BI_HOME%/fanruanxxx/bi6/tomcat_logs | 作用：Tomcat通用日志位置 是否必须拷贝：用户自行决定，Tomcat历史访问日志，可不拷贝 |
| %Tomcat_HOME%/webapps/webroot/logs | %BI_HOME%/fanruanxxx/bi6/logs | 作用：swift日志 是否必须拷贝：用户自行决定 如果不拷贝，会丢失工程历史操作日志（即logdb），「管理系统>平台日志」功能无数据 如对历史使用情况无要求，无需拷贝 |
| %Tomcat_HOME%/webapps/webroot/WEB-INF/classes | %BI_HOME%/fanruanxxx/bi6/classes | 作用：工程调用的默认和自定义class文件 是否必须拷贝：必须拷贝 有可能存在自定义的class文件，如不拷贝会影响工程正常使用 |
找到非工程自带的JAR包（自定义驱动、定制JAR等） 一般存放在以下两个目录中： %Tomcat_HOME%/webapps/webroot/WEB-INF/lib %Tomcat_HOME%/webapps/webroot/WEB-INF/customLib | %BI_HOME%/fanruanxxx/bi6/customLib | 作用：工程定制/外部引入的JAR包 是否必须拷贝：必须拷贝，如不拷贝会影响模板访问 |
| %Tomcat_HOME%/webapps/webroot/WEB-INF/plugins | %BI_HOME%/fanruanxxx/bi6/plugins | 作用：插件相关文件 是否必须拷贝：必须拷贝，如不拷贝会影响插件相关功能的实现 |
FineReport需要拷贝的文件
| 原非容器化工程目录 | 新容器化工程外挂目录 | 说明 |
|---|---|---|
| %Tomcat_HOME%/logs | %FR_HOME%/fanruanxxx/fr/tomcat_logs | 作用：Tomcat通用日志位置 是否必须拷贝：用户自行决定，Tomcat历史访问日志，可不拷贝 |
| %Tomcat_HOME%/webapps/webroot/logs | %FR_HOME%/fanruanxxx/fr/logs | 作用：swift日志 是否必须拷贝：用户自行决定 如果不拷贝，会丢失工程历史操作日志（即logdb），「管理系统>平台日志」功能无数据 如对历史使用情况无要求，无需拷贝 |
| %Tomcat_HOME%/webapps/webroot/WEB-INF/classes | %FR_HOME%/fanruanxxx/fr/classes | 作用：工程调用的默认和自定义class文件 是否必须拷贝：必须拷贝 有可能存在自定义的class文件，如不拷贝会影响工程正常使用 |
找到非工程自带的JAR包（自定义驱动、定制JAR等） 一般存放在以下两个目录中： %Tomcat_HOME%/webapps/webroot/WEB-INF/lib %Tomcat_HOME%/webapps/webroot/WEB-INF/customLib | %FR_HOME%/fanruanxxx/fr/customLib | 作用：工程定制/外部引入的JAR包 是否必须拷贝：必须拷贝，如不拷贝会影响模板访问 |
| %Tomcat_HOME%/webapps/webroot/WEB-INF/plugins | %FR_HOME%/fanruanxxx/fr/plugins | 作用：插件相关文件 是否必须拷贝：必须拷贝，如不拷贝会影响插件相关功能的实现 |
4.2 启动全部工程节点
用户登录运维平台，点击「运维管理>项目管理」，点击新容器化部署的工程项目后的「组件管理」按钮。
找到bi6组件，点击组件后的「启动」按钮，即可启动该集群所有工程节点。如下图所示：
4.3 验证是否迁移成功
依次登录所有工程节点：
1）查看「管理系统>智能运维>集群配置>节点管理」中是否出现所有集群节点，说明多节点集群全部配置成功
2）查看各节点的工程配置是否相同，说明外接数据库配置成功
5. 迁移授权编辑
参考 容器私有云认证 的使用步骤，向商务索要注册镜像文件fanruan_license_server.tar，并参考文档为新容器化工程进行授权。
请在邮件中附上2.4节获取的销毁凭证。并注明是「非容器化工程迁移容器化工程」。