升級指南

1. 功能簡介：FineReport 10.0 內置一鍵升級的功能，以便完善舊版本的不足以及上線新功能。

2. 版本說明：版本号包括大版本和小版本，大版本如10.0、9.0、8.0、7.0、6.5 等。大版本中包含小版本，用戶可以根據 JAR 包的時間辨别小版本。

注1：自 2020-08-31起，帆軟發布的 FineReport 軟件，将顯示小版本号和發布時間，在設計器菜單欄【幫助】→【關於軟件】可以查看。

注2：高版本向下兼容低版本，但低版本不能向上兼容高版本，即用高版本制作或者開啟過的範本将無法用低版本開啟。如用 9.0 制作的範本在 10.0 設計器中開啟過一次之後，就無法再用 9.0 開啟了；用 10.0 制作的範本顯然也是無法用 9.0 或 8.0 開啟的。

注3：為了保證範本功能的兼容性，要求使用者的設計器版本同伺服器版本保持一致，包括大版本和小版本。

1

FineReport 9.0 升10.0。

1. FineReport 9.0 與 10.0 版本之間沒有內置升級功能，使用者可透过升級工具完成。

注：8.0 升級 10.0，要先升級到 9.0，再升級至 10.0。8.0 升級 10.0 可參考 ：FineReport升级指南。

2

FineReport 10.0小版本升級。

1. 10.0 小版本之間的升級一般為固定的 JAR 包更新，也可能會存在增刪 JAR 包的情況。

2. 由於2019-12-05 後的 JAR 包版本自動更新功能有變動，並且為預防後續更新可能會拆 JAR 包帶來的風險，2019-12-05 之前的版本更新時有一些限制。

3. 2019-12-05 之前的版本，需要增刪 JAR 包時，只能進行手動升級操作。若需要進行自動更新升級，需要先更新至 2019-12-05 版本的 JAR 包，再進行自動升級。

4. 2019-12-05 之後的版本，自動更新升級可以自動增刪 JAR 包，進行更新升級時，允許升級到當前最新版本。

5. 舉例：當前版本 JAR 包時間—— 2019-05-20 ，最新版本 JAR 包時間—— 2020-04-26 。使用者需要：

   手動升級至 JAR 包時間為 2019-12-05 的版本。

   通過自動更新升級至 JAR 包時間為 2020-04-26 的 10.0 版本。 

注：使用者在進行升級前，為避免升級失敗出現檔案丟失的情況，請將所需要的檔案進行備份後再升級。備份可參考：B09-02 備份還原。

1. 為了幫助使用者更順利的從 9.0 升級到 10.0 版本，我們特提供一個獨立的輔助升級程式，可以將 9.0 的 Web 工程升級到 10.0 工程，包括 JAR 包、各類配置檔案、FineDB 資料表等檔案的相容升級。 

2. 該輔助升級工具無需安裝，即點即用，簡單方便。具體可參考：9-10 升級工具。

注1：升級工具目前只支援 jdk1.8，使用者在升級時要確定自己的 jdk 為 1.8 版本。

注2：9.0 升級 10.0 後，建議新版本的 配置外接資料庫。和舊版本不同；若使用者希望使用同一外接資料庫，需要將外接資料庫中舊版本的工程資訊全部刪除，否則可能會因為表結構不一致導致一些問題。

1

設計器升級-直接更新升級。

1. 開啟設計器，點擊選單【说明】→【更新升級】，在【最新JAR】 一欄會出現新版本號，下方會有更新按鈕，如下圖所示。

2. 觸發更新後，系統提示儲存重要資訊，如下圖2所示。

3. 設計器更新時由於要獲取比對 JS 並解析，會出現幾秒的延遲，獲取更新資訊中，如下圖3所示。

4. 按照提示更新，下方顯示下載 JAR 包進度，如下圖4所示。

5. 等待準備工作完成，系統將立即自動重啓。重啓之後最新 JAR 一欄顯示為【已經是最新版本】，即完成 10.0 版本更新。

 注：遠程設計狀態下不支援【更新升級】功能。

2

設計器升級-插件管理觸發升級。

1. 进入【檔案】→【選項】，勾選【使用新插件管理器】，如下圖1所示。

2. 進入【伺服器】→【插件管理】，若檢查到 jxbrowser 的 JAR 包不存在，則彈出強制升級提示框，如下圖2所示。

3. 點擊確定或關閉提示框，將跳轉至更新升級介面，後續升級步驟如上一節所示。

注：設計器手動更新至 10.0.18 版本時，jxbrowser 的 JAR 包需要新增 【jxbrowser-7X.jar】、【jxbrowser-swing.jar】、【jxbrowser-XX.jar】（XX指代系統版本）存放在 %FR_Home%/lib 下，原 jxbrowser 的 JAR 包需保留。JAR 包請聯絡帆軟技術人員索要。

3

決策平台管理升級。

1. 開啟資料決策系統，在【管理系統】→【智慧運維】→【備份還原】→【更新升級】點擊【立刻更新】按鈕，等待更新 JAR，成功後重啓 Web 伺服器即可。

注：平台更新升級後，需要透过 Ctrl+C / kill 關閉 Tomcat 進程，使用其他方式會存在一定風險。

1

設計器升級-直接更新升級。

1. 操作方式與第三部分第3節相同。

2. 開啟資料決策系統，在【管理系統】→【智慧運維】→【備份還原】→【更新升級】點擊【立刻更新】按鈕，等待更新 JAR，成功後重啓 Web 伺服器即可。

注：平台更新升級後，需要透过 Ctrl+C / kill 關閉 Tomcat 進程，使用其他方式會存在一定風險。

2

設計器升級-人工更新 JAR 包。

1. 向 FineReport 技術人員索要 13 個升級 JAR 包：【fine-accumulator-10.0.jar】、【fine-activator-10.0.jar】、【fine-core-10.0.jar】、【fine-datasource-10.0.jar】、【fine-decision-10.0.jar】、【fine-decision-report-10.0】、【fine-report-designer-10.0.jar】、【fine-report-engine-10.0.jar】、【fine-schedule-10.0.jar】、【fine-schedule-report-10.0.jar】、【fine-swift-log-adaptor-10.0.jar】、【fine-third-10.0.jar】、【fine-webui-10.0.jar】。

2. fine-report-designer-10.0 ：這一個 JAR 包包含 FineReport 設計器的所有功能，必須更新，存放在 %FR_Home%/lib 下，如下圖1所示。

3. 其餘 JAR 包：升級到版本的時候，需要將剩下的 12 個 JAR 包放到 %FR_Home%/webapps/webroot/WEB-INF/lib下，如下圖2所示。

注：更新 JAR 包後需要透过重啓設計器來生效，而且 JAR 包所放位置不能放錯，否則會導致不能開啟設計器。

3

設計器升級-決策平台管理升級。

1. 操作方式與第三部分第3節相同。

2. 開啟資料決策系統，在【管理系統】→【智慧運維】→【備份還原】→【更新升級】點擊【立刻更新】按鈕，等待更新 JAR，成功後重啓 Web 伺服器即可。

注：平台更新升級後，需要透过 Ctrl+C / kill 關閉 Tomcat 進程，使用其他方式會存在一定風險。

4

伺服器升級-人工更新 JAR 包。

1. 使用者可以獲取 JAR 包後手動更換更新， linux 系統和 windows 系統下操作方式一致。

2. 使用者可以向 FineReport 技術人員索要如下 12 個升級包，也可以安裝最新版本設計器後在安裝目錄 %FR_Home%/webapps/webroot/WEB-INF/lib 下拷貝：【fine-accumulator-10.0.jar】、【fine-activator-10.0.jar】、【fine-core-10.0.jar】、【fine-datasource-10.0.jar】、【fine-decision-10.0.jar】、【fine-decision-report-10.0】、【fine-report-engine-10.0.jar】、【fine-schedule-10.0.jar】、【fine-schedule-report-10.0.jar】、【fine-swift-log-adaptor-10.0.jar】、【fine-third-10.0.jar】、【fine-webui-10.0.jar】。

3. 獲取後，更換伺服器工程 %TOMCAT_HOME%/webapps/webroot/WEB-INF/lib下之前的 12 個 JAR 包，重啓伺服器即可完成升級。

注1：更新 JAR 包後需要重啓伺服器透过會生效。Linux 系統下，重啓時請參考：Tomcat獨立部署。

注2：在進行版本升級時請先查看 版本說明 ，部分版本升級方式可能會有所差異。

注3：伺服器上和設計器上的 JAR 的版本要保持一致，否則可能會導致某些範本本地看預覽效果正常，伺服器下預覽出現問題。

5

伺服器升級-決策平台管理升級。

1. 操作方式與第三部分第3節相同。

2. 開啟資料決策系統，在【管理系統】→【智慧運維】→【備份還原】→【更新升級】點擊【立刻更新】按鈕，等待更新 JAR，成功後重啓 Web 伺服器即可。

注：平台更新升級後，需要透过 Ctrl+C / kill 關閉 Tomcat 進程，使用其他方式會存在一定風險。