本地機器資訊認證（臨時註冊）

1.1 版本

提示:

FineBI7.0 只推薦使用線上註冊（外網環境）和維運平台註冊（內網環境）。

本文的「本地機器資訊認證」方式，僅面向臨時註冊的工程，正式註冊請勿選用本文註冊方式。

1.2 功能簡介

本地機器資訊認證操作簡單，十分方便 。

使用者透過匯出 rif 檔案，獲取 mac 地址和機器碼，來生成一個唯一標識的 license 檔案 。

1.3 注意事項

1）本地機器資訊認證，需要 FineBI 工程所在伺服器的物理資訊固定。如不固定，不適合使用該註冊方法。

     例如要 FineBI 工程部署在虛擬機器環境下，虛擬機器環境下物理資訊可能變化，造成註冊失敗，請選取其他註冊方式。

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

3）一個正式 license 檔案只適用於一台伺服器，如需更換伺服器，需要進行註冊遷移。

4）同一伺服器下跨大版本升級（6.0 升級 7.0）後，需要進行註冊遷移。

5）請確定工程使用 JDK 1.8 且小版本需在 JDK8u200 以上。

6）Mac 地址不允許設定為空，不允許不限。因為正式  license  檔案強制校驗 Mac 地址，為空則一定會註冊失敗。

2.1 確認工程名

管理者登入維運平台，在「開發者模式」下，透過「變更存取路徑」，即可查看FineBI的工程名，預設為webroot 。

使用者可在註冊前根據自身需要修改工程名，註冊後將無法修改。

注：此工程名的修改可能會影響範本的超連結等設定，請謹慎修改。

      修改後，存取工程的地址就變成了http://IP:埠/工程名/decision

2.2 匯出工程ID資訊（7.0.3~7.0.8版本必做）

7.0.3~7.0.8版本 FineBI 工程需完成此操作，其他版本請跨越。

1）管理者登入 FineBI 系統，點選「管理系統>註冊管理 。

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

3）匯出的檔案名稱為「appID.rif」，該檔案中儲存了工程的ID資訊。

2.2 匯出註冊資訊

管理者登入FineBI系統，點選「管理系統>註冊管理>立即註冊」，如下圖所示：

認證方式選擇「本地機器資訊認證」，點選「匯出註冊資訊」，如下圖所示：

匯出的檔案名為RegistrationInformation.rif，該檔案中儲存了 FineBI 工程的版本資訊。

2.3 匯出工程註冊資訊

1）管理者登入 FineBI 系統，點選「管理系統>註冊管理」。

2）在「註冊資訊>版本註冊」後，點選「立即註冊」/「重新註冊」按鈕。

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

4）匯出的檔案名稱為「RegistrationInformation.rif」，該檔案中儲存了工程的版本和機器資訊。7.0.9 及之後版本，該檔案還包含工程的唯一 ID 資訊。

2.4 獲取授權檔案

1）傳送商務郵件

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

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

注2：臨時註冊建議直接透過「帆軟軟體-臨時授權自助導航」入口申請。

2）確認 license 檔案名稱

收到商務傳回的 license 檔案後，請先根據檔案名稱確認是否符合你的註冊需求。

license 檔案命名規則：FanRuan_產品名版本號_認證類型_授權類型_生成日期.lic

範例：FanRuan_FR11.5&BI6.1_LocalMachine_Offical_20250106.lic

2.5 上傳 lic 檔案

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

2）認證方式選擇「本地機器資訊認證」，點選「上傳lic檔案」，選擇商務傳送的 license 檔案上傳。

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

• license 檔案儲存在檔案伺服器的 resources 資料夾中 。

1）進入 FineBI 檔案伺服器中，在/WEB-INF/resources目錄下，刪除「FanRuan.lic」檔案

注：請注意檔案伺服器類型是否支援後端刪除等傳輸細節（例如minio等S3類型，必須透過瀏覽器登入前端存取）

2）使用維運平台的「組件管理」功能，重啟 FineBI 應用節點，取消註冊成功。

4.1 現象描述

若註冊失敗，頁面將出現提示彈窗，如下圖所示：

4.2 失敗原因

點選詳細資訊即可查看註冊失敗的原因，根據具體失敗原因進行排查。

注：除上述外失敗原因外，其他統一報錯：憑證內容不正確。

       有多個失敗原因時，平台中會全部顯示出來。