Deploying the Agent VM installs and configures a Data Management for VMware Tanzu agent in a vSphere Cluster.

You will perform the following procedure to install and deploy the Agent VM:

Step 1: Satisfy the Prerequisites
Step 2: Identify the Agent .ova download URL, or optionally download the Agent .ova package
Step 3: Install the Agent .ova on vCenter
Step 4: Power On the Agent VM


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

Step 1: Prerequisites

Before you begin deploying the Agent VM, your vCenter must be configured. Ensure that you have on hand and can identify:

  • The IP address or fully-qualified distinguished name for your vCenter Server instance.
  • Your vCenter administrator credentials.
  • The vSphere Cluster or ESXi host on which you want to install and deploy the VM.
  • The network or distributed port group that will host the Control Plane Network (eth0) for the Agent VM. This network must be able to access the Control Plane Network (eth1) configured for the Provider VM.
  • The network information for the Agent VM if you plan to assign it a static IP address, including the IP address, netmask, gateway, and domain information.

Step 2: Downloading the Agent .ova

The Data Management for VMware Tanzu Agent .ova is available as a separate download from VMware Tanzu Network and VMware Customer Connect.

Perform these steps to download the Agent .ova:

  1. Navigate to Data Management for VMware Tanzu on VMware Tanzu Network or VMware Customer Connect, locate and select Agent Virtual Appliance, and download the file.

    The format of the Agent virtual appliance download file name is:


    For example:

  2. Make note of the directory to which the file was downloaded.

Step 3: Installing the Agent .ova on vCenter

  1. Open a web browser window, and log in to your vCenter Server instance:

  2. Locate the data center and cluster.
  3. Right click on a cluster or ESXi host, or another inventory object, and then select Deploy OVF Template.

    The Select an OVF Template form displays.

  4. Deploy the OVF template at the desired location.

  5. On the Select a compute resource form, select the cluster or ESXi host on which to install the Agent VM. Click NEXT after vCenter successfully completes compatibility checks on the selected object.

    After resource validation on the selected deployment target completes, the Review details form displays.

  6. Examine the template details for the Agent VM, taking note of the Size on disk values. This information may help inform your selection of storage configuration for the Agent VM in an upcoming step.
  7. Click NEXT.

    The Select storage form displays.

  8. Specify the disk format and the data store for the virtual machine files and virtual disks:

    Property Name Value
    Encrypt this virtual machine This option is currently disabled.
    Select virtual disk format Select the format of the virtual disk from the drop-down menu. Choices are Thick Provision Lazy Zeroed (recommended for production environments), Thin Provision, or Thick Provision Eager Zeroed. Note that thick formats improve performance, while thin formats save storage space. Storage Provisioning and Space Reclamation in the VMware vSphere documentation provides more information about these settings.
    VM Storage Policy Retain the Datastore Default policy or select a preconfigured policy from the dropdown list.
    Disable Storage DRS for this virtual machine When you check this setting, vSphere cannot move the VM to a different datastore.
    Disk Choose the destination storage disk and select the associated table row.
  9. Wait for the compatibility checks for your selections to succeed, and then click NEXT.

    The Select networks form displays.

  10. Use the Destination Network drop-down menu to select the Control Plane Network for the Agent VM.

  11. Review the IP Allocation Settings, and then click NEXT to complete the network configuration.

    The Agent Customize template form displays.

  12. Use the Customize template to configure these Agent Application properties:

    Property Name Value
    Agent VM Root Password The password for the root user on the Agent VM.
    VM Admin Password The password for the admin user on the Agent VM.
    NTP Server The NTP server URL. The Provider, Agent, and Service Instance VMs must all use the same NTP Server.
  13. Configure the Networking Properties of the Agent VM. Agent recovery requires that the VM have a static IP address assigned to it. Specify values for the following properties:

    Property Name Value
    Default Gateway The IP address of the default gateway for the Agent VM.
    Domain Name The DNS search domain.
    Note: Each Agent must be assigned a unique Domain Name.
    Domain Name Servers The IP address of the domain name server for the Agent VM.
    Control Plane Network IP Address The IP address for the Agent VM on the Control Plane Network.
    Control Plane Network Netmask The netmask or prefix for the Agent VM on the Control Plane Network.
  14. Click NEXT.

  15. Examine the Agent VM configuration displayed on the Ready to complete form, and click FINISH.

    Note: It may take some time to deploy the Agent VM. Monitor the Recent Tasks table at the bottom of the vCenter UI to follow the progress of the operation.

Step 4: Powering On the Agent VM

Power on the Agent VM after it successfully deploys:

  1. Return to the vCenter UI.

  2. Locate the cluster in which you deployed the VM, recall the name of the VM, and select it from the left navigation pane.

  3. Click the green Play icon at the top of the main pane, or click Actions and select Power->Power On from the pop up menu.

    Note: Powering on and initializing the VM may take some time. Monitor the Recent Tasks table at the bottom of the vCenter UI to monitor the progress of the power on operation.

Next Steps

You successfully installed and deployed the Agent VM. Next, you perform certain tasks as you prepare to onboard the Agent VM.

check-circle-line exclamation-circle-line close-line
Scroll to top icon