RecoverPoint voor VM's: De RP4VMs plug-inserver registreren en deregistreren met behulp van de API

Goede communicatie tussen de Virtual RecoverPoint Appliances (vRPA's) en de plug-inserver is vereist om de gebruikersinterface van RecoverPoint for Virtual Machines correct weer te geven. Deze communicatie wordt voltooid door het uitvoeren van de wizard Configure Plugin Server van de RecoverPoint WDM.

Ditzelfde proces kan worden uitgevoerd met behulp van de plug-in server-API als de wizard Plugin Server configureren van de RecoverPoint WDM niet werkt.

De plug-in server-API kan ook worden gebruikt om een plug-inserver uit een specifiek vCenter te verwijderen als dit nodig is voor verwijderings- of herinstallatiedoeleinden.

Een van de voordelen van het gebruik van de Plugin Server API is dat het aanvullende informatie kan bieden om te helpen bij de Plugin Server registratie.

Hieronder vindt u twee afzonderlijke processen die illustreren hoe u een plug-inserver kunt registreren en verwijderen vanuit een RP4VMs-omgeving.

Proces voor het registreren van de RP4VMs Plugin Server met behulp van de API:

1. Open een webbrowser naar de plug-inserver met de volgende syntaxis:
   https://Plugin_Server_IP/ui

2. In de rechterbovenhoek bevindt zich een knop met de naam Autoriseren. Klik op deze knop en voer een gebruikersnaam en wachtwoord in voor het vCenter waar u uw RP4VMs Plugin Server wilt registreren. Eenmaal ingevoerd, klikt u op de knop Sluiten om terug te gaan naar het vorige scherm.

3. Zoek met behulp van de optie Zoeken in de webbrowser de API-sectie met het label VC-inventaris.

4. Selecteer onder de kop VC-inventaris de optie POST. In dit gedeelte aan de rechterkant van het scherm bevindt zich een knop met het label 'Probeer het uit'. Klik op de knop. Als u dit doet, kan tekst worden ingevoerd in de hoofdtekst van het JSON-vak.

5. De standaardtekst van de JSON is de volgende:

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

1. We willen bevestigen welk root-CA-certificaat de plug-inserver nodig heeft. Om dat te doen, willen we het eerste registratieproces expres laten mislukken. Als u dit doet, wordt een bericht weergegeven met het certificaat dat nodig is.
   Voer de volgende informatie in om het registratieproces opzettelijk te laten mislukken, zodat wij het certificaat krijgen dat de Plugin Server nodig heeft.

   LET OP het "certificaat": "string", regel blijft ongewijzigd. Nogmaals, we willen dat dit niet het certificaat bevestigt dat we van vCenter nodig hebben.

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

6. Zodra de vCenter-informatie is ingevoerd in de JSON-body, scrolt u omlaag en klikt u op de lange, blauwe knop met het label 'Execute'.

7. Er verschijnt een retourcode onder de knop "Uitvoeren", die zou moeten worden 400 Error: BAD REQUEST, waarin wordt bevestigd dat de bewerking is mislukt. De bewerking is met opzet mislukt omdat we het vCenter-certificaat de plug-inserver hebben geweigerd die nodig is om de bewerking te voltooien. Onder de foutcode wordt een bericht weergegeven:

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

1. Daaronder staat een certificaat dat wordt vermeld. Dit is het vCenter-basiscertificaat dat de plug-inserver nodig heeft.

   Kopieer het certificaat naar uw klembord. Kopieer alles beginnend met en inclusief de eerste offerte na het volgende: "message": en beëindig de kopie na het volgende: END CERTIFICATE-----\n

   Vervang het "string"-veld door de gekopieerde uitvoer hierboven en druk nogmaals op de knop "Execute".

8. Omdat het vereiste CA-certificaat van tevoren aan de plug-inserver is gegeven, moet een succesvolle retourcode van 200 worden weergegeven. Navigeer door de vCenter server-UI.
   Een bericht dat de plug-in serverextensie is geïnstalleerd, wordt boven aan de vCenter-gebruikersinterface weergegeven.
   Er kunnen ook enkele berichten worden opgenomen in de "Recente taken" waarin staat dat de RP4VMs-plug-in is gedownload en geïmplementeerd. Vernieuw uw browser om het RP4VMs-pictogram weer te geven.
   Als dit niet gebeurt, meldt u zich af bij vCenter en weer in om de nieuw geïnstalleerde RP4VMs-plugin te bekijken.

Proces voor het deregistreren van de RP4VMs Plugin Server met behulp van de API:
Om verschillende redenen, zoals het verwijderen of opnieuw installeren van RP4VM's, kan verwijdering van de Plugin Server uit het vCenter vereist zijn. De onderstaande stappen worden beschreven om dit te bereiken.

1. Open een webbrowser naar de plug-inserver met de volgende syntaxis:
   https://Plugin_Server_IP/ui

2. In de rechterbovenhoek bevindt zich een knop met de naam Autoriseren. Klik op deze knop en voer een gebruikersnaam en wachtwoord in voor het vCenter waar u uw RP4VMs Plugin Server wilt registreren. Eenmaal ingevoerd, klikt u op de knop Sluiten om terug te gaan naar het vorige scherm.

3. Zoek met behulp van de optie Zoeken in de webbrowser het API-gedeelte met het label 'VC-inventaris'.

4. Selecteer onder de kop VC-inventaris de optie GET. In dit gedeelte aan de rechterkant van het scherm bevindt zich een knop met het label 'Probeer het uit'. Klik op deze knop.

5. Hier zijn geen parameters vereist. In dit gedeelte moet er een veld met het label 'id' zijn, gevolgd door een alfanumerieke tekenreeks. Kopieer deze tekenreeks zonder aanhalingstekens. Dit is de vCenter-UUID die u nodig hebt voor de verwijderingsopdracht.

6. Selecteer onder de kop VC-inventaris de optie DELETE. In dit gedeelte aan de rechterkant van het scherm bevindt zich een knop met het label 'Probeer het uit'. Klik op deze knop. Als u dit doet, kan tekst worden ingevoerd in de hoofdtekst van het JSON-vak.

7. Plak de vCenter-UUID die u van de GET-opdracht hebt gekopieerd in het veld "vc-id" en selecteer de knop "Execute".

8. Er wordt een retourcode weergegeven onder de knop "Execute", wat 204 Successful Request moet zijn, wat bevestigt dat de bewerking de RP4VMs Plugin Server uit vCenter heeft verwijderd. Binnen de RP4VMs Plugin wordt een reeks onbekende foutmeldingen gerapporteerd en de UI reageert niet omdat de Plugin is verwijderd.

9. Wacht een paar minuten en meld u vervolgens af bij vCenter en meld u vervolgens weer aan. Nadat u dit hebt gedaan, moet het RP4VMs-pictogram worden verwijderd uit de vCenter-lijst met menu-items. Hierna kunt u zonder incidenten een nieuwe plug-in server registreren.

Als de bovenstaande opties niet werken om de RP4VMs Plugin Server correct te registreren of te deregistreren, neem dan contact op met Dell Technologies RecoverPoint support voor extra hulp.