RecoverPoint for VMs: Come registrare e annullare la registrazione del server plug-in RP4VMs utilizzando l'API

Affinché l'interfaccia utente di RecoverPoint for Virtual Machines venga visualizzata correttamente, è necessaria una comunicazione corretta tra i Virtual RecoverPoint Appliance (vRPA) e il server plug-in. Questa comunicazione viene completata eseguendo la procedura guidata di configurazione del server plug-in da WDM di RecoverPoint.

Questo stesso processo può essere eseguito utilizzando l'API del server plug-in se la procedura guidata di configurazione del server plug-in da WDM di RecoverPoint non riesce.

L'API del server plug-in può essere utilizzata anche per rimuovere un server plug-in da un vCenter specifico, se necessario per scopi di disinstallazione o reinstallazione.

Uno dei vantaggi dell'utilizzo dell'API del server plug-in è che può fornire informazioni aggiuntive per facilitare la registrazione del server plug-in.

Di seguito sono riportati due processi separati che illustrano come registrare e annullare la registrazione di un server plug-in da un'ambiente RP4VMs.

Procedura per registrare il server plug-in RP4VMs utilizzando l'API:

1. Aprire un web browser sul server plug-in con la sintassi seguente:
   https://Plugin_Server_IP/ui

2. Nell'angolo in alto a destra è presente un pulsante denominato Autorizza. Cliccare su questo pulsante e immettere un nome utente e una password di amministratore per il vCenter in cui si desidera registrare il server plug-in RP4VMs. Una volta inserito, fare clic sul pulsante Chiudi per tornare alla schermata precedente.

3. Utilizzando l'opzione Find all'interno del web browser, individuare la sezione API con etichetta VC Inventory.

4. Sotto l'intestazione VC Inventory selezionare l'opzione POST. All'interno di questa sezione, sul lato destro dello schermo, è presente un pulsante con l'etichetta "Prova". Fare clic sul pulsante. In questo modo è possibile immettere del testo nella sezione del corpo della casella JSON.

5. Il corpo predefinito del JSON è il seguente:

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

1. Vogliamo verificare quale certificato CA root richiede il server plug-in. Per farlo, vogliamo che il primo processo di registrazione fallisca di proposito. In questo modo viene visualizzato un messaggio che indica il certificato necessario.
   Inserisci le seguenti informazioni per fare in modo che il processo di registrazione fallisca di proposito, fornendoci il certificato richiesto dal server dei plug-in.

   NOTA BENE il "certificato": "stringa", la linea rimane invariata. Anche in questo caso, vogliamo che l'operazione non riesca a confermare il certificato richiesto da vCenter.

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

6. Una volta inserite le informazioni di vCenter nel corpo JSON, scorrere verso il basso e cliccare sul lungo pulsante blu con l'etichetta "Execute".

7. Sotto il pulsante "Esegui" viene visualizzato un codice di restituzione, che dovrebbe essere 400 Error: BAD REQUEST, confermando l'operazione non riuscita. L'operazione non è riuscita intenzionalmente perché abbiamo negato al certificato vCenter il server plug-in necessario per completare l'operazione. Sotto il codice di errore viene visualizzato un messaggio:

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

1. Al di sotto di questo è elencato un certificato. Si tratta del certificato root vCenter richiesto dal server plug-in.

   Copiare il certificato negli Appunti. Copiare tutto ciò che inizia con il primo preventivo incluso dopo il seguente: "message": e terminare la copia dopo quanto segue: END CERTIFICATE-----\n

   Sostituisci il campo "string" con l'output copiato sopra e premi nuovamente il pulsante "Execute".

8. Poiché il certificato CA richiesto è stato fornito in anticipo al server plug-in, dovrebbe essere visualizzato un codice restituito di successo di 200. Sfogliare l'interfaccia utente di vCenter Server.
   Nella parte superiore dell'interfaccia utente di vCenter viene visualizzato un messaggio che indica che l'estensione Server plug-in è stata installata.
   È inoltre possibile che vengano registrati alcuni messaggi in "Recent Tasks" che indicano che il plug-in RP4VMs è stato scaricato e implementato. Aggiornare il browser per visualizzare l'icona RP4VMs.
   Se ciò non accade, disconnettersi da vCenter e riconnettersi per visualizzare il plug-in RP4VMs appena installato.

Procedura per annullare la registrazione del server plug-in RP4VMs tramite l'API:
Per vari motivi, ad esempio la disinstallazione o la reinstallazione di RP4VMs, potrebbe essere necessaria la rimozione del server plug-in da vCenter. A tale scopo, vengono descritti i passaggi riportati di seguito.

1. Aprire un web browser sul server plug-in con la sintassi seguente:
   https://Plugin_Server_IP/ui

2. Nell'angolo in alto a destra è presente un pulsante denominato Autorizza. Cliccare su questo pulsante e immettere un nome utente e una password di amministratore per il vCenter in cui si desidera registrare il server plug-in RP4VMs. Una volta inserito, fare clic sul pulsante Chiudi per tornare alla schermata precedente.

3. Utilizzando l'opzione Find all'interno del web browser, individuare la sezione API denominata "VC Inventory".

4. Sotto l'intestazione VC Inventory, selezionare l'opzione GET. All'interno di questa sezione, sul lato destro dello schermo, c'è un pulsante con l'etichetta "Prova". Cliccare su questo pulsante.

5. In questo caso non sono richiesti parametri. All'interno di questa sezione, deve essere presente un campo contrassegnato come "id" seguito da una stringa alfanumerica di caratteri. Copiare questa stringa di caratteri senza virgolette. Si tratta dell'UUID vCenter necessario per il comando di rimozione.

6. Sotto l'intestazione VC Inventory selezionare l'opzione DELETE. All'interno di questa sezione, sul lato destro dello schermo, è presente un pulsante con l'etichetta "Prova". Cliccare su questo pulsante. In questo modo è possibile immettere del testo nella sezione del corpo della casella JSON.

7. Incollare l'UUID vCenter copiato dal comando GET nel campo "vc-id" e selezionare il pulsante "Execute".

8. Sotto il pulsante "Execute" viene visualizzato un return code che dovrebbe essere 204 Successful Request, a conferma della corretta rimozione del server plug-in RP4VMs da vCenter. All'interno del plug-in RP4VMs, viene segnalata una serie di messaggi di errore sconosciuti e l'interfaccia utente non risponde, a causa della rimozione del plug-in.

9. Attendere alcuni minuti, quindi disconnettersi da vCenter e quindi effettuare nuovamente l'accesso. Dopo aver eseguito questa operazione, l'icona RP4VMs deve essere rimossa dall'elenco delle voci di menu di vCenter. Dopodiché, è possibile registrare un nuovo server plug-in senza incidenti.

Se le opzioni descritte sopra non funzionano per registrare o annullare correttamente la registrazione del server plug-in RP4VMs, contattare il supporto Dell Technologies RecoverPoint per ulteriore assistenza.