1. 概述编辑
报表服务器版本 | FineDataLink 版本 |
---|---|
11.0.4 及之后 | 4.0.1.1 |
为满足多类型客户的使用诉求,FDL 从 4.0.1.1 版本开始支持独立和集成两种部署方式。
本文档将会详尽介绍 FR11-FDL 集成部署的客户升级 FDL 版本的操作方法。
1.1 版本确认
集成部署升级前请确认,最低支持的 FineReport 版本如下:
FineDataLink | FineReport11.0版本 |
---|---|
4.0.5-4.0.8 | 数据开发最低支持版本为2022.04.18 数据管道最低支持版本为2022.07.15 |
4.0.9-4.0.13 | 最低支持版本为2022.09.27 |
4.0.14 | 支持版本区间:2022.09.27~2022.11.16 |
4.0.14.2(JAR 2022.12.07) 4.0.15 4.0.16 4.0.17 4.0.18 4.0.19 | 最低支持版本:2022.12.07(FR11.0.11) |
4.0.20 4.0.21 4.0.22 4.0.23 4.0.24 | 最低支持版本:2023.03.14(FR11.0.14) |
4.0.26 4.0.27 | 最低支持版本:2023.07.11(FR11.0.18) |
2. 升级步骤编辑
2.1 获取JAR包
付费用户请联系帆软技术支持,索要最新/指定版本的JAR包。
请明确告知技术支持:当前工程是FineReport11.0与FineDataLink集成、是否使用数据管道功能。
技术支持联系方式:前往「服务」,选择「在线支持」、电话「400-811-8890」。
注:不同版本的JAR包数量略有不同,请与技术支持确认好版本即可。
2.2 暂停管道任务
管理员登录FineDataLink,点击「任务运维>管道任务」,如有运行中的管道任务,请先暂停。在升级完成后再启动。
2.3 备份工程
在进行工程迁移前,为避免迁移失败,导致工程文件丢失无法回退等问题,请务必对原工程进行备份后再进行后续操作。
请参考 工程备份还原方案 4.1节,对工程进行备份。
2.4 关闭工程
请参考「关闭或重启FineReport工程」文档,关闭原工程。
2.5 手动升级
1)删除JAR
注:如需回退到当前版本,请加回删除的JAR包。
当前版本 | 目标版本 | 操作内容 |
---|---|---|
FDL4.0.18以下 | FDL4.0.18及以上 | 删除%Tomcat_HOME%/webapps/webroot/WEB-INF/lib目录下的fdl-piepline-4.0.jar |
FDL4.0.14.2以下 | FDL4.0.14.2及以上 | 删除%Tomcat_HOME%/webapps/webroot/WEB-INF/lib目录下的fine-bi-engine-third-5.1.jar,新增fine-bi-engine-third-6.0.jar 原因:fine-bi-engine-third-5.1.jar和fine-bi-engine-third-6.0.jar互相冲突 |
- | FDL4.0.14.2以下 | 集成FineReport 需要新增一个 fine-bi-engine-third-5.1.jar |
FDL4.0.14以下 | FDL4.0.14及以上 | 删除%Tomcat_HOME%/webapps/webroot/WEB-INF/lib目录下,名称中包含netty的相关 JAR 包 原因:平台11.0.9及之后版本,产品内置了netty-all-4.1.78.Final.jar相关功能 |
FDL4.0.6以下 | FDL4.0.6及以上 | 删除%Tomcat_HOME%/webapps/webroot/WEB-INF/lib目录下的fine-data-platform-11.0.jar |
2)替换JAR
将技术支持处获取的JAR包上传至%Tomcat_HOME%/webapps/webroot/WEB-INF/lib目录下。
2.6 检查Kafka是否正常运行
如工程使用了数据管道功能,建议在启动工程前检查Kafka是否正常运行。
查看 Kafka 运行状态和启动操作请参见:部署Kafka
2.7 启动工程
请参考「关闭或重启FineReport工程」文档,重启原工程。
2.8 检查升级是否成功
升级重启后,管理员登录FR-FDL 集成部署工程,点击「管理系统>注册管理>版本信息」。
可查看当前JAR版本,确认是否是自己所需的工程版本。如下图所示:
3. 集成部署升级至独立部署版本编辑
3.1 独立部署 FDL
参考 FineDataLink独立部署 完成最新版本 FDL 工程部署。
3.2 确认升级前后版本
集成部署升级至独立部署的 FDL ,需要确保集成部署的 FDL 升级成与 3.1节独立部署相同版本。
在注册管理中查看当前集成部署版本,如果与 3.1节相同,则执行3.3节即可。
如果版本不一致,则需要对集成部署工程进行升级,升级步骤为本节内容。
3.2.1 获取 FDL 专属 jar 包
联系 FDL 技术支持获取升级包。技术支持联系方式:前往「服务」,选择「在线支持」、电话「400-811-8890」
3.2.2 FR11-FDL 集成部署原工程安装 FDL 新 jar 包
FR11-FDL 集成部署原工程,删除 fine-data-platform-11.0.jar 包,再安装 FDL 新 jar 包,重启服务器。
3.3 资源导出
使用数据连接导出,导出所有数据连接;
使用任务导出功能 ,导出所有 ETL 任务。
3.4 定时任务导入独立部署 FDL
使用数据连接导入,导入所有数据连接;
使用任务导入功能,将所有原 ETL 任务导入独立部署 FDL 工程内。
4. 下一步操作编辑
操作 | 说明 |
---|---|
FineDataLink注册授权 | 完成工程部署操作后,需要对 FineDataLink 进行注册授权,才能使用功能点 |
管道任务运维 | 升级前,暂停了管道任务,建议在升级后手动启动任务 |