1. 概述
1.1 版本
| 報表伺服器版本 | 插件版本 | JAR包日期 | 功能變更 |
|---|---|---|---|
| 10.0 & 11.0 | 4.1 | 2020-08-04 及以後 | - |
| 4.2 | 新增檢查是否外接資料庫 | ||
| 4.3 | 新增自動備份狀態檢查 | ||
| 4.4 | 新增資訊項檢查 |
1.2 應用場景
本插件主要用於產品升級前檢查工程環境是否符合升級要求，以及存在是升級風險項，獲取升級所需要的重要資訊，避免升級時出現問題。10-11 跨大版本升級和小版本升級均試用。
2. 插件介紹
2.1 插件安裝
點選下載插件：FR＆BI 升級工具
設計器插件安裝方法請參見：設計器插件管理
伺服器安裝插件方法請參見：伺服器插件管理
2.2 操作方法
1）完成插件安裝後進入數據決策系統，可以發現左側目錄處出現「升級檢查」，如下圖所示：
2）選擇「升級檢查>升級注意事項」，仔細閱讀「進行系統備份」、「升級後重啟」兩部分內容，並根據注意事項中的內容進行系統備份，完成後即可勾選「已經閱讀完上述注意事項」，進行下一步，如下圖所示：
3）點選下一步，即將開始為您自動檢查，檢查完成後將在介面上顯示升級檢查結果，可以根據檢查內容和匯出的excel自行閱讀檢查，或是傳送給技術人員協助評估。
2.3 檢查內容說明
點選「確定」後將進行升級檢查，升級檢查級別定義如下：
阻擋項：影響升級執行，如不調整無法進行下一步升級。
警告項：不影響正常升級但是影響升級後功能使用，需升級後手動處理。
提示項：系統自動處理的隱患以及建議您升級後根據配置進行檢查項。
資訊項：記錄升級相關的環境資訊。
注：阻擋項、警告項均會在介面上出現提示，提示項需要匯出 Excel 查看。
檢查內容及提示內容如下表所示：
| 檢查項 | 提示資訊 | |
|---|---|---|
| 檢查磁碟空間 | 磁碟空間檢查小於 3G，標記為阻擋項； | 檢查到當前磁碟剩餘空間不足 3G，請確定磁碟空間大於 3G 再進行升級，您可以先清理磁碟空間然後進行升級 |
| 檢查是否是外接庫 | 檢查是否外接庫，內建庫說明為內建庫，外接庫做出提示，標記為建議項 | 檢查到是外界庫，升級工具處理升級之後，平台會轉為預設內建finedb 模式。升級之後需要重新增立新的資料庫做外接庫遷移 |
| 檢查外置庫權限 | 檢查外置庫 DDL 權限缺失，標記為阻擋項 | 外接庫 DDL 權限缺失，需要開放權限 |
| 檢查外置庫編碼 | mysql編碼不為 utf8 或 utf8mb4，標記為阻擋項； | 外置庫編碼不是要求的編碼 |
| 檢查 JDK | JDK 版本為 oracle 的 1.8.0.102，需先升級 JDK，標記為阻擋項； 檢查不到JDK版本資訊，標記為警告項； | JDK版本低於 1.8.0.102，升級後會因為 JDK 漏洞導致啟動異常，請您先升級 JDK 版本 |
| 檢查 lib 資料夾 | 檢查是否存在 fr-xxxx-8.0、fr-xxxx-9.0，或是以 .bak 結尾的 JAR 包，標記為阻擋項 | lib 異常檔案衝突阻擋，需刪除多餘 JAR 包 |
| 檢查埠 | 升級過程會佔用 20216 和 20217 埠，檢查這兩個埠是否被佔用，標記為阻擋項 | 檢查到埠被佔用，20216 和 20217 埠被佔用會導致升級失敗，需保證埠不被佔用 |
| web 容器檢查 | 檢查 web 容器版本，低於要求的版本可參考：部署環境準備，標記為阻擋項 | 檢查到web容器版本不適配，需升級版本詳見：部署環境準備 |
| 插件檢查 | 1）檢查插件是否存在二開客製：插件名存在 JSD、SLN 等二開插件，標記為警告項 | 1）檢查到插件管理中存在二開插件，建議您聯絡技術支援確認新版本插件的是否相容 |
| 自訂資源檢查 | 檢查是否引入自訂 css 檔案和 class 檔案，標記為警告項 | 檢查到有自訂樣式或是自訂類，有失效的風險，若失效則升級之後需要重新適配 |
| 自動備份狀態檢查 | 檢查 24h 內是否存在配置的備份檔案 | 檢查是否有平台備份檔案，若檢查到當前系統中平台配置最近 24h 內無備份檔案將會出現提示：檢查到當前系統中平台配置最近 24h 內無備份檔案，建議手動備份，需到「管理系統>智慧維運>備份還原>平台配置」中選中手動備份，確認是否能備份成功，若備份失敗需聯絡技術人員先解決備份問題。 |
| 部署方式 | 檢查已有的工程的部署方式 | - |
| 工作系統 | 檢查當前伺服器所用工作系統及其版本 | - |
| FineReport 是否與 FineBI 整合 | 檢查是否是 FineReport 與 FineBI 的整合 | - |
| 是否有正式授權 | - | - |
| 開發範本數量 | 檢查 reportlet 資料夾下除內建範本外的範本數量 | - |
2.4 檢查完成
完成檢查後，出現提示：升級檢查完成，請參考升級指南進行升級：https://help.fanruan.com/finereport-tw/doc-view-5176.html ，再繼續進行版本升級即可。
