RecoverPoint for VMs:如何使用 API 注册和取消注册 RP4VMs 插件程序服务器

Summary: 本文介绍如何使用 API 注册和注销 RecoverPoint for Virtual Machines (RP4VM) 插件服务器。

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

需要在虚拟 Virtual RecoverPoint Appliance (vRPA) 和插件程序服务器之间进行适当的通信,以便 RecoverPoint for Virtual Machines UI 正确显示。通过从 RecoverPoint WDM 运行 Configure Plugin Server Wizard,完成此通信。

如果 RecoverPoint WDM 中的 Configure Plugin Server Wizard 失败,则可以使用插件程序服务器 API 完成相同的过程。

如果出于卸载或重新安装目的需要,插件程序服务器 API 还可用于从特定 vCenter 中删除插件程序服务器。

使用插件程序服务器 API 的优势之一是,它可以提供其他信息来帮助进行插件程序服务器注册。

以下是两个单独的流程,说明如何从 RP4VMs 环境中注册和取消注册插件程序服务器。

 

使用 API 注册 RP4VMs 插件程序服务器的过程:

  1. 使用以下语法打开网页浏览器以访问插件程序服务器:
    https://Plugin_Server_IP/ui

  2. 在右上角,有一个名为“Authorize”的按钮。单击此按钮并输入要在其中注册 RP4VMs 插件程序服务器的 vCenter 的管理员用户名和密码。输入后,单击“关闭”按钮以返回上一个屏幕。

  3. 使用 Web 浏览器中的 Find 选项,找到标记为 VC Inventory 的 API 部分。

  4. 在 VC Inventory 标头下,选择 POST 选项。在屏幕右侧的此部分中,有一个标有“试一试”的按钮。单击此按钮。这样做可以将文本输入到 JSON 框的正文部分。

  5. JSON 的默认正文如下:

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

 

  1. 我们想要确认插件程序服务器所需的根 CA 证书。为此,我们希望第一个注册过程会故意失败。这样做会显示一条消息,指出需要的证书。
    输入以下信息以使注册过程故意失败,从而为我们提供插件程序服务器所需的证书。

    请注意 “证书”:“string,”行保持不变。同样,我们希望它无法确认我们需要从 vCenter 获得的证书。
{
  "address": "vCenter_IP_Address",
  "certificate": "string",
  "password": "vCenter_Password",
  "port": 443,
  "userName": "vCenter_User_Name"
}

 

  1. 将 vCenter 信息输入 JSON 正文后,向下滚动并单击标有“Execute”的蓝色长按钮。

  2. 返回代码显示在“Execute”按钮下方,这应该是 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

    将“string”字段替换为上面复制的输出,然后再次按下“Execute”按钮。

  1. 由于所需的 CA 证书已提前提供给插件程序服务器,因此应显示成功返回代码 200。浏览 vCenter Server UI。
    vCenter UI 顶部会显示一条消息,指出已安装插件程序服务器扩展。
    此外,可能还会在“Recent Tasks”中记录少量消息,指出已下载并部署 RP4VMs 插件程序。刷新浏览器以查看 RP4VMs 图标。
    如果未执行此操作,请注销 vCenter 并重新登录以查看新安装的 RP4VMs 插件。

 

使用 API 注销 RP4VMs 插件程序服务器的过程:
出于各种原因(例如卸载或重新安装 RP4VM),可能需要从 vCenter 中删除插件程序服务器。以下步骤概述了实现此目的的步骤。

  1. 使用以下语法打开网页浏览器以访问插件程序服务器:
    https://Plugin_Server_IP/ui

  2. 在右上角,有一个名为“Authorize”的按钮。单击此按钮并输入要在其中注册 RP4VMs 插件程序服务器的 vCenter 的管理员用户名和密码。输入后,单击“关闭”按钮以返回上一个屏幕。

  3. 使用 Web 浏览器中的 Find 选项,找到标有“VC Inventory”的 API 部分。

  4. 在 VC Inventory 标头下,选择 GET 选项。在屏幕右侧的此部分中,有一个标有“试一试”的按钮。单击此按钮。

  5. 此处不需要参数。在此部分中,应有一个字段标记为“id”,后跟字母数字字符串。复制此字符串而不带引号。这是执行删除命令所需的 vCenter UUID。

  6. 在 VC Inventory 标头下,选择 DELETE 选项。在屏幕右侧的此部分中,有一个标有“试一试”的按钮。单击此按钮。这样做可以将文本输入到 JSON 框的正文部分。

  7. 将从 GET 命令复制的 vCenter UUID 粘贴到“vc-id”字段中,然后选择“Execute”按钮。

  8. 返回代码显示在“Execute”按钮下方,这应该是 204 Successful Request,确认操作已成功从 vCenter 中删除 RP4VMs 插件程序服务器。在 RP4VMs 插件中,由于插件被移除,系统报告一系列未知错误消息,并且 UI 无响应。

  9. 等待几分钟,注销 vCenter,然后重新登录。执行此操作后,应从 vCenter 菜单项列表中删除 RP4VMs 图标。在此之后,您可以注册新的插件程序服务器,而不会发生任何事件。

 

Additional Information

如果上述选项无法正确注册或注销 RP4VMs 插件程序服务器,请联系 Dell Technologies RecoverPoint 支持以获得更多帮助。

 

Article Properties
Article Number: 000196664
Article Type: How To
Last Modified: 06 Feb 2024
Version:  6
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.