1. 概述
1.1 版本
| FineBI 版本 | 功能變動 |
|---|---|
| 5.1 | - |
| 5.1.13 | 升級時支援自動備份外接資料庫 |
1.2 適用版本
適用於 5.1.5 以及 5.1.5 之後的版本升級。
1.3 升級前準備
若您是未聯絡帆軟銷售經理的個人使用者，可致電 400-8118890 轉1 與帆軟商務聯絡獲取相關資訊；若您已與帆軟銷售經理有對接，可透過 FineBI 技術支援（QQ：800049425）獲取新版本 JAR 檔案下載連結和 「BI升級」插件包。
在「管理系統>插件管理」中安裝「BI升級」插件包。
2. 升級步驟
2.1 進行系統備份
注：版本升級不支援直接回退lib檔案，請務必進行備份完成後再執行升級；5.1.14 以及之後的版本重啓後會檢查配置與 JAR 版本是否一致，如檢查不匹配將無法正常啟動，需更換同版本lib在進行重啓。
進入「管理系統>智慧維運>備份還原」，在「平台配置」、「報表範本」、「BI範本」、「jar 包」、「插件」 Tab 欄下分別點選「手動備份」，如下圖所示：
若「管理系統>智慧維運>備份還原」頁面提示為當前環境為內建庫不支援備份還原功能，表示該工程為舊版本 BI，暫不支援平台備份，需手動將%FineBI%/webroot/WEB-INF下的 dashboards、embed、lib、plugins、reportlets、resources 六個資料夾copy到%FineBI%/webroot/backup目錄下。
更多詳情資訊見：備份還原
自動備份方法：
若不想每次進行都手動進行備份，5.1.13 之後的版本支援在升級過程中自動進行備份。
使用 FINE_CONF_ENTITY視覺化配置 插件，點選「管理系統>系統工具」，選擇「自訂參數配置」，輸入系統參數名「BIUpdateConfig.autoBackup」和系統參數值「true」，點選儲存，如下圖所示：
則會在升級時自動判斷是否有升級當天的外接資料庫備份，若沒有則會在升級前自動進行備份。
注：自動備份只備份外接資料庫，是用於防止忘記備份外接資料庫的情況，若需要回退還是需要手動備份的 webroot 資料夾，詳情參見：
2.2 建立 newJarPath 檔案
如果你的 BI 工程使用了單點登入或者二次開發相關的插件，請執行該步驟。
此步驟是為了檢查升級後插件依賴是否會丟失，如果升級後插件不能使用，則會在風險項中提示：請先刪除插件，升級後安裝最新插件。
注：由於二次開發插件較多，不保證所有插件問題均被檢查出來，此項僅收集部分已知問題。
在 BI 安裝目錄的 WEB-INF目錄下建立一個 newJarPath 資料夾作為檢查目錄，將要升級的新版本 BI 的 Jar 包放到檢查目錄，如下圖所示：
若插件依賴缺失，會在 2.3 節檢查項中提示。
2.3 運作升級工具執行升級檢查
1）點選 「BI 升級」進入BI升級介面，升級工具會先進行系統升級前檢查，將升級中存在的風險項列出，進入「升級注意事項」，閱讀注意事項並點選「下一步」，如下圖所示：
應答完成工程備份後，點選「確定」，如下圖所示：
進入「系統升級檢查」，系統自動檢查風險項，可以匯出查看升級詳情，如下圖所示：
風險項分為三類：升級阻擋項和升級建議項，如下所示：
| 風險項 | 說明 |
|---|---|
| 升級阻擋項（BLOCK） | 該檢查的風險項大概率會導致升級失敗，升級後系統無法使用，需要在升級前進行處理，如不處理則無法進行下一步升級。比如：磁碟空間不足、外置庫無表的編輯權限、存在升級後容易產生故障的配置等。 |
升級建議項（WARNNING） 注：在檢查完成後的 BI 介面上顯示。 | 該檢查的風險項建議進行修改，不會引發系統故障，但會對後續某些功能使用產生一定影響。比如：插件升級、驅動更新提示。 |
升級建議項（SUGGEST） 注：BI 介面不顯示檢查結果，需要匯出 Excel 查看。 |
使用者需要根據自己的情況對這些風險項進行處理後在進行升級。
詳細風險項以及處理方案見 ：升級風險項及處理方法
2.4 上傳 JAR 檔案並執行升級
2.4.1 單節點環境
將阻擋風險項處理完成後點選「開始升級」，進入上傳 Jar 檔案介面，將升級所需的壓縮檔案進行上傳，並輸入工程 Jar 路徑以及當前工程啟動路徑，點選「執行」，如下圖所示：
注1：當「當前工程的jar路徑」、「上傳zip檔案包」、「當前工程的啟動路徑」任意一個沒有輸入時，執行按鈕灰化不可點選。
注2：上傳zip包沒有執行結束時，執行按鈕灰化。
2.4.2 叢集環境
若當前是叢集環境，則不能使用自動更換 JAR 功能。
由於叢集環境有多個節點，處理不同的請求，在開啓多個節點的情況下，上述請求會被轉發到不同的節點處理，會導致升級有誤；因此對於叢集需要手動更換 JAR 檔案到%FineBI%/webroot/WEB-INF/lib目錄
2.5 重啓工程
單機工程直接重啓即可。
叢集工程更換 JAR 檔案後，先啟動一個節點，等該節點啟動成功後，再啟動其他的節點，不可以同時啟動。
2.6 升級後驗證
1）系統升級完成後建議分別使用超管&普通使用者登入系統查看是否能正常登入，確定升級成功。
2）系統升級完成後建議登入系統，切換插件管理介面，將提示需升級的插件進行線上升級，如遇問題請勿回退。
3）系統升級完成後建議登入系統，點選常用資料集進行資料更新驗證資料集更新是否可用以及更新後資料是否準確。
3. 注意事項
3.1 升級後重啓啟動慢
在升級後第一次重啓會對配置進行相容升級，相容過程可能較慢請耐心等待，過程中可以查看日誌，有匯出即為正常升級相容，請勿中途 kill 進程再重啓，否則會導致升級失敗。
3.2 升級嚴重故障回退方案
詳情參見：跨版本升級後回退至原版本。