1. 概述
1.1 版本
報表伺服器版本 | 功能變動 |
---|---|
11.0 | - |
11.0.18 | 注冊失敗提示優化,提供具體失敗原因,幫助使用者排查問題 |
1.2 應用場景
使用者需要注冊多個工程,多次匯出工程資訊十分麻煩,又不想本地搭建授權伺服器。
帆軟搭建了一個公有云認證伺服器,客戶透過填寫認證資訊發起授權請求,傳送至公有云認證伺服器,統一驗證授權。
1.3 功能簡介
公有云注冊方式有以下幾個特點:
1)報表工程進行公有云注冊,將不受物理資訊限制,物理資訊變化不會導致注冊失敗。
2)客戶報表伺服器必須與授權伺服器透過公網連通,不允許開放外網的客戶無法使用該注冊方式。
需要開放的外網位址包括:
域名 | 埠 | 說明 |
---|---|---|
https://register.fanruan.com | 443 | 公有云認證伺服器 |
https://cloud.fanruan.com | 443 | 網址管理中心 |
3)注冊方式簡便易操作,基本不會發生注冊失敗的情況。
4)使用者申請一個授權,可注冊多個工程,價格按照「最大可注冊量」產生波動。
可以在任意報表伺服器注冊,較為靈活。
1.4 注意事項
報表工程會每 2 小時向公有云認證伺服器進行一次查詢認證,若連續 12 次(即 24 小時後)認證失敗,則報表工程顯示注冊失敗,需重新輸入帳號密碼進行注冊。
11.0.18 及之後版本,將在「管理系統>注冊管理」頁面內以列表形式顯示每次認證的失敗時間和失敗原因,幫助使用者排查問題,如下圖所示:注:叢集環境下,每個節點的失敗原因可能不同,將顯示每個節點的失敗原因。
2. 注冊步驟
2.1 獲取授權檔案
請使用合同中指定的郵箱傳送注冊資訊給 FineReport 商務business@fanruan.com,郵件格式如下:
商務收到郵件,覈實無誤後會為使用者生成帳號和密碼,以郵件方式傳送給使用者。
注:若有任何特殊情況,請在郵件中註明。
清單 | 要求 | 注意事項 | |
---|---|---|---|
優先聯絡 | 請提前聯絡帆軟銷售,確認相關事項並簽署合同 | - | |
發件人 | 請使用合同中指定的郵箱 | 如傳送注冊資訊的郵箱,非合同中指定的郵箱,則不予注冊 | |
收件人 | business@fanruan.com | - | |
標題 | XXX 公司注冊 FineReport 正式授權檔案 | 如傳送注冊資訊時,未註明公司名稱,則不予注冊 | |
正文 | 基礎資訊 | 公司名稱:XXX 公司 專案名稱:XXX 專案 合同簽定日期:XXXX年XX月XX日 | - |
注冊方式 | 公有云認證 | - | |
最大可注冊量 | 允許注冊的工程數 | 若不提供該選項,則預設為1 可在部署成功後,在註冊管理頁面「最大連結數」中查看 | |
帳號 | 公有云帳號名 | 如需指定公有云帳號名,請在郵件中註明該項,若帳號名已被佔用則不可使用 如不指定/指定不可用公有云帳號名,商務將為您隨機生成一個帳號 |
2.2 驗證注冊
管理者登入數據決策系統,點選「管理系統>注冊管理>立即注冊」,如下圖所示:
認證方式選擇「公有云認證」,輸入商務傳送郵件中的帳號和密碼,點選「提交認證」,認證成功。如下圖所示:
預設採用 RSA 對公有云密碼進行加密儲存,若切換加密算法,同步進行密碼更新。
3. 注冊失敗
11.0.18 之前版本,若注冊失敗,頁面將出現提示彈窗:認證失敗,請重新認證。
11.0.18 及之後版本,注冊失敗提示資訊優化,若注冊失敗,頁面將彈窗提示具體失敗原因,使用者可根據提示資訊進行排查。
3.1 單機環境注冊失敗
若注冊失敗,頁面將彈窗提示具體失敗原因,點選「詳細資訊」按鈕,即可查看具體失敗原因或問題排查方案,如下圖所示:
點選「傳回」回到注冊管理頁面,「注冊資訊」處會顯示注冊失敗和失敗原因,點選「查看錯誤詳情」即可查看具體失敗原因或問題排查方案,如下圖所示:
3.2 叢集環境注冊失敗
若注冊失敗,不同節點的注冊失敗原因可能不同,頁面將彈窗提示每個節點的具體失敗原因,點選「詳細資訊」按鈕,即可查看具體失敗原因或問題排查方案,如下圖所示:
點選「返回」回到注冊管理頁面,「注冊資訊」處會以列表形式顯示每個節點的失敗原因,點選「查看錯誤詳情」即可查看對應的失敗原因或問題排查方案
3.3 失敗原因
注冊失敗原因匯總如下,使用者可根據具體失敗原因或錯誤詳情中提示的排查方案進行排查。
注1:除以下外失敗原因外,其他統一報錯:憑證內容不正確。
注2:一次注冊過程中有多個失敗原因時,僅展示第一次失敗的原因。
錯誤碼 | 錯誤碼 | 含義 |
---|---|---|
10000 | JSON_PARSER_ERROR | 資料格式不正確 |
10001 | PARAM_INPUT_ERROR | 您輸入參數有誤 |
20000 | DO_NOT_NEED_DEACTIVATE | 該機器未授權無需解除綁定(解除綁定的時候出現該提示,說明這臺機器因未授權無需解除綁定) |
20001 | MYSQL_UPDATE_ERROR | 更新 MYSQL 資料庫出錯 |
20002 | REDIS_UPDATE_ERROR | 往 REDIS 資料庫裏插入資料出錯 |
30000 | LICENSE_EXPIRED | 憑證已過期 |
30001 | REPORT_VERSION_ERROR | 版本不匹配 |
30002 | ACCOUNT_STATUS_ERROR | 賬戶狀態不正常 |
30003 | LICENSE_IP_ERROR | IP 不在允許的範圍之內 |
30004 | LICENSE_DOMAIN_ERROR | 域名不在允許的範圍之內 |
30005 | LICENSE_APPNAME_ERROR | 應用名不在允許的範圍之內 |
30006 | ACCOUNT_INPUT_ERROR | 該賬戶和密碼並未被授權 |
30007 | REGISTER_OUT_OF_LIMIT | 已達可授權數量上限 |
- | 工程伺服器與雲注冊伺服器連結失敗 | - |
4. 注冊遷移
傳送商務郵件時,註明了最大可注冊量。
1)伺服器數量不超過最大可注冊數時,可直接使用原伺服器公有云帳號在新伺服器注冊。
2)若超過最大可注冊數,原伺服器解除綁定後,新伺服器使用原伺服器公有云帳號注冊。
管理者登入數據決策系統,點選「管理系統>注冊管理>版本資訊」,點選「重新注冊>解除綁定」,即可解除舊伺服器的綁定。如下圖所示:
注:原伺服器若不解除綁定,新伺服器使用原伺服器公有云帳號注冊時,注冊失敗,提示:已達可授權數量上限。