1. 概述
为满足客户的新需求以及完善之前版本某些功能的不足之处，FineDataLink 在不断地更新迭代。
若需要体验新产品功能或者修复之前版本中存在的一些问题，客户需要升级到当前最新版本。
提示:目前最新版本为4.2.x，建议用户升级到最新版本。2. 操作索引（必看）
4.0.20-4.0.30 版本升级到 4.2.x：操作步骤直接参考本文第三章即可。
4.1.x 升级到 4.2.x：步骤与本文第三章步骤大都相同，不同处已在下方表格中说明：
4.1.7.3 版本若需要做升级，建议升级到 4.2.0.3 及之后版本；若 4.1.8.1<目标版本<=4.2.0.2 版本，需要先升级到 4.1.8.1 过渡下，4.1.7.3 升级到 4.1.8.1 步骤请参考：4.1.x版本间升级说明
| 序号 | 需要做的步骤说明 | 4.1.x 升级到 4.2.x |
|---|---|---|
| 步骤一 | 获取 JAR 包 | 参考本文 3.1 节步骤即可 |
| 步骤二 | 暂停管道任务 | 如果升级前，您的工程为 4.1.6.2 及之后版本，可以不用暂停管道任务 |
| 如果升级前，您的工程版本为 4.1.6.2 之前版本，需要参考本文 3.2 节暂停管道任务 | ||
| 步骤三 | 一些准备工作 | 参考本文 3.3-3.5 节内容 |
| 步骤四 | 更换为最新的 JAR | %Tomcat/webapps/webroot/WEB-INF/lib目录中： 1）删除所有后缀为 4.1.jar 的文件 2）检查下是否有 fine-bi-engine-third-*.jar 文件，删掉 3）检查下是否有 fdl-bi-extension-4.1.jar 文件，删掉 4）将最新 JAR 文件上传到该目录下 具体步骤可参考本文 3.6 节内容，灵活修改 Linux 语句 |
| 步骤五 | 后续动作 | 1）参考本文 3.7 节内容启动工程 2）升级到 4.2.X 之后，之前的 Lic 文件无法使用，需要重新注册再上传 3）若之前暂停过管道任务，可重新启动管道任务 |
3. 4.0.20-4.0.30 版本升级到 4.2.x
3.1 获取最新 JAR 包
注：获取升级 JAR 包可直接在服务群内沟通相应客户成功获取或者填写 表单 后有对应人员联系您提供。
若非常紧急可电话联系处理，联系电话 400-811-8890转1。
3.2 暂停管道任务
管理员登录 FineDataLink，点击「任务运维>管道任务」，如有运行中的管道任务，请先暂停。如下图所示：
3.3 备份工程
3.3.1 平台中备份
在进行工程升级前，为避免升级失败，导致工程文件丢失无法回退等问题，请务必对原工程进行备份后再进行后续操作。
管理员进入「管理系统>智能运维>备份还原」，依次点击「平台配置」 、「FDL任务」、「jar包」、「插件」进行手动备份，如下图所示：
3.3.2 手动备份 FineDB
由于数据管道无法在平台备份还原中备份，因此需要手动备份 FineDB，在配置了外接数据库的数据库中，手动将 FineDB 备份。
外接数据库配置位置如下：
3.4 关闭 Tomcat
示例：工程部署在/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> 长时间无法关闭，联系技术支持人员进行排查。
3.5 服务器备份
为了稳妥起见，建议整个工程做个备份。
在%tomcat%/目录下执行命令备份工程：
tar -zcvf tomcat_Bak20240102.tar.gz tomcat
如果 webtoot 文件过大，可以在备份前进入%FineDataLink%/webroot/WEB-INF/dpworks/record下，删除一些历史的运行记录文件，例如下图所示：
以及 %FineDataLink%/webapps/webroot/backup 和 logs 下日期较旧的文件，如下图所示：
3.6 更换为最新 JAR
需要将%Tomcat/webapps/webroot/WEB-INF/lib目录中后缀为 4.0.jar 的文件删除，再删除该目录下的 fine-bi-engine-third-*.jar 文件，将最新 JAR 包上传到该目录下。
1）收到最新 JAR 包后，上传到 FDL 所在服务器中并解压，本文示例中，解压后的文件夹名称为 FDL_jar_4.2.0.3（用户根据实际情况修改），将解压后的文件上传到 FDL 工程的webapps/webroot/WEB-INF/lib目录下。
步骤如下：
进入 %Tomcat/webapps/webroot/WEB-INF/lib%目录下，执行命令：
cp -r FDL_jar_4.2.0.3/* Tomcat/webapps/webroot/WEB-INF/lib
然后分别输入 y。
2）删除xxx-4.0.jar
进入 %Tomcat/webapps/webroot/WEB-INF/lib%目录下，执行命令
rm *-4.0.jar
然后分别输入 y。
3）删除 fine-bi-engine-third-*.jar
进入%Tomcat/webapps/webroot/WEB-INF/lib%目录下，执行命令：
rm fine-bi-engine-third-*.jar
然后分别输入 y。
3.7 启动工程
1）检查Kafka是否正常运行
如工程使用了数据管道功能，建议在启动工程前检查Kafka是否正常运行。
查看 Kafka 运行状态和启动操作请参见：部署Kafka
2）在%tomcat%/bin目录下执行 ./startup.sh 启动工程。步骤可参见：重启工程
3）然后登录 FDL 工程，点击「管理系统>注册管理」查看当前数据平台的版本信息是否已经升级成为指定的版本。如下图所示：
3.8 重新注册
1）登录 FDL 工程，进入「管理系统>注册管理」 ，在注册信息重新上传 Lic，Lic 申请步骤详情参见：本地机器信息认证
2）启动之前被暂停过的管道任务。
4. 升级到 4.2.x 后回退说明
升级到 4.2.1.1 版本&创建了新的管道任务，若需要回退，回退后需要在 FineDB 数据库中的 fine_dp_pipeline_execut 表中删除 to_sync_traffic 字段，重启 FDL 工程。
上一篇：4.2.x版本间升级说明
