1. 概述
1.1 版本
| 報表伺服器版本 | 功能變動 |
|---|---|
| 11.0 | - |
| 11.0.18 | 注冊失敗提示資訊優化，提供具體失敗原因和解決方案 |
1.2 功能簡介
本地機器資訊認證是最常見的認證方式，操作簡單，十分方便。
報表工程所在伺服器的物理資訊固定，使用者透過匯出 rif 檔案，獲取 mac 位址和機器碼，來生成一個唯一標識的 license 檔案。
1.3 注意事項
推薦使用者使用最簡單快捷的登入方法：本地容器認證。
1）本地機器資訊認證，需要報表工程所在伺服器的物理資訊固定。如不固定，不適合使用該登入方法。
例如報表工程部署在虛擬機環境下，虛擬機環境下物理資訊可能變化，造成登入失敗，請選取其他登入方式。
2）一個正式 license 檔案在一臺機器上只能注冊一次，若需要在同一臺機器上注冊多個工程，則需要購買多個 license 。
3）一個正式 license 檔案只適用於一臺伺服器，如需更換伺服器，需要進行注冊遷移。
4）同一伺服器下跨大版本升級（9.0升級10.0）後，需要進行注冊遷移。推薦使用：授權遷移插件 。
5）請確定工程使用 JDK 1.8 且小版本需在 JDK8u200 以上。
6）Mac位址不允許設定為空，不允許不限。因為正式 license 檔案強制校驗Mac位址，為空則一定會注冊失敗。
2. 注冊步驟
2.1 確認工程名
開啟報表工程所在伺服器%FR_HOME%\webapps\目錄，確認報表 Web 工程名，預設為webroot。
使用者可在注冊前根據自身需要修改工程名，注冊後將無法修改。
注：此工程名的修改可能會影響範本的超連結等設定，請謹慎修改。
修改工程名就是改這個資料夾的名稱，修改後，存取工程的位址就變成了http://IP:埠/工程名/decision
2.2 匯出注冊資訊
啟動 FineReport 工程所在伺服器，管理者存取數據決策系統，點選「管理系統>注冊管理」；
在「版本資訊」 Tab 頁下點選「立即注冊」，認證方式選擇「本地機器資訊認證」，點選「匯出注冊資訊」，如下圖所示：
匯出的檔案名稱為RegistrationInformation.rif，該檔案中儲存了報表工程的版本資訊。
2.3 獲取授權檔案
請使用合同中指定的郵箱傳送登入資訊給 FineReport 商務business@fanruan.com，郵件格式如下：
注：若有任何特殊情況，請在郵件中註明。
| 清單 | 內容 | 注意事項 |
|---|---|---|
| 優先聯絡 | 請提前聯絡帆軟銷售，確認相關事項並簽署合同 | - |
| 發件人 | 請使用合同中指定的郵箱 | 如傳送注冊資訊的郵箱，非合同中指定的郵箱，則不予注冊 |
| 收件人 | business@fanruan.com | - |
| 標題 | XXX 公司注冊 FineReport 正式授權檔案 | 如傳送注冊資訊時，未註明公司名稱，則不予注冊 |
| 正文 | 公司名稱：XXX 公司 專案名稱：XXX 項 合同簽定日期：XXXX年XX月XX日 注冊方式：本地機器資訊認證 | 其他併發數、使用者數等資訊，將按照簽訂的合同進行注冊 |
| 附件 | 上述匯出的 rif 檔案 | 不要開啟生成的 RegistrationInformation.rif檔案，這會導致檔案損壞，如果再將其傳送給帆軟商務，就會導致注冊不成功 |
2.4 上傳 lic 檔案
商務收到郵件，覈實無誤後會為您生成一個FanRuan.lic授權檔案，以郵件方式傳送給您。
點選「管理系統>注冊管理>版本資訊」，點選「上傳lic檔案」，匯入 FanRuan.lic 授權檔案，如下圖所示：
若正確無誤，此時會顯示注冊成功，如下圖所示：
注：FanRuan.lic會自動儲存到您當前工程%FR-HOME%\webroot\WEB-INF\resources 目錄下。
3. 取消注冊
1）進入%FR_HOME%/webroot/WEB-INF/resources 目錄下，刪除「FanRuan.lic」檔案，如下圖所示：
2）重啟報表伺服器。
4. 注冊失敗
11.0.18 之前版本，若注冊失敗，頁面將出現提示彈窗：注冊失敗，請重新注冊。
11.0.18 及之後版本，注冊失敗提示資訊優化，若注冊失敗，頁面將彈窗提示具體的失敗原因，並提供相應的解決方案或問題排查步驟。
4.1 單機環境注冊失敗
若注冊失敗，頁面將彈窗提示具體失敗原因，點選「詳細資訊」按鈕，即可查看解決方案或問題排查步驟，如下圖所示：
點選「傳回」回到注 冊管理頁面，「注冊資訊」處會顯示注冊失敗和失敗原因，點選「查看錯誤詳情」即可查看解決方案或問題排查步驟，如下圖所示：
4.2 叢集環境注冊失敗
若注冊失敗，不同節點的注冊失敗原因可能不同，頁面將彈窗提示每個節點的具體失敗原因，點選「詳細資訊」按鈕，即可查看對應的解決方案或問題排查步驟，如下圖所示：
點選「傳回」回到注冊管理頁面，「注冊資訊」處會以列表形式顯示每個節點的失敗原因，點選「查看錯誤詳情」即可查看對應的解決方案或問題排查步驟
4.3 失敗原因匯總
注冊失敗原因匯總如下，使用者可根據具體失敗原因以及錯誤詳情進行問題排查。
注1：除以下失敗原因外，其他統一報錯：憑證內容不正確。
注2：一次登入過程中有多個失敗原因時，僅展示第一次失敗的原因。
| 失敗型別 | 失敗原因 |
|---|---|
| lic本身問題 | lic檔案損壞或版本錯誤 |
| 憑證過期 過期時間：xxx | |
| lic檔案已被銷燬 | |
| lic上傳問題 | lic上傳失敗 |
| lic附件上傳失敗 | |
| lic檔案未透過上傳校驗 | |
| 硬體問題 | MAC 位址不匹配 本地 MAC 位址：xxx 認證 MAC 位址：xxx |
機器碼不匹配 本地機器碼：xxx 認證機器碼：xxx | |
| 環境問題 | 授權使用的埠 xxx 存在衝突，已達可授權數量上限 |
5. 注冊過期提醒
提醒：期限為 15 天，自達到提醒期限開始，超級管理者每次登入管理平台，都會收到平台通知
內容：您的授權允許將於 n 天后過期，請儘快重新授權。如下圖所示：
