非容器化FineBI6.0.X小版本升級指南

6.0.5

-

請在升級前，認真查看升級注意事項，確定瞭解各個版本的相容問題：FineBI6.0.X小版本升級注意事項

在進行工程升級前，為避免升級失敗，導致工程檔案丟失無法回退等問題，請務必對原工程進行備份後再進行後續操作

請參考 工程備份還原 3.1節，對工程進行備份

1）整合的FineReport

如為FineBI與FineReport整合工程，升級FineBI即可，其中包含FineReport相關JAR，無需再單獨升級FineReport

2）獨立匹配使用的FineReport

如有完全獨立部署、需要匹配使用的獨立FineReport工程，請在升級前確認版本匹配情況：FineBI與FineReport版本適配說明

1）整合的FineDataLink

FineBI6.0.18 版本開始，不再內建 FineDataLink 相關功能依賴的 JAR 包，升級後不再支援兩者整合

如為FineBI與FineDataLink整合工程，如需升級至FineBI6.0.18及以上版本，請在升級前聯絡FineDataLink客戶成功，進行FineDataLink獨立部署

2）獨立匹配使用的FineDataLink

如有完全獨立部署、需要匹配使用的獨立FineDataLink工程，請在升級前確認版本匹配情況：FineDataLink版本適配說明

付費使用者請聯絡帆軟技術支援，索要最新/指定版本的「BI版本管理工具」

請說明你的工程環境（Linux/Linux_arm/Windows）

技術支援聯絡方式：前往「服務>線上支援」

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）確認工程是否關閉

• 如輸入「1」：無法繼續執行升級

• 如輸入「2」：可敲擊return 鍵繼續

4）選擇工程路徑

請輸入待升級工程的webroot路徑，請輸入絕對路徑，敲擊return 鍵繼續

5）檢查是否存在不相容JAR包

如檢查到待升級工程版本為6.0.18及以上，且當前工程存在fdl有用JAR包

提示「6.0.18及之後版本不支援fdl整合，請確認已拆分fdl獨立部署」（即準備步驟中的確認FineDataLink適配情況步驟是否已完成）

• 如輸入「1」：終止升級，請拆分fdl獨立部署後再嘗試升級

• 如輸入「2」：可敲擊return 鍵繼續

6）確認執行升級

• 如輸入「1」：敲擊return 鍵，即自動更換JAR包進行升級

• 如輸入「2」：終止升級

請耐心等待，直到出現提示「新版工程準備完畢，請啟動工程執行升級」，說明JAR包更換成功

請參考 關閉或重啟FineBI工程 文檔，啟動工程節點

如為叢集工程，請確定所有工程節點均執行了上一步的升級操作後再啟動工程

如為叢集工程，請先啟動一個節點，等該節點啟動成功後，再啟動其他的節點，不可以同時啟動

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適配情況步驟是否已完成）

• 點選「否」：終止升級，請拆分fdl獨立部署後再嘗試升級

• 點選「是」：進入下一步

6）確認版本資訊

請確認待升級工程版本，是否與預期相同

如目標版本正確，點選「開始更換」，即進入自動升級環節。

7）自動換JAR升級

請耐心等待出現提示「新版本準備完畢」，即為換JAR成功

點選「下一步」

此時將明確列出工程原版本和新版本，並提示「新版工程準備完畢，請啟動工程執行升級」，點選「更換完成」，自動關閉BI版本管理工具

如為叢集工程，請確定所有工程節點均執行了上一步的升級操作後再啟動工程

如為叢集工程，請先啟動一個節點，等該節點啟動成功後，再啟動其他的節點，不可以同時啟動

請在升級前，認真查看升級注意事項，確定瞭解各個版本的相容問題：FineBI6.0.X小版本升級注意事項

在進行工程升級前，為避免升級失敗，導致工程檔案丟失無法回退等問題，請務必對原工程進行備份後再進行後續操作

請參考 工程備份還原 3.1節，對工程進行備份

1）整合的FineReport

如為FineBI與FineReport整合工程，升級FineBI即可，其中包含FineReport相關JAR，無需再單獨升級FineReport

2）獨立匹配使用的FineReport

如有完全獨立部署、需要匹配使用的獨立FineReport工程，請在升級前確認版本匹配情況：FineBI與FineReport版本適配說明

1）整合的FineDataLink

FineBI6.0.18 版本開始，不再內建 FineDataLink 相關功能依賴的 JAR 包，升級後不再支援兩者整合

如為FineBI與FineDataLink整合工程，如需升級至FineBI6.0.18及以上版本，請在升級前聯絡FineDataLink客戶成功，進行FineDataLink獨立部署

2）獨立匹配使用的FineDataLink

如有完全獨立部署、需要匹配使用的獨立FineDataLink工程，請在升級前確認版本匹配情況：FineDataLink版本適配說明

使用者可以安裝最新版本 FineBI 後，在安裝目錄 %FineBI_Home%/webapps/webroot/WEB-INF/lib 下copy獲取最新版本 JAR 包。

請刪除單機工程節點/叢集每一個工程節點/webapps/webroot/WEB-INF/lib下，以下兩類檔案：

• 刪除netty-all-*.Final.jar（不存在可忽略）

• 刪除fdl-*-4.0.jar（不存在可忽略）

刪除impl文件

請參考 關閉或重啟FineBI工程 文檔，啟動工程節點

如為叢集工程，需要先啟動一個節點，等該節點啟動成功後，再啟動其他的節點，不可以同時啟動