Add a host (VCF 9.x)
After you deploy VMware Cloud Foundation (VCF) in a Self-deployed environment, you can add hosts to increase capacity and workload resiliency. You create the host with the Amazon Elastic VMware Service console or the AWS CLI, and then you add it to a cluster with VCF 9.x tools. You can add hosts with local storage or diskless hosts.
To add the first hosts of a new environment, see Step 3: Add hosts instead. For EVS-deployed environments (VCF 5.2.x), see Add a host (VCF 5.x).
All hosts in a cluster must use the same instance type and the same ESX version. After you add a host, you can change its ESX version only with vSphere Lifecycle Manager.
Before you begin
Before you begin, make sure that the following are true.
-
You created the forward (A) and reverse (PTR) DNS records for the new host, and they resolve. For more information, see Step 2: Create DNS records.
-
Your Host count per EVS environment quota is at least the number of hosts that the environment will have after you add hosts. Host creation fails if the quota is lower. For more information, see Service quotas for Amazon EVS.
-
You have the name of an Amazon EC2 key pair. Amazon EVS requires the key pair name when you add a host.
-
You know the instance type and ESX version of the hosts in the target cluster. For the versions available to your account, run
aws evs get-versionsor see Supported VCF versions and instance types. -
For a diskless host, the new host can reach the external storage of the cluster. For more information, see Step 2: Connect a diskless host to external storage.
Step 1: Create the host
To create the host in the Amazon EVS console or with the AWS CLI, use the following steps.
Example
Don’t run the create command again for a host that is in the CREATING state.
A host usually reaches CREATED in about 9 minutes.
When the host is CREATED, confirm that its IP address equals the address in its A record.
If the host stays in CREATING or moves to CREATE_FAILED, check its DNS records first.
For more information, see Troubleshoot Self-deployed deployments.
Amazon EVS stores the ESX root password of each host in AWS Secrets Manager. Each host has its own secret. You need the root password to add the host to VCF.
Step 2: Connect a diskless host to external storage
Skip this step for hosts with local storage.
Diskless hosts have no local storage for VCF, so the datastores of the cluster are on external storage. Before you add a diskless host to a cluster, make sure that the host can reach the external storage of the cluster, and mount the datastores on the host.
-
For Amazon FSx for OpenZFS, the NFS export list of each volume and the security group of the file system must allow the host management VLAN subnet. For more information, see Configure FSx for OpenZFS as principal storage for diskless hosts.
-
For other external storage, see External storage options for diskless hosts.
Step 3: Add the host to a cluster in VCF
In VCF
-
Add the host to the VCF inventory with the ESX root password from Secrets Manager.
-
Add the host to the target cluster.
For the procedures, see the Broadcom documentation for VCF
You have added the host when it is connected in the cluster and shows no configuration errors. To check the environment after the change, see Monitor environment status. If adding the host to the cluster fails, see Troubleshoot hosts.