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) 之後再進行升級, 可參考微軟說明文檔：點選進入 |
