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