1. 概述编辑
为满足多类型客户的使用诉求，FDL 从 4.0.1.1 版本开始支持独立和集成两种部署方式，本文档将会详尽介绍报表模块为 FineBI-FDL 集成部署的客户升级 FDL 版本的操作方法。
1.1 版本确认
集成部署升级前请确认，最低支持的 FineBI 版本如下：
| FineDataLink | FineBI5.1 版本 | FineBI6.0版本 |
|---|---|---|
| 4.0.5-4.0.8 | 最低支持版本为5.1.24 | 最低支持版本为2022.06.28 |
| 4.0.9-4.0.14 | 依赖FR发布推算对应版本 | 最低支持版本为2022.06.28 |
4.0.14.2（jar 2022-12-07） 4.0.15 4.0.16 4.0.17 4.0.18 4.0.19 | 最低支持版本为BI5.1.29 | 最低支持版本为BI6.0.5.2 （JAR 2022-12-07） |
4.0.20 4.0.21 4.0.22 4.0.23 4.0.24 | 最低支持版本5.1.31 | 最低支持版本为BI6.0.8 （JAR 2023-03-23） |
| 4.0.26 | 最低支持版本 5.1.33 | 最低支持版本 6.0.12（JAR 2023-08-03） |
4.0.27 4.0.28 | 不支持 5.1 | 最低支持版本 6.0.12 （JAR 2023-08-03） |
| 4.0.29 | 不支持 5.1 | 最低支持版本 6.0.13 （JAR 2023-09-04） |
2. 集成FineBI6.0升级步骤编辑
2.1 获取JAR包
付费用户请联系帆软技术支持，索要最新/指定版本的JAR包。
请明确告知技术支持：当前工程是FineBI6.0与FineDataLink集成、是否使用数据管道功能。
技术支持联系方式：前往「服务」，选择「在线支持」、电话「400-811-8890」。
注：不同版本的JAR包数量略有不同，请与技术支持确认好版本即可。
2.2 备份工程
在进行工程迁移前，为避免迁移失败，导致工程文件丢失无法回退等问题，请务必对原工程进行备份后再进行后续操作。
请参考 工程备份还原方案 3.1节，对工程进行备份。
依次备份「平台配置」「报表模板」「FRL任务」「jar包」这几个tab，如下图所示：
2.3 关闭工程
请参考 关闭或重启FineBI工程 文档，关闭工程节点。
2.4 备份webroot
备份 FineBI 的webroot: 复制一份 webroot 文件夹到其他路径，完成备份。
2.5 手动更新
1）删除JAR
注：如需回退到当前版本，请加回删除的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 重启工程
请参考 关闭或重启FineBI工程 文档，重启工程节点。
2.7 检查升级是否成功
升级重启后，管理员登录BI-FDL 集成部署工程，点击「管理系统>注册管理>版本信息」。
可查看当前JAR版本，确认是否是自己所需的工程版本。如下图所示：
3. 集成FineBI5.1升级步骤编辑
3.1 备份工程
在进行工程迁移前，为避免迁移失败，导致工程文件丢失无法回退等问题，请务必对原工程进行备份后再进行后续操作。
请参考 工程备份还原方案 3.1节，对工程进行备份。
3.2 升级FineBI5.1
参考5.1.18-5.1.19及之后版本升级指南升级FineBI5.1。
3.3 获取FineDataLink相关JAR包
付费用户请联系帆软技术支持，索要最新/指定版本的JAR包。
请明确告知技术支持：当前工程是FineBI5.1与FineDataLink集成、FineBI工程的版本和JAR包时间是多少。
技术支持联系方式：前往「服务」，选择「在线支持」、电话「400-811-8890」。
注：不同版本的JAR包数量略有不同，请与技术支持确认好版本即可。
3.4 关闭工程
请参考 关闭或重启FineBI工程 文档，关闭工程节点。
3.5 手动升级
1）删除JAR
注：如需回退到当前版本，请加回删除的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目录下。
3.6 重启工程
请参考 关闭或重启FineBI工程 文档，重启工程节点。
3.7 检查升级是否成功
升级重启后，管理员登录BI-FDL 集成部署工程，点击「管理系统>注册管理>版本信息」。
可查看当前JAR版本，确认是否是自己所需的工程版本。
4. 下一步操作编辑
| 操作 | 说明 |
|---|---|
| FineDataLink注册授权 | 完成工程部署操作后，需要对 FineDataLink 进行注册授权，才能使用功能点 |
| 管道任务运维 | 升级前，暂停了管道任务，建议在升级后手动启动任务 |