本機機器資訊認證

1.1 版本

1.2 功能簡介

本地機器資訊認證透過讀取報表工程所在伺服器的物理資訊，生成唯一標識的 license 檔案，進而完成授權註冊。

整個流程分為三步：匯出伺服器的 MAC 地址和機器碼、將資訊傳送給帆軟商務獲取 license 檔案、將 license 檔案上傳至工程完成註冊。

1.3 注意事項

1）伺服器物理資訊必須固定。若工程部署在虛擬機環境下，物理資訊可能隨時變化，導致註冊失敗，請改用其他認證方式。

2）一個正式 license 檔案在同一台機器上只能註冊一次。若需在同一台機器上註冊多個工程，須購買多個 license。

3）一個正式 license 檔案僅適用於一台伺服器。取代伺服器時，需進行註冊遷移。

4）同一伺服器跨大版本升級（如 10.0 升級至 11.0）後，需進行註冊遷移，推薦使用 授權遷移插件。

5）請確定工程使用 JDK 1.8，且小版本在 JDK 8u200 及以上。

6）MAC 地址不允許為空或設定為不限。正式 license 檔案強制校驗 MAC 地址，為空則註冊必然失敗。

2.1 確認工程名

1）開啟工程安裝目錄%FR_HOME%/webapps，查看當前工程資料夾名稱，預設為 webroot。

2）如需自訂工程名，請在註冊前完成。註冊完成後將無法再修改工程名。

注：修改工程名可能影響範本中的超連結等配置，請在修改前確認相關影響並做好備份。

         修改後，存取工程的地址變為 http://IP:埠/工程名/decision。

2.2 匯出工程ID資訊（11.5~11.5.8版本必做）

11.5~11.5.8版本 FineReport 工程需完成此操作，其他版本請跨越。

1）以管理者身分登入 FineReport 系統，依次點選「管理系統 > 註冊管理」。

2）在工程資訊 > 應用工程 ID 右側，點選「匯出ID」按鈕。

3）系統生成並下載「appID.rif」檔案，該檔案包含工程的唯一 ID 資訊。

2.3 匯出注冊資訊

1）以管理者身分登入 FineReport 系統，依次點選「管理系統>註冊管理」。

2）在「註冊資訊>版本註冊」右側，點選「立即註冊」按鈕。

3）認證方式選擇「本地機器資訊認證」，點選「匯出註冊資訊」按鈕。

4）系統生成並下載「RegistrationInformation.rif」檔案，該檔案包含工程版本和伺服器機器資訊。11.5.9 及之後版本，該檔案還包含工程的唯一 ID 資訊。

2.4 獲取授權檔案

請使用合同中指定的信箱傳送註冊資訊給 FineReport 商務business@fanruan.com。商務覈實無誤後將生成FanRuan.lic檔案並透過郵件傳回給客戶。

注1：請提前聯絡帆軟銷售確認相關事項並簽署合同，再傳送註冊郵件。

注2：若有任何特殊情況，請在郵件中註明。

郵件傳送清單

2.5 上傳 lic 檔案

1）收到商務傳回的FanRuan.lic檔案後，管理者登入FineReport系統，點選「管理系統>註冊管理>立即註冊」，如下圖所示：

2）認證方式選擇「本地機器資訊認證」，點選「上傳lic檔案」，選擇 FanRuan.lic 檔案上傳。

3）上傳成功後，頁面顯示「註冊成功」，即完成授權註冊。

• FanRuan.lic 檔案會自動儲存到工程 /webroot/WEB-INF/resources 目錄下。

• 叢集工程的 lic 檔案儲存在叢集檔案伺服器的 resources 資料夾中。

1）刪除 lic 檔案：進入 工程/webroot/WEB-INF/resources 目錄，刪除 FanRuan.lic 檔案。

注1：叢集工程的 lic 檔案儲存在叢集檔案伺服器的 resources 資料夾中。

注2：使用 MinIO 等 S3 類型檔案伺服器時，不支援直接在後端刪除檔案，須透過瀏覽器登入檔案伺服器前端進行刪除操作。

2）重啟工程：重啟 FineReport 工程，使取消註冊生效。

11.0.18 之前的版本，註冊失敗時頁面僅提示「註冊失敗，請重新註冊」，不顯示具體原因。

11.0.18 及之後的版本，註冊失敗時頁面會彈窗提示具體失敗原因，並提供對應的解決方案或排查步驟。

4.1 單機環境註冊失敗

若註冊失敗，頁面將彈窗提示具體失敗原因，點選「詳細資訊」按鈕，即可查看解決方案或問題排查步驟，如下圖所示：

點選「返回」後，註冊管理頁面的「註冊資訊」區域也會顯示失敗原因，點選查看錯誤詳情可再次查看解決方案。

4.2 叢集環境註冊失敗

叢集環境下，不同節點的註冊失敗原因可能不同。頁面彈窗會分節點展示每個節點的具體失敗原因，點選對應節點的詳細資訊按鈕，可查看該節點的解決方案或排查步驟。

點選返回後，註冊管理頁面會以列表形式展示各節點的失敗原因，點選查看錯誤詳情可查看對應解決方案。

4.3 失敗原因匯總

除下表所列原因外，其他情況統一報錯「憑證內容不正確」。

一次註冊程式中存在多個失敗原因時，頁面僅展示第一個失敗原因。

授權到期前 15 天開始提醒。在此期間，超級管理者每次登入帆軟平台時，系統會推播通知：您的授權允許將於 n 天后過期，請儘快重新授權。

收到提醒後，請即時聯絡帆軟商務續期，避免授權到期後影響正常使用。