反饋已提交
網絡繁忙
使用者需將報表系統升級至11.0版本,並在升級後的系統上進行日常的報表開發和使用操作。
本次升級共提供2種方案,下方將具體說明,升級操作將由技術人員協助完成。
升級程序支援 5 種語種:簡體中文、正體中文、英文、日文、韓文。
本文的升級方案支援對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 相容說明。
由於 FineReport 功能不斷優化,産品不斷疊代升級,本文暫不提供升級工具下載連結。請需要的客戶先聯絡帆軟銷售确認升級可行性和相關事宜,确認後可聯絡帆軟技術支援獲取升級工具。
磁碟容量:由於升級工具體積較大,升級過程會對必要的檔案進行解壓,同時會對 10.0 進行整體 webroot 備份,所以升級工具所在磁碟保證剩餘容量大於 3G ,備份路徑所在磁碟保證剩餘容量大於 webroot 工程大小。
注:如果webroot工程過大,優先考慮刪除日誌檔案(logs下若資料夾過多,也會影響升級時的備份速度,建議清理後再進行升級)。
工程及升級工具路徑:升級工具和工程所在路徑不要包含較多特殊字符,可包含中文、英文、數字、英文括号、下劃線、英文連結符、空格(一般不要将工程放在 C 盤内)。
關閉工程:升級之前請先關閉待升級的 10.0 工程。
工程配置:10.0 工程如果配置了外接資料库、狀态伺服器、檔案伺服器,升級過程需要保證均可以正常連結以便更新檔案。
埠占用:升級過程會占用 20216 和 20217 埠。
升級環境:支援斷網升級,支援無 JDK 環境升級。
工程配置:支援對單機工程和集群工程進行升級。集群升級時,只對單節點進行升級,升級成功後将升級成功的 webroot 拷貝替換至其他節點下。
注:10.0 升級到 11.0 時,需要手動将各個節點對應的 logs 進行備份,在升級完成後再将 logs 拷貝到升級後的 webroot 資料夾下(相當於保留原各節點下 logs)再啓動工程。
客製情況:10.0 工程存在客製情況,比如 JAR 客製、外置庫客製、二開、集成客製等,請提前與技術支援确認升級後是否相容以及如何相容适配。
插件适配:當前 FR11.0 只适配了官方插件,所以第三方插件、客製插件可能會出現升級後無法使用的情況。
外接資料庫:如果配置了外接資料庫,必須備份平台配置,升級成功後,使用者需要重新遷移外接資料庫。
注:升級工具會將外接資料庫轉為內建資料庫後再進行升級,不會對資料庫表進行任何改動。
JAR 包版本:在進行升級前需要将 JAR 包升級至 2021-11-15 及之後的日期。
注:若未将 JAR 包未升級至 2021-11-15 就使用升級工具進行升級,在升級失敗後會出現 finedb 無法匹配的問題。
在當前報表系統的測試/正式環境升級。
該升級方案需對已有的報表工程進行備份,透過升級工具對備份工程進行升級。
升級後不影響原工程,可以繼續使用FR10.0。
在新伺服器環境進行升級。
該升級方案需提前準備一台和已有報表工程環境配置相同的伺服器。
將已有的報表工程遷移到新伺服器環境後,和方案1相同,備份後透過升級工具進行升級。
如原報表工程使用的是外接資料庫,需保證新的伺服器環境可成功連結外接資料庫。
使用管理员帳號登入決策平台,點選【管理系統】→【智慧維運】→【備份還原】→【平台設定】→【手動備份】。預設備份路徑為:【.../backup】,備份檔案儲存在工程的【%FR_HOME%/webapps/webroot/backup】資料夾下。
原來的 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 步驟進行升級即可。
指令切換到【tomcat/bin】目錄下,雙擊 startup.bat 啟動 Tomcat(按照自己的啟動方式去啟動工程即可),訪問決策平台,跟原先 10.0 的訪問路徑一致。
注:Linux啟動 Tomcat 是執行 startup.sh。
平台訪問URL:http://IP:埠/webroot/decision(其中,webroot為工程名,decision為Servlet名)
範本訪問URL:http://IP:埠/webroot/decision/view/report?viewlet=xxx.cpt或者xxx.frm
升級工具處理後,平台是預設內建 finedb 模式,如果需要遷移到自己的資料庫,需要重新遷移相關文檔見:配置外接資料庫。
注1:為了跟原先 FineReport 10 的外接資料庫互相獨立,不影響之前的環境,建議建立一個資料庫做遷移,後續 FineReport 11 運作穩定,可以將原先 10 的外接資料庫刪除。
注2:如果是遷移到 MySQL 資料庫,建議建立一個區分大小寫的資料庫再做遷移。
將叢集單個節點升級後,啟動進入平台配置外接庫(如果 五.9 小節已經做了外接資料庫配置則無需再配置),具體頁面如下圖1所示。
開啓叢集(開啓叢集即可,叢集配置預設保留),如下圖2所示。
關閉 tomcat,複製 webroot 到另一個節點(必須要在配置了外接資料庫,開啓叢集后才行),依次啟動兩個節點 tomcat,叢集配置成功。
注1:平台備份、備份整個 Tomcat、啟動 Tomcat、外接資料庫遷移、叢集遷移操作步驟,同本文 五、升級步驟 - Windows。
注2:在備份完整個 Tomcat 後,開始使用升級工具執行以下步驟。
注3:升級成功後,參考本文 五、8,9,10小節 啟動 Tomcat、外接資料庫遷移、叢集遷移操作步驟。
注:FineUpgrade_v11_linux_xxx.sh 代表升級工具名稱。
部分升級進程關鍵字如下表,若有模塊升級失敗可對應查找關鍵字确認。
升級工具只對 Web 工程的升級,不提供對完整設計器的升級。設計器如果需要升級,可以先全新安裝 11.0,然後将老設計器下的工程升級到 11.0 後,将升級後的工程拷貝到新安裝的 11.0 設計器目錄下(也就是将 11.0 webapps 目錄中的 webroot 檔案替換為升級後的工程檔案)。
如果一個 Web 工程已經升級過,不管是否升級成功,都不要再次運行升級工具來升級。只能透過已備份的 10.0 工程重新執行升級。
升級工具不能跨版本升級,如 9.0 工程想升級到 10.0,需要把工程先升級到 10.0,再從 10.0 升級到 11.0。
若 10.0 工程已經配置 tools.jar ,則不需要重新引入 tools 工具包,相反則要将【%JAVA_HOME%/jdk/lib】下的環境變量 tools.jar 放到【%TOMCAT_HOME%/lib】和或【%TOMCAT_HOME%/webapps/工程名/WEB_INF/lib】下,若不執行此步驟伺服器部署過程中會報錯 500。相關内容可參考:伺服器部署500報錯 引入 tools.jar
升級工具支援官方的資料集類插件,支援列表如下。
10.0 升級到 11.0 時,備份預設跨越 schedule、backup、logs 三個目錄,若升級失敗,需要將原工程下的 schedule、backup、logs 三個檔案手動copy到備份的目錄下後,切換到備份的路徑下即可正常使用。
Window 系統升級失敗時,前台操作面板會提示失敗顯示具體的失敗原因和訊息。
Linux 升級失敗時,會提示失敗顯示具體的失敗原因和訊息,建議使用 lsof -i:20216 和 lsof -i:20217 查找 pid,若找到 pid 則殺掉後在進行重新升級。
文 檔回 饋
滑鼠選中內容,快速回饋問題
滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。
不再提示
10s後關閉