升級前查看升級所對應的版本：升級指南索引
本文介紹 5.1.1 升級到 5.1.2、5.1.3、5.1.5 版本單節點，叢集 5.1.x 升級指南參見文檔：「叢集」5.1.1-5.1.5升級指南
升級前需進行一些升級的準備工作，請參考文檔：5.1.1-5.1.5升級前準備工作
非 web 叢集升級 BI 工程步驟如下：
注：若使用者從 5.1.2-5.1.5 升級，且使用了nginx轉發，nginx有檔案傳輸大小和時間的限制，可能會出現插件安裝失敗，jar包上傳失敗的問題，IP+埠存取可以避免。
注：BI升級插件雖為簡體，功能不受影響
注：升級工具最早支援 5.1.1 8.16 版本的 BI 使用，需要在安裝升級工具插件前確定工程已經升至該版本。
1）下載插件。
若您是未聯絡帆軟銷售經理的個人使用者，可致電 400-8118890 轉1 與帆軟商務聯絡獲取相關資訊；若您已與帆軟銷售經理有對接，可透過 FineBI 技術支援（QQ：800049425）獲取新版本 JAR 檔案下載連結和 「BI升級」插件包。
2）安裝插件方法請參見：插件管理 ，
安裝完插件後，進行單節點升級，視頻操作步驟如下：
詳細步驟截圖，文檔說明如下文所示：
勾選閱讀完上述注意事項之後，可以點選「下一步」進行，如下圖所示：
系統會跳出備份提示介面，點選「確定」如下圖所示：
如果未進行備份，請參考本文第 2 節。
工具會檢查當前系統版本以及 jar 時間，並推薦可用的升級型別。
升級至最新版本路線圖為：5.1歷史版本 → 5.1.1版本 → 5.1.2_歷史版本 → 5.1.2_jar2020-07-17版本 → 5.1.5及後續版本
閱讀「升級型別介紹」後，根據需要選擇合適的升級型別後，繼續點選「下一步」，如下圖所示：
注：升級 5.1.5-純直連版本需聯絡技術支援 QQ（800049425）。
若選擇升級型別後，升級的目標版本介面沒有「下一步」，則直接點選「執行」，進行下一步操作，可直接跳轉至本文 3.4 節進行操作。介面如下圖所示：
注：僅5.1.2升級到5.1.5模式有此步驟
瞭解「表模式相容調整說明」後，匯出表後，繼續點選「下一步」，如下圖所示：
注：僅 5.1.2 升級 5.1.5 有此步驟，且配置升級只能執行一次，不能多次執行。
瞭解「聯動與權限相容說明」後，匯出相關資料，點選「執行」進行配置升級，如下圖所示：
點選「執行」會進入配置自動升級的介面，如下圖所示：
配置升級完成後，會自動跳轉下一步操作；並且會自動生成 Excel 格式「升級報表說明」，如下圖所示：
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）若自助資料集資料處理表依賴了資料分析表，報錯提示如下圖所示：
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 節。
注 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 節，驗證升級效果。
如果升級成功則會提示介面如下圖所示：
完成介面詳情：
系統升級成功，系統將在10s之後立即重啓；第一次重啓時間較長，請耐心等待。--------//（10s之後執行重啓腳本）
注 1 ：自動重啓功能僅支援 Tomcat 和 exe 部署方式。如果是 Weblogic、Wildfly(JBoss)、Websphere、Docker 伺服器部署，請自行立即重啓
注 2 ：如果重啓功能未執行，請自行立即重啓。
如果升級失敗則會提示：
系統升級失敗，請聯絡 BI 技術支援（QQ：800049425 ）定位解決問題。
系統重啓完成後，查看「管理系統>登入管理」中的版本號和 jar 日期。如果已經變更為新版本，則說明升級成功，如下圖所示：
繼續檢查範本是否都可以正常預覽，如果升級過程中遇到其他問題，請聯絡 BI 技術支援（QQ：800049425 ）定位解決問題。
注意事項：
只有 5.1.5 之後的版本才會顯示小版本號。之前的版本顯示為 5.1.0 ，可以根據 JAR 的日期來確定版本。
下表為每個小版本第一次發佈的 JAR 包日期。若在 JAR 包日期在兩個版本中間，則為較早的版本。
例如，下圖是 2020.08.04 的 JAR ，因此是5.1.5的版本。
若出現升級失敗等原因，需要回退原來的舊版本
升級回退請參見：跨版本升級回退至原版本
升級後的功能變化：更新日誌
注：根據自己對應的 JAR 包和版本查看該日期及之前的功能變化.