You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by jt...@apache.org on 2012/10/17 20:34:48 UTC
[1/2] git commit: Docs: Fixing up hypervisor install sections. Adding
hypervisor host system requirements in the correct locations. Partially fixed
indentation.
Updated Branches:
refs/heads/master d417dd159 -> c556323b4
Docs: Fixing up hypervisor install sections. Adding hypervisor host system requirements in the correct locations. Partially fixed indentation.
Project: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/commit/c556323b
Tree: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/tree/c556323b
Diff: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/diff/c556323b
Branch: refs/heads/master
Commit: c556323b4bc814371ae63e27d45661dad0cabf77
Parents: 2bd76f0
Author: Jessica Tomechak <je...@gmail.com>
Authored: Wed Oct 17 11:32:53 2012 -0700
Committer: Jessica Tomechak <je...@gmail.com>
Committed: Wed Oct 17 11:34:12 2012 -0700
----------------------------------------------------------------------
docs/en-US/citrix-xenserver-installation.xml | 197 +++++++++---------
docs/en-US/hypervisor-host-install-overview.xml | 6 +-
docs/en-US/hypervisor-installation.xml | 2 +
docs/en-US/hypervisor-kvm-install-flow.xml | 1 +
docs/en-US/hypervisor-kvm-requirements.xml | 53 +++++
docs/en-US/minimum-system-requirements.xml | 35 +---
docs/en-US/ovm-install.xml | 29 +++
docs/en-US/ovm-requirements.xml | 28 +++
docs/en-US/vmware-install.xml | 29 +++
docs/en-US/vmware-requirements.xml | 40 ++++
10 files changed, 291 insertions(+), 129 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/c556323b/docs/en-US/citrix-xenserver-installation.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/citrix-xenserver-installation.xml b/docs/en-US/citrix-xenserver-installation.xml
index b8ab592..c786b83 100644
--- a/docs/en-US/citrix-xenserver-installation.xml
+++ b/docs/en-US/citrix-xenserver-installation.xml
@@ -1,5 +1,5 @@
<?xml version='1.0' encoding='utf-8' ?>
-<!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
%BOOK_ENTITIES;
]>
@@ -26,123 +26,123 @@
<title>Citrix XenServer Installation for &PRODUCT;</title>
<para>If you want to use the Citrix XenServer hypervisor to run guest virtual machines, install XenServer 6.0 or XenServer 6.0.2 on the host(s) in your cloud. For an initial installation, follow the steps below. If you have previously installed XenServer and want to upgrade to another version, see <xref linkend="xenserver-version-upgrading" />.</para>
<section id="system-requirements-xenserver-hosts">
- <title>System Requirements for XenServer Hosts</title>
- <itemizedlist>
- <listitem><para>The host must be certified as compatible with one of the following. See the Citrix Hardware Compatibility Guide: <ulink url="http://hcl.xensource.com">http://hcl.xensource.com</ulink></para>
+ <title>System Requirements for XenServer Hosts</title>
<itemizedlist>
- <listitem><para>XenServer 5.6 SP2</para></listitem>
- <listitem><para>XenServer 6.0</para></listitem>
- <listitem><para>XenServer 6.0.2</para></listitem>
+ <listitem><para>The host must be certified as compatible with one of the following. See the Citrix Hardware Compatibility Guide: <ulink url="http://hcl.xensource.com">http://hcl.xensource.com</ulink></para>
+ <itemizedlist>
+ <listitem><para>XenServer 5.6 SP2</para></listitem>
+ <listitem><para>XenServer 6.0</para></listitem>
+ <listitem><para>XenServer 6.0.2</para></listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem><para>You must re-install Citrix XenServer if you are going to re-use a host from a previous install.</para></listitem><listitem><para>Must support HVM (Intel-VT or AMD-V enabled)</para></listitem>
+ <listitem><para>Be sure all the hotfixes provided by the hypervisor vendor are applied. Track the release of hypervisor patches through your hypervisor vendor’s support channel, and apply patches as soon as possible after they are released. &PRODUCT; will not track or notify you of required hypervisor patches. It is essential that your hosts are completely up to date with the provided hypervisor patches. The hypervisor vendor is likely to refuse to support any system that is not up to date with patches.</para></listitem>
+ <listitem><para>All hosts within a cluster must be homogenous. The CPUs must be of the same type, count, and feature flags.</para></listitem>
+ <listitem><para>Must support HVM (Intel-VT or AMD-V enabled in BIOS)</para></listitem>
+ <listitem><para>64-bit x86 CPU (more cores results in better performance)</para></listitem>
+ <listitem><para>Hardware virtualization support required</para></listitem>
+ <listitem><para>4 GB of memory</para></listitem>
+ <listitem><para>36 GB of local disk</para></listitem>
+ <listitem><para>At least 1 NIC</para></listitem>
+ <listitem><para>Statically allocated IP Address</para></listitem>
+ <listitem><para>When you deploy &PRODUCT;, the hypervisor host must not have any VMs already running</para></listitem>
</itemizedlist>
- </listitem>
- <listitem><para>All hosts must be 64-bit and must support HVM (Intel-VT or AMD-V enabled in BIOS).</para></listitem>
- <listitem><para>All hosts within a cluster must be homogenous. That means the CPUs must be of the same type, count, and feature flags.</para></listitem>
- <listitem><para>You must re-install Citrix XenServer if you are going to re-use a host from a previous install.</para></listitem>
- <listitem><para>64-bit x86 CPU (more cores results in better performance)</para></listitem>
- <listitem><para>Hardware virtualization support required</para></listitem>
- <listitem><para>4 GB of memory</para></listitem>
- <listitem><para>36 GB of local disk</para></listitem>
- <listitem><para>At least 1 NIC</para></listitem>
- <listitem><para>Statically allocated IP Address</para></listitem>
- <listitem><para>Be sure all the hotfixes provided by the hypervisor vendor are applied. Track the release of hypervisor patches through your hypervisor vendor’s support channel, and apply patches as soon as possible after they are released. &PRODUCT; will not track or notify you of required hypervisor patches. It is essential that your hosts are completely up to date with the provided hypervisor patches. The hypervisor vendor is likely to refuse to support any system that is not up to date with patches. For more information, see <ulink url="http://docs.cloudstack.org/Knowledge_Base/Possible_VM_corruption_if_XenServer_Hotfix_is_not_Applied/Highly_Recomended_Hotfixes_for_XenServer_5.6_SP2">Highly Recommended Hotfixes for XenServer</ulink> in the &PRODUCT; Knowledge Base.</para></listitem>
- </itemizedlist>
- <warning><para>The lack of up-do-date hotfixes can lead to data corruption and lost VMs.</para></warning>
+ <warning><para>The lack of up-do-date hotfixes can lead to data corruption and lost VMs.</para></warning>
</section>
<section id="xenserver-installation-steps">
- <title>XenServer Installation Steps</title>
- <orderedlist>
- <listitem><para>From <ulink url="https://www.citrix.com/English/ss/downloads/">https://www.citrix.com/English/ss/downloads/</ulink>, download the appropriate version of XenServer for your &PRODUCT; version (see <xref linkend="system-requirements-xenserver-hosts"/>). Install it using the Citrix XenServer Installation Guide.</para></listitem>
- <listitem><para>After installation, perform the following configuration steps, which are described in the next few sections:</para>
+ <title>XenServer Installation Steps</title>
+ <orderedlist>
+ <listitem><para>From <ulink url="https://www.citrix.com/English/ss/downloads/">https://www.citrix.com/English/ss/downloads/</ulink>, download the appropriate version of XenServer for your &PRODUCT; version (see <xref linkend="system-requirements-xenserver-hosts"/>). Install it using the Citrix XenServer Installation Guide.</para></listitem>
+ <listitem><para>After installation, perform the following configuration steps, which are described in the next few sections:</para>
<informaltable frame="all">
<tgroup cols="2" align="left" colsep="1" rowsep="1">
- <colspec colname="c1" />
- <colspec colname="c2" />
- <thead>
- <row>
+ <colspec colname="c1" />
+ <colspec colname="c2" />
+ <thead>
+ <row>
<entry><para>Required</para></entry>
<entry><para>Optional</para></entry>
- </row>
- </thead>
- <tbody>
- <row>
+ </row>
+ </thead>
+ <tbody>
+ <row>
<entry><para><xref linkend="config-xenserver-dom0-memory" /></para></entry>
<entry><para><xref linkend="xenserver-support-pkg-installation" /></para></entry>
- </row>
- <row>
+ </row>
+ <row>
<entry><para><xref linkend="xenserver-username-password" /></para></entry>
<entry><para>Set up SR if not using NFS, iSCSI, or local disk; see <xref linkend="xenserver-primary-storage-setup" /></para></entry>
- </row>
- <row>
+ </row>
+ <row>
<entry><para><xref linkend="xenserver-time-sync" /></para></entry>
<entry><para><xref linkend="xenserver-iscsi-multipath-setup" /></para></entry>
- </row>
- <row>
+ </row>
+ <row>
<entry><para><xref linkend="xenserver-get-deploy-license" /></para></entry>
<entry><para><xref linkend="xenserver-physical-network-setup" /></para></entry>
- </row>
- </tbody>
+ </row>
+ </tbody>
</tgroup>
</informaltable>
- </listitem>
- </orderedlist>
+ </listitem>
+ </orderedlist>
</section>
<section id="config-xenserver-dom0-memory">
- <title>Configure XenServer dom0 Memory</title>
- <para>Configure the XenServer dom0 settings to allocate more memory to dom0. This can enable XenServer to handle larger numbers of virtual machines. We recommend 2940 MB of RAM for XenServer dom0. For instructions on how to do this, see <ulink url="http://support.citrix.com/article/CTX126531">http://support.citrix.com/article/CTX126531</ulink>. The article refers to XenServer 5.6, but the same information applies to XenServer 6.0.</para>
+ <title>Configure XenServer dom0 Memory</title>
+ <para>Configure the XenServer dom0 settings to allocate more memory to dom0. This can enable XenServer to handle larger numbers of virtual machines. We recommend 2940 MB of RAM for XenServer dom0. For instructions on how to do this, see <ulink url="http://support.citrix.com/article/CTX126531">http://support.citrix.com/article/CTX126531</ulink>. The article refers to XenServer 5.6, but the same information applies to XenServer 6.0.</para>
</section>
<section id="xenserver-username-password">
- <title>Username and Password</title>
- <para>All XenServers in a cluster must have the same username and password as configured in &PRODUCT;.</para>
+ <title>Username and Password</title>
+ <para>All XenServers in a cluster must have the same username and password as configured in &PRODUCT;.</para>
</section>
<section id="xenserver-time-sync">
- <title>Time Synchronization</title>
- <para>The host must be set to use NTP. All hosts in a pod must have the same time.</para>
- <orderedlist>
- <listitem>
+ <title>Time Synchronization</title>
+ <para>The host must be set to use NTP. All hosts in a pod must have the same time.</para>
+ <orderedlist>
+ <listitem>
<para>Install NTP.</para>
<programlisting># yum install ntp</programlisting>
- </listitem>
- <listitem>
+ </listitem>
+ <listitem>
<para>Edit the NTP configuration file to point to your NTP server.</para>
<programlisting># vi /etc/ntp.conf</programlisting>
<para>Add one or more server lines in this file with the names of the NTP servers you want to use. For example:</para>
- <programlisting>
-server 0.xenserver.pool.ntp.org
+ <programlisting>server 0.xenserver.pool.ntp.org
server 1.xenserver.pool.ntp.org
server 2.xenserver.pool.ntp.org
server 3.xenserver.pool.ntp.org
</programlisting>
- </listitem>
- <listitem>
+ </listitem>
+ <listitem>
<para>Restart the NTP client.</para>
<programlisting># service ntpd restart</programlisting>
- </listitem>
- <listitem>
+ </listitem>
+ <listitem>
<para>Make sure NTP will start again upon reboot.</para>
<programlisting># chkconfig ntpd on</programlisting>
- </listitem>
- </orderedlist>
+ </listitem>
+ </orderedlist>
</section>
<section id="xenserver-licensing">
- <title>Licensing</title>
- <para>Citrix XenServer Free version provides 30 days usage without a license. Following the 30 day trial, XenServer requires a free activation and license. You can choose to install a license now or skip this step. If you skip this step, you will need to install a license when you activate and license the XenServer.</para>
- <section id="xenserver-get-deploy-license">
- <title>Getting and Deploying a License</title>
- <para>If you choose to install a license now you will need to use the XenCenter to activate and get a license.</para>
- <orderedlist>
+ <title>Licensing</title>
+ <para>Citrix XenServer Free version provides 30 days usage without a license. Following the 30 day trial, XenServer requires a free activation and license. You can choose to install a license now or skip this step. If you skip this step, you will need to install a license when you activate and license the XenServer.</para>
+ <section id="xenserver-get-deploy-license">
+ <title>Getting and Deploying a License</title>
+ <para>If you choose to install a license now you will need to use the XenCenter to activate and get a license.</para>
+ <orderedlist>
<listitem><para>In XenCenter, click Tools > License manager.</para></listitem>
<listitem><para>Select your XenServer and select Activate Free XenServer.</para></listitem>
<listitem><para>Request a license.</para></listitem>
- </orderedlist>
- <para>You can install the license with XenCenter or using the xe command line tool.</para>
- </section>
+ </orderedlist>
+ <para>You can install the license with XenCenter or using the xe command line tool.</para>
+ </section>
</section>
<section id="xenserver-support-pkg-installation">
- <title>Install &PRODUCT; XenServer Support Package (CSP)</title>
- <para>(Optional)</para>
- <para>To enable security groups, elastic load balancing, and elastic IP on XenServer, download and install the &PRODUCT; XenServer Support Package (CSP). After installing XenServer, perform the following additional steps on each XenServer host.</para>
- <orderedlist>
- <listitem>
+ <title>Install &PRODUCT; XenServer Support Package (CSP)</title>
+ <para>(Optional)</para>
+ <para>To enable security groups, elastic load balancing, and elastic IP on XenServer, download and install the &PRODUCT; XenServer Support Package (CSP). After installing XenServer, perform the following additional steps on each XenServer host.</para>
+ <orderedlist>
+ <listitem>
<para>Download the CSP software onto the XenServer host from one of the following links:</para>
<para>For XenServer 6.0.2:</para>
<para><ulink url="http://download.cloud.com/releases/3.0.1/XS-6.0.2/xenserver-cloud-supp.tgz">http://download.cloud.com/releases/3.0.1/XS-6.0.2/xenserver-cloud-supp.tgz</ulink></para>
@@ -150,51 +150,50 @@ server 3.xenserver.pool.ntp.org
<para><ulink url="http://download.cloud.com/releases/2.2.0/xenserver-cloud-supp.tgz">http://download.cloud.com/releases/2.2.0/xenserver-cloud-supp.tgz</ulink></para>
<para>For XenServer 6.0:</para>
<para><ulink url="http://download.cloud.com/releases/3.0/xenserver-cloud-supp.tgz">http://download.cloud.com/releases/3.0/xenserver-cloud-supp.tgz</ulink></para>
- </listitem>
- <listitem>
+ </listitem>
+ <listitem>
<para>Extract the file:</para>
<programlisting># tar xf xenserver-cloud-supp.tgz</programlisting>
- </listitem>
- <listitem>
+ </listitem>
+ <listitem>
<para>Run the following script:</para>
<programlisting># xe-install-supplemental-pack xenserver-cloud-supp.iso</programlisting>
- </listitem>
- <listitem>
+ </listitem>
+ <listitem>
<para>If the XenServer host is part of a zone that uses basic networking, disable Open vSwitch (OVS):</para>
<programlisting># xe-switch-network-backend bridge</programlisting>
<para>Restart the host machine when prompted.</para>
- </listitem>
- </orderedlist>
- <para>The XenServer host is now ready to be added to &PRODUCT;.</para>
+ </listitem>
+ </orderedlist>
+ <para>The XenServer host is now ready to be added to &PRODUCT;.</para>
</section>
<section id="xenserver-primary-storage-setup">
- <title>Primary Storage Setup for XenServer</title>
- <para>&PRODUCT; natively supports NFS, iSCSI and local storage. If you are using one of these storage types, there is no need to create the XenServer Storage Repository ("SR").</para>
- <para>If, however, you would like to use storage connected via some other technology, such as FiberChannel, you must set up the SR yourself. To do so, perform the following steps. If you have your hosts in a XenServer pool, perform the steps on the master node. If you are working with a single XenServer which is not part of a cluster, perform the steps on that XenServer.</para>
- <orderedlist>
- <listitem><para>Connect FiberChannel cable to all hosts in the cluster and to the FiberChannel storage host.</para></listitem>
- <listitem>
+ <title>Primary Storage Setup for XenServer</title>
+ <para>&PRODUCT; natively supports NFS, iSCSI and local storage. If you are using one of these storage types, there is no need to create the XenServer Storage Repository ("SR").</para>
+ <para>If, however, you would like to use storage connected via some other technology, such as FiberChannel, you must set up the SR yourself. To do so, perform the following steps. If you have your hosts in a XenServer pool, perform the steps on the master node. If you are working with a single XenServer which is not part of a cluster, perform the steps on that XenServer.</para>
+ <orderedlist>
+ <listitem><para>Connect FiberChannel cable to all hosts in the cluster and to the FiberChannel storage host.</para></listitem>
+ <listitem>
<para>Rescan the SCSI bus. Either use the following command or use XenCenter to perform an HBA rescan.</para>
<programlisting># scsi-rescan</programlisting>
- </listitem>
- <listitem><para>Repeat step 2 on every host.</para></listitem>
- <listitem>
+ </listitem>
+ <listitem><para>Repeat step 2 on every host.</para></listitem>
+ <listitem>
<para>Check to be sure you see the new SCSI disk.</para>
<programlisting># ls /dev/disk/by-id/scsi-360a98000503365344e6f6177615a516b -l</programlisting>
<para>The output should look like this, although the specific file name will be different (scsi-<scsiID>):</para>
- <programlisting>
-lrwxrwxrwx 1 root root 9 Mar 16 13:47
+ <programlisting>lrwxrwxrwx 1 root root 9 Mar 16 13:47
/dev/disk/by-id/scsi-360a98000503365344e6f6177615a516b -> ../../sdc
</programlisting>
- </listitem>
- <listitem><para>Repeat step 4 on every host.</para></listitem>
- <listitem>
+ </listitem>
+ <listitem><para>Repeat step 4 on every host.</para></listitem>
+ <listitem>
<para>On the storage server, run this command to get a unique ID for the new SR.</para>
<programlisting># uuidgen</programlisting>
<para>The output should look like this, although the specific ID will be different:</para>
<programlisting>e6849e96-86c3-4f2c-8fcc-350cc711be3d</programlisting>
- </listitem>
- <listitem>
+ </listitem>
+ <listitem>
<para>Create the FiberChannel SR. In name-label, use the unique ID you just generated.</para>
<programlisting>
# xe sr-create type=lvmohba shared=true
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/c556323b/docs/en-US/hypervisor-host-install-overview.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/hypervisor-host-install-overview.xml b/docs/en-US/hypervisor-host-install-overview.xml
index 187abea..716b43d 100644
--- a/docs/en-US/hypervisor-host-install-overview.xml
+++ b/docs/en-US/hypervisor-host-install-overview.xml
@@ -23,11 +23,11 @@
-->
<section id="hypervisor-host-install-overview">
- <title>Hypervisor Host Installation Overview</title>
- <para>This section describes installing a Hypervisor host. This is targeted towards hosts running Linux Kernel Virtual Machine (KVM)</para>
+ <title>KVM Installation Overview</title>
+ <para>If you want to use the Linux Kernel Virtual Machine (KVM) hypervisor to run guest virtual machines, install KVM on the host(s) in your cloud. The material in this section doesn't duplicate KVM installation docs. It provides the &PRODUCT;-specific steps that are needed to prepare a KVM host to work with &PRODUCT;.</para>
<warning><para>Before continuing, make sure that you have applied the latest updates to your host.</para></warning>
<warning><para>It is NOT recommended to run services on this host not controlled by &PRODUCT;.</para></warning>
- <para>The procedure for installing the Hypervisor Host is:</para>
+ <para>The procedure for installing a KVM Hypervisor Host is:</para>
<orderedlist>
<listitem><para>Prepare the Operating System</para></listitem>
<listitem><para>Install and configure libvirt</para></listitem>
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/c556323b/docs/en-US/hypervisor-installation.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/hypervisor-installation.xml b/docs/en-US/hypervisor-installation.xml
index 8bfc0c0..cc6a762 100644
--- a/docs/en-US/hypervisor-installation.xml
+++ b/docs/en-US/hypervisor-installation.xml
@@ -26,4 +26,6 @@
<title>Hypervisor Installation</title>
<xi:include href="hypervisor-kvm-install-flow.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
<xi:include href="citrix-xenserver-installation.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ <xi:include href="vmware-install.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ <xi:include href="ovm-install.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
</chapter>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/c556323b/docs/en-US/hypervisor-kvm-install-flow.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/hypervisor-kvm-install-flow.xml b/docs/en-US/hypervisor-kvm-install-flow.xml
index e2544c1..fe79e85 100644
--- a/docs/en-US/hypervisor-kvm-install-flow.xml
+++ b/docs/en-US/hypervisor-kvm-install-flow.xml
@@ -24,6 +24,7 @@
<section id="hypervisor-kvm-install-flow">
<title>KVM Hypervisor Host Installation</title>
+ <xi:include href="hypervisor-kvm-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="hypervisor-host-install-overview.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="hypervisor-host-install-prepare-os.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="hypervisor-host-install-libvirt.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/c556323b/docs/en-US/hypervisor-kvm-requirements.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/hypervisor-kvm-requirements.xml b/docs/en-US/hypervisor-kvm-requirements.xml
new file mode 100644
index 0000000..7e7af6a
--- /dev/null
+++ b/docs/en-US/hypervisor-kvm-requirements.xml
@@ -0,0 +1,53 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<section id="hypervisor-kvm-requirements">
+ <title>System Requirements for KVM Hypervisor Hosts</title>
+ <para>KVM is included with a variety of Linux-based operating systems. Although you are not required to run these distributions, the following are recommended:</para>
+ <itemizedlist>
+ <listitem><para>CentOS / RHEL: 6.3</para></listitem>
+ <listitem><para>Ubuntu: 12.04(.1)</para></listitem>
+ </itemizedlist>
+ <para>The main requirement for KVM hypervisors is the libvirt and Qemu version. No matter what
+ Linux distribution you are using, make sure the following requirements are met:</para>
+ <itemizedlist>
+ <listitem><para>libvirt: 0.9.4 or higher</para></listitem>
+ <listitem><para>Qemu/KVM: 1.0 or higher</para></listitem>
+ </itemizedlist>
+ <para>In addition, the following hardware requirements apply:</para>
+ <itemizedlist>
+ <listitem><para>Hosts must be certified as compatible with the selected operating system. For example, see the RHEL Hardware Compatibility Guide at https://hardware.redhat.com/.</para></listitem>
+ <listitem><para>Within a single cluster, the hosts must be of the same kernel version. For example, if one host is RHEL6 64 bit, they must all be RHEL6 64 bit.</para></listitem>
+ <listitem><para>All hosts within a cluster must be homogenous. The CPUs must be of the same type, count, and feature flags.</para></listitem>
+ <listitem><para>Must support HVM (Intel-VT or AMD-V enabled)</para></listitem>
+ <listitem><para>64-bit x86 CPU (more cores results in better performance)</para></listitem>
+ <listitem><para>Hardware virtualization support required</para></listitem>
+ <listitem><para>4 GB of memory</para></listitem>
+ <listitem><para>36 GB of local disk</para></listitem>
+ <listitem><para>At least 1 NIC</para></listitem>
+ <listitem><para>Statically allocated IP Address</para></listitem>
+ <listitem><para>Latest hotfixes applied to hypervisor software</para></listitem>
+ <listitem><para>When you deploy &PRODUCT;, the hypervisor host must not have any VMs already running</para></listitem>
+ </itemizedlist>
+</section>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/c556323b/docs/en-US/minimum-system-requirements.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/minimum-system-requirements.xml b/docs/en-US/minimum-system-requirements.xml
index 422a810..7c0f15f 100644
--- a/docs/en-US/minimum-system-requirements.xml
+++ b/docs/en-US/minimum-system-requirements.xml
@@ -45,7 +45,7 @@
<title>Host/Hypervisor System Requirements</title>
<para>The host is where the cloud services run in the form of guest virtual machines. Each host is one machine that meets the following requirements:</para>
<itemizedlist>
- <listitem><para>Must be 64-bit and must support HVM (Intel-VT or AMD-V enabled).</para></listitem>
+ <listitem><para>Must support HVM (Intel-VT or AMD-V enabled).</para></listitem>
<listitem><para>64-bit x86 CPU (more cores results in better performance)</para></listitem>
<listitem><para>Hardware virtualization support required</para></listitem>
<listitem><para>4 GB of memory</para></listitem>
@@ -54,36 +54,17 @@
<listitem><para>Statically allocated IP Address</para></listitem>
<listitem><para>Latest hotfixes applied to hypervisor software</para></listitem>
<listitem><para>When you deploy &PRODUCT;, the hypervisor host must not have any VMs already running</para></listitem>
+ <listitem><para>All hosts within a cluster must be homogenous. The CPUs must be of the same type, count, and feature flags.</para></listitem>
</itemizedlist>
<para>Hosts have additional requirements depending on the hypervisor. See the requirements listed at the top of the Installation section for your chosen hypervisor:</para>
<warning>
<para>Be sure you fulfill the additional hypervisor requirements and installation steps provided in this Guide. Hypervisor hosts must be properly prepared to work with CloudStack. For example, the requirements for XenServer are listed under Citrix XenServer Installation.</para>
</warning>
- <section id="hypervisor-requirements-xenserver">
- <title>Citrix XenServer requirements</title>
- <para>To be determined</para>
- </section>
- <section id="hypervisor-requirements-vmware">
- <title>VMware vSphere requirements</title>
- <para>To be determined</para>
- </section>
- <section id="hypervisor-requirements-kvm">
- <title>KVM requirements</title>
- <para>For running a KVM hypervisor the main requirement is the Linux distribution it is running. Although you are not required to run these distributions, it is recommended.</para>
- <para>Recommended distributions:</para>
- <itemizedlist>
- <listitem><para>CentOS / RHEL: 6.3</para></listitem>
- <listitem><para>Ubuntu: 12.04(.1)</para></listitem>
- </itemizedlist>
- <para>The main requirement for KVM hypervisors is the libvirt and Qemu version. If you whish to run on a different distribution, make sure you meet the following requirements:</para>
- <itemizedlist>
- <listitem><para>libvirt: 0.9.4 or higher</para></listitem>
- <listitem><para>Qemu/KVM: 1.0 or higher</para></listitem>
- </itemizedlist>
- </section>
- <section id="hypervisor-requirements-ovm">
- <title>Oracle VM (OVM) requirements</title>
- <para>To be determined</para>
- </section>
+ <itemizedlist>
+ <listitem><para><xref linkend="hypervisor-kvm-requirements"/></para></listitem>
+ <listitem><para><xref linkend="system-requirements-xenserver-hosts"/></para></listitem>
+ <listitem><para><xref linkend="vmware-requirements"/></para></listitem>
+ <listitem><para><xref linkend="ovm-requirements"/></para></listitem>
+ </itemizedlist>
</section>
</section>
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/c556323b/docs/en-US/ovm-install.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/ovm-install.xml b/docs/en-US/ovm-install.xml
new file mode 100644
index 0000000..fa4a86b
--- /dev/null
+++ b/docs/en-US/ovm-install.xml
@@ -0,0 +1,29 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<section id="ovm-install">
+ <title>Installing OVM for &PRODUCT;</title>
+ <para>TODO</para>
+ <xi:include href="ovm-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</section>
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/c556323b/docs/en-US/ovm-requirements.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/ovm-requirements.xml b/docs/en-US/ovm-requirements.xml
new file mode 100644
index 0000000..aadc71f
--- /dev/null
+++ b/docs/en-US/ovm-requirements.xml
@@ -0,0 +1,28 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<section id="ovm-requirements">
+ <title>System Requirements for OVM</title>
+ <para>TODO</para>
+</section>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/c556323b/docs/en-US/vmware-install.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/vmware-install.xml b/docs/en-US/vmware-install.xml
new file mode 100644
index 0000000..211bfe4
--- /dev/null
+++ b/docs/en-US/vmware-install.xml
@@ -0,0 +1,29 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<section id="vmware-install">
+ <title>Installing VMware for &PRODUCT;</title>
+ <para>TODO</para>
+ <xi:include href="vmware-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</section>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/c556323b/docs/en-US/vmware-requirements.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/vmware-requirements.xml b/docs/en-US/vmware-requirements.xml
new file mode 100644
index 0000000..8a64796
--- /dev/null
+++ b/docs/en-US/vmware-requirements.xml
@@ -0,0 +1,40 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<section id="vmware-requirements">
+ <title>System Requirements for VMware</title>
+ <para>TODO</para>
+ <itemizedlist>
+ <listitem><para>Must support HVM (Intel-VT or AMD-V enabled).</para></listitem>
+ <listitem><para>64-bit x86 CPU (more cores results in better performance)</para></listitem>
+ <listitem><para>Hardware virtualization support required</para></listitem>
+ <listitem><para>4 GB of memory</para></listitem>
+ <listitem><para>36 GB of local disk</para></listitem>
+ <listitem><para>At least 1 NIC</para></listitem>
+ <listitem><para>Statically allocated IP Address</para></listitem>
+ <listitem><para>Latest hotfixes applied to hypervisor software</para></listitem>
+ <listitem><para>When you deploy &PRODUCT;, the hypervisor host must not have any VMs already running</para></listitem>
+ <listitem><para>All hosts within a cluster must be homogenous. The CPUs must be of the same type, count, and feature flags.</para></listitem>
+ </itemizedlist>
+</section>
\ No newline at end of file