帆軟9.0升級10.0（摘自帆軟官方文檔）

 

1. 描述

現提供一個獨立的輔助升級程序，能夠將 9.0 的 Web 工程升級到 10.0 工程，包括 JAR 包、各種配置文件、FineDB 數據表等的兼容升級。

 

1） 提供免安裝版程序，點擊便可運行，無需安裝卸載。

2）程序支持簡體中文、英文、繁體中文。

3）支持 Windows、Linux 主流操做系統。

注：請在升級前仔細閱讀 9-10兼容說明

2. 獲取升級工具

因爲FineReport功能不斷優化，產品不斷迭代升級，所以升級工具也在不斷更新。

 帆軟技術支持提供

3. 升級前準備

1）工程備份：升級以前請先關閉待升級的工程，對此工程進行備份。

2）以管理員方式啓動升級工具，保證升級工具能在工程所在的磁盤建立文件夾（通常不要將工程放在C盤內）。

3）當前只支持JDK1.8，因此升級工程前務必查看JDK版本（若是環境不容許改動，請將工程拷貝到jdk1.8環境中升級再拷貝回來）,不然升級成功後會出現部署報錯

4）內網離線環境下，從 9.0 升級上來的工程，沒法升級插件商城腳本

      升級成功後須要手動替換腳本文件scripts，替換路徑爲：%FR_HOME%/webapps/webroot/scripts，替換後重啓服務器，而且清除瀏覽器緩存

注：點擊下載 scripts：scripts.zip

5）如待升級工程進行過平臺數據庫遷移，升級過程當中須要確保可以鏈接到外接數據庫。

6）9.0及之前版本同步數據集中密碼能夠選擇內置MD5加密，升級後如仍需使用 MD5 加密請參見：MD5 加密方式

      若是之前用戶存的是明文，升上來之後，再也不能登陸上了，只能去重置；其餘全部自定義加密類升級到10.0都須要從新適配

7）部分插件未支持新版本，在升級前請進行刪除。

8）單點登陸的客戶升級到 10.0 要進行從新適配。

9）深度集成的客戶，建議把數據先拿到獨立部署的工程裏面，升級完成後，另行適配10.0。

10）非簡體中文系統用戶升級前，務必要手動備份數據庫信息。升級工具會刪除不一樣語言下的權限配置。

11）Linux 非簡體中文環境下，2018-02-28~2018-09-06 之間的 9.0 JAR 包與10.0沒法徹底兼容，須要先將 9.0 JAR 升級最新，再使用升級工具升級到 10.0。

4. 升級步驟

4.1 升級工具使用

1）右鍵點擊升級工具，選擇以管理員身份運行。以下圖所示：

 

2）打開程序後，進行語言選擇，可選擇簡體中文、繁體中文、英語。以下圖所示：

 

3）點擊肯定，進入 FineReport 10.0 升級工具的安裝程序嚮導，選擇待升級的 9.0 工程文件夾。以下圖所示：

注：工程文件夾通常爲%FR9.0_HOME%/WebReport，是包含WEB-INF的文件夾。

 

注：若是所選目錄未檢測到 WEB-INF 文件夾，則提示請選擇包含 WEB-INF 目錄的WEB容器文件夾。

 

注：若是選擇的工程版本非 9.0，則提示僅支持 9.0 的工程升級。 

 

4）點擊下一步，進入原工程備份界面，選擇原文件夾備份保存的地址，以下圖所示：

 

注：備份地址不容許爲空，爲空時提示您必須輸入備份目錄。

 

5）點擊下一步，提示即將開始升級，在升級過程當中請勿關閉本程序，同時不要對原工程作任何編輯修改操做。以下圖所示：

 

6）點擊下一步，啓動備份升級，以下圖所示：

 

注：備份成功後，在設置好的文件夾下生成 WebReport_bak 的備份文件。

 

7）升級結束後，界面以下圖所示：

 

8）點擊完成後，9.0 中的項目文件 WebReport 就是被升級後的文件。以下圖所示：

 

4.2 升級後部署

1）將 %JAVA_HOME%/jdk/lib 下的環境變量tools.jar 放到%TOMCAT_HOME%/lib或%TOMCAT_HOME%/webapps/工程名/WEB_INF/lib下，以下圖所示：

注：如不執行此步驟，服務器部署過程當中會報錯 500，詳情請參見：服務器部署需引入 tools.jar。

 

注：若環境變量指向的%JRE_HOME%/bin 下無attach.dll 文件，還需將%JAVA_HOME%/jdk/jre/bin 下的attach.dll 拷貝到此路徑下。

2）將升級後的文件部署到服務器上，便可看到 9.0 工程升級到了 10.0 並保留數據，以下圖所示：

注：此處是將升級後的 WebReport 文件夾名稱改成了 webroot。

 

5. 常見問題

5.1 升級工具閃退

問題描述：升級過程當中，可能會由於一些緣由致使升級工具閃退。

解決方案：如發生閃退狀況，請聯繫技術支持解決，併發送error.log文件，文件位置以下：

1）windows：error.log在升級工具同級文件夾生成

 

2）linux：不生成日誌文件，升級過程在控制檯輸出日誌，須要升級前手動保存控制檯信息，如xshell

 

5.2 Unsupported major.minor version 52.0

問題描述：工程能夠升級成功，但升級後部署報錯：com/sun/tools/attach/VirtualMachine:Unsupported major.minor version 52.0

緣由分析：升級工具僅支持 JDK1.8 環境，其餘版本的 JDK 環境不支持

解決方案：

1. 直接更換爲 JDK1.8 的環境再升級

2. 客戶的工程拷貝到另一個 JDK1.8 的環境進行升級，完成後再拷貝回其餘的環境

5.3 權限丟失

問題描述：2018-02-28~2018-09-06之間的 JAR 包，Linux 英文/繁體中文環境下，全部部門全部職務存在遺留問題，致使權限會存在全部部門全部職務或者All DepartmentAll Post上。

解決方案：因爲升級工具會根據 JAR 包時間以及升級的語言環境升級對應的權限，所以直接將9.0 JAR升級至最新，再使用升級工具升級到 10.0 便可。

5.4 端口被佔用

緣由分析：2018-11-06及以後的 JAR 包。10.0 工程有兩個端口，一個是容器的端口：默認爲 8075，另外一個是 websocket：默認爲 38888。當同一個設備上有不止一個 10.0 工程時，兩個端口不能同時相同，不然會出現端口被佔用報錯的問題。

解決方案：工程端口被佔用的處理方法

5.5 其餘說明

1）只提供對 Web 工程的升級，不提供對完整設計器的升級。設計器若是須要升級，能夠先全新安裝 10.0，而後將老設計器下的工程升級到 10.0 ，將升級後的工程拷貝到新安裝的 10.0 設計器目錄下（也就是將 10.0 webapps 目錄中的 webroot 文件替換爲升級後的工程文件）。

2）若是一個 Web 工程已經升級過，不論是否升級成功，都沒法再次運行升級工具來升級。只能經過已備份的 9.0 工程從新執行升級。

3）升級到 10.0 後，遷移過的 FineDB 會從數據庫回退到原先的 FineDB ，須要從新遷移。

4）升級工具不能跨版本升級，如 8.0 工程想升級到 10.0，須要把工程先升級到 9.0，再從 9.0 升級到 10.0。

5）2019 年 4 月 15 號及以後的升級工具支持官方的數據集類插件，支持列表以下：

插件

多維數據集

SAP 數據集

JSON 數據集

MongoDB 數據集

新 SAP BW 數據集

螺旋數據集