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 數據集 |
|
螺旋數據集 |