1. 使用者需將報表系統升級至11.0版本，並在升級後的系統上進行日常的報表開發和使用操作。

2. 本次升級共提供2種方案，下方將具體說明，升級操作將由技術人員協助完成。

3. 本文的升級方案支援對Windows環境和Linux環境的報表系統進行升級。

注1：已獲取授權的 10.0 且可用的工程，升級前請先與銷售聯絡，申請遷移授權，升級後，工程需要重新授權。

注2：升級工具僅支援 JAR 包日期為 2021-11-15 及之後的FineReport 10.0版本進行升級。

注3：升級工具是針對報表工程進行升級，如果是使用者本地的設計器，需要自行下載 11.0 版本的設計器，再遠程連結到報表工程中。

注4：若需要保留 10.0 設計器中的範本、資料和相關設置，可先使用升級工具對原設計器下的 %FR_HOME%/webapps/webroot 資料夾進行升級，再拷貝到 11.0 設計器下。

由於 FineReport 功能不斷優化，産品不斷疊代升級，本文暫不提供升級工具下載連結。

請需要的客戶先聯絡帆軟銷售确認升級可行性和相關事宜，确認後可聯絡帆軟技術支援獲取升級工具。

1. 磁盤容量：由於升級工具體積較大，升級過程會對必要的檔案進行解壓，同時會對 10.0 進行整體 webroot 備份，所以升級工具所在磁盤保證剩餘容量大於 3G ，備份路徑所在磁盤保證剩餘容量大於 webroot 工程大小。

   注：如果webroot工程過大，優先考慮刪除日誌檔案（logs下若資料夾過多，也會影響升級時的備份速度，建議清理後再進行升級）。
   

2. 工程及升級工具路徑：升級工具和工程所在路徑不要包含較多特殊字符，可包含中文、英文、數字、英文括号、下劃線、英文連結符、空格（一般不要将工程放在 C 盤内）。

3. 關閉工程：升級之前請先關閉待升級的 10.0 工程。

4. 工程配置：10.0 工程如果配置了外接資料库、狀态伺服器、檔案伺服器，升級過程需要保證均可以正常連結以便更新檔案。

5. 埠占用：升級過程會占用 20216 和 20217 埠。

6. 升級環境：支援斷網升級，支援無 JDK 環境升級。

7. 工程配置：支援對單機工程和集群工程進行升級。集群升級時，只對單節點進行升級，升級成功後将升級成功的 webroot 拷貝替換至其他節點下。

   注：10.0 升級到 11.0 時，需要手動将各個節點對應的 logs 進行備份，在升級完成後再将 logs 拷貝到升級後的 webroot 資料夾下（相當於保留原各節點下 logs）再啓動工程。

8. 客製情況：10.0 工程存在客製情況，比如 JAR 客製、外置庫客製、二開、集成客製等，請提前與技術支援确認升級後是否兼容以及如何兼容适配。

9. 插件适配：當前 FR11.0 只适配了官方插件，所以第三方插件、客製插件可能會出現升級後無法使用的情況。

10. 外接資料庫：如果配置了外接資料庫，建議先将外接資料庫進行備份，備份後切換到備份資料庫升級。也可以通過備份切換到内接資料庫再升級。

11. JAR 包版本：在進行升級前需要将 JAR 包升級至 2021-11-15 及之後的日期。

    注：若未将 JAR 包未升級至 2021-11-15 就使用升級工具進行升級，在升級失敗後會出現 finedb 無法匹配的問題。

1. 在當前報表系統的測試/正式環境升級。

該升級方案需對已有的報表工程進行備份，透過升級工具對備份工程進行升級。

升級後不影響原工程，可以繼續使用FR10.0。

2. 在新伺服器環境進行升級。

該升級方案需提前準備一台和已有報表工程環境配置相同的伺服器。

將已有的報表工程遷移到新伺服器環境後，和方案1相同，備份後透過升級工具進行升級。

如原報表工程使用的是外接資料庫，需保證新的伺服器環境可成功連結外接資料庫。

1

備份原10.0工程到 10old 資料夾下。

2

選擇10版本工程的路徑以及生成備份的路徑（升級工具會再備份一次）。

3

選擇完後，點擊開始升級，出現彈窗。

4

等待一段時間後，控制台提示升級成功。

5

啟動服務，查看訪問登錄決策平台是否正常，註冊訊息頁面是否是11.0的版本號。

1

備份原10工程至 /opt/10old 下。

2

賦予升級程式執行權限。

3

輸入10版本工程的路徑。

4

輸入生成備份的路徑（升級工具會再備份一次）。

5

等待一段時間後，提示升級成功。

6

啟動服務，查看訪問登錄決策平台是否正常，註冊訊息頁面是否是11.0的版本號。

部分升級進程關鍵字如下表，若有模塊升級失敗可對應查找關鍵字确認。

1. 升級工具只對 Web 工程的升級，不提供對完整設計器的升級。設計器如果需要升級，可以先全新安裝 11.0，然後将老設計器下的工程升級到 11.0 後，将升級後的工程拷貝到新安裝的 11.0 設計器目錄下（也就是将 11.0 webapps 目錄中的 webroot 檔案替換為升級後的工程檔案）。

2. 如果一個 Web 工程已經升級過，不管是否升級成功，都不要再次運行升級工具來升級。只能通過已備份的 10.0 工程重新執行升級。

3. 升級工具不能跨版本升級，如 9.0 工程想升級到 10.0，需要把工程先升級到 10.0，再從 10.0 升級到 11.0。

4. 若 10.0 工程已經配置 tools.jar ，則不需要重新引入 tools 工具包，相反則要将【%JAVA_HOME%/jdk/lib】下的環境變量 tools.jar 放到【%TOMCAT_HOME%/lib】和或【%TOMCAT_HOME%/webapps/工程名/WEB_INF/lib】下，若不執行此步驟伺服器部署過程中會報錯 500。相關内容可參考：伺服器部署500報錯 引入 tools.jar

5. 升級工具支援官方的資料集類插件，支援列表如下。

   插件
   多維資料集
   SAP 資料集
   JSON 資料集
   MongoDB 資料集
   新 SAP BW 資料集
   螺旋資料集

6. Window 系統升級失敗時，前台操作面板會提示失敗顯示具體的失敗原因和訊息。

7. Linux 升級失敗時，會提示失敗顯示具體的失敗原因和訊息，建議使用 lsof -i:20216 和 lsof -i:20217 查找 pid，若找到 pid 則殺掉後在進行重新升級。