本文仅用于指导非运维平台部署的FineDataLink4.1.x工程升级。

运维平台部署的FineDataLink工程，请通过运维平台进行升级，详情请参见：外网升级运维项目、内网升级运维项目

为满足客户的新需求以及完善之前版本某些功能的不足之处，FineDataLink在不断地更新迭代。

若需要体验新产品功能或者修复之前版本中存在的一些问题，客户需要将 FDL 升级到当前最新版本。

提示:4.1.x 版本间说明请参见：历史版本

；本文给出 4.2.x 版本间的升级步骤。

2.1 用户须知

建议升级到 4.2 的最新版本。

2.2 获取JAR包

可直接在服务群内沟通相应客户成功获取或者填写 https://t6ixa9nyl6.jiandaoyun.com/f/6152dbd4a57b9b0008992c6a?ext=help 后有对应人员联系您提供。

若非常紧急可电话联系处理，联系电话 400-811-8890转1。

2.3 备份工程

在进行工程升级前，为避免升级失败，导致工程文件丢失无法回退等问题，请务必对原工程进行备份后再进行后续操作。

管理员进入「管理系统>智能运维>备份还原」，依次点击「平台配置」 、「FDL任务」、「jar包」、「插件」进行手动备份，如下图所示：

若使用了数据管道且配置了外接数据库，需要在数据库对外迁的 FineDB 进行手动备份。

2.4 上传更新升级工程

提示:

建议查看本文 2.1 节内容，有些场景中需要先升级到过渡版本，再升级到目标版本。

2.4.1 场景一：外网环境且独立部署工程

目标版本为 4.2.6.2 之前版本：

参考 上传更新升级工程 步骤，上传最新 JAR 包更新工程。

目标版本为 4.2.6.2 及之后版本：

先删除%Tomcat/webapps/webroot/WEB-INF/lib下的fdl-offline-4.2.jar、fdl-pipeline-4.2.jar、fdl-stream-4.2.jar；再参考 上传更新升级工程 步骤，上传最新 JAR 包更新工程。

2.4.2 场景二：手动更新JAR

适用于所有环境。

目标版本为 4.2.6.2 之前版本：

将 2.2 节获得的 JAR 包解压，放置到%Tomcat/webapps/webroot/WEB-INF/lib下（文件同名则覆盖更新）。

目标版本为 4.2.6.2 及之后版本：

1）先删除%Tomcat/webapps/webroot/WEB-INF/lib下的fdl-offline-4.2.jar、fdl-pipeline-4.2.jar、fdl-stream-4.2.jar。

2）再将 2.2 节获得的 JAR 包解压，放置到%Tomcat/webapps/webroot/WEB-INF/lib下（文件同名则覆盖更新）。

2.5 检查Kafka是否正常运行

如工程使用了数据管道功能，建议在启动工程前检查 Kafka 是否正常运行。

查看 Kafka 运行状态和启动操作请参见：部署Kafka

2.6 重启tomcat

请参见：关闭或重启FineDataLink工程

2.7 检查升级是否成功

升级重启后，管理员登录 FineDataLink，点击「管理系统>注册管理>版本信息」。

可查看当前 JAR 版本，确认是否是自己所需的工程版本。如下图所示：

2.8 功能兼容说明

若升级到 4.2.6.2 及之后版本&升级前使用了数据服务功能，需注意：

• 升级后不影响已上线任务的正常调用，但是编辑 API 可能会修改请求 json 的格式，注意提醒 API 调用方同步变更。

• 数据服务响应头的 Content-Type 从 text/json 变更为 applicaiton/json ，升级前确认一下之前是否通过代码对接，并且代码里指定解析了 text/json 。如果做了针对性的解析，需要调整请求类型，不然调用会失败。

升级到 4.2.1.1 版本&创建了新的管道任务，若需要回退，回退后需要在 FineDB 数据库中的 fine_dp_pipeline_execut 表中删除 to_sync_traffic 字段，重启 FDL 工程。