1. 概述编辑
为满足客户的新需求以及完善之前版本某些功能的不足之处，FineDataLink在不断地更新迭代。
若需要体验新产品功能或者修复之前版本中存在的一些问题，客户需要将FDL升级到当前最新版本。
注：本文仅介绍内网手动升级的步骤，外网用户推荐使用 FineDataLink一键升级，实现更便捷的升级。
2. 小版本间升级编辑
本章内容适用于：非 4.0.X 升级到 4.1.X 及之后版本的用户。
2.1 获取JAR包
可直接在服务群内沟通相应客户成功获取或者填写 https://t6ixa9nyl6.jiandaoyun.com/f/6152dbd4a57b9b0008992c6a?ext=help 后有对应人员联系您提供。
若非常紧急可电话联系处理，联系电话 400-811-8890转1。
注：不同版本的JAR包数量略有不同，请与技术支持确认好版本即可。
2.2 暂停管道任务
管理员登录FineDataLink，点击「任务运维>管道任务」，如有运行中的管道任务，请先暂停。在升级完成后再启动。
2.3 备份工程
在进行工程升级前，为避免升级失败，导致工程文件丢失无法回退等问题，请务必对原工程进行备份后再进行后续操作。
请参考 FineDataLink备份还原，对工程进行备份。
注：4.0.X 升级到 4.1.X 及之后版本的用户，需备份 FineDB ；步骤请参见：平台配置
2.4 关闭Tomcat
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> 长时间无法关闭，联系技术支持人员进行排查。
2.5 手动更新
1）删除JAR
注1：如需回退到当前版本，请加回删除的JAR包。
注2：由于4.0.27内置了数据服务jar 包fdl-dataservice-4.0.jar，若4.0.27及以上回退，需要需要删除该jar。
| 当前版本 | 目标版本 | 操作内容 |
|---|---|---|
| 任意版本 | 4.1 版本 |
|
| 任意版本 | 4.0.30 版本 | 删除%Tomcat_HOME%/webapps/webroot/WEB-INF/lib目录下的 fine-bi-engine-third-6.0.jar |
| 任意版本 | 4.0.27及以上版本 | 查看%Tomcat_HOME%/webapps/webroot/WEB-INF/lib目录下是否有fdl-bi-extension-4.0.jar 若没有，需要联系技术支持获取 联系方式：前往「服务」，选择「在线支持」、电话「400-811-8890」。 |
| 任意版本 | 4.0.27以下版本 | 删除%Tomcat_HOME%/webapps/webroot/WEB-INF/lib目录下的fdl-bi-extension-4.0.jar 注：如果有就必须删除。 |
| FDL4.0.15以下 且使用过数据管道功能 | FDL4.0.15及以上 | 删除%Tomcat_HOME%/webapps/webroot/WEB-INF/lib目录下的 Kafka 驱动包 包括： objenesis-2.5.1.jar mysql-binlog-connector-java-0.25.6.jar kafka-clients-2.8.1.jar javassist-3.21.0-GA.jar jackson-core-2.8.8.jar fst-2.57.jar |
| FDL4.0.14.2以下 | FDL4.0.14.2及以上 | 删除%Tomcat_HOME%/webapps/webroot/WEB-INF/lib目录下的fine-bi-engine-third-5.1.jar 原因：fine-bi-engine-third-5.1.jar和fine-bi-engine-third-6.0.jar互相冲突 |
| FDL4.0.14以下 | FDL4.0.14及以上 | 删除%Tomcat_HOME%/webapps/webroot/WEB-INF/lib目录下，名称中包含netty的相关 JAR 包 原因：平台11.0.9及之后版本，产品内置了netty-all-4.1.78.Final.jar相关功能 |
| FDL4.0.6以下 | FDL4.0.6及以上 | 删除%Tomcat_HOME%/webapps/webroot/WEB-INF/lib目录下的fine-data-platform-11.0.jar |
2）替换JAR
将技术支持处获取的JAR包上传至%Tomcat_HOME%/webapps/webroot/WEB-INF/lib目录下。
2.6 检查Kafka是否正常运行
如工程使用了数据管道功能，建议在启动工程前检查Kafka是否正常运行。
查看 Kafka 运行状态和启动操作请参见：部署Kafka
2.7 重启tomcat
2.8 检查升级是否成功
升级重启后，管理员登录FineDataLink，点击「管理系统>注册管理>版本信息」。
可查看当前JAR版本，确认是否是自己所需的工程版本。如下图所示：
3. 跨版本升级编辑
本节内容适用于 4.0.X 升级到 4.1.X 及之后版本的用户。
4.1 版本功能点注册与 4.0.x 不兼容，升级后需要生成新 license 进行注册。4.0.X 升级到 4.1.X 及之后版本步骤为：
1）参考 授权迁移插件 文档的 2.1-2.4 节内容，销毁旧的授权，生成新的授权。
2）参考本文第二章内容，更新 JAR。
3）使用新授权文件，对工程进行注册。步骤可参见：新工程注册