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