You can simplify the deployment of individual components by defining installation variables or by creating a registry file on your vCloud Availability Installer Appliance.

There are two ways to deploy and configure vCloud Availability

  • You can use Full Commands Installation. The commands include addresses, user names, and the location of password files for all vCenter Server instances and vCloud Director hosts.

  • With Simple Command Installation you are using a vCloud Availability Installer Appliance registry. This way all vCenter Server and vCloud Director details are contained in a registry file.

Both ways to deploy and configure vCloud Availability are displayed for your reference. The installation using variables is presented in the left column of the table in each step, containing standard installation and configuration commands. The installation with simple commands, using a vCloud Availability Installer Appliance registry file, is presented in the right column of the table in each step.

The VSPHERE_PLACEMENT_LOCATOR value contains the target data center name, the tag host, the name of the target cluster, and the IP address or the fully qualified domain name (FQDN) of the target ESXi host. The VSPHERE_PLACEMENT_LOCATOR value depends on the topology of your vSphere environment. Following are examples for valid VSPHERE_PLACEMENT_LOCATOR values.

  • /data-center-name/host/cluster-1-name/fully-qualified-domain-name

  • /data-center-name/host/cluster-2-name/host-IP-address

If the target ESXi host is not part of a cluster, skip the cluster-name element, as shown in the following examples.

  • /data-center-name/host/fully-qualified-domain-name

  • /data-center-name/host/host-IP-address

The VSPHERE_PLACEMENT_DATASTORE value is the datastore name as it is displayed in the vSphere Web Client.

For more information about the VSPHERE_PLACEMENT_LOCATOR and VSPHERE_PLACEMENT_DATASTORE values, see Specifying the Inventory Path for a Cluster, Host, or Resource Pool in the OVF Tool User's Guide.


The Variables listed in the table are used as an example. Update values to match your environment.

Define Installation Variables

Create Registry File

# export MGMT_VSPHERE_ADDRESS=mgmt-vsphere-address
# export MGMT_VSPHERE_USER=mgmt-vsphere-admin-user
# export MGMT_VSPHERE_LOCATOR='mgmt-locator'
# export MGMT_VSPHERE_DATASTORE='mgmt-datastore'
# export MGMT_VSPHERE_NETWORK='mgmt-network'
# export VSPHERE01_ADDRESS=vsphere-01-address
# export VSPHERE01_PLACEMENT_LOCATOR=vsphere-01-locator
# export VSPHERE01_PLACEMENT_DATASTORE=vsphere-01-datastore
# export VSPHERE01_PLACEMENT_NETWORK=vsphere-01-network

# export VSPHERE02_ADDRESS=vsphere-02-address
# export VSPHERE02_PLACEMENT_LOCATOR=vsphere-02-locator
# export VSPHERE02_PLACEMENT_DATASTORE=vsphere-02-datastore
# export VSPHERE02_PLACEMENT_NETWORK=vsphere-02-network

# export VCD_ADDRESS=vcd-01-address
# export VCD_USER=root@system
# export SSO_USER=administrator@vsphere.local
  1. Create a ~/.vcav/registry file to hold installation variables. Update the values to match your environment.

    vsphere mgmt-vsphere-name
        address mgmt-vsphere-address
        api-port 443
        api-user admin-user
        api-password admin-user-password
        placement-locator mgmt-locator
        placement-datastore mgmt-datastore
        placement-network mgmt-network
    vsphere vsphere-01-name
        address vsphere-01-address
        api-port 443
        api-user vsphere-01-admin-user
        api-password vsphere-01-admin-password
        placement-locator vsphere-01-locator
        placement-datastore vsphere-01-datastore
        placement-network vsphere-01-network
    vsphere vsphere-02-name
        address vsphere-02-address
        api-port 443
        api-user vsphere-02-admin-user
        api-password admin-user-password
        placement-locator vsphere-02-locator
        placement-datastore vsphere-02-datastore
        placement-network vsphere-02-network
    VCD vcd-01-name
        address vcd-01-address
        api-port 443
        api-user administrator@system
        api-password vcd-root-password
        sso-user administrator@vsphere.local
        sso-password sso-password
  2. Update the file permissions

# chmod 0600 ~/.vcav/registry

If you are using a registry file to work with the vCloud Availability Installer Appliance, you can replace the --vsphere-address, --vsphere-user, and --vsphere-password-file options with the --vsphere=vsphere-name argument.

If you are using a registry file to work with the vCloud Availability Installer Appliance, you can replace the --vcd-address, --vcd-user, and --vcd-password-file options with --vcd=vcd-name.