1. 概述
| 报表服务器版本 | FineDataLink 版本 |
|---|---|
| 11.0.4 及之后 | 4.0.1.1 |
为满足多类型客户的使用诉求，FDL 从 4.0.1.1 版本开始支持独立和集成两种部署方式。
本文档将会详尽介绍 FR11-FDL 集成部署的客户升级 FDL 版本的操作方法。
集成部署升级前请确认，最低支持的 FineReport 版本如下：版本适配说明
2. 操作步骤
2.1 注意事项
非 4.0.X 升级到 4.1.X 及之后版本的用户，可忽略本节内容。
4.1 版本功能点注册与 4.0.x 不兼容，升级后需要生成新 license 进行注册。4.0.X 升级到 4.1.X 及之后版本步骤为：
1）参考 授权迁移插件 文档的 2.1-2.4 节内容，销毁旧的授权，生成新的授权。
2）参考本文 2.2-2.9 节内容，更新 JAR。
3）使用新授权文件，对工程进行注册。步骤可参见：新工程注册
2.2 获取JAR包
可直接在服务群内沟通相应客户成功获取或者填写 https://t6ixa9nyl6.jiandaoyun.com/f/6152dbd4a57b9b0008992c6a?ext=help 后有对应人员联系您提供。
若非常紧急可电话联系处理，联系电话 400-811-8890转1。
注：不同版本的JAR包数量略有不同，请与技术支持确认好版本即可。
2.3 备份工程
在进行工程迁移前，为避免迁移失败，导致工程文件丢失无法回退等问题，请务必对原工程进行备份后再进行后续操作。
请参考 工程备份还原方案 4.1节，对工程进行备份。
2.4 关闭工程
请参考「关闭或重启FineReport工程」文档，关闭原工程。
2.5 备份webroot
备份 FineReport 的 webroot: 复制一份 webroot 文件夹到其他路径，完成备份。
2.6 手动升级
1）删除JAR
注：如需回退到当前版本，请加回删除的JAR包。
| 当前版本 | 目标版本 | 操作内容 |
|---|---|---|
| 任意版本 | 4.1.5.2 及之后 | 删除%Tomcat_HOME%/webapps/webroot/WEB-INF/lib目录下的fine-bi-engine-third-6.0.jar |
| FDL4.0.18及以上 | 4.1 版本 | 把带有 4.0 后缀的 JAR 删除。 |
| FDL4.0.18以下 | FDL4.0.18-4.0.30 | 删除%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.7 检查Kafka是否正常运行
如工程使用了数据管道功能，建议在启动工程前检查Kafka是否正常运行。
查看 Kafka 运行状态和启动操作请参见：部署Kafka
2.8 启动工程
请参考「关闭或重启FineDataLink工程」文档，重启原工程。
2.9 检查升级是否成功
升级重启后，管理员登录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 工程内。
