<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>7.5. Adding a Cluster</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Apache_CloudStack-Admin_Guide-4.2.0-en-US-1-" /><script type="text/javascript" src="../../../../../toc.js"></script><script type="text/javascript">
              addID('Apache_CloudStack');
              
	      addID('Apache_CloudStack.4.2.0');
              
              addID('Apache_CloudStack.4.2.0.books');
	      addID('Apache_CloudStack.4.2.0.Admin_Guide');
              </script><link rel="home" href="index.html" title="CloudStack Administrator's Guide" /><link rel="up" href="provisioning-steps.html" title="Chapter 7. Steps to Provisioning Your Cloud Infrastructure" /><link rel="prev" href="pod-add.html" title="7.4. Adding a Pod" /><link rel="next" href="host-add.html" title="7.6. Adding a Host" /></head><body class="toc_embeded "><div id="tocdiv" class="toc"><iframe id="tocframe" class="toc" src="../../../../toc.html">This is an iframe, to view it upgrade your browser or enable iframe display.</iframe></div><p id="title"><a class="left" href="http://cloudstack.apache.org"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="http://cloudstack.apache.org/docs"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="pod-add.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="host-add.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" id="cluster-add" lang="en-US"><div class="titlepage"><div><div><h2 class="title">7.5. Adding a Cluster</h2></div></div></div><div class="para">
		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.
	</div><div xml:lang="en-US" class="section" id="add-clusters-kvm-xenserver" lang="en-US"><div class="titlepage"><div><div><h3 class="title">7.5.1. Add Cluster: KVM or XenServer</h3></div></div></div><div class="para">
		These steps assume you have already installed the hypervisor on the hosts and logged in to the CloudStack UI.
	</div><div class="orderedlist"><ol><li class="listitem"><div class="para">
				In the left navigation, choose Infrastructure. In Zones, click View More, then click the zone in which you want to add the cluster.
			</div></li><li class="listitem"><div class="para">
				Click the Compute tab.
			</div></li><li class="listitem"><div class="para">
				In the Clusters node of the diagram, click View All.
			</div></li><li class="listitem"><div class="para">
				Click Add Cluster.
			</div></li><li class="listitem"><div class="para">
				Choose the hypervisor type for this cluster.
			</div></li><li class="listitem"><div class="para">
				Choose the pod in which you want to create the cluster.
			</div></li><li class="listitem"><div class="para">
				Enter a name for the cluster. This can be text of your choosing and is not used by CloudStack.
			</div></li><li class="listitem"><div class="para">
				Click OK.
			</div></li></ol></div></div><div xml:lang="en-US" class="section" id="add-clusters-vsphere" lang="en-US"><div class="titlepage"><div><div><h3 class="title">7.5.2. Add Cluster: vSphere</h3></div></div></div><div class="para">
		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.
	</div><div class="para">
		For vSphere servers, we recommend creating the cluster of hosts in vCenter and then adding the entire cluster to CloudStack. Follow these requirements:
	</div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
				Do not put more than 8 hosts in a vSphere cluster
			</div></li><li class="listitem"><div class="para">
				Make sure the hypervisor hosts do not have any VMs already running before you add them to CloudStack.
			</div></li></ul></div><div class="para">
		To add a vSphere cluster to CloudStack:
	</div><div class="orderedlist"><ol><li class="listitem"><div class="para">
				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.
			</div><div class="mediaobject"><img src="./images/vsphere-client.png" width="444" alt="vsphereclient.png: vSphere client" /></div></li><li class="listitem"><div class="para">
				Log in to the UI.
			</div></li><li class="listitem"><div class="para">
				In the left navigation, choose Infrastructure. In Zones, click View More, then click the zone in which you want to add the cluster.
			</div></li><li class="listitem"><div class="para">
				Click the Compute tab, and click View All on Pods. Choose the pod to which you want to add the cluster.
			</div></li><li class="listitem"><div class="para">
				Click View Clusters.
			</div></li><li class="listitem"><div class="para">
				Click Add Cluster.
			</div></li><li class="listitem"><div class="para">
				In Hypervisor, choose VMware.
			</div></li><li class="listitem"><div class="para">
				Provide the following information in the dialog. The fields below make reference to the values from vCenter.
			</div><div class="mediaobject"><img src="./images/add-cluster.png" alt="addcluster.png: add a cluster" /></div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
						<span class="bold bold"><strong>Cluster Name</strong></span>: Enter the name of the cluster you created in vCenter. For example, "cloud.cluster.2.2.1"
					</div></li><li class="listitem"><div class="para">
						<span class="bold bold"><strong>vCenter Username</strong></span>: Enter the username that CloudStack should use to connect to vCenter. This user must have all the administrative privileges.
					</div></li><li class="listitem"><div class="para">
						<span class="bold bold"><strong>CPU overcommit ratio</strong></span>: Enter the CPU overcommit ratio for the cluster. The value you enter determines the CPU consumption of each VM in the selected cluster. By increasing the over-provisioning ratio, more resource capacity will be used. If no value is specified, the value is defaulted to 1, which implies no over-provisioning is done.
					</div></li><li class="listitem"><div class="para">
						<span class="bold bold"><strong>RAM overcommit ratio</strong></span>: Enter the RAM overcommit ratio for the cluster. The value you enter determines the memory consumption of each VM in the selected cluster. By increasing the over-provisioning ratio, more resource capacity will be used. If no value is specified, the value is defaulted to 1, which implies no over-provisioning is done.
					</div></li><li class="listitem"><div class="para">
						<span class="bold bold"><strong>vCenter Host</strong></span>: Enter the hostname or IP address of the vCenter server.
					</div></li><li class="listitem"><div class="para">
						<span class="bold bold"><strong>vCenter Password</strong></span>: Enter the password for the user named above.
					</div></li><li class="listitem"><div class="para">
						<span class="bold bold"><strong>vCenter Datacenter</strong></span>: Enter the vCenter datacenter that the cluster is in. For example, "cloud.dc.VM".
					</div></li><li class="listitem"><div class="para">
						<span class="bold bold"><strong>Override Public Traffic</strong></span>: Enable this option to override the zone-wide public traffic for the cluster you are creating.
					</div></li><li class="listitem"><div class="para">
						<span class="bold bold"><strong>Public Traffic vSwitch Type</strong></span>: This option is displayed only if you enable the Override Public Traffic option. Select a desirable switch. If the vmware.use.dvswitch global parameter is true, the default option will be VMware vNetwork Distributed Virtual Switch.
					</div><div class="para">
						If you have enabled Nexus dvSwitch in the environment, the following parameters for dvSwitch configuration are displayed:
					</div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
								Nexus dvSwitch IP Address: The IP address of the Nexus VSM appliance.
							</div></li><li class="listitem"><div class="para">
								Nexus dvSwitch Username: The username required to access the Nexus VSM appliance.
							</div></li><li class="listitem"><div class="para">
								Nexus dvSwitch Password: The password associated with the username specified above.
							</div></li></ul></div></li><li class="listitem"><div class="para">
						<span class="bold bold"><strong>Override Guest Traffic</strong></span>: Enable this option to override the zone-wide guest traffic for the cluster you are creating.
					</div></li><li class="listitem"><div class="para">
						<span class="bold bold"><strong>Guest Traffic vSwitch Type</strong></span>: This option is displayed only if you enable the Override Guest Traffic option. Select a desirable switch.
					</div><div class="para">
						If the vmware.use.dvswitch global parameter is true, the default option will be VMware vNetwork Distributed Virtual Switch.
					</div><div class="para">
						If you have enabled Nexus dvSwitch in the environment, the following parameters for dvSwitch configuration are displayed:
					</div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
								Nexus dvSwitch IP Address: The IP address of the Nexus VSM appliance.
							</div></li><li class="listitem"><div class="para">
								Nexus dvSwitch Username: The username required to access the Nexus VSM appliance.
							</div></li><li class="listitem"><div class="para">
								Nexus dvSwitch Password: The password associated with the username specified above.
							</div></li></ul></div></li><li class="listitem"><div class="para">
						There might be a slight delay while the cluster is provisioned. It will automatically display in the UI.
					</div></li></ul></div></li></ol></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="pod-add.html"><strong>Prev</strong>7.4. Adding a Pod</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="host-add.html"><strong>Next</strong>7.6. Adding a Host</a></li></ul></body></html>
