當前為5.1版本文檔，更多實例內容將在最新幫助文檔中展現，點選跳轉至 最新版幫助文檔。

升級風險項及處理方法

1. 環境類檢查項

檢查級別檢查內容處理方案BI介面提示匯出 Excel 提示

BLOCK/

WARNING


磁碟空間檢查<1g，標記為阻擋項

檢查不到磁碟空間，標記為警告項


提示處理方案，自行處理檢查到當前磁碟剩餘空間不足1G，請確定磁碟空間大於1G再進行升級，您可以先清理磁碟空間然後進行升級”檢查到當前磁碟剩餘空間不足1G，請確定磁碟空間大於1G再進行升級，您可以先清理磁碟空間然後進行升級”
WARNING是否發生升級回退建議先在測試環境進行升級-檢查到您系統曾經發生升級未按照文檔回退配置內容，該操作可能產生髒資料，強烈建議您先測試環境進行升級驗證

BLOCK/

WARNING

檢查外置庫DDL權限缺失，標記為阻擋項提示處理方案，自行處理-檢查到您系統使用外置庫且當前使用者無外置庫表的增刪改查（DDL）權限，建議您聯絡資料庫維運人員修改對應權限後再進行升級

BLOCK/

WARNING

檢查外置庫編碼

mysql編碼不為utf8或utf8mb4，標記阻擋

SQL server編碼不為為Chinese_PRC_CS_AS，如果是

Chinese_PRC_CI_AS標記為warn，其他的為BLOCK


提示處理方案，自行處理-

檢查外置庫編碼不為要求的編碼

WARNING檢查當前環境是否為叢集環境，如果是提示更新nginx提示處理方案，自行處理WARN :檢查到當前環境為叢集環境，升級後請參考說明文檔更新nginx轉發配置WARN :檢查到當前環境為叢集環境，升級後請參考說明文檔更新nginx轉發配置
SUGGEST---升級後需清理瀏覽器快取
BLOCK檢查運作環境是否存在msvcr120.dll提示處理方案，自行處理-

msvcr120.dll運作庫不存在，需要安裝x64版本的 Visual Studio 2010 (VC++ 10.0) 之後再進行升級, 可參考微軟說明文檔：https://docs.microsoft.com/en-US/cpp/windows/latest-supported-vc-redist?view=msvc-160。

2. 配置類檢查項

檢查級別
檢查內容處理方案 BI 介面提示匯出 Excel 提示


WARNING

1）檢查MySQL參數max_allowed_packet需配置小於1073741824，則標記為警告項


2）檢查不到MySQL參數max_allowed_packet，則標記為警告項


提示處理方案，您可自行處理


1）

WARN:配置外置庫為MySQL且參數max_allowed_packet小於1073741824，影響配置相容執行


2）WARN : 當前外置庫連結使用者無權限查詢MySQL的max_allowed_packet參數，要求參數值>=1073741824,請您自行查詢


檢查到外置庫為MySQL，且參數max_allowed_packet<1073741824,升級過程需要對配置進行相容調整，參數過小會導致配置寫入資料庫失敗，為保證升級順利進行，請您優先調整max_allowed_packet參數，調整方式如下


方案一：


MySQL 安裝目錄下的「my.ini」檔案中的[mysqld] 欄位中的「max_allowed_packet = 1M」修改為 1024M ，重啓 MySQL 即可。


方案二：


1）使用「set global max_allowed_packet = 1073741824;」 語句將「max_allowed_packet」的值設定為 1024M，無需重啓。


2）使用「show VARIABLES like '%max_allowed_packet%';」 語句查看是否修改成功。


SUGGESTUpdatePushConfig.open”，檢查值是否為false，標記為提示項

產品自動處理



FineDB中配置UpdatePushConfig.open為true，自動更改為false
BLOCK

獲取spider_local_root_path對應的路徑，檢查對應路徑下是否可以建立檔案

提示處理方案，您可自行處理檢查到XXXX路徑下無檔案建立權限，該路徑為資料更新路徑且必須有檔案讀寫權限檢查到XXXX路徑下無檔案建立權限，該路徑為資料更新路徑且必須有檔案讀寫權限，請使用chmod路徑給該路徑賦權 ，命令格式如下 chmod -R 777 xxx路徑

BLOCK/

WARNING

1）jdk版本為oracle的1.8.0.102，需先升級JDK，標記為阻擋項


2）檢查不到JDK版本資訊，標記為警告項


提示處理方案，您可自行處理

BLOCK: JDK版本低於1.8.0.102，升級後會因為JDK漏洞導致啟動異常，請您先升級JDK版本在進行BI升級


WARN : 當前無法獲取JDK版本，請您先應答JDK版本大於1.8.0.102


檢查到jdk 版本低於1.8.0.102 ，舊版本JDK存在漏洞，升級後會存在啟動當機的現象，需要更換為1.8.0.102以後版本的 jdk 再進行升級。 


JDK版本更新後引入加密套件，可能導致資料連結連結不上，需要按照如下文檔進行完善

https://help.fanruan.com/finebi/doc-view-1617.html


WARNING

檢測  FineClusterConfig.params.cluster为false

且

SystemOptimizationConfig.biClusterMasterNodeHostName  非空

hotBackConf.master 非空 

SystemOptimizationConfig.ClientMasterId 非空

hotBackConf.slave 非空


StateServerConfig.type != standone

StateServerConfig.clusterMode != false


提示處理方案，您可自行處理

WARN : 檢查當前為單機環境但是殘留叢集相關配置，需刪除殘留參數

檢查當前為單機環境但是殘留叢集相關配置，需刪除殘留參數，以下熱備參數需刪除，需連結配置庫中將fine_conf_entity表中對應參數進行修改


非空則提示需刪除ID為：SystemOptimizationConfig.biClusterMasterNodeHostName  


非空則提示需刪除ID為：hotBackConf.master  


非空則提示需刪除ID為：SystemOptimizationConfig.ClientMasterId   


非空則提示需刪除ID為：hotBackConf.slave  


以下為redis配置參數，請應答redis配置是否仍在使用，如已停止使用登入超級管理者，在智慧維運→ 叢集配置中,將狀態伺服器改為關閉狀態


WARNING檢查是否有當天的備份檔案提示處理方案，您可自行處理WARN : 檢查到系統近一天內無成功備份，請應答系統配置有備份檢查到當前系統中近一天內無備份檔案，建議您備份後再進行升級

3. 驅動檔案檢查項

檢查級別檢查內容處理方案BI 介面提示匯出 Excel 提示
WARNNING檢查外置庫為oracle11g及以上版本且lib目錄下無ojdbc8提示處理方案，您可自行處理WARN : 檢查到外置庫為oracle11g及以上的版本，建議您使用匹配的驅動ojdbc8檢查到當前系統使用的外置庫為oracle11g及之後的版本，建議您將驅動更換為ojdbc8再進行升級，需要將ojdbc14.jar檔案更換為ojdbc8.jar和orai18n.jar兩個jar檔案
BLOCKhive、phoenix、spark、impala、TRANSWARP 、INCEPTOR安裝驅動隔離插件

提示處理方案，您可自行處理

BLOCK：驅動衝突阻擋檢查到系統使用了hive、phoenix、spark、impala、TRANSWARP 、INCEPTOR等大數據平台，其使用的驅動容易和BI的代碼產生衝突，強烈建議您配置驅動隔離以保證系統的穩定運作，詳情參見：驅動隔離插件

4. lib 檔案檢查項

檢查級別檢查內容處理方案BI 介面提示匯出 Excel 提示
BLOCKcommons等jar，檢查後提示刪除提示處理方案，自行處理BLOCK：lib異常檔案衝突阻擋檢查到該檔案容易和BI的代碼產生衝突，需要您刪除之後重啓BI，然後進行升級
BLOCKlib下資料夾、zip檔案、重名檔案，檢查後提示刪除提示處理方案，自行處理BLOCK：lib異常檔案衝突阻擋檢查到lib檔案中存在資料夾、zip檔案、重名檔案，此型別檔案極容易導致BI運作不穩定，需要您刪除之後重啓BI，然後進行升級。
WARNINGlib下資料夾下非txt和jar檔案認為是非法檔案，檢查後提示刪除提示處理方案，自行處理WARNING：lib異常檔案警告，建議刪除

檢查到lib檔案中存在非jar和非txt的檔案，可能對工程產生影響，請刪除後在升級。

BLOCK

hive、phoenix、spark、impala、TRANSWARP 、INCEPTOR、hbase、maxcomputer、kylin、驅動包

提示處理方案，自行處理BLOCK：lib異常檔案衝突阻擋檢查到lib檔案中存在hive、phoenix、spark、impala、TRANSWARP 、INCEPTOR等大數據平台的驅動，該檔案容易和BI的代碼產生衝突，需要您刪除之後重啓BI，然後進行升級
BLOCK檢查是否存在fr-xxxx-8.0、fr-xxxx-9.0、fr-xxxx-4.0、fr-xxxx-4.1、fr-slf4j-frlog4j提示處理方案，自行處理BLOCK：lib異常檔案衝突阻擋檢查到lib檔案中存在8.0、9.0版本的jar檔案，該檔案容易和BI的代碼產生衝突，需要您刪除之後重啓BI，然後進行升級

5. 插件檢查項

檢查級別檢查內容處理方案BI 介面提示匯出 Excel 提示
WARNING檢查插件名存在JSD、SLN等二開插件提示處理方案，自行處理WARN：檢查到插件管理中存在二開插件，建議您聯絡技術支援應答新版本插件的是否相容檢查到插件管理中存在單點登入插件，建議您聯絡技術支援應答新版本插件的是否相容
WARNING

插件檢查插件名稱存在

壓縮檔案名稱fr-plugin-platform-bridge，

壓縮檔案名稱com.tptj.plugin.hg.platform.bridge；安裝檔案名稱plugin-com.tptj.plugin.hg.platform.bridge

明確需升級插件

提示處理方案，自行處理WARN：檢查到插件管理中存在單點插件，建議您聯絡技術支援獲取新版本插件檢查到插件管理中存在單點登入插件，建議您聯絡技術支援應答新版本插件的是否相容
SUGGEST刪除插件plugin-com.fr.plugin.decision.data.check，壓縮檔案plugin-com.fr.plugin.decision.data.check

自行處理


匯出檔案提示檢查到插件管理中存在無效插件插件，該插件影響升級執行，會在升級過程中自動刪除
SUGGEST刪除插件資料集切換表插件

自行處理

匯出檔案提示檢查到插件管理中存在無效插件插件，該插件影響升級執行，會在升級過程中自動刪除
SUGGEST刪除插件儀表板預設選擇表格插件

自行處理


匯出檔案提示檢查到插件管理中存在儀表板預設選擇表格插件，新版本已包含該功能，會在升級過程中自動刪除
SUGGEST删除com.fr.plugin.platform.safelogin

自行處理


匯出檔案提示檢查到插件管理中存在9.0版本插件，當前系統為10.0版本，該插件對系統穩定性產生隱患，已自動刪除
WARNING

檢查插件名稱是否存在

name :  多ldap登入

id不為： com.fr.plugin.decision.multi.ldap.passport

提示升級後需要重新配置

提示處理方案，自行處理匯出檔案提示檢查到插件管理中存在 “ 多域LDAP認證 ” 插件，該插件新版本功能邏輯發生變更，需手動進行調整
SUGGEST

刪除插件名稱是否存在plugin-com.finebi.memory-1.0.5、plugin-com.finebi.memory-1.0.5

刪除插件名稱是否存在plugin-com.finebi.memory-1.0.6、plugin-com.finebi.memory-1.0.6

自行處理

匯出檔案提示檢查到插件管理中存在舊版本記憶體管理插件，當前系統為10.0版本，該插件對系統穩定性產生隱患，已自動刪除
SUGGEST

壓縮檔案名稱fr-plugin-bi-inspector id ：com.finebi.plugin.bi.inspector 安装文件名：plugin-com.finebi.plugin.bi.inspector


壓縮檔案名稱fr-plugin-bi-cleaner id ：com.finebi.plugin.bi.cleaner 安裝檔案名稱：plugin-com.finebi.plugin.bi.cleaner

自行處理

匯出檔案提示檢查到插件管理中存在舊版本工具插件，該插件對系統穩定性產生隱患，已自動刪除
WARNING檢查當前環境是否能連結到插件商城，提示升級後插件需要升級提示處理方案，自行處理

WARN :如果可以連結提示升級後登入插件管理頁面升級對應插件升級項


如果不可以連結提示開啟插件商城https://market.fanruan.com/查看已安裝插件是否有新版本更新


（有外網）升級後請登入系統，開啟插件管理頁面升級提示需要升級的插件，當前已經安裝XXX個插件，如不更新對應的插件將導致部分功能異常。


或


（無外網）檢查到當前環境無法連結到插件商城，請開啟插件商城https://market.fanruan.com/查看已安裝插件是否有新版本更新，並下載對應的插件進行本地更新，當前已經安裝XXX個插件，如不更新對應的插件將導致部分功能異常。


WARNING插件依賴丟失可能導致的插件異常（如果該項可以實現13、14、22可以無需提示）提示處理方案，自行處理
                                                                                                                                          
SUGGEST

刪除插件

檔案名稱：plugin-com.fr.plugin.operation

ID：com.fr.plugin.operation

自行處理




SUGGEST插件類資源丟失自行處理-

依賴存在丟失，請先刪除插件，升級完畢後更新最新插件

依賴存在丟失，可能影響功能




附件列表


主題： 管理员指南
已經是第一篇
已經是最後一篇