1. 概述
1.1 版本
FineBI伺服器版本 | 功能變更 |
6.0.5 | - |
| 6.0.16 | 新增版本更新推播和問題反饋入口 |
1.2 功能介紹
為滿足客戶的新需求以及完善之前版本某些功能的不足之處，我們的產品在不斷地更新迭代。
本文主要介紹FineBI工程在6.0.x小版本內（例如FineBI6.0.5升級FineBI6.0.9）升級的情況。
2. BI版本管理工具升級方案
僅面向購買了技術支援服務的付費使用者。
2.1 準備步驟
| 步驟 | 說明 | |
|---|---|---|
| 1 | 瞭解升級注意事項 | 請在升級前，認真查看升級注意事項，確定瞭解各個版本的相容問題：FineBI6.0.X小版本升級注意事項 |
| 2 | 備份工程 | 在進行工程升級前，為避免升級失敗，導致工程檔案丟失無法回退等問題，請務必對原工程進行備份後再進行後續操作 請參考 工程備份還原 3.1節，對工程進行備份 |
| 3 | 確認FineReport適配情況（沒有可忽略） | 1）整合的FineReport 如為FineBI與FineReport整合工程，升級FineBI即可，其中包含FineReport相關JAR，無需再單獨升級FineReport 2）獨立匹配使用的FineReport 如有完全獨立部署、需要匹配使用的獨立FineReport工程，請在升級前確認版本匹配情況：FineBI與FineReport版本適配說明 |
| 4 | 確認FineDataLink適配情況（沒有可忽略） | 1）整合的FineDataLink FineBI6.0.18 版本開始，不再內建 FineDataLink 相關功能依賴的 JAR 包，升級後不再支援兩者整合 如為FineBI與FineDataLink整合工程，如需升級至FineBI6.0.18及以上版本，請在升級前聯絡FineDataLink客戶成功，進行FineDataLink獨立部署 2）獨立匹配使用的FineDataLink 如有完全獨立部署、需要匹配使用的獨立FineDataLink工程，請在升級前確認版本匹配情況：FineDataLink版本適配說明 |
| 5 | 獲取BI版本管理工具 | 付費使用者請聯絡帆軟技術支援，索要最新/指定版本的「BI版本管理工具」 請說明你的工程環境（Linux/Linux_arm/Windows） 技術支援聯絡方式：前往「服務>線上支援」 |
2.2 升級步驟-Linux
| 步驟 | 說明 | |
|---|---|---|
| 1 | 關閉工程 | 請參考 關閉或重啟FineBI工程 文檔，關閉單機工程節點/叢集每一個工程節點 |
| 2 | 使用「BI版本管理工具」執行換JAR升級 | 本步驟操作，需在單機工程節點/叢集每一個工程節點伺服器均執行一次 1）上傳解壓工具 請將技術支援提供的BI版本管理工具壓縮包，上傳至工程所在伺服器 請上傳至有操作權限的目錄下並解壓，本範例上傳至/home/bi目錄下 cd /home/bi unzip fine-bi-version-manager-linux.zip
2）啟動工具 進入「BI版本管理工具」bin目錄下，執行啟動語句 cd /home/bi/fine-bi-version-manager-linux/bin/ ./start-version-manager.sh 3）確認工程是否關閉
4）選擇工程路徑 請輸入待升級工程的webroot路徑，請輸入絕對路徑，敲擊return 鍵繼續 5）檢查是否存在不相容JAR包 如檢查到待升級工程版本為6.0.18及以上，且當前工程存在fdl有用JAR包 提示「6.0.18及之後版本不支援fdl整合，請確認已拆分fdl獨立部署」（即準備步驟中的確認FineDataLink適配情況步驟是否已完成）
6）確認執行升級
請耐心等待，直到出現提示「新版工程準備完畢，請啟動工程執行升級」，說明JAR包更換成功
|
| 3 | 啟動工程 | 請參考 關閉或重啟FineBI工程 文檔，啟動工程節點 如為叢集工程，請確定所有工程節點均執行了上一步的升級操作後再啟動工程 如為叢集工程，請先啟動一個節點，等該節點啟動成功後，再啟動其他的節點，不可以同時啟動 |
2.3 升級步驟-Windows
| 步驟 | 說明 | |
|---|---|---|
| 1 | 關閉工程 | 請參考 關閉或重啟FineBI工程 文檔，關閉單機工程節點/叢集每一個工程節點 |
| 2 | 使用「BI版本管理工具」執行換JAR升級 | 本步驟操作，需在單機工程節點/叢集每一個工程節點伺服器均執行一次 1）上傳解壓工具 請將技術支援提供的BI版本管理工具壓縮包，上傳至工程所在伺服器 請上傳至有操作權限的目錄下，例如D盤 請解壓獲取「BI版本管理工具」 2）啟動工具 雙擊「BI版本管理工具」bin目錄下的「start-version-manager.bat」，即可啟動該工具
3）確認工程是否關閉
4）選擇工程路徑 請詳細閱讀升級須知（即上一節準備步驟相關內容） 請選擇待升級工程的webroot資料夾，點選進入下一步
5）檢查是否存在不相容JAR包 如檢查到待升級工程版本為6.0.18及以上，且當前工程存在fdl有用JAR包 提示「6.0.18及之後版本不支援fdl整合，請確認已拆分fdl獨立部署」（即準備步驟中的確認FineDataLink適配情況步驟是否已完成）
6）確認版本資訊 請確認待升級工程版本，是否與預期相同 如目標版本正確，點選「開始更換」，即進入自動升級環節。
7）自動換JAR升級 請耐心等待出現提示「新版本準備完畢」，即為換JAR成功 點選「下一步」
此時將明確列出工程原版本和新版本，並提示「新版工程準備完畢，請啟動工程執行升級」，點選「更換完成」，自動關閉BI版本管理工具
|
| 3 | 啟動工程 | 請參考 關閉或重啟FineBI工程 文檔，啟動工程節點 如為叢集工程，請確定所有工程節點均執行了上一步的升級操作後再啟動工程 如為叢集工程，請先啟動一個節點，等該節點啟動成功後，再啟動其他的節點，不可以同時啟動 |
3. 手動換JAR升級方案
3.1 準備步驟
| 步驟 | 說明 | |
|---|---|---|
| 1 | 瞭解升級注意事項 | 請在升級前，認真查看升級注意事項，確定瞭解各個版本的相容問題：FineBI6.0.X小版本升級注意事項 |
| 2 | 備份工程 | 在進行工程升級前，為避免升級失敗，導致工程檔案丟失無法回退等問題，請務必對原工程進行備份後再進行後續操作 請參考 工程備份還原 3.1節，對工程進行備份 |
| 3 | 確認FineReport適配情況（沒有可忽略） | 1）整合的FineReport 如為FineBI與FineReport整合工程，升級FineBI即可，其中包含FineReport相關JAR，無需再單獨升級FineReport 2）獨立匹配使用的FineReport 如有完全獨立部署、需要匹配使用的獨立FineReport工程，請在升級前確認版本匹配情況：FineBI與FineReport版本適配說明 |
| 4 | 確認FineDataLink適配情況（沒有可忽略） | 1）整合的FineDataLink FineBI6.0.18 版本開始，不再內建 FineDataLink 相關功能依賴的 JAR 包，升級後不再支援兩者整合 如為FineBI與FineDataLink整合工程，如需升級至FineBI6.0.18及以上版本，請在升級前聯絡FineDataLink客戶成功，進行FineDataLink獨立部署 2）獨立匹配使用的FineDataLink 如有完全獨立部署、需要匹配使用的獨立FineDataLink工程，請在升級前確認版本匹配情況：FineDataLink版本適配說明 |
| 5 | 獲取升級JAR包 | 使用者可以安裝最新版本 FineBI 後，在安裝目錄 %FineBI_Home%/webapps/webroot/WEB-INF/lib 下copy獲取最新版本 JAR 包。 |
3.2 升級步驟
| 步驟 | 說明 | |
|---|---|---|
| 1 | 關閉工程 | 請參考 關閉或重啟FineBI工程 文檔，關閉單機工程節點/叢集每一個工程節點 |
| 2 | 刪除冗餘JAR包 | 請刪除單機工程節點/叢集每一個工程節點/webapps/webroot/WEB-INF/lib下，以下兩類檔案：
|
| 3 | 刪除impl文件 | 請刪除單機工程節點/叢集每一個工程節點/webapps/webroot/WEB-INF/classes/com/fr/data下impl資料夾中的所有檔案（不存在可忽略） |
| 4 | 更換升級JAR包 | 請將準備步驟獲取的JAR包，上傳改寫更新到單機工程節點/叢集每一個工程節點/webapps/webroot/WEB-INF/lib下 |
| 5 | 啟動工程 | 請參考 關閉或重啟FineBI工程 文檔，啟動工程節點 如為叢集工程，需要先啟動一個節點，等該節點啟動成功後，再啟動其他的節點，不可以同時啟動 |
4. 升級後操作
4.1 檢查升級是否成功
管理者登入FineBI系統，點選「管理系統>註冊管理>版本資訊」。
可查看當前JAR版本，確認是否是自己所需的工程版本。如下圖所示：
4.2 升級插件
工程升級完成後，建議登入FineBI系統，點選「系統管理>插件管理」，對存在新版本的插件一一進行升級。
4.3 更新資料
工程升級完成後，建議登入FineBI系統，點選常用資料集進行資料更新驗證資料集更新是否可用以及更新後資料是否準確。
4.4 使用者登入
工程升級完成後，建議分別使用超管和普通使用者帳號，依次登入FineBI系統，查看是否能正常登入，確定升級成功。
