1. 概述编辑
2.升級前準備工作编辑
升級前需進行一些升級的準備工作，請參考文檔：5.1.1-5.1.5升級前準備工作
3. 單節點升級编辑
非 web 叢集升級 BI 工程步驟如下：
注：若使用者從 5.1.2-5.1.5 升級，且使用了nginx轉發，nginx有檔案傳輸大小和時間的限制，可能會出現插件安裝失敗，jar包上傳失敗的問題，IP+埠存取可以避免。
3.1 安裝插件「BI升級工具」
注：升級工具最早支援 5.1.1 8.16 版本的 BI 使用，需要在安裝升級工具插件前確定工程已經升至該版本。
1）下載插件。
若您是未聯絡帆軟銷售經理的個人使用者，可致電 400-8118890 轉1 與帆軟商務聯絡獲取相關資訊；若您已與帆軟銷售經理有對接，可透過 FineBI 技術支援（QQ：800049425）獲取新版本 JAR 檔案下載連結和 「BI升級」插件包。
2）安裝插件方法請參見：插件管理 ，
安裝完插件後，進行單節點升級，視頻操作步驟如下：
詳細步驟截圖，文檔說明如下文所示：
3.2 閱讀升級注意事項
勾選閱讀完上述注意事項之後，可以點選「下一步」進行，如下圖所示：
系統會跳出備份提示介面，點選「確定」如下圖所示：
如果未進行備份，請參考本文第 2 節。
3.3 選擇升級型別
工具會檢查當前系統版本以及 jar 時間，並推薦可用的升級型別。
升級至最新版本路線圖為：5.1歷史版本 → 5.1.1版本 → 5.1.2_歷史版本 → 5.1.2_jar2020-07-17版本 → 5.1.5及後續版本
閱讀「升級型別介紹」後，根據需要選擇合適的升級型別後，繼續點選「下一步」，如下圖所示：
若選擇升級型別後，升級的目標版本介面沒有「下一步」，則直接點選「執行」，進行下一步操作，可直接跳轉至本文 3.4 節進行操作。介面如下圖所示：
3.3.1 表模式相容調整說明
注：僅5.1.2升級到5.1.5模式有此步驟
瞭解「表模式相容調整說明」後，匯出表後，繼續點選「下一步」，如下圖所示：
3.3.2 聯動與權限相容說明
注：僅 5.1.2 升級 5.1.5 有此步驟，且配置升級只能執行一次，不能多次執行。
瞭解「聯動與權限相容說明」後，匯出相關資料，點選「執行」進行配置升級，如下圖所示：
3.4 執行配置升級
3.4.1 操作步驟
點選「執行」會進入配置自動升級的介面，如下圖所示：
配置升級完成後，會自動跳轉下一步操作；並且會自動生成 Excel 格式「升級報表說明」，如下圖所示：
3.4.2 注意事項
1）執行配置升級的步驟會自動檢查，外接資料庫權限。
自動檢查%FineBI%/webapps/webroot/WEB-INF/config下的db.properties的配置是否正確， db.properties 中下圖位置配置必須為 update：
插件自動檢查外接資料庫使用者資料庫 DDL 權限，使用者必須要有 DDL 權限。外接資料庫使用者如下圖所示：
如果上述兩項任意一項檢查不過，報錯均如下圖所示：
解決方法：維運人員去檢查對應的權限
如果應答是第（2）項檢查不過，可以查看 fanruan.log，搜尋鍵 create db table or insert data failed ，查看資料庫詳細報錯資訊。
2）若自助資料集資料處理表依賴了資料分析表，報錯提示如下圖所示：
解決方法：聯絡技術支援解決問題 QQ（800049425）。
3.5 上傳jar檔案
3.5.1 自动换 JAR
1）先相信閱讀「上傳Jar檔案」的注意事項，再輸入完資訊後，點選「執行」進行 jar 檔案更換，如下圖所示：
當前工程 JAR 路徑：%FineBI%/webapps/webroot/WEB-INF/lib
上傳 zip 檔案包：範例為%FineBI%/webapps/webroot/WEB-INF/exchangeJars（zip 包可聯絡技術支援獲取： QQ：800049425）
當前工程的啟動路徑：%FineBI%/bin/
注：5.1.1-5.1.2 可能會出現下面的內容：
當前工程的啟動 JAR路徑：%FineBI%/lib（只有exe安裝的才有，若是 BI 部署到了其他容器中，則不需要做這個步驟。）
新 JAR 路徑：%FineBI%/exchangeJars（只有exe安裝的才有，若是 BI 部署到了其他容器中，則不需要做這個步驟。 Jar 包獲取請點選：lib）
2）點選「執行」後，會出現提示介面。點選「確定」執行操作，提示介面如下圖所示：
若未進行備份，可參考本文第 2 節。
3.5.2 手動換 JAR
注 1：通常情況下，按照升級工具指引步驟操作即可。如果上傳 Jar 檔案失敗，可選擇手動換 Jar 。
注 2：5.1.2 升級 5.1.5，配置升級只能執行一次，不能多次執行。如果換 jar 失敗，不用再執行前面的步驟，直接手動換 jar 即可。
操作失敗後，手動換 Jar 步驟如下：
1）關閉正在運作的 FineBI 工程。
2）copy並更換 jar 檔案。
將升級的 jar 包，copy至 FineBI 目錄%FineBI%/webapps/webroot/WEB-INF/lib中，更換原先的 JAR 包。
3）手動重啓 BI 工程。
結束可跳轉第 4 節，驗證升級效果。
3.6 完成
如果升級成功則會提示介面如下圖所示：
完成介面詳情：
系統升級成功，系統將在10s之後立即重啓；第一次重啓時間較長，請耐心等待。--------//（10s之後執行重啓腳本）
注 1 ：自動重啓功能僅支援 Tomcat 和 exe 部署方式。如果是 Weblogic、Wildfly(JBoss)、Websphere、Docker 伺服器部署，請自行立即重啓
注 2 ：如果重啓功能未執行，請自行立即重啓。
如果升級失敗則會提示：
系統升級失敗
4. 驗證升級效果编辑
系統重啓完成後，查看「管理系統>登入管理」中的版本號和 jar 日期。如果已經變更為新版本，則說明升級成功，如下圖所示：
繼續檢查範本是否都可以正常預覽，如果升級過程中遇到其他問題，請聯絡 BI 技術支援（QQ：800049425 ）定位解決問題。
注意事項：
只有 5.1.5 之後的版本才會顯示小版本號。之前的版本顯示為 5.1.0 ，可以根據 JAR 的日期來確定版本。
下表為每個小版本第一次發佈的 JAR 包日期。若在 JAR 包日期在兩個版本中間，則為較早的版本。
| FineBI 版本號 | JAR 包日期 |
|---|---|
| 5.0 | 2018-09-01 |
| 5.1 | 2019-01-15 |
| 5.1.1 | 2019-05-15 |
| 5.1.2 | 2019-11-08 |
| 5.1.5 | 2020-08-04 |
例如，下圖是 2020.08.04 的 JAR ，因此是5.1.5的版本。
5. 升级回退编辑
若出現升級失敗等原因，需要回退原來的舊版本。
升級回退請參見：跨版本升級回退至原版本
6. 升級後功能變化编辑
升級後的功能變化：更新日志
注：根據自己對應的 JAR 包和版本查看該日期及之前的功能變化。