1. 概述
为满足客户的新需求以及完善之前版本某些功能的不足之处，FineDataLink在不断地更新迭代。
若需要体验新产品功能或者修复之前版本中存在的一些问题，客户需要将 FDL 升级到当前最新版本。
2. 4.2.x 之间版本升级
2.1 用户须知
建议升级到 4.2 的最新版本。
| 用户工程版本 | 目标版本 | 说明 |
|---|---|---|
| 小于 4.2.2.3 | 大于等于 4.2.4.3 | 1）先升级到 4.2.2.3 版本，升级后，建议参考本文 2.5、2.6 节内容启动工程查看是否升级成功 2）再升级到 4.2.4.3 版本，升级后，建议参考本文 2.5、2.6 节内容启动工程查看是否升级成功；由于 JAR 包名称 fdl-cron 变更为 fdl-offline，替换 JAR 升级时需要手动把 fdl-cron 删掉 3）再继续升级到目标版本 |
| 4.2.2.3<=用户工程版本<4.2.4.3 | 1）先升级到 4.2.4.3 版本，升级后，建议参考本文 2.5、2.6 节内容启动工程查看是否升级成功；由于 JAR 包名称 fdl-cron 变更为 fdl-offline，替换 JAR 升级时需要手动把 fdl-cron 删掉 2）再继续升级到目标版本 | |
| 大于等于 4.2.4.3 | 升级到目标版本即可 |
2.2 获取JAR包
可直接在服务群内沟通相应客户成功获取或者填写 https://t6ixa9nyl6.jiandaoyun.com/f/6152dbd4a57b9b0008992c6a?ext=help 后有对应人员联系您提供。
若非常紧急可电话联系处理，联系电话 400-811-8890转1。
2.3 备份工程
在进行工程升级前，为避免升级失败，导致工程文件丢失无法回退等问题，请务必对原工程进行备份后再进行后续操作。
管理员进入「管理系统>智能运维>备份还原」，依次点击「平台配置」 、「FDL任务」、「jar包」、「插件」进行手动备份，如下图所示：
若使用了数据管道且配置了外接数据库，需要在数据库对外迁的 FineDB 进行手动备份。
2.4 上传更新升级工程
提示:2.4.1 场景一：外网环境且独立部署工程
参考 上传更新升级工程 步骤，上传最新 JAR 包更新工程。
2.4.2 场景二：手动更新JAR
适用于所有环境。
将 2.2 节获得的 JAR 包解压，放置到%Tomcat/webapps/webroot/WEB-INF/lib下（文件同名则覆盖更新）。
2.5 检查Kafka是否正常运行
如工程使用了数据管道功能，建议在启动工程前检查 Kafka 是否正常运行。
查看 Kafka 运行状态和启动操作请参见：部署Kafka
2.6 重启tomcat
2.7 检查升级是否成功
升级重启后，管理员登录 FineDataLink，点击「管理系统>注册管理>版本信息」。
可查看当前 JAR 版本，确认是否是自己所需的工程版本。如下图所示：
3. 升级到 4.2.x 后回退说明
升级到 4.2.1.1 版本&创建了新的管道任务，若需要回退，回退后需要在 FineDB 数据库中的 fine_dp_pipeline_execut 表中删除 to_sync_traffic 字段，重启 FDL 工程。
