10-11升級前準備

本文將詳細的介紹 Finereport 10.0 升級至 11.0 前，需要做的準備工作。

2.1 升級技術協助

Finereport 大版本升級技術協助，目前由專屬的升級團隊負責，有升級的需求，請QR code聯絡工作人員line溝通。

2.2 升級工具獲取

由於 FineReport 功能不斷優化，產品不斷疊代升級，因此升級工具也在不斷更新，本文暫不提供升級工具下載連結。您可以選擇直接提交風險評估書，屆時升級團隊會給您發放；或者聯絡技術支援獲取。技術支援聯絡方式：前往「服務」。

1）升級前請先仔細閱讀：10-11 相容說明 。

2）10-11需要使用升級工具：FineReport 10.0 與 11.0 版本之間沒有內建升級功能，使用者需要使用 10-11 升級工具完成。升級工具使用可參考：10-11 升級工具 。

3）FineReport 9.0 升級 FineReport 11.0：要先升級到 FineReport 10.0，再升級至 11.0。FineReport 9.0 升級 FineReport 10.0 可聯係技術支持。

4）FineReport 與 FineBI 整合使用的使用者：請您在升級前仔細閱讀：FineBI與FineReport版本適配說明 。

5）升級前務必備份：使用者在進行升級前，為避免升級失敗出現檔案丟失的情況，請將所需要的檔案進行備份後再升級。備份可參考：文檔第3節 。

6）10-11授權變更：因大版本的授權不能共用，授權也需要升級，進行10-11前，請務必和對應的銷售進行應答，否則會導致升級後授權無法使用。

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

8）工程及升級工具路徑：升級工具和工程所在路徑不要包含較多特殊字元，可包含中文、英文、數字、英文括號、底線、英文連結符、空格（一般不要將工程放在 C 盤內）。
9）工程配置：10.0 工程如果配置了外置庫、狀態伺服器、檔案伺服器，升級過程需要保證均可以正常連結以便更新檔案。
10）埠占用：升級過程會佔用 20216 和 20217 埠。

11）升級環境：支援斷網升級，支援無 JDK 環境升級。
12）JAR 包版本：在進行升級前需要將 JAR 包升級至 2020-08-04 及之後的日期。若未將 JAR 包未升級至 2020-08-04 就使用升級工具進行升級，將會提示報錯：

工程版本低於2020.08.04，無法升級，建議更新後再嘗試升級。
13）插件適配：當前 FR11.0 只適配了官方插件，所以第三方插件、客製插件可能會出現升級後無法使用的情況，需要提前應答。
14）客製情況：10.0 工程存在客製情況，比如 JAR 客製、外置庫客製、二開、整合客製等，請提前與技術支援應答升級後是否相容以及如何相容適配。升級工具在進行 10.0 升11.0 的時候升級工具會更換 webroot\scripts 和 webroot\upm 資料夾，若在 scripts 和 upm 資料夾下存在客製檔案（例如自訂的 js、css 檔案）需要提前備份，再升級完成後手動複製到升級後的 11.0 工程中。

4.1 備份平台配置（必做）

使用管理帳號登入數據決策系統，在「管理系統>智慧維運>備份還原>平台配置」中選中手動備份。預設備份路徑為：.../backup，備份檔案儲存在工程的 %FR_HOME%/webapps/webroot/backup 資料夾下。

4.2 備份工程檔案（必做）

注：叢集的每個節點建議都備份下。
可以備份整個 tomcat，或者%TOMCAT_HOME%/webapps 下的 webroot 工程包。建議可備份整個 tomcat，原來的 10.0  的工程在 tomcat 中，把 tomcat 複製一份，重命名為 tomcat11。
叢集有檔案伺服器的，也需要把檔案伺服器上的WEB-INF檔案進行備份。

4.3 建立資料庫表空間

注：升級前做了外接庫的必做。
1）如果升級前配置了外接庫，升級前準備一個新的表空間，建表相關文檔見：配置外接資料庫 。
2）升級前不用處理外接庫配置，直接升級即可。但是在升級工具處理後，平台迴轉為預設內建 finedb 模式。所以為了跟原先 10 的外接庫互相獨立，不影響之前的表資料，建議建立一個資料庫做遷移。待後續 11 運作穩定，可以將原先 10 的外接庫刪除。
注1：升級工具進行處理時，不會修改外接庫裏的資料，而是轉為內建表進行升級的。
注2：finedb 與資料連結的差別：升級後須知 中 2.2 節。

升級之前，如果使用了正式的授權檔案，因大版本的授權不能共用，需要對原授權進行處理，待升級成功後，再去申請新版本的正式授權。
這一步驟請聯絡升級小組的技術人員協助處理。

單機的環境如果需要將工程拿到其他環境下升級，則需要將 finedb 還原成內建 finedb 模式，避免新環境外接庫連不上而導致升級失敗。還原內建 finedb 具體操作：
1）“4.1 節備份平台配置”操作完成後，進入工程的 /webapps/webroot/backup/config/manual/ 下，找到最新的日期的資料夾（比如：2022-04-13-13:47:53，資料夾名稱是手動備份的時間），其中 config.zip 裏面存放的是轉換為內建庫模式的 finedb。
2）解壓 config.zip 檔案，將解壓後的 finedb 檔案copy到備份工程的 /webapps/webroot/WEB-INF/embed 中，更換掉之前的 finedb 資料夾（按照 tomcat10 為原始環境，tomcat11 為備份環境來看，就需要將tomcat11/webapps/webroot/WEB-INF/embed中的 finedb 更換掉）。
3）再進入備份 tomcat11/webapps/webroot/WEB-INF/config 目錄，刪除 db.properties 配置檔案（該檔案儲存了外接資料庫的配置）。
tomcat11 完成轉換為內建 finedb 模式，至此 tomcat11 和原先的 tomcat10 完全獨立，互不影響，但是不能在一個環境上同時啟動（埠占用導致不能同時啟動）。
4）再對還原內建 finedb 後的 webroot 用升級工具進行升級即可。

FineReport 11.0 版本其他的目錄使用說明，如果需要了解，請聯係技術支持。

此外，FineReport 11.0 版本新出了磁碟清理的功能，詳情見：磁碟清理 。