apache/cloudstack
1
0
Fork 0
mirror of https://github.com/apache/cloudstack.git synced 2025-12-20 20:43:43 +01:00
Code Issues Packages Projects Releases Wiki Activity
cloudstack/docs/tmp/en-US/html/host-add.html

76 lines
9.7 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?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 Host</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.0.0-incubating-en-US-1-" /><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="cluster-add.html" title="7.4. Adding a Cluster" /><link rel="next" href="primary-storage-add.html" title="7.6. Add Primary Storage" /></head><body><p id="title"><a class="left" href="http://cloudstack.org"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="http://docs.cloudstack.org"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="cluster-add.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="primary-storage-add.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" id="host-add" lang="en-US"><div class="titlepage"><div><div><h2 class="title" id="host-add">7.5. Adding a Host</h2></div></div></div><div class="orderedlist"><ol><li class="listitem"><div class="para">
Before adding a host to the CloudStack configuration, you must first install your chosen hypervisor on the host. CloudStack can manage hosts running VMs under a variety of hypervisors.
</div><div class="para">
The CloudStack Installation Guide provides instructions on how to install each supported hypervisor and configure it for use with CloudStack. See the appropriate section in the Installation Guide for information about which version of your chosen hypervisor is supported, as well as crucial additional steps to configure the hypervisor hosts for use with CloudStack.
</div><div class="warning"><div class="admonition_header"><h2>Warning</h2></div><div class="admonition"><div class="para">
Be sure you have performed the additional CloudStack-specific configuration steps described in the hypervisor installation section for your particular hypervisor.
</div></div></div></li><li class="listitem"><div class="para">
Now add the hypervisor host to CloudStack. The technique to use varies depending on the hypervisor.
</div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
<a class="xref" href="host-add.html#host-add-xenserver-kvm-ovm">Section 7.5.1, “Adding a Host (XenServer or KVM)”</a>
</div></li><li class="listitem"><div class="para">
<a class="xref" href="host-add.html#host-add-vsphere">Section 7.5.2, “Adding a Host (vSphere)”</a>
</div></li></ul></div></li></ol></div><div xml:lang="en-US" class="section" id="host-add-xenserver-kvm-ovm" lang="en-US"><div class="titlepage"><div><div><h3 class="title" id="host-add-xenserver-kvm-ovm">7.5.1. Adding a Host (XenServer or KVM)</h3></div></div></div><div class="para">
XenServer and KVM hosts can be added to a cluster at any time.
</div><div class="section"><div class="titlepage"><div><div><h4 class="title" id="idp18965080">7.5.1.1. Requirements for XenServer and KVM Hosts</h4></div></div></div><div class="warning"><div class="admonition_header"><h2>Warning</h2></div><div class="admonition"><div class="para">
Make sure the hypervisor host does not have any VMs already running before you add it to CloudStack.
</div></div></div><div class="para">
Configuration requirements:
</div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
Each cluster must contain only hosts with the identical hypervisor.
</div></li><li class="listitem"><div class="para">
For XenServer, do not put more than 8 hosts in a cluster.
</div></li><li class="listitem"><div class="para">
For KVM, do not put more than 16 hosts in a cluster.
</div></li></ul></div><div class="para">
For hardware requirements, see the installation section for your hypervisor in the CloudStack Installation Guide.
</div><div class="section"><div class="titlepage"><div><div><h5 class="title" id="idp15274064">7.5.1.1.1. XenServer Host Additional Requirements</h5></div></div></div><div class="para">
If network bonding is in use, the administrator must cable the new host identically to other hosts in the cluster.
</div><div class="para">
For all additional hosts to be added to the cluster, run the following command. This will cause the host to join the master in a XenServer pool.
</div><pre class="programlisting"># xe pool-join master-address=[master IP] master-username=root master-password=[your password]</pre><div class="note"><div class="admonition_header"><h2>Note</h2></div><div class="admonition"><div class="para">
When copying and pasting a command, be sure the command has pasted as a single line before executing. Some document viewers may introduce unwanted line breaks in copied text.
</div></div></div><div class="para">
With all hosts added to the XenServer pool, run the cloud-setup-bond script. This script will complete the configuration and setup of the bonds on the new hosts in the cluster.
</div><div class="orderedlist"><ol><li class="listitem"><div class="para">
Copy the script from the Management Server in /usr/lib64/cloud/common/scripts/vm/hypervisor/xenserver/cloud-setup-bonding.sh to the master host and ensure it is executable.
</div></li><li class="listitem"><div class="para">
Run the script:
</div><pre class="programlisting"># ./cloud-setup-bonding.sh</pre></li></ol></div></div><div class="section"><div class="titlepage"><div><div><h5 class="title" id="idp30637992">7.5.1.1.2. KVM Host Additional Requirements</h5></div></div></div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
If shared mountpoint storage is in use, the administrator should ensure that the new host has all the same mountpoints (with storage mounted) as the other hosts in the cluster.
</div></li><li class="listitem"><div class="para">
Make sure the new host has the same network configuration (guest, private, and public network) as other hosts in the cluster.
</div></li></ul></div></div></div><div class="section"><div class="titlepage"><div><div><h4 class="title" id="idp17980992">7.5.1.2. Adding a XenServer or KVM Host</h4></div></div></div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
If you have not already done so, install the hypervisor software on the host. You will need to know which version of the hypervisor software version is supported by CloudStack and what additional configuration is required to ensure the host will work with CloudStack. To find these installation details, see the appropriate section for your hypervisor in the CloudStack Installation Guide.
</div></li><li class="listitem"><div class="para">
Log in to the CloudStack UI as administrator.
</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 host.
</div></li><li class="listitem"><div class="para">
Click the Compute tab. In the Clusters node, click View All.
</div></li><li class="listitem"><div class="para">
Click the cluster where you want to add the host.
</div></li><li class="listitem"><div class="para">
Click View Hosts.
</div></li><li class="listitem"><div class="para">
Click Add Host.
</div></li><li class="listitem"><div class="para">
Provide the following information.
</div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
Host Name. The DNS name or IP address of the host.
</div></li><li class="listitem"><div class="para">
Username. Usually root.
</div></li><li class="listitem"><div class="para">
Password. This is the password for the user from your XenServer or KVM install).
</div></li><li class="listitem"><div class="para">
Host Tags (Optional). Any labels that you use to categorize hosts for ease of maintenance. For example, you can set to the cloud's HA tag (set in the ha.tag global configuration parameter) if you want this host to be used only for VMs with the "high availability" feature enabled. For more information, see HA-Enabled Virtual Machines as well as HA for Hosts.
</div></li></ul></div><div class="para">
There may be a slight delay while the host is provisioned. It should automatically display in the UI.
</div></li><li class="listitem"><div class="para">
Repeat for additional hosts.
</div></li></ul></div></div></div><div xml:lang="en-US" class="section" id="host-add-vsphere" lang="en-US"><div class="titlepage"><div><div><h3 class="title" id="host-add-vsphere">7.5.2. Adding a Host (vSphere)</h3></div></div></div><div class="para">
For vSphere servers, we recommend creating the cluster of hosts in vCenter and then adding the entire cluster to CloudStack. See Add Cluster: vSphere.
</div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="cluster-add.html"><strong>Prev</strong>7.4. Adding a Cluster</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="primary-storage-add.html"><strong>Next</strong>7.6. Add Primary Storage</a></li></ul></body></html>
Reference in New Issue View Git Blame Copy Permalink