RecoverPoint for VMs：如何使用 API 註冊和取消註冊 RP4VM 附掛程式伺服器

Virtual RecoverPoint Appliances (vRPAs) 和附掛程式伺服器之間需要有良好的通訊能力，才能正確顯示 RecoverPoint for Virtual Machines 的 UI。從 RecoverPoint WDM 執行「配置附掛程式伺服器」精靈，可完成此通訊。

如果 RecoverPoint WDM 的「配置附掛程式伺服器」精靈失敗，也可以使用附掛程式伺服器 API 來執行相同程序。

若解除安裝或重新安裝時需要，也可使用附掛程式伺服器 API 從特定 vCenter 移除附掛程式伺服器。

使用外掛程式伺服器 API 的優點之一是，它可以提供其他資訊來幫助進行外掛程式伺服器註冊。

以下為兩個獨立的程序，說明如何從 RP4VM 環境中註冊和取消註冊附掛程式伺服器。

使用 API 註冊個 rp4vm 附掛程式伺服器的程序：

1. 使用下列語法開啟網頁瀏覽器至附掛程式伺服器：
   https://Plugin_Server_IP/ui

2. 在右上角，有一個稱為「授權」的按鈕。按一下此按鈕，然後輸入要註冊 RP4VM 附掛程式伺服器之 vCenter 的系統管理員使用者名稱和密碼。進入後，按一下關閉按鈕，讓您回到上一個畫面。

3. 使用網頁瀏覽器中的「尋找」選項，找到標示為「VC 清查」的 API 區段。

4. 在「VC 清查」標題下，選取「POST」選項。在屏幕右側的此部分中，有一個標有“試用”的按鈕。按一下按鈕。這樣做可以將文本輸入到 JSON 框的正文部分中。

5. JSON 的預設內文如下：

{
  "address": "string",
  "certificate": "string",
  "password": "string",
  "port": 443,
  "userName": "string"
}

1. 我們要確認附掛程式伺服器需要哪個根 CA 憑證。為此，我們會故意讓第一個註冊程序失敗。這樣會顯示訊息，指出所需的憑證。
   輸入以下資訊以使註冊過程故意失敗，為我們提供外掛程式伺服器所需的證書。

   請注意 「憑證」：「字串」行維持不變。同樣地，我們希望這無法確認我們需要的 vCenter 憑證。

{
  "address": "vCenter_IP_Address",
  "certificate": "string",
  "password": "vCenter_Password",
  "port": 443,
  "userName": "vCenter_User_Name"
}

6. 將 vCenter 資訊輸入 JSON 內文後，向下捲動並按一下標示為「執行」的藍色長按鈕。

7. 返回代碼出現在「執行」按鈕下方，應該是 400 Error: BAD REQUEST，確認操作失敗。由於我們拒絕提供附掛程式完成作業所需的 vCenter 憑證，因此該作業會失敗。錯誤代碼下方會顯示訊息：

You must confirm the root CA certificate for vCenter Server '<vCenter_IP>:443' before you can register it.

1. 在此下方會列出一個憑證。這是附掛程式伺服器所需的 vCenter 根憑證。

   將憑證複製至剪貼簿。複製 "message": 之後的所有內容，包括第一個雙引號，並複製到以下字串的最尾端： END CERTIFICATE-----\n

   將“字串”字段替換為上面複製的輸出，然後再次按“執行”按鈕。

8. 由於所需的 CA 憑證已提前提供給附掛程式伺服器，因此應會顯示成功的返回代碼 200。瀏覽 vCenter 伺服器 UI。
   指出已安裝附掛程式伺服器延伸模組的訊息會出現在 vCenter UI 頂端。
   一些訊息可能也會記錄在「最近的工作」中，指出已下載並部署 RP4VM 附掛程式。重新整理瀏覽器以檢視 RP4VM 圖示。
   如果沒有，請登出 vCenter，然後返回以檢視新安裝的 RP4VM 附掛程式。

使用 API 取消註冊個 rp4vm 附掛程式伺服器的程序：
由於各種原因，例如解除安裝或重新安裝 RP4VM，可能需要從 vCenter 移除附掛程式伺服器。下列步驟概述如何完成此作業。

1. 使用下列語法開啟網頁瀏覽器至附掛程式伺服器：
   https://Plugin_Server_IP/ui

2. 在右上角，有一個稱為「授權」的按鈕。按一下此按鈕，然後輸入要註冊 RP4VM 附掛程式伺服器之 vCenter 的系統管理員使用者名稱和密碼。進入後，按一下關閉按鈕，讓您回到上一個畫面。

3. 使用網頁瀏覽器中的「尋找」選項，找到標示為「VC 詳細目錄」的 API 區段。

4. 在「VC 清查」標題下，選取「GET」選項。在屏幕右側的此部分中，有一個標有“試用”的按鈕。按一下此按鈕。

5. 此處不需要任何參數。在本區段中，應該會有一個欄位標示為「id」，隨後為英數字串。複製此字串，不需要複製引號。這是您執行移除命令所需的 vCenter UUID。

6. 在「VC 清查」標題下，選取「DELETE」選項。在屏幕右側的此部分中，有一個標有“試用”的按鈕。按一下此按鈕。這樣做可以將文本輸入到 JSON 框的正文部分中。

7. 將從 GET 命令複製的 vCenter UUID 貼至「vc-id」欄位，然後選取「執行」按鈕。

8. 在「執行」按鈕下會顯示返回代碼，應為 204 成功要求，確認該作業已成功從 vCenter 移除 RP4VM 附掛程式伺服器。在 RP4VMs 附掛程式中，會回報一系列未知的錯誤訊息，且由於已移除附掛程式，UI 沒有回應。

9. 請等待數分鐘，然後登出 vCenter 並重新登入。之後，RP4VM 圖示應會從 vCenter 的功能表項目清單中移除。在此之後，您可以註冊新的外掛程式伺服器而不會發生任何事件。

如果上述選項無法正確註冊或取消註冊 RP4VM 附掛程式伺服器，請聯絡 Dell Technologies RecoverPoint 支援以取得其他協助。