RecoverPoint for VMs: Como registrar e cancelar o registro do servidor plug-ins de RP4VMs usando a API

A comunicação adequada entre os Virtual RecoverPoint Appliances (vRPAs) e o servidor de plug-ins é necessária para que a IU do RecoverPoint for Virtual Machines seja exibida corretamente. Essa comunicação é concluída executando o assistente Configure Plugin Server do WDM do RecoverPoint.

Esse mesmo processo poderá ser feito usando a API do servidor de plug-ins se o assistente Configure Plugin Server do WDM do RecoverPoint estiver falhando.

A API do servidor de plug-ins também pode ser usada para remover um servidor de plug-ins de um vCenter específico se isso for necessário para fins de desinstalação ou reinstalação.

Uma das vantagens de usar a API do Plugin Server é que ela pode fornecer informações adicionais para ajudar no registro do Plugin Server.

Abaixo estão dois processos separados que ilustram como registrar e cancelar o registro de um servidor plug-ins de um ambiente RP4VMs.

Processo para registrar o servidor de plug-in do RP4VMs usando a API:

1. Abra um navegador da Web para o Plugin Server com a seguinte sintaxe:
   https://Plugin_Server_IP/ui

2. No canto superior direito, há um botão chamado Authorize. Clique neste botão e digite um nome de usuário e uma senha de administrador do vCenter em que você deseja registrar seu servidor de plug-ins de RP4VMs. Uma vez inserido, clique no botão Fechar para voltar à tela anterior.

3. Usando a opção Localizar no navegador da Web, localize a seção de API denominada VC Inventory.

4. No cabeçalho VC Inventory, selecione a opção POST. Dentro desta seção, no lado direito da tela, há um botão identificado como "Try It Out". Clique no botão. Isso permite que o texto seja inserido na seção body da caixa JSON.

5. O corpo padrão do JSON é o seguinte:

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

1. Queremos confirmar qual certificado raiz da CA o servidor de plug-in exige. Para fazer isso, queremos que o primeiro processo de registro falhe de propósito. Isso apresentará uma mensagem informando o certificado necessário.
   Insira as informações a seguir para que o processo de registro falhe propositalmente, fornecendo-nos o certificado que o servidor de plug-in exige.

   OBSERVE o "certificado": "string", a linha permanece inalterada. Novamente, queremos que isso não confirme o certificado que exigimos do vCenter.

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

6. Depois que as informações do vCenter tiverem sido inseridas no corpo JSON, role para baixo e clique no botão azul longo identificado como "Execute".

7. Um código de retorno é exibido abaixo do botão "Execute", que deve ser 400 Error: BAD REQUEST, confirmando a falha da operação. A operação falhou de propósito, pois negamos ao vCenter o certificado do servidor de plug-ins necessário para concluir a operação. Abaixo do código de erro, uma mensagem é exibida:

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

1. Abaixo dela, há um certificado listado. Esse é o certificado raiz do vCenter que o servidor de plug-in exige.

   Copie o certificado para sua área de transferência. Copie tudo começando com e incluindo as primeiras aspas após o seguinte: "message": e termine a cópia após o seguinte: END CERTIFICATE-----\n

   Substitua o campo "string" pela saída copiada acima e pressione o botão "Execute" mais uma vez.

8. Como o certificado CA necessário foi fornecido com antecedência ao servidor de plug-in, um código de retorno 200 bem-sucedido deverá ser exibido. Navegue até a IU do vCenter Server.
   Uma mensagem informando que a extensão do servidor de plug-in foi instalada aparece na parte superior da interface do usuário do vCenter.
   Algumas mensagens também podem ser gravadas em "Recent Tasks" informando que o plug-in RP4VMs foi baixado e implementado. Atualize seu navegador para visualizar o ícone RP4VMs.
   Se isso não acontecer, faça log-out do vCenter e entre novamente para visualizar o plug-in RP4VMs recém-instalado.

Processo para cancelar o registro do servidor de plug-in RP4VMs usando a API:
Por vários motivos, como desinstalar ou reinstalar RP4VMs, talvez seja necessário remover o servidor de plug-in do vCenter. As etapas abaixo descrevem isso.

1. Abra um navegador da Web para o Plugin Server com a seguinte sintaxe:
   https://Plugin_Server_IP/ui

2. No canto superior direito, há um botão chamado Authorize. Clique neste botão e digite um nome de usuário e uma senha de administrador do vCenter em que você deseja registrar seu servidor de plug-ins de RP4VMs. Uma vez inserido, clique no botão Fechar para voltar à tela anterior.

3. Usando a opção Localizar no navegador da Web, localize a seção da API chamada "VC Inventory".

4. No cabeçalho VC Inventory, selecione a opção GET. Dentro desta seção, no lado direito da tela, há um botão identificado como "Try It Out". Clique nesse botão.

5. Nenhum parâmetro é necessário aqui. Nessa seção, deve haver um campo identificado como "id" seguido por uma string alfanumérica de caracteres. Copie essa string de caracteres sem aspas. Esse é o UUID do vCenter necessário para o comando de remoção.

6. No cabeçalho VC Inventory, selecione a opção DELETE. Dentro desta seção, no lado direito da tela, há um botão identificado como "Try It Out". Clique nesse botão. Isso permite que o texto seja inserido na seção body da caixa JSON.

7. Cole o UUID do vCenter copiado do comando GET no campo "vc-id" e selecione o botão "Execute".

8. Um código de retorno é exibido abaixo do botão "Execute", que deve ser 204 Successful Request, confirmando que a operação removeu com sucesso o servidor de plug-ins de RP4VMs do vCenter. No plug-in RP4VMs, uma série de mensagens de erro desconhecidas é relatada e a interface do usuário não está respondendo, devido à remoção do plug-in.

9. Aguarde alguns minutos, faça log-out do vCenter e, em seguida, faça login novamente. Depois disso, o ícone RP4VMs deve ser removido da lista de itens de menu do vCenter. Depois disso, você pode registrar um novo Plugin Server sem incidentes.

Se as opções acima não funcionarem para registrar ou cancelar corretamente o registro do servidor do plug-in RP4VMs, entre em contato com o suporte do Dell Technologies RecoverPoint para obter assistência adicional.