1. 概述
為滿足客戶的新需求以及完善之前版本某些功能的不足之處，FineDataLink在不斷地更新迭代。
若需要體驗新產品功能或者修復之前版本中存在的一些問題，客戶需要將 FDL 升級到當前最新版本。
2. 4.2.x 之間版本升級
2.1 使用者須知
建議升級到 4.2 的最新版本。
| 使用者工程版本 | 目標版本 | 說明 |
|---|---|---|
| 小於 4.2.2.3 | 大於等於 4.2.4.3 | 1）先升級到 4.2.2.3 版本，升級後，建議參考本文 2.5、2.6 節內容啟動工程查看是否升級成功 2）再升級到 4.2.4.3 版本，升級後，建議參考本文 2.5、2.6 節內容啟動工程查看是否升級成功；由於 JAR 包名稱 fdl-cron 變更為 fdl-offline，取代 JAR 升級時需要手動把 fdl-cron 刪掉 3）再繼續升級到目標版本 |
| 4.2.2.3<=使用者工程版本<4.2.4.3 | 1）先升級到 4.2.4.3 版本，升級後，建議參考本文 2.5、2.6 節內容啟動工程查看是否升級成功；由於 JAR 包名稱 fdl-cron 變更為 fdl-offline，取代 JAR 升級時需要手動把 fdl-cron 刪掉 2）再繼續升級到目標版本 | |
| 大於等於 4.2.4.3 | 升級到目標版本即可 |
2.2 獲取JAR包
可直接在服務群內溝通相應客戶成功獲取或者填寫 https://t6ixa9nyl6.jiandaoyun.com/f/6152dbd4a57b9b0008992c6a?ext=help 後有對應人員聯絡您提供。
若非常緊急可電話聯絡處理，聯絡電話 400-811-8890轉1。
2.3 備份工程
在進行工程升級前，為避免升級失敗，導致工程檔案丟失無法回退等問題，請務必對原工程進行備份後再進行後續操作。
管理者進入「管理系統>智慧維運>備份還原」，依次點選「平台配置」 、「FDL任務」、「jar包」、「插件」進行手動備份，如下圖所示：
若使用了資料管道且配置外接資料庫，需要在資料庫對外遷的 FineDB 進行手動備份。
2.4 上傳更新升級工程
提示 :
建議查看本文 2.1 節內容，有些場景中需要先升級到過渡版本，再升級到目標版本。
2.4.1 場景一：外網環境且獨立部署工程
參考 上傳更新升級工程 步驟，上傳最新 JAR 包更新工程。
2.4.2 場景二：手動更新JAR
適用於所有環境。
將 2.2 節獲得的 JAR 包解壓，放置到%Tomcat/webapps/webroot/WEB-INF/lib下（檔案同名則改寫更新）。
2.5 檢查Kafka是否正常運作
如工程使用了資料管道功能，建議在啟動工程前檢查 Kafka 是否正常運作。
查看 Kafka 運作狀態和啟動操作請參見：部署Kafka
2.6 重啟tomcat
2.7 檢查升級是否成功
升級重啟後，管理者登入 FineDataLink，點選「管理系統>註冊管理>版本資訊」。
可查看當前 JAR 版本，確認是否是自己所需的工程版本。如下圖所示：
3. 升級到 4.2.x 後回退說明
升級到 4.2.1.1 版本&建立了新的管道任務，若需要回退，回退後需要在 FineDB 資料庫中的 fine_dp_pipeline_execut 表中刪除 to_sync_traffic 欄位，重啟 FDL 工程。