Linux 系統10-11升級步驟

1.1 功能簡介

本文透過一個獨立的輔助升級過程，可以將 10.0 的 Web 工程升級到 11.0 工程，包括 JAR 包、插件、各類配置檔案、FineDB 資料表等的相容升級。

1）提供免安裝版過程，點選即可運作，無需安裝卸載。
2）過程支援 5 種語言是簡體中文、繁體中文、英文、日文、韓文。
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）使用上傳工具將升級工具上傳到伺服器端，升級工具選擇一個目錄put 命令即可（不要放到tomcat下面）。
2）停掉tomcat：
     ① ps -ef | grep tomcat   #查看tomcat的進程號pid ②kill -9 pid   #關閉tomcat進程（pid是剛才的查到的進程號）
     ③ ps - ef |grep tomcat查看是否有殘留進程，有的話kill掉
3）切換目錄到升級工具目錄下。
注：FineUpgrade_v11_linux_xxx.sh 代表升級工具名稱，下面代碼的工具名稱為範例，請根據實際情況自行修改。
4）給升級工具賦權 chmod +x FineUpgrade_v11_linux_2022-09-30-amd64-CN.sh。

5）啟動升級工具 ./FineUpgrade_v11_linux_2022-09-30-amd64-CN.sh。
6）輸入工程路徑 ，可以提前準備好路徑，範例：/opt/tomcat11/webapps/webroot。
7）根據提示選擇是否跨越備份，輸入 N 則出現提示：請選擇備份路徑，輸入備份路徑後即可正常升級；
      輸入Y則表示跨越備份，二次應答再次輸入Y即可正常升級。
8）升級成功後出現將會顯示 upgrade success。
9）升級成功後啟動 Tomcat，指令切換到tomcat/bin 目錄下，執行 ./startup.sh，啟動成功後存取決策平台，跟原先 10.0 的存取路徑一致。
平台存取URL：http://IP:埠/webroot/decision（其中，webroot為工程名，decision為Servlet名）
範本存取URL：http://IP:埠/webroot/decision/view/report?viewlet=xxx.cpt或者xxx.frm
升級過程如下圖所示：

根據提示選擇是否跨越備份，輸入 N 則出現提示：請選擇備份路徑，輸入備份路徑後即可正常升級；
輸入 Y 後回車出現提示：

未選擇備份目錄將跨越備份直接升級，請提前應答已備份原工程和配置資料庫，是否應答跨越備份，再次輸入 Y 後即可正常升級，如下圖所示：

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

請按照對應資料庫的文檔，嚴格遵循建表的編碼等說明進行建表，否則會導致遷移失敗。常見外接庫的遷移報錯如下：外接資料庫配置常見問題 。

注1：升級工具不會修改原外接庫裏的任何資料，而是讀取資料生成內建庫進行升級修改的。

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

流程圖如下：

5.1 升級單節點後應答配置好外接資料庫

1）按照文檔第3節，先對節點一進行升級。

2）節點一升級好後，利用 10-11升級前準備 中建好的表空間，進行外接庫遷移，具體步驟參考：配置外接資料庫。

5.2 應答單節點叢集配置正常

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

5.3 同步升級檔案

1）關閉所有節點的tomcat，刪除未升級節點 webroot 下的 WEB-INF 資料夾（刪除前請應答已經做好備份工作），否則後續複製檔案會導致10版本的檔案還在，啟動異常。
2）複製升級好的節點 webroot 下的WEB-INF資料夾到其他的節點（必須要在配置了外接庫，開啓叢集后才行），並刪除WEB-INF\config資料夾下的 cluster.properties 檔案後，依次啟動各個節點 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）Linux 升級失敗時，會提示失敗顯示具體的失敗原因和資訊，建議使用 lsof -i:20216 和 lsof -i:20217 尋找 pid，若找到 pid 則殺掉後在進行重新升級。
7）10.0 升級到 11.0 時，備份預設跨越 schedule、backup、logs 三個目錄，若升級失敗，需要將原工程下的 schedule、backup、logs 三個檔案手動copy到備份的目錄下後，切換到備份的路徑下即可正常使用。
8）日誌關鍵字對照說明：部分升級進程關鍵字如下表，若有模組升級失敗可對應尋找關鍵字應答。