適用於 5.1.1 升級到 5.1.2、5.1.3、5.1.5 版本在升級前進行準備工作。
對應的升級文檔參見:5.1.1-5.1.5升級指南
升級版本應答及每個版本對應的文檔索引參見:升級指南索引
5.1.5 之前的版本升級則按照流程進行操作。
歷史版本升級會有一些不相容的問題。因此,升級前建議調整風險場景,降低升級風險。
首先,使用者需要對自己的 FineBI 工程進行評估。步驟如下所示:
填寫 申請升級問卷 ,聯集傳系統風險分析結果 Excel。
填寫完升級問卷後,帆軟技術支援將會為您評估升級風險,三個工作日內給您答覆;或者直接聯絡技術支援 QQ(800049425)。
關於 FineBI 5.1.5 版本直連與抽取雙引擎獨立說明請參見文檔:直連與抽數獨立說明
風險項及修改方式如下表所示:
當前的使用方式會導致進行大量記憶體計算,嚴重拖累系統效能,還會增加記憶體上限溢位導致當機的風險
自 BI 5.1.5 版本(jar:2020-08-04)開始,將對直連模式和抽取模式進行拆分,不再支援抽取與直連模式的表配置聯動關係,並且直連模式將不再支援跨庫聯動
如果這些資料表來自不同的資料源(資料庫),直連模式下將無法再聯動使用
「轉為抽取」方式 1 :升級前將這些資料錶轉為抽取模式
「需要保留實時性」方式 2 :升級過程中將會自動斷開之間的聯動關係,保持資料表可單獨使用
自 BI 5.1.5 版本(jar:2020-08-04)開始,直連模式(實時化)的資料表,將不再支援該功能
「需要保留實時性」方式 2 :
如果該表為 Excel 資料集,將無法保留實時性效果,升級會自動轉為抽取模式。
如果該表為 SQL 資料集,升級前將需改變的欄位型別的透過修改 SQL 的方式調整 SQL 資料集
如果該表為 DB 資料集。先使用「BI清理工具」將 DB 資料集轉製為 SQL 資料集,再參考上述操作進行修改
自BI5.1.5版本(jar:2020-08-04)開始,直連模式(實時化)的資料表,將不再支援該功能
該功能導致底層結構會導致嚴重效能問題,BI 5.1.5 版本(jar:2020-08-04),暫時不再支援該功能
BI 5.1.6 版本(jar:2020-09-30),該功能從「分組彙總步驟」調整至「新增列步驟」,並優化了之前的效能問題
升級完成後,需要重新操作在「自助資料集-新增列」中新增需要複製的分組;並調整相應的儀表板
自BI5.1.5版本(jar:2020-08-04)開始,基於直連模式(實時化)資料表製作的組件或儀表板,將不再支援某些特定的日期過濾方式
不再支援的特定的過濾方式如下:「日期欄位」設定「包含/不包含、開頭是/結尾是、開頭不是/結尾不是」
「轉為抽取」方式1:升級前將對應的資料錶轉為抽取模式
「需要保留實時性」方式2:升級前將所使用的過濾條件刪除,並透過其他條件進行替代,實現之前過濾要求
如果這些該聯動路徑上,存在跨越直連和抽取兩種模式的權限配置;那麼這些權限也將隨之失效。需要升級完成後重新進行權限配置操作
權限失效情況如下:1、直連模式的資料表,權限設定時使用了抽取模式的表,進行權限配置。2、抽取模式的資料表,權限設定時使用了直連模式的表,進行權限配置
「轉為抽取」方式1:升級前將這些資料錶轉為抽取模式
「需要保留實時性」方式2:升級過程中會斷開這類聯動關係,權限也會隨之失效;升級完成後根據需要重新配置
自 FIneBI 5.1.5 版本開始,將對直連模式和 spider 模式進行拆分,將不再支援直連模式表和抽取模式表建立聯動關係,不再支援抽取和直連混用的自助資料集。對於現有的聯動與混用資料表,升級過程中將自動檢索現存的所有「混用模式資料表」;並找到這些資料表的「直連模式的父表」,透過複製SQL資料集的方式,對這些父表進行copy,複製其資料結果;來實現「抽取」與「直連」模式的分離調整。具體方式如圖所示:
隨着「抽取」與「直連」模式的分離,升級後「抽取」與「直連」模式資料表之間的聯動關係也將隨之丟失。如果這些該聯動路徑上,存在跨越直連和抽取兩種模式的權限配置;那麼這些權限也將隨之失效。需要升級完成後重新進行權限配置操作。
權限失效情況如下:1、直連模式的資料表,權限設定時使用了抽取模式的表,進行權限配置。2、抽取模式的資料表,權限設定時使用了直連模式的表,進行權限配置。
與此同時,直連模式的資料表將不再支援【自循環列】、【行列轉換】、【更改欄位型別】、【排序】、【自訂分組】、【跨資料源聯動】等造成嚴重記憶體化問題的功能,使用了這些功能的資料表將被轉至為抽取模式。
如果使用了「抽取」與「直連」兩種模式,升級完後系統將實現兩種模式的資料準備模組完全獨立。使用者依舊可以使用統一的儀表板來新增不同模式的資料,並透過儀表板進行聯動分析。
升級前請應答備份好 webroot 資料夾,如果配置了 外接資料庫 請同時備份平台配置。系統升級過程都會順利進行,為確定萬無一失,做好系統備份可以在突發情況發生時,快速切換。
使用者需要參照 跨版本升級後回退至原版本 判斷自己配置的是內建資料庫還是外接資料庫,並對照文檔備份需要的內容。
注:版本升級不支援直接回退,請務必進行備份完成後再執行升級。
1)關閉 FineBI 。
2)內建資料庫的工程備份:若升級前工程沒有配置過外接資料庫,則需要備份好「webroot」資料夾,在 webroot 路徑:%FineBI%\webapps\webroot下copy工程。如下圖所示:
注:備份會以壓縮資料夾形式存放,或者把備份檔案copy到非工程所在目錄,確定 Web 容器裏只有一個名為 webroot 的工程。
外接資料庫的工程備份:若升級前配置了外接資料庫,需要進入「管理系統>智慧維運>備份還原」,在「平台配置」、「報表範本」、「BI範本」、「jar 包」、「插件」 Tab 欄下分別點選「手動備份」,更多詳情資訊見:備份還原
詳情參見:升級前必須檢查內容
注:適用於 5.1.3 升級到 5.1.5。
記錄權限配置>業務包權限處「登入使用者所在欄位」的配置,升級後需要手動重新配置。
需要修改-Duser.language和-Duser.country为 zh 和 CN
注:伺服器系統語言和地區必須是 zh 和 CN。
修改%FineBI_HOME%\bin目錄下的檔案 finebi.vmoptions 檔案,修改內容如下:
-Duser.language=zh-Duser.country=CN
在%Tomcat_HOME%\bin\catalina.sh 第一行添加:
JAVA_OPTS = "$JAVA_OPTS -Duser.language=zh -Duser.country=CN"
進入控制檯,加上參數 -Duser.language=zh -Duser.country=CN
5.1.2 版本:基礎表A做了編輯(修改了欄位型別,取消勾選欄位),資料庫中修改基礎表A的某個欄位型別,更新基礎表A,可以更新成功。
升級到 5.1.5 版本:更新基礎表 A,更新失敗,需要重新編輯儲存基礎表 A 。
1)5.1.3 升級到 5.1.5,如果原來在版本做過刪除業務包的操作,可能會有無效行權限的髒資料,需要對該表中 tableID 為 null 的髒資料刪除,否則可能導致遷移外接資料庫到 oracle 失敗。
注:該問題已在5.1.2升級5.1.5工具進行處理。
2)2020-09-01 的 5.1.5 版本新增功能 組件切換資料表;升級到 2020-09-01 及之後的版本,需要刪除 BI切換表插件,才可以正常使用儀表板詳細設定介面的切換表功能。
3)2020-05-15 版本的 5.1.3 升級到 5.1.5,建立儀表板會出現報錯 500 的現象,原因是範本存取 socket 插件無法使用備用方案,需要升級,此插件現在無法線上升級,需要刪除後商城重新安裝。
關於升級前的其他檢查,可參見文檔:5.1.x升級FAQ
準備工作結束後前往升級,參考文檔:5.1.1-5.1.5升級指南
叢集升級,請參考文檔:「叢集」5.1.1-5.1.5升級指南