windows 系統10-11升級步驟

1.1 功能簡介

本文透過一個獨立的輔助升級過程，可以將 10.0 的 Web 工程升級到 11.0 工程，包括 JAR 包、插件、各類配置檔案、FineDB 資料表等的相容升級。
1）提供免安裝版過程，點選即可運作，無需安裝卸載。
2）過程支援 4 種語言是簡體中文、繁體中文、英文、日文、韓文。
3）支援 Windows、Linux 主流工作系統。

1.2 注意事項

1）已獲取授權的 10.0 且可用的工程，升級前請先與銷售聯絡，申請遷移授權，升級後，工程需要重新授權。
2）升級工具僅支援 JAR 包日期為 2020-08-04 及之後的 FineReport 10.0 版本進行升級。目前升級工具僅支援 10.0 版本升級至最新的 11.0.X 版本。
3）升級工具是針對報表工程進行升級，如果是使用者本地的設計器，需要自行下載 11.0 版本的設計器，再遠端連結到報表工程中：下載 FineReport。
4）升級工具的獲取以及準備工作，注意事項等，請仔細閱讀：10-11升級前準備。

升級思路導圖如下：

1）先將升級工具上傳到伺服器端。
2）關閉工程後，以管理者身分啟動升級工具，如下圖所示：

3）將會出現前臺操作面板，輸入工程路徑，如下圖所示：

注：需要輸入待升級的工程路徑，是容器比如tomcat下的webroot，不是設計器目錄下。
4）點選「...」，選擇備份工程的路徑（此步驟可跨越），如下圖所示：

若不選擇「備份路徑」直接進行開始升級，將會出現提示：

未選擇備份目錄將跨越備份直接升級，請提前確認已備份原工程和配置資料，是否確認跨越備份，選擇「Yes」將直接開始升級，如下圖所示：

5）點選「開始升級」，將會顯示升級進度，升級成功後，將會顯示 upgrade success，如下圖所示：

6）手動關閉升級操作面板。
7）升級成功後，啟動 Tomcat。

指令切換到 tomcat/bin 目錄下，雙擊 startup.bat 啟動 tomcat（按照自己的啟動方式去啟動工程即可），存取決策平台，和原 10.0 的存取路徑一致。
平台存取URL：http://IP:埠/webroot/decision（其中，webroot為工程名，decision為Servlet名）
範本存取URL：http://IP:埠/webroot/decision/view/report?viewlet=xxx.cpt  或者 xxx.frm

升級工具處理後，平台是內建 finedb 模式，如果需要遷移到自己的資料庫，需要重新遷移相關文檔見：配置外接資料庫。
請按照對應資料庫的文檔，嚴格遵循建表的編碼等說明進行建表，否則會導致遷移失敗。常見外接庫的遷移報錯如下：外接資料庫配置常見問題 。

注1：升級工具不會修改原外接庫裏的任何資料，而是讀取資料生成內建庫進行升級修改的。
注2：為了和舊版本的外接庫互相獨立，不影響之前的環境，可以在原來所用資料庫實體的相同使用者下，建立一個資料庫做遷移。待後續 11 運作穩定，可以將原先 10 的外接庫刪除。如果已經在準備工作中做好，直接用建好的實體即可。

思路導圖如下：

5.1 升級單節點後確認配置好外接資料庫

1）按照文檔第3節，先對節點一進行升級。
2）節點一升級好後，利用 10-11升級前準備 中建好的表空間，進行外接庫遷移，參考文檔中的步驟4 。

5.2 確認單節點叢集配置正常

配置好外接庫後，叢集配置預設保留，確認節點管理無飄紅即可繼續進行下一步。

5.3 同步升級檔案

1）關閉所有節點的tomcat，刪除未升級節點 webroot 下的WEB-INF資料夾（刪除前請確認已經做好備份工作）。
2）複製升級好的節點 webroot 下的WEB-INF資料夾到其他的節點（必須要在配置了外接庫，開啟叢集后才行），並刪除WEB-INF\config 資料夾下的 cluster.properties 檔案。
3）依次啟動各個節點 tomcat，啟動成功後即可看到原始叢集升級成功。

使用者在進行升級後若遇到嚴重的故障可回退到之前的版本，回退方案詳情參見：10-11後回退至原版本。

1）升級工具只對 Web 工程的升級，不提供對完整設計器的升級。設計器如果需要升級，可以先全新安裝 11.0，然後將老設計器下的工程升級到 11.0 後，將升級後的工程copy到新安裝的 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。相關內容可參考：tools.jar不存在。
5）升級工具支援官方的資料集類插件，支援列表如下：

6）Window 系統升級失敗時，前臺操作面板會提示失敗顯示具體的失敗原因和資訊。
7）10.0 升級到 11.0 時，備份預設跨越 schedule、backup、logs 三個目錄，若升級失敗，需要將原工程下的 schedule、backup、logs 三個檔案手動copy到備份的目錄下後，切換到備份的路徑下即可正常使用。
8）日誌關鍵字對照說明：部分升級進程關鍵字如下表，若有模組升級失敗可對應尋找關鍵字確認。