升級風險項及修復方案列表- FineBI帮助文档 FineBI帮助文档

1. 概述

使用「FR和BI升級檢查」工具，進行 6.0 升級檢查時，匯出的風險項及修復方案介紹。

6.0升級前檢查步驟詳情參見：升級前檢測

2. 風險項及修復方案

檢查工具處理：是升級檢查插件自動處理

	分類	阻擋等級	處理方式	檢查內容	介面提示內容	Excel提示內容
1	配置	SUGGEST	檢查工具處理	1）有配置外置庫 2）WEB-INF/config/db.properties中hibernate.hbm2ddl.auto值是否設定為update	無需提示	檢查到系統配置hibernate.hbm2ddl.auto不為update，修改該配置參數為update，否則升級過程中無法進行配置相容升級
2	配置	WARN	手動處理	1）檢查MySQL參數max_allowed_packet需配置小於1073741824，則標記為警告項 2）檢查不到MySQL參數max_allowed_packet，則標記為警告項	WARN:配置外置庫為MySQL且參數max_allowed_packet小於1073741824，影響配置相容執行 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%';」語句查看是否修改成功。
3	配置	SUGGEST	檢查工具處理	UpdatePushConfig.open”，檢查值是否為false，標記為提示項	匯出檔案提示
4	配置	BLOCK	手動處理	獲取spider_local_root_path對應的路徑，檢查對應路徑下是否可以建立檔案	檢查到XXXX路徑下無檔案建立權限，該路徑為資料更新路徑且必須有檔案讀寫權限	檢查到XXXX路徑下無檔案建立權限，該路徑為資料更新路徑且必須有檔案讀寫權限，請使用chmod路徑給該路徑賦權，命令格式如下 chmod -R 777 xxx路徑
5	配置	BLOCK/ WARN	手動處理	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版本更新後引入加密套件，可能導致資料連結連結不上，需要按照如下文檔進行完善：JDK 升級及注意事項
6	配置	WARN	手動處理	檢查 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配置是否仍在使用，如已停止使用登入超級管理者，在智慧維運→ 叢集配置中,將狀態伺服器改為關閉狀態
7	配置	WARN	手動處理	檢查是否有當天的備份檔案	WARN : 檢查到系統近一天內無成功備份，請應答系統配置有備份	檢查到當前系統中近一天內無備份檔案，建議您備份後再進行升級：備份還原
8	驅動	WARN	手動處理	檢查外置庫為oracle11g及以上版本且lib目錄下無ojdbc8	WARN : 檢查到外置庫為oracle11g及以上的版本，建議您使用匹配的驅動ojdbc8	檢查到當前系統使用的外置庫為oracle11g及之後的版本，建議您將驅動更換為ojdbc8再進行升級，需要將ojdbc14.jar檔案更換為ojdbc8.jar和orai18n.jar兩個jar檔案
9	驅動	BLOCK	手動處理	hive、phoenix、spark、impala、TRANSWARP 、INCEPTOR安裝驅動隔離插件	BLOCK：驅動衝突阻擋	檢查到系統使用了hive、phoenix、spark、impala、TRANSWARP 、INCEPTOR等大數據平台，其使用的驅動容易和BI的代碼產生衝突，強烈建議您配置驅動隔離以保證系統的穩定運作，詳細配置方式：5.1.2 及之後版本驅動隔離插件
10	lib異常檔案	BLOCK	手動處理	commons等jar，檢查後提示刪除	BLOCK：lib異常檔案衝突阻擋	檢查到該檔案容易和BI的代碼產生衝突，需要您刪除之後重啓BI，然後進行升級
11	lib異常檔案	BLOCK	手動處理	lib下資料夾、zip檔案、重名檔案，檢查後提示刪除	BLOCK：lib異常檔案衝突阻擋	檢查到lib檔案中存在資料夾、zip檔案、重名檔案，此型別檔案極容易導致BI運作不穩定，需要您刪除之後重啓BI，然後進行升級。
12	lib異常檔案	WARN	手動處理	lib下資料夾下非txt和jar檔案認為是非法檔案，檢查後提示刪除	WARNING：lib異常檔案警告，建議刪除	檢查到lib檔案中存在非jar和非txt的檔案，可能對工程產生影響，請刪除後在升級。
13	lib異常檔案	BLOCK	手動處理	hive、phoenix、spark、impala、TRANSWARP 、INCEPTOR、hbase、maxcomputer、kylin、驅動包 hive： geronimo-jaspi、hadoop-common、hive-jdbc、xercesImpl spark： hadoop-core、hive-jdbc maxcomputer slf4j-log4j、odps-jdbc TRANSWARP -INCEPTOR TRANSWARP 、INCEPTOR hbase、phoenix phoenix impala impala kylin kylin	BLOCK：lib異常檔案衝突阻擋	檢查到lib檔案中存在hive、phoenix、spark、impala、TRANSWARP 、INCEPTOR等大數據平台的驅動，該檔案容易和BI的代碼產生衝突，需要您刪除之後重啓BI，然後進行升級
14	lib異常檔案	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，然後進行升級
15	插件	WARN	手動處理	檢查插件名存在JSD、SLN等二開插件	WARN：檢查到插件管理中存在二開插件，建議您聯絡技術支援應答新版本插件的是否相容	檢查到插件管理中存在二開插件，建議您聯絡技術支援應答新版本插件的是否相容
16	插件	WARN	手動處理	插件檢查插件名稱存在壓縮檔案名稱fr-plugin-platform-bridge，壓縮檔案名稱com.tptj.plugin.hg.platform.bridge；安裝檔案名稱plugin-com.tptj.plugin.hg.platform.bridge 明確需升級插件	WARN：檢查到插件管理中存在單點插件，建議您聯絡技術支援獲取新版本插件	檢查到插件管理中存在單點登入插件，建議您聯絡技術支援應答新版本插件的是否相容
17	插件	SUGGEST	檢查工具處理	刪除插件plugin-com.fr.plugin.decision.data.check，壓縮檔案plugin-com.fr.plugin.decision.data.check	匯出檔案提示	檢查到插件管理中存在無效插件插件，該插件影響升級執行，會在升級過程中自動刪除
18	插件	SUGGEST	檢查工具處理	刪除插件資料集切換表bi-plugin-table-switcher-1.0.2-513.zip	匯出檔案提示	檢查到插件管理中存在無效插件插件，該插件影響升級執行，會在升級過程中自動刪除
19	插件	SUGGEST	檢查工具處理	刪除插件儀表板預設選擇表格fr-plugin-default-widget-type-1.0.0.zip	匯出檔案提示	檢查到插件管理中存在儀表板預設選擇表格插件，新版本已包含該功能，會在升級過程中自動刪除
20	插件	SUGGEST	檢查工具處理	刪除com.fr.plugin.platform.safelogin	匯出檔案提示	檢查到插件管理中存在9.0版本插件，當前系統為10.0版本，該插件對系統穩定性產生隱患，已自動刪除
21	插件	WARN	手動處理	檢查插件名稱是否存在 name : 多ldap登入 id不為： com.fr.plugin.decision.multi.ldap.passport 提示升級後需要重新配置	匯出檔案提示	檢查到插件管理中存在 “ 多域LDAP認證 ” 插件，該插件新版本功能邏輯發生變更，需手動進行調整，詳見說明文檔：多域LDAP認證
22	插件	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版本，該插件對系統穩定性產生隱患，已自動刪除
23	插件	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	匯出檔案提示	檢查到插件管理中存在舊版本工具插件，該插件對系統穩定性產生隱患，已自動刪除
24	插件	WARN	手動處理	檢查當前環境是否能連結到插件商城，提示升級後插件需要升級	WARN :如果可以連結提示升級後登入插件管理頁面升級對應插件升級項如果不可以連結提示開啟插件商城https://market.fanruan.com/查看已安裝插件是否有新版本更新	（有外網）升級後請登入系統，開啟插件管理頁面升級提示需要升級的插件，當前已經安裝XXX個插件，如不更新對應的插件將導致部分功能異常。或（無外網）檢查到當前環境無法連結到插件商城，請開啟插件商城查看已安裝插件是否有新版本更新，並下載對應的插件進行本地更新，當前已經安裝XXX個插件，如不更新對應的插件將導致部分功能異常。
25	插件	WARN	手動處理	插件依賴丟失可能導致的插件異常（如果該項可以實現13、14、22可以無需提示）
26	插件	suggest	檢查工具處理	刪除插件檔案名稱：plugin-com.fr.plugin.operation ID：com.fr.plugin.operation
27	插件	BLOCK	手動處理	檢查BI熱備插件啟用 plugin-bi-hot-backup	BLOCK：熱備叢集不支援升級	檢查到插件管理中啟用BI熱備插件，當前升級工具暫不支援熱備環境升級
28	插件	WARN	升級工具處理	檢查spider資料集插件 plugin-report-spider-dataset	匯出檔案提示	檢查到插件管理中存在Spider資料集，6.0暫不支援此功能，會在升級過程中禁用
29	插件	SUGGEST	升級工具處理	刪除驅動隔離插件 plugin-decision-driver-loader https://git.fanruan.com/fanruan/demo-driver-loader/src/master	匯出檔案提示	檢查到插件管理中存在 ”XXXX“ 插件，新版本已包含該功能，會在升級過程中自動刪除
30	插件	SUGGEST	升級工具處理	刪除前端區分處理分析表插件 bi-plugin-classify-table	匯出檔案提示	檢查到插件管理中存在 ”XXXX“ 插件，新版本不再區分處理分析表，會在升級過程中自動刪除
31	插件	SUGGEST	升級工具處理	刪除BI範本存取socket插件 plugin-bi-websocket-visit	匯出檔案提示	檢查到插件管理中存在 ”XXXX“ 插件，新版本已包含該功能，會在升級過程中自動刪除
	插件	SUGGEST	升級工具處理	HTTPS_SameSite_跨域 com.fr.plugin.decision.cookie.check	匯出檔案提示	檢查到插件管理中存在 ”XXXX“ 插件，新版本已包含該功能，會在升級過程中自動刪除
	插件	SUGGEST	升級工具處理	資料集中SQL可全螢幕 com.fr.solution.plugin.better.sql.editor	匯出檔案提示	檢查到插件管理中存在 ”XXXX“ 插件，新版本已包含該功能，會在升級過程中自動刪除
	插件	SUGGEST	升級工具處理	新手引導 com.fr.plugin.user.guide	匯出檔案提示	新版本已內建
32	插件	SUGGEST	升級工具處理	BI欄位分組插件 com.finebi.plugin.fieldgroup	匯出檔案提示	不再支援此插件
33	插件	SUGGEST	手動處理	刪除BI範本螢幕自適應 plugin-bi-screen-adaptive 升級後自動更新為BI範本螢幕自適應plus：plugin-bi-show-adaptive	匯出檔案提示	檢查到插件管理中存在 ”XXXX“ 插件，新版本已不支援該插件，會在升級過程中自動刪除；如需使用，請於插件商城下載“BI範本螢幕自適應plus”插件
34	資料	WARN	手動處理	檢查自訂函式class的規範性	WARN：自訂函式xxx無法序列化	檢查到系統中存在自訂函式xxxxx，該函式編寫不規範導致無法序列化，請重新修改適配。
35	資料	WARN	手動處理	檢查到使用者自助資料集下Excel表使用了自循環列與行列轉換	WARN：使用者自助資料集下的Excel表升級後不再支援自循環列與行列轉換步驟	檢查到XX使用者自助資料集的xxExcel表存在行列轉換/自循環列步驟，建議行動到公共資料
36	資料	WARN	手動處理	檢查複合過濾組件參數使用了過濾組件	WARN：複合過濾組件不再支援引用元件參數的用法	檢查到複合過濾組件x使用到了過濾組件的參數用法，建議調整不含過濾組件參數的過濾方法
37	環境	BLOCK/ WARN	手動處理	磁碟空間檢查<1g，標記為阻擋項檢查不到磁碟空間，標記為警告項		檢查到當前磁碟剩餘空間不足1G，請確定磁碟空間大於1G再進行升級，您可以先清理磁碟空間然後進行升級”
38	環境	WARN	手動處理	是否發生升級回退		檢查到您系統曾經發生升級未按照文檔回退配置內容，該操作可能產生髒資料，強烈建議您先測試環境進行升級驗證
39	環境	BLOCK/ WARN	手動處理	檢查外置庫DDL權限缺失，標記為阻擋項		檢查到您系統使用外置庫且當前使用者無外置庫表的增刪改查（DDL）權限，建議您聯絡資料庫維運人員修改對應權限後再進行升級
40	環境	BLOCK/ WARN	手動處理	檢查外置庫編碼 mysql編碼不為utf8或utf8mb4，標記阻擋 SQL server編碼不為為Chinese_PRC_CS_AS，如果是Chinese_PRC_CI_AS標記為warn，其他的為BLOCK		檢查外置庫編碼不為要求的編碼
41	環境	WARN	手動處理	檢查當前環境是否為叢集環境，如果是提示更新nginx	WARN :檢查到當前環境為叢集環境，升級後請參考說明文檔：版本升級Nginx配置指導更新nginx轉發配置	WARN :檢查到當前環境為叢集環境，升級後請參考說明文檔：版本升級Nginx配置指導更新nginx轉發配置
42	環境	SUGGEST	手動處理			升級後需清理瀏覽器快取
43	環境	BLOCK	手動處理	檢查運作環境是否存在msvcr120.dll		msvcr120.dll運作庫不存在，需要安裝x64版本的 Visual Studio 2010 (VC 10.0) 之後再進行升級, 可參考微軟說明文檔：點選進入

已经是第一篇

已经是最后一篇

有帮助
没帮助
只是浏览
圖片不清晰
用語看不懂
功能說明看不懂
操作說明太簡單
內容有錯誤

中文（简体） English 日本語

中文（繁體）

升級風險項及修復方案列表

1. 概述

2. 風險項及修復方案

附件列表