Product SiteDocumentation Site

6.4. Adding a Cluster

You need to tell CloudStack about the hosts that it will manage. Hosts exist inside clusters, so before you begin adding hosts to the cloud, you must add at least one cluster.

6.4.1. Add Cluster: KVM or XenServer

These steps assume you have already installed the hypervisor on the hosts and logged in to the CloudStack UI.
  1. In the left navigation, choose Infrastructure. In Zones, click View More, then click the zone in which you want to add the cluster.
  2. Click the Compute tab.
  3. In the Clusters node of the diagram, click View All.
  4. Click Add Cluster.
  5. Choose the hypervisor type for this cluster.
  6. Choose the pod in which you want to create the cluster.
  7. Enter a name for the cluster. This can be text of your choosing and is not used by CloudStack.
  8. Click OK.

6.4.2. Add Cluster: vSphere

Host management for vSphere is done through a combination of vCenter and the CloudStack admin UI. CloudStack requires that all hosts be in a CloudStack cluster, but the cluster may consist of a single host. As an administrator you must decide if you would like to use clusters of one host or of multiple hosts. Clusters of multiple hosts allow for features like live migration. Clusters also require shared storage such as NFS or iSCSI.
For vSphere servers, we recommend creating the cluster of hosts in vCenter and then adding the entire cluster to CloudStack. Follow these requirements:
  • Do not put more than 8 hosts in a vSphere cluster
  • Make sure the hypervisor hosts do not have any VMs already running before you add them to CloudStack.
To add a vSphere cluster to CloudStack:
  1. Create the cluster of hosts in vCenter. Follow the vCenter instructions to do this. You will create a cluster that looks something like this in vCenter.
    vsphereclient.png: vSphere client
  2. Log in to the UI.
  3. In the left navigation, choose Infrastructure. In Zones, click View More, then click the zone in which you want to add the cluster.
  4. Click the Compute tab, and click View All on Pods. Choose the pod to which you want to add the cluster.
  5. Click View Clusters.
  6. Click Add Cluster.
  7. In Hypervisor, choose VMware.
  8. Provide the following information in the dialog. The fields below make reference to values from vCenter.
    • Cluster Name. Enter the name of the cluster you created in vCenter. For example, "cloud.cluster.2.2.1"
    • vCenter Host. Enter the hostname or IP address of the vCenter server.
    • vCenter Username. Enter the username that CloudStack should use to connect to vCenter. This user must have all administrative privileges.
    • vCenter Password. Enter the password for the user named above
    • vCenter Datacenter. Enter the vCenter datacenter that the cluster is in. For example, "cloud.dc.VM".
    • addcluster.png: add cluster
      There might be a slight delay while the cluster is provisioned. It will automatically display in the UI