mirror of
https://github.com/apache/cloudstack.git
synced 2025-11-02 20:02:29 +01:00
Docs: Fixing up hypervisor install sections. Adding hypervisor host system requirements in the correct locations. Partially fixed indentation.
This commit is contained in:
Jessica Tomechak
parent
2bd76f0103
commit
c556323b4b
@ -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;
|
||||
]>
|
||||
@ -35,16 +35,17 @@
|
||||
<listitem><para>XenServer 6.0.2</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>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>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>
|
||||
<listitem><para>When you deploy &PRODUCT;, the hypervisor host must not have any VMs already running</para></listitem>
|
||||
</itemizedlist>
|
||||
<warning><para>The lack of up-do-date hotfixes can lead to data corruption and lost VMs.</para></warning>
|
||||
</section>
|
||||
@ -106,8 +107,7 @@
|
||||
<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
|
||||
@ -182,8 +182,7 @@ server 3.xenserver.pool.ntp.org
|
||||
<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>
|
||||
|
||||
@ -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>
|
||||
|
||||
@ -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>
|
||||
@ -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" />
|
||||
|
||||
53
docs/en-US/hypervisor-kvm-requirements.xml
Normal file
53
docs/en-US/hypervisor-kvm-requirements.xml
Normal file
@ -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>
|
||||
@ -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>
|
||||
<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>
|
||||
<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>
|
||||
</section>
|
||||
</section>
|
||||
|
||||
29
docs/en-US/ovm-install.xml
Normal file
29
docs/en-US/ovm-install.xml
Normal file
@ -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>
|
||||
28
docs/en-US/ovm-requirements.xml
Normal file
28
docs/en-US/ovm-requirements.xml
Normal file
@ -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>
|
||||
29
docs/en-US/vmware-install.xml
Normal file
29
docs/en-US/vmware-install.xml
Normal file
@ -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>
|
||||
40
docs/en-US/vmware-requirements.xml
Normal file
40
docs/en-US/vmware-requirements.xml
Normal file
@ -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>
|
||||
Loading…
x
Reference in New Issue
Block a user