1. 概述
为满足客户的新需求以及完善之前版本某些功能的不足之处，FineDataLink在不断地更新迭代。
若需要体验新产品功能或者修复之前版本中存在的一些问题，客户需要将 FDL 升级到当前最新版本。
本文来说明如何进行 4.1.x 之间的版本升级。
注：本文仅介绍内网手动升级的步骤，外网用户推荐使用 FineDataLink一键升级，实现更便捷的升级。
2. 注意事项
4.1.x.x 版本升级推荐 4.1.11.3 以及之后的版本。
3. 4.1.x 小版本升级
3.1 获取JAR包
可直接在服务群内沟通相应客户成功获取或者填写 https://t6ixa9nyl6.jiandaoyun.com/f/6152dbd4a57b9b0008992c6a?ext=help 后有对应人员联系您提供。
若非常紧急可电话联系处理，联系电话 400-811-8890转1。
3.2 暂停管道任务
管理员登录 FineDataLink，点击「任务运维>管道任务」，如有运行中的管道任务，请先暂停。在升级完成后再启动。
3.3 备份工程
在进行工程升级前，为避免升级失败，导致工程文件丢失无法回退等问题，请务必对原工程进行备份后再进行后续操作。
管理员进入「管理系统>智能运维>备份还原」，依次点击「平台配置」 、「FDL任务」、「jar包」、「插件」进行手动备份，如下图所示：
若使用了数据管道且配置了外接数据库，需要在数据库对外迁的 FineDB 进行手动备份。
3.4 关闭Tomcat
若升级前的 FineDataLink 为 4.1.7.2 及以上版本，可以不执行下面 3.4、3.5 节内容，直接使用 上传更新升级工程
若升级前的 FineDataLink 为 4.1.7.2 以下版本，则需要参考下面的步骤进行手动操作
1）在%tomcat%/bin目录下，执行./shutdown.sh
2）等待 30s 左右，然后通过 ps -ef | grep tomcat-linux 查看任务是否关闭：
3）如果任务没有关闭：
查看占用进程：使用 ps -ef|grep tomcat查看进程，查看当前Tomcat占用进程，如下图进程号为 18727。
杀死进程：执行 kill <pid> 。例如进程号为 20976，则执行 kill 20976。
然后再次使用ps -ef|grep tomcat查看进程是否被关闭，如下图进程号消失则为成功关闭服务器。
注：如果通过 kill <pid> 长时间无法关闭，联系技术支持人员进行排查。
3.5 替换新 JAR
1）进入 %Tomcat/webapps/webroot/WEB-INF/lib%目录下，删除指定 JAR ，可以参考下表看是否需要删除内容：
| 当前版本 | 目标版本 | 部署情况 | 操作内容 |
|---|---|---|---|
4.1.5.2 以上版本 | 4.1.8.2 及以上版本 | 独立部署 | 删除%Tomcat_HOME%/webapps/webroot/WEB-INF/lib目录下的 fdl-bi-extension-4.1.jar 包 |
| 4.1.5.2 以下版本 | 4.1.8.2 及以上版本 | 独立部署 | |
| 4.1.8.2 及以上版本 | 使用与 FR 集成的部署包 | 1）手动将%Tomcat_HOME%/webapps/webroot/WEB-INF/lib下的 fine-bi-engine-third-6.0.jar 删除。 2）删除%Tomcat_HOME%/webapps/webroot/WEB-INF/lib目录下的 fdl-bi-extension-4.1.jar 包 | |
| 4.1.5.2 | 手动将%Tomcat_HOME%/webapps/webroot/WEB-INF/lib下的 fine-bi-engine-third-6.0.jar 删除。 |
2）进入 %Tomcat/webapps/webroot/WEB-INF/lib%目录下，执行命令：
cp -r FDL_jar_4.1.9.1/* Tomcat/webapps/webroot/WEB-INF/lib
然后分别输入 y。
注：示例使用的是 4.1.9.1 版本的 JAR，若用户需要使用其他版本，修改 JAR 命令的后缀与获取的 JAR 包文件后缀一致即可。
3.6 检查Kafka是否正常运行
如工程使用了数据管道功能，建议在启动工程前检查 Kafka 是否正常运行。
查看 Kafka 运行状态和启动操作请参见：部署Kafka
3.7 重启tomcat
3.8 检查升级是否成功
升级重启后，管理员登录 FineDataLink，点击「管理系统>注册管理>版本信息」。
可查看当前 JAR 版本，确认是否是自己所需的工程版本。如下图所示：
4. 小版本升级失败后的回退
注：暂不支持数据管道升级后回退。
若遇到特殊情况需要再升级后会退至指定的版本，可以在「管理系统>智能运维>备份还原」下，对「平台配置」和「jar包」选择指定的备份进行还原，如下图所示：
需要注意的是，一些版本需要修改 FineDB 相关内容：
| 已经升级至的目标版本 | 注意事项 |
|---|---|
| 4.1.7.3 | 如果升级到当前发布版本后再回退，则需要在 finedb 里将 fine_dp_conf_entity_x 表里升级后生成的带新版本号标记的数据删掉 修改 fine_dp_conf_entity_x 表里 namespace 为 ”DPFineDBVersionStore“ 对应的 version 值为旧版本 修改 fine_dp_conf_entity_x 数据操作步骤与修改 fine_conf_entity 表相同。修改后需要重启工程 |
| 4.1.8.1 | 1）备份升级后创建的任务，建议把新版本下创建的任务导出，后续再升级时进行导入。 2）修改fine_dp_conf_entity_x表里namespace为”DPFineDBVersionStore“对应的version值为旧版本 3）变更 fine_dp_conf_entity_x 表里 namespace 为 "DPFineBackupStore" 对应的 entity_value 为 true 修改 fine_dp_conf_entity_x 数据操作步骤与修改 fine_conf_entity 表相同。修改后需要重启工程 旧版本启动后，会展示回退前新版本创建的任务对应的目录树，重启工程即可解决 |
| 4.1.9.3 | 当前版本如果配置通用配置-自定义字段映射规则后，仍有回退操作：
|