1. 概述
1.1 版本
工程版本 | 功能变更 |
---|---|
FineReport11.0 FineBI6.0 | - |
1.2 应用场景
有时用户需要复用一个工程,或者迁移工程所在服务器。
本文方案,帮助用户将原有容器化部署的单机工程,迁移到另一个容器化部署的单机工程。
注:全文以FineBI作为演示。FineReport迁移步骤基本一致,仅需要两个点:
1)拷贝文件时,FineReport和FineBI需要拷贝的文件不完全相同,注意文档中的表格即可。
2)使用运维平台启停容器时,FineReport关闭的是fr组件,FineBI关闭的是bi6组件。
2. 新工程准备
2.1 部署运维平台
容器化FineBI工程,需要通过运维平台部署。因此用户需要先部署一个FineOps运维平台。
详情请参见:部署运维平台
2.2 部署新容器化工程
进行迁移前,用户需要先通过运维平台部署一个容器化单机工程。
详情请参见:部署新项目-FineBI、部署新项目-FineReport
注1:请记录下MySQL组件的相关信息,由于密码随机生成,请务必修改MySQL组件的密码,方便后续使用。
注2:请记录下FineBI工程的挂载路径,用户可自定义路径。这是工程文件的存放路径,后面步骤中需要用到。
2.3 确认新工程服务器剩余磁盘空间
1)检查原工程的大小。
2)根据原工程大小,适度扩大新工程所在服务器节点剩余磁盘空间,建议大于原工程的两倍,最少剩余磁盘大小500G。
2.4 关闭新工程
用户登录运维平台,点击「运维管理>项目管理」,点击新工程项目后的「组件管理」按钮。
找到bi6组件,点击「停止」按钮,即可关闭新工程。如下图所示:
2.5 备份config
请在新工程的挂载路径/fanruanxxx/bi目录下,找到config文件夹,并另行备份。
该文件夹中存放的yaml文件中,有着工程部署所用语句,后续运营维护时可能会需要使用/查找,请务必异地备份。
3. 原工程准备
3.1 备份原工程
在进行工程迁移前,为避免迁移失败,导致工程文件丢失无法回退等问题,请务必对原工程进行备份后再进行后续操作。
请使用运维平台的 备份管理 功能对原工程进行手动备份。
3.2 升级原工程
工程迁移的前提是,两个工程必须处于同一版本。
管理员登录运维平台,点击「运维管理>项目管理」点击新老工程后的「组件管理」,查看bi6组件的当前版本是否相同(精确到日期)。
若两个工程版本不相同,可参考该文档更新工程版本:外网升级指定版本/内网升级项目
3.3 关闭原工程
用户登录运维平台,点击「运维管理>项目管理」,点击原工程项目后的「组件管理」按钮。
找到bi6组件,点击「停止」按钮,即可关闭新工程。如下图所示:
4. 迁移工程
4.1 拷贝外接数据库
将原容器化项目中的MySQL组件的外挂目录数据,拷贝到新工程项目中的MySQL组件的外挂目录里。
注:MySQL组件的外挂目录地址,一般在项目挂载路径/fanruanxxx/mysql下。
4.2 拷贝工程文件
将原容器化项目中的bi6组件的外挂目录数据,拷贝到新工程项目中的bi6组件的外挂目录里。
1)请提前检查原工程,是否修改了外挂目录位置、是否配置共享文件服务器,确保拷贝到正确的文件。
2)新工程外挂文件所在位置,为2.2节记录的挂载路径。
3)将以下文件,从原工程外挂目录,拷贝到新工程外挂目录中:
注1:请勿直接拷贝整个外挂目录文件夹到新工程,部分文件不可以被覆盖。
注2:请勿使用3.1节备份的文件,而是使用工程最终的文件进行拷贝操作。
FineBI需要拷贝的文件
外挂目录文件位置 | 说明 |
---|---|
%BI_HOME%/fanruanxxx/bi6/assets/temp_attach | 作用:FineBI数据表相关信息 是否必须拷贝:必须拷贝 该文件夹中存放着工程Excel原始文件信息,如不拷贝该文件夹会导致原始Excel丢失 |
%BI_HOME%/fanruanxxx/bi6/assets/vcs | 作用:FineReport模板备份文件 是否必须拷贝:用户自行决定 如果工程未使用FineReport模板,或不需要回退历史开发的FineReport模板,则无需拷贝 |
%BI_HOME%/fanruanxxx/bi6/assets/其他文件 | 作用:通用的共享持久化目录 是否必须拷贝:必须拷贝 工程正常运行所需要的文件,如不拷贝会影响工程正常使用 |
%BI_HOME%/fanruanxxx/bi6/backup | 作用:工程历史备份文件 是否必须拷贝:用户自行决定,可存储在原始的目录下备份,可不拷贝 |
%BI_HOME%/fanruanxxx/bi6/bi-data | 作用:FineBI抽取数据 是否必须拷贝: 如果新老工程在同一服务器上,可重新-v挂载原工程的bi-data文件夹,或在新工程启动后重新抽取数据,无需拷贝 如果新老工程不在同一服务器上,不建议拷贝,该文件夹一般数据量太大,拷贝困难,可在新工程启动后重新抽取数据 |
%BI_HOME%/fanruanxxx/bi6/classes | 作用:工程调用的默认和自定义class文件 是否必须拷贝:必须拷贝 有可能存在自定义的class文件,如不拷贝会影响工程正常使用 |
%BI_HOME%/fanruanxxx/bi6/customlib | 作用:工程定制/外部引入的JAR包 是否必须拷贝:必须拷贝,如不拷贝会影响模板访问 |
%BI_HOME%/fanruanxxx/bi6/dpworks | 作用:FineDataLink任务相关的配置文件 是否必须拷贝:必须拷贝,如不拷贝会影响FineDataLink任务使用 (如不存在该文件夹,说明工程没有使用FDL相关功能,略过) |
%BI_HOME%/fanruanxxx/bi6/logs | 作用:swift日志 是否必须拷贝:用户自行决定 如果不拷贝,会丢失工程历史操作日志(即logdb),「管理系统>平台日志」功能无数据 如对历史使用情况无要求,无需拷贝 |
%BI_HOME%/fanruanxxx/bi6/plugins | 作用:插件相关文件 是否必须拷贝:必须拷贝,如不拷贝会影响插件相关功能的实现 |
%BI_HOME%/fanruanxxx/bi6/reportlets | 作用:FineReport模板存放目录 是否必须拷贝:用户自行决定 如果工程未使用FineReport模板,则无需拷贝 |
%BI_HOME%/fanruanxxx/bi6/schedule | 作用:定时调度生成的文件 是否必须拷贝:用户自行决定 如果不拷贝,定时任务挂载到决策平台的结果报表无法访问 |
%BI_HOME%/fanruanxxx/bi6/tomcat_logs | 作用:Tomcat通用日志位置 是否必须拷贝:用户自行决定,Tomcat历史访问日志,可不拷贝 |
FineReport需要拷贝的文件
外挂目录文件位置 | 说明 |
---|---|
%FR_HOME%/fanruanxxx/fr/assets/temp_attach | 作用:读写缓存存储路径 是否必须拷贝:必须拷贝 该文件夹中存放着工程读写(图片)缓存,不拷贝可能会导致模板设置的背景图片预览为空 |
%FR_HOME%/fanruanxxx/fr/assets/vcs | 作用:FineReport模板备份文件 是否必须拷贝:用户自行决定 如果工程不需要回退历史开发的FineReport模板,则无需拷贝 |
%FR_HOME%/fanruanxxx/fr/assets/其他文件 | 作用:通用的共享持久化目录 是否必须拷贝:必须拷贝 工程正常运行所需要的文件,如不拷贝会影响工程正常使用 |
%FR_HOME%/fanruanxxx/fr/backup | 作用:工程历史备份文件 是否必须拷贝:用户自行决定,可存储在原始的目录下备份,可不拷贝 |
%FR_HOME%/fanruanxxx/fr/classes | 作用:工程调用的默认和自定义class文件 是否必须拷贝:必须拷贝 有可能存在自定义的class文件,如不拷贝会影响工程正常使用 |
%FR_HOME%/fanruanxxx/fr/customlib | 作用:工程定制/外部引入的JAR包 是否必须拷贝:必须拷贝,如不拷贝会影响模板访问 |
%FR_HOME%/fanruanxxx/fr/dpworks | 作用:FineDataLink任务相关的配置文件 是否必须拷贝:必须拷贝,如不拷贝会影响FineDataLink任务使用 (如不存在该文件夹,说明工程没有使用FDL相关功能,略过) |
%FR_HOME%/fanruanxxx/fr/logs | 作用:swift日志 是否必须拷贝:用户自行决定 如果不拷贝,会丢失工程历史操作日志(即logdb),「管理系统>平台日志」功能无数据 如对历史使用情况无要求,无需拷贝 |
%FR_HOME%/fanruanxxx/fr/plugins | 作用:插件相关文件 是否必须拷贝:必须拷贝,如不拷贝会影响插件相关功能的实现 |
%FR_HOME%/fanruanxxx/fr/reportlets | 作用:FineReport模板存放目录 是否必须拷贝:必须拷贝,如不拷贝会导致工程所有模板丢失 |
%FR_HOME%/fanruanxxx/fr/schedule | 作用:定时调度生成的文件 是否必须拷贝:用户自行决定 如果不拷贝,定时任务挂载到决策平台的结果报表无法访问 |
%FR_HOME%/fanruanxxx/fr/tomcat_logs | 作用:Tomcat通用日志位置 是否必须拷贝:用户自行决定,Tomcat历史访问日志,可不拷贝 |
5. 启动新老工程
用户登录运维平台,点击「运维管理>项目管理」,点击新老工程项目后的「组件管理」按钮。
找到bi6组件,点击「启动」按钮,即可启动新老工程。如下图所示:
6. 迁移授权
容器化工程一般使用「容器私有云认证」方式进行注册。
请参考文档第四章进行授权迁移操作:容器私有云认证