Updated Branches: refs/heads/master e8359806e -> c8830ad8a
hyper v changes to agent installer, storage, smb etc. CLOUDSTACK-1001 Project: http://git-wip-us.apache.org/repos/asf/cloudstack-docs/repo Commit: http://git-wip-us.apache.org/repos/asf/cloudstack-docs/commit/c8830ad8 Tree: http://git-wip-us.apache.org/repos/asf/cloudstack-docs/tree/c8830ad8 Diff: http://git-wip-us.apache.org/repos/asf/cloudstack-docs/diff/c8830ad8 Branch: refs/heads/master Commit: c8830ad8a821c443a5e1485c54cc8b77b181cf30 Parents: e835980 Author: radhikap <[email protected]> Authored: Tue Jan 21 11:43:19 2014 +0530 Committer: radhikap <[email protected]> Committed: Tue Jan 21 11:43:19 2014 +0530 ---------------------------------------------------------------------- en-US/about-secondary-storage.xml | 1 + en-US/hyperv-agent-install.xml | 5 +- en-US/hyperv-checklist.xml | 11 +- en-US/hyperv-install.xml | 6 +- en-US/hyperv-requirements.xml | 1 - en-US/hypervisor-installation.xml | 14 +- en-US/hypervisor-support-for-primarystorage.xml | 2 +- en-US/minimum-system-requirements.xml | 150 +++++++++++++------ en-US/primary-storage-add.xml | 2 + en-US/secondary-storage-add.xml | 12 +- 10 files changed, 135 insertions(+), 69 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/c8830ad8/en-US/about-secondary-storage.xml ---------------------------------------------------------------------- diff --git a/en-US/about-secondary-storage.xml b/en-US/about-secondary-storage.xml index 7383825..f6c2277 100644 --- a/en-US/about-secondary-storage.xml +++ b/en-US/about-secondary-storage.xml @@ -57,4 +57,5 @@ <para>Heterogeneous Secondary Storage is not supported in Regions. For example, you cannot set up multiple zones, one using NFS secondary and the other using S3 or Swift secondary.</para> </warning> + <para></para> </section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/c8830ad8/en-US/hyperv-agent-install.xml ---------------------------------------------------------------------- diff --git a/en-US/hyperv-agent-install.xml b/en-US/hyperv-agent-install.xml index a3bc916..1bec8ed 100644 --- a/en-US/hyperv-agent-install.xml +++ b/en-US/hyperv-agent-install.xml @@ -33,8 +33,7 @@ port 8250.</para> <note> <para>The Agent installer automatically perform this operation. You have not selected this - option during the Agent installation, it can also be done manually as given in <xref - linkend="ssl-agent"/>.</para> + option during the Agent installation, it can also be done manually as given in step 1.</para> </note> <para/> <orderedlist> @@ -60,7 +59,7 @@ >Building CloudStack Hyper-V Agent</ulink>.</para> </listitem> <listitem> - <para>Run the installer.</para> + <para>As an administrator, run the installer.</para> </listitem> <listitem> <para>Provide the Hyper-V admin credentials when prompted.</para> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/c8830ad8/en-US/hyperv-checklist.xml ---------------------------------------------------------------------- diff --git a/en-US/hyperv-checklist.xml b/en-US/hyperv-checklist.xml index 5e7f8fc..f68045e 100644 --- a/en-US/hyperv-checklist.xml +++ b/en-US/hyperv-checklist.xml @@ -50,7 +50,7 @@ <entry><para>New folders in the /Share directory</para></entry> <entry><para>Ensure that folders are created for Primary and Secondary storage. The SMB share and the hosts should be part of the same domain.</para> - <para>If you are using Windows SMB shre, the location of the file share for the Hyper-V + <para>If you are using Windows SMB share, the location of the file share for the Hyper-V deployment will be the new folder created in the \Shares on the selected volume. You can create sub-folders for both &PRODUCT; Primary and Secondary storage within the share location. When you select the profile for the file shares, ensure that you @@ -119,14 +119,17 @@ <entry><para>Migration</para></entry> <entry><para>Migration</para></entry> <entry><para>Enable Migration.</para> + <para>For more information, see <ulink + url="http://technet.microsoft.com/en-us/library/jj134199.aspx ">Configuring Live + Migration</ulink>.</para> </entry> </row> <row> <entry><para>Migration</para></entry> <entry><para>Delegation</para></entry> - <entry><para>If you want to use Live Migration, enable Delegation. Enable the following services of other - hosts participating in Live Migration: CIFS and Microsoft Virtual System Migration - Service.</para> + <entry><para>If you want to use Live Migration, enable Delegation. Enable the following + services of other hosts participating in Live Migration: CIFS and Microsoft Virtual + System Migration Service.</para> </entry> </row> <row> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/c8830ad8/en-US/hyperv-install.xml ---------------------------------------------------------------------- diff --git a/en-US/hyperv-install.xml b/en-US/hyperv-install.xml index 384c026..e02d44b 100644 --- a/en-US/hyperv-install.xml +++ b/en-US/hyperv-install.xml @@ -1,5 +1,5 @@ <?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"; [ +<!DOCTYPE section 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; ]> @@ -21,7 +21,7 @@ specific language governing permissions and limitations under the License. --> -<chapter id="hyperv-install"> +<section id="hyperv-install"> <title>Installing Hyper-V for &PRODUCT;</title> <para>If you want to use Hyper-V hypervisor to run guest virtual machines, install Hyper-V on the hosts in your cloud. The instructions in this section doesn't duplicate Hyper-V Installation @@ -33,4 +33,4 @@ <xi:include href="hyperv-agent-install.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> <xi:include href="hyperv-install-network.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> <xi:include href="hyperv-install-storage.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> -</chapter> +</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/c8830ad8/en-US/hyperv-requirements.xml ---------------------------------------------------------------------- diff --git a/en-US/hyperv-requirements.xml b/en-US/hyperv-requirements.xml index 312708d..51c0e7d 100644 --- a/en-US/hyperv-requirements.xml +++ b/en-US/hyperv-requirements.xml @@ -23,7 +23,6 @@ --> <section id="hyperv-requirements"> <title>System Requirements for Hyper-V Hypervisor Hosts</title> - <para/> <section id="hyperv-supported-os"> <title>Supported Operating Systems for Hyper-V Hosts</title> <itemizedlist> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/c8830ad8/en-US/hypervisor-installation.xml ---------------------------------------------------------------------- diff --git a/en-US/hypervisor-installation.xml b/en-US/hypervisor-installation.xml index 5ee7dea..341322c 100644 --- a/en-US/hypervisor-installation.xml +++ b/en-US/hypervisor-installation.xml @@ -21,12 +21,12 @@ specific language governing permissions and limitations under the License. --> - <chapter id="hypervisor-installation"> - <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"/> --> - <xi:include href="lxc-install.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> + <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="hyperv-install.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"/> --> + <xi:include href="lxc-install.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> </chapter> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/c8830ad8/en-US/hypervisor-support-for-primarystorage.xml ---------------------------------------------------------------------- diff --git a/en-US/hypervisor-support-for-primarystorage.xml b/en-US/hypervisor-support-for-primarystorage.xml index 8f42749..c48d85b 100644 --- a/en-US/hypervisor-support-for-primarystorage.xml +++ b/en-US/hypervisor-support-for-primarystorage.xml @@ -48,7 +48,7 @@ <entry><para>VHD</para></entry> <entry><para>QCOW2</para></entry> <entry><para>VHD</para> - <para>Snapshorts are not supported.</para></entry> + <para>Snapshots are not supported.</para></entry> </row> <row> <entry><para><emphasis role="bold">iSCSI support</emphasis></para></entry> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/c8830ad8/en-US/minimum-system-requirements.xml ---------------------------------------------------------------------- diff --git a/en-US/minimum-system-requirements.xml b/en-US/minimum-system-requirements.xml index 870ef68..b5fcf99 100644 --- a/en-US/minimum-system-requirements.xml +++ b/en-US/minimum-system-requirements.xml @@ -22,53 +22,109 @@ under the License. --> <section id="minimum-system-requirements"> - <title>Minimum System Requirements</title> - <section id="management-server-system-requirements"> - <title>Management Server, Database, and Storage System Requirements</title> - <para> - The machines that will run the Management Server and MySQL database must meet the following requirements. - The same machines can also be used to provide primary and secondary storage, such as via localdisk or NFS. - The Management Server may be placed on a virtual machine. - </para> - <itemizedlist> - <listitem><para>Operating system:</para> - <itemizedlist> - <listitem><para>Preferred: CentOS/RHEL 6.3+ or Ubuntu 12.04(.1)</para></listitem> - </itemizedlist> - </listitem> - <listitem><para>64-bit x86 CPU (more cores results in better performance)</para></listitem> - <listitem><para>4 GB of memory</para></listitem> - <listitem><para>250 GB of local disk (more results in better capability; 500 GB recommended)</para></listitem> - <listitem><para>At least 1 NIC</para></listitem> - <listitem><para>Statically allocated IP address</para></listitem> - <listitem><para>Fully qualified domain name as returned by the hostname command</para></listitem> - </itemizedlist> - </section> - <section id="hypervisor-system-requirements"> - <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 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><note><para>If DHCP is used for hosts, ensure that no conflict occurs between DHCP server used for these hosts and the DHCP router created by &PRODUCT;.</para></note></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 homogeneous. 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> + <title>Minimum System Requirements</title> + <section id="management-server-system-requirements"> + <title>Management Server, Database, and Storage System Requirements</title> + <para> The machines that will run the Management Server and MySQL database must meet the + following requirements. The same machines can also be used to provide primary and secondary + storage, such as via localdisk or NFS. The Management Server may be placed on a virtual + machine. </para> + <itemizedlist> + <listitem> + <para>Operating system:</para> <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> --> - <listitem><para><xref linkend="lxc-requirements"/></para></listitem> + <listitem> + <para>Preferred: CentOS/RHEL 6.3+ or Ubuntu 12.04(.1)</para> + </listitem> </itemizedlist> - </section> + </listitem> + <listitem> + <para>64-bit x86 CPU (more cores results in better performance)</para> + </listitem> + <listitem> + <para>4 GB of memory</para> + </listitem> + <listitem> + <para>250 GB of local disk (more results in better capability; 500 GB recommended)</para> + </listitem> + <listitem> + <para>At least 1 NIC</para> + </listitem> + <listitem> + <para>Statically allocated IP address</para> + </listitem> + <listitem> + <para>Fully qualified domain name as returned by the hostname command</para> + </listitem> + </itemizedlist> + </section> + <section id="hypervisor-system-requirements"> + <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 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> + <note> + <para>If DHCP is used for hosts, ensure that no conflict occurs between DHCP server used + for these hosts and the DHCP router created by &PRODUCT;.</para> + </note> + </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 homogeneous. 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> + <para></para> + <itemizedlist> + <listitem> + <para><xref linkend="hypervisor-kvm-requirements"/></para> + </listitem> + <listitem> + <para><xref linkend="system-requirements-xenserver-hosts"/></para> + </listitem> + <listitem> + <para><xref linkend="hyperv-requirements"/></para> + </listitem> + <listitem> + <para><xref linkend="vmware-requirements"/></para> + </listitem> + <!-- <listitem><para><xref linkend="ovm-requirements"/></para></listitem> --> + <listitem> + <para><xref linkend="lxc-requirements"/></para> + </listitem> + </itemizedlist> + </section> </section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/c8830ad8/en-US/primary-storage-add.xml ---------------------------------------------------------------------- diff --git a/en-US/primary-storage-add.xml b/en-US/primary-storage-add.xml index 48ace2d..ccf3d47 100644 --- a/en-US/primary-storage-add.xml +++ b/en-US/primary-storage-add.xml @@ -61,12 +61,14 @@ storage (ex. you have an empty SAN volume or an empty NFS share). Adding the storage to &PRODUCT; will destroy any existing data.</para> </warning> + <para></para> <note> <para>Primary storage can also be added at the zone level through the &PRODUCT; API (adding zone-level primary storage is not yet supported through the &PRODUCT; UI).</para> <para>Once primary storage has been added at the zone level, it can be managed through the &PRODUCT; UI.</para> </note> + <para></para> <orderedlist> <listitem> <para>Log in to the &PRODUCT; UI (see <xref linkend="log-in"/>).</para> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/c8830ad8/en-US/secondary-storage-add.xml ---------------------------------------------------------------------- diff --git a/en-US/secondary-storage-add.xml b/en-US/secondary-storage-add.xml index c6be503..acc94fb 100644 --- a/en-US/secondary-storage-add.xml +++ b/en-US/secondary-storage-add.xml @@ -43,9 +43,14 @@ <title>Adding Secondary Storage</title> <para>When you create a new zone, the first secondary storage is added as part of that procedure. You can add secondary storage servers at any time to add more servers to an existing zone.</para> <warning><para>Ensure that nothing is stored on the server. Adding the server to &PRODUCT; will destroy any - existing data.</para></warning> + existing data.</para></warning> + <para></para> <orderedlist> - <listitem><para>To prepare for the zone-based Secondary Staging Store, you should have created and mounted an NFS share during Management Server installation. <phrase condition="install">See <xref linkend="prepare-nfs-shares" />.</phrase><phrase condition="admin">See Preparing NFS Shares in the Installation Guide.</phrase></para></listitem> + <listitem><para>To prepare for the zone-based Secondary Staging Store, you should have created and mounted an + NFS share during Management Server installation. <phrase condition="install">See <xref + linkend="prepare-nfs-shares"/>.</phrase><phrase condition="admin">See Preparing NFS + Shares in the Installation Guide.</phrase></para> + <para>If you are using an Hyper-V host, ensure that you have created a SMB share.</para></listitem> <listitem><para>Make sure you prepared the system VM template during Management Server installation. <phrase condition="install">See <xref linkend="prepare-system-vm-template" />.</phrase><phrase condition="admin">See Prepare the System VM Template in the Installation Guide.</phrase></para></listitem> <listitem><para>Log in to the &PRODUCT; UI as root administrator.</para></listitem> <listitem><para>In the left navigation bar, click Infrastructure.</para></listitem> @@ -60,7 +65,8 @@ zone-based storage, and the others for region-wide storage. For Hyper-V, select SMB/CIFS.</para> <warning><para>Heterogeneous Secondary Storage is not supported in Regions. You can use only a single NFS, - S3, or Swift account per region.</para></warning></listitem> + S3, or Swift account per region.</para></warning> + <para></para></listitem> <listitem><para>Create NFS Secondary Staging Store. This box must always be checked.</para> <warning><para>Even if the UI allows you to uncheck this box, do not do so. This checkbox and the three fields below it must be filled in.
