Configure NSX Manager to install controllers automatically on vSphere ESXi hosts managed by a vCenter Server. After installation, these controllers are automatically added to a controller cluster on an vSphere ESXi host.


  • Deploy NSX Manager.

  • Deploy vCenter Server and vSphere ESXi hosts.

  • Register vSphere ESXi host to the vCenter Server.

  • vSphere ESXi host must have enough CPU, memory, and hard disk resources to support 12vCPUs, 48 GB RAM, and 360 GB Storage.


  1. Log in to the NSX Manager, https://<nsxmanagerIPAddress>/
  2. In the NSX Manager UI, if it does not have a registered vCenter, go to the Fabric panel, click Compute Manager, and add a Compute Manager.
  3. On the System page, click Add Controllers.
  4. On the Common Attributes page, enter the required values on the page.
  5. Select the Compute Manager.
  6. (Optional) You can enable SSH.
  7. (Optional) You can enable Root Access.
  8. (Optional) If you add a node to an existing cluster, enable Join Existing Cluster.
  9. Enter and confirm the Shared Secret key that is required to initialize and form the cluster.

    All controller nodes added to this cluster must use the same Shared Secret key.

  10. Enter the Controller credentials.
  11. Click Next.
  12. On the Controllers page, click Add Controller.
  13. Enter a valid hostname or fully qualified domain name for the controller node.
  14. Select the cluster.
  15. (Optional) Select the resource pool. The resource pool only provides a pool of compute resources to deploy the controller nodes. Assign specific storage resources.
  16. (Optional) Select the host.
  17. Select the datastore.
  18. Select the management interface that is used by the host to communicate with different components within the host itself.
  19. Enter a static IP address with port details (<IPAddress>/<PortNumber>) and net mask.
  20. You can add multiple controllers. Click the + button and enter the controller details before beginning the deployment.
  21. Click Finish.

    The automated controller installation begins. The controllers are first registered with the NSX Manager before forming the cluster or joining an existing cluster.

  22. Verify whether the controllers are registered with the NSX Manager.

    1. Log in to the NSX Manager console.

    2. Enter # get management-cluster status.

      The management cluster status must be STABLE.

    3. Alternatively, from the NSX Manager UI, verify that the Manager connectivity is UP.

  23. Verify control cluster status.

    1. Log in to the controller CLI console.

    2. Enter # get control-cluster status

      The controller cluster status must be STABLE.

    3. Alternatively, from the NSX Manager UI, verify that the Cluster connectivity is UP.

What to do next

Configure NSX Manager to install controllers and cluster automatically using APIs. See Configure Automated Installation of Controller and Cluster Using API.