1. 概述
为满足客户的新需求以及完善之前版本某些功能的不足之处，FineDataLink 在不断地更新迭代。
若需要体验新产品功能或者修复之前版本中存在的一些问题，客户需要升级到当前最新版本。
本文来说明如何从 4.0.20 版本升级至 4.1.x 最新版本。
注1：4.0.20-4.0.30 版本升级至 4.1.x 版本均适用此方案。
注2：获取升级 JAR 包可直接在服务群内沟通相应客户成功获取或者填写 https://t6ixa9nyl6.jiandaoyun.com/f/6152dbd4a57b9b0008992c6a?ext=help 后有对应人员联系您提供。
若非常紧急可电话联系处理，联系电话 400-811-8890转1。
2. 暂停管道任务
3. 备份工程
3.1 平台中备份
在进行工程升级前，为避免升级失败，导致工程文件丢失无法回退等问题，请务必对原工程进行备份后再进行后续操作。
管理员进入「管理系统>智能运维>备份还原」，依次点击「平台配置」 、「FDL任务」、「jar包」、「插件」进行手动备份，如下图所示：
3.2 手动备份 FineDB
由于数据管道无法在平台备份还原中备份，因此需要手动备份 FineDB，在配置了外接数据库的数据库中，手动将 FineDB 备份。
外接数据库配置位置如下：
4. 关闭Tomcat
1）在%tomcat%/bin目录下，执行./shutdown.sh
2）等待 30s 左右，然后通过命令查看任务是否关闭
ps -ef | grep tomcat-linux
3）如果任务没有关闭：
查看占用进程：使用命令查看进程，查看当前 Tomcat 占用进程，如下图进程号为 18727。
ps -ef|grep tomcat
杀死进程：执行命令。例如进程号为 20976，则执行 kill 20976。
kill <pid>
然后再次使用命令查看进程是否被关闭，如下图进程号消失则为成功关闭服务器。
ps -ef|grep tomcat
注：如果通过 kill <pid> 长时间无法关闭，联系技术支持人员进行排查。
5. 服务器备份
为了稳妥起见，建议整个工程做个备份。
在%tomcat%/目录下执行命令备份工程：
tar -zcvf tomcat_Bak20240102.tar.gz tomcat
如果 webtoot 文件过大，可以在备份前进入%FineDataLink%/webroot/WEB-INF/dpworks/record下，删除一些历史的运行记录文件，例如下图所示：
以及 %FineDataLink%/webapps/webroot/backup 和 logs 下日期较旧的文件，如下图所示：
6. 升级至 4.0.24（可选）
初始版本为 4.0.24 以下版本为保险起见，可以先升级至 4.0.24 版本（较稳定）再升级至 4.1 版本。
1）进入 %Tomcat/webapps/webroot/WEB-INF/lib%目录下，输入命令替换 4.0.24 的 JAR：
cp -r FDL_jar_4.0.24/* Tomcat/webapps/webroot/WEB-INF/lib
分别输入 y 确认替换。
注：实际 4.0.24 的 jar 压缩包名称以及正式 FDL 工程路径按照实际情况替换。
2）启动验证。
进入 %Tomcat/bin%目录下，执行命令启动系统工程。
./startup.sh
登录系统工程，进入「管理系统>注册管理」检查是否已经升级至 4.0.24 版本。
3）工程关闭。进入 %Tomcat/bin%目录，执行命令关闭工程。
./shutdown.sh
使用命令查看进程是否存在
ps -ef|grep tomcat
如果还存在 FDL 的进程，参考本文第四章杀死进程。
7. 替换最新的 4.1.x JAR
1）进入 %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）删除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。
8. 启动工程
1）检查Kafka是否正常运行
如工程使用了数据管道功能，建议在启动工程前检查Kafka是否正常运行。
查看 Kafka 运行状态和启动操作请参见：部署Kafka
2）在%tomcat%/bin目录下执行 ./startup.sh 启动工程。
3）然后登录系统，进入「管理系统>注册管理」查看当前数据平台的版本信息是否已经升级成为指定的版本，如下图所示：
