資源遷移伺服器資料集

1.1 版本

1.2 應用場景

使用 FineReport 數據決策系統時，一般先在測試環境系統上進行開發部署，確認無誤後再遷移到正式系統中。

FineReport 支援將「伺服器資料集」從測試系統增量遷移到正式系統。

1.3 功能簡介

超管登入數據決策系統，點選「管理系統>智慧維運>資源遷移」，分為「資源匯出」、「資源匯入」兩部分。

本文僅介紹遷移資源類型為「伺服器資料集」時的操作方法。

1.4 注意事項

1）資源遷移功能僅支援超級管理者，次級管理者。

2）次管在進行「資源匯出」時不支援「同時匯出權限配置」。

3）正式工程需購買「智慧維運」功能點才可使用「資源遷移」功能。

4）請確定在資源遷移程式中，沒有其他人使用超級管理者帳號，否則部分執行請求可能被取消。

5）不建議在個人 PC 端工程開發範本後，再以資源遷移的形式同步到公司工程。

      因為個人 PC 端沒有管理者維護，經常會因為 JAR 包不同步或資源以及配置不同步的問題導致資源遷移失敗，維運成本會很高。

6）單次資源匯入內容不可超出2GB，否則在匯入資源時會報錯：out of memoryerror。請少量多次分配匯出和匯入資源 。

2.1 確認版本

資源遷移之前，請確定資源匯入和匯出的 FineReport 工程使用的版本一致（包括 JAR 包時間）。

管理者可在「管理系統>註冊管理>報表模組」下查看 JAR 包時間，如下圖所示：

若版本不一致，可透過升級來確定版本一致。

注：在資源匯入時，若上傳資源對應的工程和當前工程版本不一致，則無法上傳。

       提示：無法匯入，即將匯入的資源需要的工程版本：XXX。當前工程版本：XXX。請確定工程版本一致！

2.2 系統備份

資源匯入前建議對測試系統和正式系統均進行 系統備份，如下圖所示：

注：備份遷移到的 MySQL 資料庫需要選擇 utf8_bin 的排序規則。

2.3 確認插件和驅動

1）若伺服器資料集需依賴第三方插件，目前只支援 JSON 資料集和 Mysql8 資料連結，其他插件類型不適配，會匯入失敗。

2）權限匯出插件生成的伺服器資料集，不支援遷移，會匯入失敗。

3）伺服器資料集遷移只遷移配置。驅動jar包、kerberos認證檔案、JNDI 配置檔案等都不會遷移，需要手動配置/放置。

• 請在進行伺服器資料集遷移前，確認正式工程下是否提前安裝依賴的相關資料集插件，否則將導致匯入失敗。

• 請在進行伺服器資料集遷移前，確認正式工程下是否提前安裝依賴的相關驅動，否則將導致匯入的伺服器資料集不可使用。

2.4 確認資料連結

伺服器資料集若依賴相關資料連結，請確認將相關資料連結匯入正式工程，否則匯入的伺服器資料集無法使用。

資源遷移資料連結的操作請參見：資源遷移資料連結

超級管理者登入數據決策系統，選擇「管理系統>智慧維運>資源遷移>資源匯出」，如下圖所示：

4.1 上傳檔案

超級管理者登入數據決策系統，選擇「管理系統>智慧維運>資源遷移>資源匯入」，如下圖所示：

注1：資源匯入前建議進行 系統備份，其中備份遷移到的 MySQL 資料庫需要選擇 utf8_bin 的排序規則。

注2：單次只允許上傳單個壓縮檔案。

注3：單次資源匯入內容不可超出2GB，否則在匯入資源時會報錯：out of memoryerror。請少量多次分配匯出和匯入資源 。

系統會獲取匯入檔案所包含的資源，包含類型、平台路徑、物理資源、權限資訊及匯入方式。

4.2 匯入檔案

勾選需要上傳的資源，點選「匯入」，點選「確定」。

若匯入失敗，顯示失敗的原因（如：匯入不支援的插件類型資料連結或者匯入工程沒有安裝插件）；若匯入成功，則資源即時生效。如下圖所示：