[單機]5.X-6.0.5升級

1.1 功能介紹

幫助使用者順利從 5.1 升級到 6.0 BI工程。

1.2 升級流程

1）閱讀 6.0 升級相容：6.0 相容說明

FineBI 對產品進行了持續優化升級，2022 年 6.0 版本全新來襲。瞭解從 5.1 到 6.0 有哪些變化。

2）進行升級前檢查：升級前檢查

對 5.1 工程進行備份、檢查升級風險項和修復。

3.1 關閉BI工程

1）關閉BI工程。

常見問題：Windows系統直接關閉工程後，往往防當機插件進程還在，會導致升級過程更換 jar 失敗，進而升級失敗。

處理方法：1）進入cmd；2）輸入 jps ，查看是否有名稱為 Operation 的進程；3）如果有，輸入taskkill /f /pid %pid%，殺掉名稱為Operation的進程。如下圖所示：

驗證是否完全關閉的方法：修改%FineBI%\webapps\webroot\WEB-INF下的 lib 檔案的檔案名稱稱，能修改，則說明工程已經完成關閉。（修改後要記得名稱改回來）

3.2 解壓升級工具

1）解壓升級工具；

2）修改記憶體

進入fine-bi-upgrade-windows\bin目錄下，編輯config.properties檔案，修改增加記憶體。如果不修改，預設記憶體是機器記憶體的 1/4 。

注：升級工具需要根據 BI 工程實際情況修改記憶體。升級工具運作記憶體至少 12 G，最好是 BI 工程配置記憶體的1.5倍，具體可根據伺服器可用記憶體設定。

3.3 執行升級

1）雙擊start-upgrade.bat，運作工具。選擇工程「已關閉」後，才能選擇「下一步」。如下圖所示：

2）選擇工程路徑：%FineBI%\webapps\webroot（工程路徑選到webroot）後，點選「開始檢查」。如下圖所示：

3）進入檢查介面，檢查期間「下一步」按鈕灰化，檢查完成後，點選「下一步」。如下圖所示：

4）點選下一步後，進入模式選擇介面，選擇模式後，點選“開始升級”，模式選擇介紹見附錄。

5）等待升級完成，升級完成後，點選「下一步」。如下圖所示：

注：此過程時長跟配置庫大小和配置庫效能有關，只要介面上沒有報錯，可以繼續等待。

6）完成升級。介面如下圖所示：

3.4 查看升級報表

升級日誌：在fine-bi-upgrade-windows\logs路徑下的 upgrade.log 檔案；

升級過程檢查到的風險項：在fine-bi-upgrade-windows\exports下。詳情見：升級後匯出的風險項說明

3.5 啟動工程

1）工程啟動後，存取工程自動進入介面如下圖所示，必須點選「立即全局更新」。如下圖所示：

2）點選後會觸發所有配置了隨父表更新的自助資料集的更新，等待更新完成。如下圖所示：

更新完成之前，存取任何工程 url 都會跳轉到此頁面，直到更新完成，方可正常存取工程。

注：只更新自助資料集，不會更新基礎表。

1）關閉 BI 工程。

2）解壓升級工具，進入fine-bi-upgrade-linux\bin目錄下，編輯 config.properties 檔案，修改增加記憶體。如果不修改，預設記憶體是機器記憶體的 1/4 。

注：升級工具需要根據 BI 工程實際情況修改記憶體。升級工具運作記憶體至少 12 G，最好是 BI 工程配置記憶體的1.5倍，具體可根據伺服器可用記憶體設定。

3）行動到fine-bi-upgrade-linux\bin目錄下，輸入命令，運作升級工具；輸入 2 並回車，運作升級工具。如下圖所示：

./start-upgrade.sh

4）選擇工程路徑：%FineBI%\webapps\webroot（工程路徑選到webroot）後，回車，開始檢查。如下圖所示：

注：檢查進度條可能出現顯示異常，可能是連結遠端伺服器的工具版本導致。但不影響檢查，檢查完畢後會自動展示下一步。

5）檢查完成後，選擇模式，輸入數字，回車。如下圖所示：

6）開始升級，等待升級進度條結束；

注：檢查進度條可能出現顯示異常，可能是連結遠端伺服器的工具版本導致。但不影響檢查，檢查完畢後會自動展示下一步。

7）查看升級報表

升級日誌：在fine-bi-upgrade-linux\logs路徑下的 upgrade.log 檔案；

升級過程檢查到的風險項：在fine-bi-upgrade-linux\exports下。詳情見：升級後匯出的風險項說明

8）啟動工程

啟動工程後，點選「立即全局更新」。操作同本文 3.5 節。

升級模式有 4 種，選擇升級到 6.0 ，直連和抽取業務包的區分策略。詳情如下：

模式	模式說明	升級前業務包	升級後業務包
以抽取為主	抽取：業務包結構保留； 直連：業務包收起，在「公共業務包-直連」節點下	抽取資料介面： 直連資料介面：
以直連為主	直連：業務包節構保留； 抽取：業務包收起，在「公共業務包-抽取」節點下
兩者都收起	抽取：在「公共業務包-抽取」節點下 直連：在「公共業務包-直連」節點下
兩者合併處理	抽取和直連業務包結構保留，合併展示 注：若直連跟抽取重名的分組/業務包，則直連的分組/業務包後加上後綴「直連」