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

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

3. 升級程序支援 5 種語種：簡體中文、正體中文、英文、日文、韓文。

4. 本文的升級方案支援對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 設計器下。

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

1. 由於 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

平台備份。

1. 使用管理员帳號登入決策平台，點選【管理系統】→【智慧維運】→【備份還原】→【平台設定】→【手動備份】。預設備份路徑為：【.../backup】，備份檔案儲存在工程的【%FR_HOME%/webapps/webroot/backup】資料夾下。

2

備份整個 Tomcat。

1. 原來的 10.0  的工程在 tomcat10 中，把 tomcat10 複製一份，重命名為 tomcat11 。

注：如果需要將工程拿到其他環境下升級，則需要將finedb還原成內建finedb模式，避免新環境外接庫連不上而導致升級失敗。備份 tomcat11還原內建 finedb 具體操作：

1）【平台備份】操作完成後，進入工程的【/webapps/webroot/backup/config/manual/】下，找到最新的日期的資料夾（eg：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 參考如下 3~7 步驟進行升級即可。

3

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

4

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

5

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

6

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

7

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

8

啟動 Tomcat。

1. 指令切換到【tomcat/bin】目錄下，雙擊 startup.bat 啟動 Tomcat（按照自己的啟動方式去啟動工程即可），訪問決策平台，跟原先 10.0 的訪問路徑一致。

   注：Linux啟動 Tomcat 是執行 startup.sh。
   

2. 平台訪問URL：http://IP:埠/webroot/decision（其中，webroot為工程名，decision為Servlet名）

3. 範本訪問URL：http://IP:埠/webroot/decision/view/report?viewlet=xxx.cpt或者xxx.frm

9

外接資料庫遷移。

1. 升級工具處理後，平台是預設內建 finedb 模式，如果需要遷移到自己的資料庫，需要重新遷移相關文檔見： 配置外接資料庫 。

注1：為了跟原先 FineReport 10 的外接資料庫互相獨立，不影響之前的環境，建議建立一個資料庫做遷移，後續 FineReport 11 運作穩定，可以將原先 10 的外接資料庫刪除。

注2：如果是遷移到 MySQL 資料庫，建議建立一個區分大小寫的資料庫再做遷移。

10

叢集遷移。

1. 將叢集單個節點升級後，啟動進入平台配置外接庫（如果 五.9 小節已經做了外接資料庫配置則無需再配置），具體頁面如下圖1所示。

2. 開啟叢集（開啟叢集即可，叢集配置預設保留），如下圖2所示。

3. 關閉 tomcat，複製 webroot 到另一個節點（ 必須要在配置了外接資料庫，開啟叢集后才行 ），依次啟動兩個節點 tomcat，叢集配置成功。

注1：平台備份、備份整個 Tomcat、啟動 Tomcat、外接資料庫遷移、叢集遷移操作步驟，同本文 五、升級步驟 - Windows。

注2：在備份完整個 Tomcat 後，開始使用升級工具執行以下步驟。

注3：升級成功後，參考 本文 五、8,9,10小節 啟動 Tomcat、外接資料庫遷移、叢集遷移操作步驟。

1

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

2

賦予升級程式執行權限。

注：FineUpgrade_v11_linux_xxx.sh 代表升級工具名稱。

3

輸入10版本工程的路徑。

4

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

5

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

6

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

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

關鍵字
啟動成功		Fine assist start successfully
10 版本工程開始備份		v10 backup process start
10 版本工程備份結束		v10 backup process end
備份失敗		Backup fail
資料模塊更新成功		Authority module upgrade successfully
更新資源檔案成功		Resource module upgrade successfully
插件更新日志	删除插件	remove plugin file
	安裝插件	install plugin
	更新插件	upgrade plugin
	插件模塊更新成功	Plugin module replace successfully
整體替換成功		V11 replace ok
V11 模組升級成功		V11 upgrade ok
整體升級成功		upgrade success

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. 10.0 升級到 11.0 時，備份預設跨越 schedule、backup、logs 三個目錄，若升級失敗，需要將原工程下的 schedule、backup、logs 三個檔案手動copy到備份的目錄下後，切換到備份的路徑下即可正常使用。

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

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