1. 概述编辑
为满足客户的新需求以及完善之前版本某些功能的不足之处，FineDataLink在不断地更新迭代。
若需要体验新产品功能或者修复之前版本中存在的一些问题，客户需要将 FDL 升级到当前最新版本。
本文来说明如何进行 4.1.x、4.2.x 之间的版本升级。
注：本文仅介绍内网手动升级的步骤，外网用户推荐使用 FineDataLink一键升级，实现更便捷的升级。
2. 4.1.x 之间版本升级编辑
提示:4.1.x.x 版本升级推荐 4.1.11.3 以及之后的版本；4.1.8.1 之前版本若想升级到 4.1.8.1 之后版本，需要先升级到 4.1.8.1 版本后，再升级到目标版本2.1 获取JAR包
可直接在服务群内沟通相应客户成功获取或者填写 https://t6ixa9nyl6.jiandaoyun.com/f/6152dbd4a57b9b0008992c6a?ext=help 后有对应人员联系您提供。
若非常紧急可电话联系处理，联系电话 400-811-8890转1。
2.2 暂停管道任务
如果升级前，您的工程为 4.1.6.2 及之后版本，可以不用暂停管道任务，忽略本节内容。
管理员登录 FineDataLink，点击「任务运维>管道任务」，如有运行中的管道任务，请先暂停。在升级完成后再启动。
2.3 备份工程
在进行工程升级前，为避免升级失败，导致工程文件丢失无法回退等问题，请务必对原工程进行备份后再进行后续操作。
管理员进入「管理系统>智能运维>备份还原」，依次点击「平台配置」 、「FDL任务」、「jar包」、「插件」进行手动备份，如下图所示：
若使用了数据管道且配置了外接数据库，需要在数据库对外迁的 FineDB 进行手动备份。
2.4 关闭 Tomcat
若升级前的 FineDataLink 为 4.1.7.2 及以上版本，可以不执行下面 2.4、2.5 节内容，直接使用 上传更新升级工程
若升级前的 FineDataLink 为 4.1.7.2 以下版本，则需要参考下面的步骤进行手动操作
示例：工程部署在/home/wendy/FDL/tomcat-linux下。
1）执行下面命令，查看工程进程，发现当前服务器处于运行状态，进程号为 14429、13878，如下图所示：
ps -ef|grep tomcat-linux
2）杀死工程进程，并检查是否有残余工程进程，需杀死所有本工程相关的进程。
kill 14429
kill 13878
使用上面语句后，可稍等半分钟，再次使用ps -ef|grep tomcat-linux查看进程是否被关闭。
注1：不建议用 kill -9 pid 语句，会导致管道任务异常。
注2：如果通过 kill <pid> 长时间无法关闭，联系技术支持人员进行排查。
2.5 替换新 JAR
提示:4.1.8.1 之前版本若想升级到 4.1.8.1 之后版本，需要先升级到 4.1.8.1 版本，再升级到目标版本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.1 4.1.8.2 及之后版本不再支持集成部署 | 使用与 FR 集成的部署包 | 手动将%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 包文件后缀一致即可。
2.6 检查Kafka是否正常运行
如工程使用了数据管道功能，建议在启动工程前检查 Kafka 是否正常运行。
查看 Kafka 运行状态和启动操作请参见：部署Kafka
2.7 重启tomcat
2.8 检查升级是否成功
1）升级重启后，管理员登录 FineDataLink，点击「管理系统>注册管理>版本信息」。
可查看当前 JAR 版本，确认是否是自己所需的工程版本。如下图所示：
2）启动之前被暂停过的管道任务。
2.9 小版本升级失败后的回退
注：暂不支持数据管道升级后回退。
若遇到特殊情况需要再升级后会退至指定的版本，可以在「管理系统>智能运维>备份还原」下，对「平台配置」和「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 | 当前版本如果配置通用配置-自定义字段映射规则后，仍有回退操作：
|
3. 4.2.x 之间版本升级编辑
参考本文 2.1、2.3、2.4、2.5、2.6、2.7、2.8 内容。
与 4.1.x 之间版本升级不同的是，无须暂停管道任务。