VMware Cloud Builder is a virtual appliance that is used to deploy and configure the first cluster of the management domain and transfer inventory and control to SDDC Manager. During the deployment process, the VMware Cloud Builder appliance validates network information you provide in the deployment parameter workbook such as DNS, network (VLANS, IPs, MTUs), and credentials.

This procedure describes deploying the VMware Cloud Builder appliance to the cluster that was created during the VxRail first run.

Prerequisites

Before you deploy the VMware Cloud Builder appliance, verify that your environment fulfills the requirements for this process.

Prerequisite Value
Environment
  • Verify that your environment is configured for deployment of VMware Cloud Builder and the management domain.
  • Verify that you have available virtual infrastructure that has access to the management network that will be used by the management domain. You deploy VMware Cloud Builder on that virtual infrastructure.
Resource Requirements
  • 4 CPUs
  • 4 GB of Memory
  • 279 GB of Storage
    • 25.1 GB (thin provisioned)
    • 253.8 GB (thick provisioned)
Installation Packages Verify that you download the OVA file(s) for VMware Cloud Builder.
Network
  • Verify that the static IP address and FQDN for the VMware Cloud Builder appliance are available.
  • Verify that connectivity is in place from the VMware Cloud Builder appliance and the management VLAN used in the deployment.

The VMware Cloud Builder appliance must be on the same management network as the hosts to be used. It must also be able to access all required external services, such as DNS and NTP.

Procedure

  1. Download the VMware Cloud Builder appliance OVA.
  2. Log in to vCenter Server using the vSphere Client.
  3. In the navigator, select the cluster that was created during the VxRail first run.
  4. Click Actions > Deploy OVF Template.
  5. Select Local file and click Upload Files.
  6. Browse to the VMware Cloud Builder appliance OVA, select it, and click Open.
  7. Click Next.
  8. Enter a name for the virtual machine, select a target location, and click Next.
  9. Select the cluster you created during the VxRail first run and click Next.
  10. Review the details and click Next.
  11. Accept the license agreement and click Next.
  12. On the Select Storage page, select the storage for the VMware Cloud Builder appliance and click Next.
  13. On the Select networks dialog box, select the management network and click Next.
  14. On the Customize template page, enter the following information for the VMware Cloud Builder appliance and click Next:
    Setting Details
    Admin Username The admin user name cannot be one of the following pre-defined user names:
    • root
    • bin
    • daemon
    • messagebus
    • systemd-bus-proxy
    • systemd-journal-gateway
    • systemd-journal-remote
    • systemd-journal-upload
    • systemd-network
    • systemd-resolve
    • systemd-timesync
    • nobody
    • sshd
    • named
    • rpc
    • tftp
    • ntp
    • smmsp
    • cassandra
    Admin Password/Admin Password confirm The admin password must be a minimum of 15 characters and include at least one uppercase, one lowercase, one digit, and one special character. Supported special characters:
    @ ! # $ % ? ^
    Note: A password cannot be based on a dictionary word (for example, VMware1!)
    Root password/Root password confirm The root password must be a minimum of 15 characters and include at least one uppercase, one lowercase, one digit, and one special character. Supported special characters:
    @ ! # $ % ? ^
    Note: A password cannot be based on a dictionary word (for example, VMware1!)
    Hostname Enter the hostname for the VMware Cloud Builder appliance.
    Network 1 IP Address Enter the IP address for the VMware Cloud Builder appliance.
    Network 1 Subnet Mask For example, 255.255.255.0.
    Default Gateway Enter the default gateway for the VMware Cloud Builder appliance.
    DNS Servers IP address of the primary and secondary DNS servers (comma separated). Do not specify more than two servers.
    DNS Domain Name For example, vsphere.local.
    DNS Domain Search Paths Comma separated. For example vsphere.local, sf.vsphere.local.
    NTP Servers Comma separated.
  15. Review the deployment details and click Finish.
    Note: Make sure your passwords meet the requirements specified above before clicking Finish or your deployment will not succeed.
  16. After the VMware Cloud Builder appliance is deployed, SSH in to the VM with the admin credentials provided in step 14.
  17. Ensure that you can ping the ESXi hosts.
  18. Verify that the VMware Cloud Builder appliance has access to the required external services, such as DNS and NTP by performing forward and reverse DNS lookups for each host and the specified NTP servers.