Recovering an Agent VM

Recovering a failed or lost Agent VM in your running Data Management for VMware Tanzu installation is similar to tasks performed during deployment: the Organization Administrator deploys a new Agent VM and onboards the new Agent, but in Recover Environment mode.

Data Management for VMware Tanzu does not automatically transfer custom certificates for you; you must manually upload any custom certificates to the new Agent VM.

Audience

The procedures in this topic are performed by a Data Management for VMware Tanzu user in the Organization Administrator role.

Prerequisites

Before you recover the Agent VM, ensure that you can identify:

• The static IP address of the original Agent VM; you must deploy the new Agent VM with the same configuration.
• The environment identifier (ENV ID) assigned to the original Agent VM.

Procedure

Perform the following procedure to recover an Agent VM in your Data Management for VMware Tanzu installation:

1. Deploy an Agent VM Using a vSphere Client.

   Be sure to deploy the VM with the same static IP address as the original Agent VM.

2. Prepare to Onboard the new Agent by ensuring that:

   • The Agent VM is deployed and has booted properly.

   • The Agent VM /etc/hosts file includes an entry similar to the following:

     <Tenant Appliance vCenter-IP>       company_vc.vsphere.local
     

   • You can identify the root login credentials for the newly-deployed Agent VM.

3. Onboard the Agent with Data Management for VMware Tanzu.

   Be sure to select the Recover Environment onboarding type, and provide the environment identifier assigned to the original Agent VM.

4. If you have registered custom certificates in your Data Management for VMware Tanzu installation, you must manually copy these certificates to the new Agent VM as described in Managing Certificates on an Agent.