RecoverPoint for VMs：APIを使用してRP4VMプラグイン サーバーを登録および登録解除する方法

RecoverPoint for Virtual MachinesのUIを正しく表示するには、仮想RecoverPoint Appliances (vRPA)とプラグイン サーバー間の適切な通信が必要です。この通信は、RecoverPoint WDMからプラグイン サーバーの設定ウィザードを実行することで完了します。

RecoverPoint WDMからの「プラグイン サーバーの設定」ウィザードが失敗した場合は、これと同じ処理をプラグイン サーバーAPIを使用して実行できます。

プラグイン サーバーAPIは、アンインストールまたは再インストールの目的で必要な場合、特定のvCenterからプラグイン サーバーを削除するためにも使用できます。

プラグイン サーバーAPIを使用する利点の1つは、プラグイン サーバーの登録に役立つ追加情報を提供できることです。

以下は、RP4VM環境からプラグイン サーバーを登録および登録解除する両方の方法を2つのプロセスに分けて説明します。

APIを使用してRP4VMプラグイン サーバーを登録するプロセス:

1. 次の構文を使用して、Webブラウザーでプラグイン サーバーを開きます。
   https://Plugin_Server_IP/ui

2. 右上隅に、［Authorize］というボタンがあります。このボタンをクリックし、お使いのRP4VMsプラグイン サーバーを登録するvCenterの管理者ユーザー名とパスワードを入力します。入力したら、[閉じる]ボタンをクリックして前の画面に戻ります。

3. Web ブラウザー内の [検索] オプションを使用して、[VC インベントリ] というラベルの付いた 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"
}

6. vCenterの情報をJSON本文に入力したら、下にスクロールして、[Execute]というラベルの付いた長い青いボタンをクリックします。

7. [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"」の部分までコピーしたら END CERTIFICATE-----\n

   「string」フィールドを上記でコピーした出力に置き換え、「Execute」ボタンをもう一度押します。

8. 必要なCA証明書はプラグイン サーバーに事前に付与されているため、正常なリターン コード200が表示されます。vCenter Server UIを参照します。
   プラグイン サーバー拡張機能がインストールされたことを示すメッセージが、vCenter UIの上部に表示されます。
   また、RP4VMプラグインがダウンロードおよび導入されたことを示すメッセージが[Recent Tasks]に記録される場合もあります。ブラウザーを更新して、[RP4VMs]アイコンを表示します。
   これが発生しない場合は、vCenterからログアウトして再度ログインし、新しくインストールされたRP4VMプラグインを表示します。

APIを使用してRP4VMプラグイン サーバーを登録解除するプロセス:
RP4VMのアンインストールや再インストールなど、さまざまな理由により、vCenterからのプラグイン サーバーの削除が必要になる場合があります。これを実現するための手順の概要を以下に示します。

1. 次の構文を使用して、Webブラウザーでプラグイン サーバーを開きます。
   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からRP4VMプラグイン サーバーを正常に削除できたことを示します。RP4VMプラグイン内で、一連の不明なエラー メッセージが報告され、プラグインが削除されているため、UIが応答しません。

9. 数分経過してから、vCenterからログアウトし、再度ログインします。そうすると、vCenterのメニュー項目一覧からRP4VMアイコンが削除されているはずです。この後、新しいプラグイン サーバーを問題なく登録できます。

上記のオプションでRP4VMプラグイン サーバーを適切に登録または登録解除できない場合は、Dell Technologies RecoverPointサポートにお問い合わせください。