You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by jz...@apache.org on 2012/11/07 19:01:12 UTC
[34/52] [abbrv] [partial] CLOUDSTACK-444 Fix from Radhika PC against
docs, adds network setup in the install guide.
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/8e353282/docs/runbook/tmp/en-US/xml/Management.xml
----------------------------------------------------------------------
diff --git a/docs/runbook/tmp/en-US/xml/Management.xml b/docs/runbook/tmp/en-US/xml/Management.xml
new file mode 100644
index 0000000..8cbd8f8
--- /dev/null
+++ b/docs/runbook/tmp/en-US/xml/Management.xml
@@ -0,0 +1,125 @@
+<?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 "Runbook.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-Runbook-Management" lang="en-US">
+ <!-- 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.
+ --> <title>Installation of the management server</title>
+ <para>
+ Now it is time to start installing CloudStack's management server and some of the related components.
+ </para>
+ <section id="sect-Runbook-Management-database">
+ <title>Database Installation and Configuration</title>
+ <para>
+ We'll start out by installing <application>MySQL</application> and configuring some options to ensure CloudStack runs well.
+ </para>
+ <para>
+ To install <application>MySQL</application> run the following command:
+<screen><prompt># </prompt><userinput><command>yum</command> -y install mysql-server</userinput></screen>
+
+ </para>
+ <para>
+ With <application>MySQL</application> installed we need to make a few configuration changes to <filename>/etc/my.cnf</filename>. Specifically we need to add the following options to the [mysqld] section:
+<screen>
+innodb_rollback_on_timeout=1
+innodb_lock_wait_timeout=600
+max_connections=350
+log-bin=mysql-bin
+binlog-format = 'ROW'
+</screen>
+
+ </para>
+ <para>
+ Now that <application>MySQL</application> is properly configured we can start it and configure it to start on boot as follows:
+<screen>
+ <prompt># </prompt><userinput><command>service</command> mysqld start</userinput>
+ <prompt># </prompt><userinput><command>chkconfig</command> mysqld on</userinput>
+</screen>
+
+ </para>
+
+ </section>
+
+ <section id="sect-Runbook-Management-extraction">
+ <title>Extraction</title>
+ <para>
+ The next step is to extract the contents of the CloudStack tarball (mentioned in <xref linkend="sect-Runbook-Overview-prereqs" />) you downloaded previously. To extract the contents of this tarball use the following command:
+ </para>
+
+<screen>
+ <prompt># </prompt><userinput><command>tar</command> -xzvf CloudStack-oss-3.0.2-1-rhel6.2.tar.gz</userinput>
+</screen>
+ <para>
+ For the next few sections you'll need to <command>cd</command> into the first level that was just created.
+ </para>
+
+ </section>
+
+ <section id="sect-Runbook-Management-installation">
+ <title>Installation</title>
+ <para>
+ Now that you are in the directory created by extracting the tarball, it's now time to install. We'll run <filename>./install.sh</filename> and choose option <option>M</option>. This will install the management server and necessary dependencies.
+ </para>
+ <para>
+ With the application itself installed we can now setup the database, we'll do that with the following command and options:
+ </para>
+
+<screen>
+ <prompt># </prompt><userinput><command>cloud-setup-databases</command> cloud:<replaceable>password</replaceable>@localhost --deploy-as=root</userinput>
+</screen>
+ <para>
+ When this process is finished, you should see a message like "CloudStack has successfully initialized the database."
+ </para>
+ <para>
+ Now that the database has been created, we can take the final step in setting up the management server by issuing the following command:
+ </para>
+
+<screen>
+ <prompt># </prompt><userinput><command>cloud-setup-mangament</command></userinput>
+</screen>
+
+ </section>
+
+ <section id="sect-Runbook-Management-templatesetup">
+ <title>System Template Setup</title>
+ <para>
+ CloudStack uses a number of system VMs to provide functionality for accessing the console of virtual machines, providing various networking services, and managing various aspects of storage. This step will acquire those system images ready for deployment when we bootstrap your cloud.
+ </para>
+ <para>
+ The place we are going to download these images to is the secondary storage share that we setup earlier, so we'll need to mount that share with the <command>mount</command> command run on the management server:
+ </para>
+
+<screen>
+ <prompt># </prompt><userinput><command>mount</command> -t nfs <replaceable>172.16.10.</replaceable>2:/secondary /mnt/secondary</userinput>
+</screen>
+ <para>
+ Now we need to download the system VM template and deploy that to the share we just mounted. The management server includes a script to properly manipulate the system VMs images.
+ </para>
+
+<screen>
+ <prompt># </prompt><userinput><command>/usr/lib64/cloud/agent/scripts/storage/secondary/cloud-install-sys-tmplt</command> -m /mnt/secondary -u http://download.cloud.com/templates/acton/acton-systemvm-02062012.qcow2.bz2 -h kvm -F</userinput>
+</screen>
+ <para>
+ That concludes our setup of the management server. We still need to configure CloudStack, but we will do that after we get our hypervisor set up.
+ </para>
+
+ </section>
+
+</chapter>
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/8e353282/docs/runbook/tmp/en-US/xml/Overview.xml
----------------------------------------------------------------------
diff --git a/docs/runbook/tmp/en-US/xml/Overview.xml b/docs/runbook/tmp/en-US/xml/Overview.xml
new file mode 100644
index 0000000..05b6e8d
--- /dev/null
+++ b/docs/runbook/tmp/en-US/xml/Overview.xml
@@ -0,0 +1,87 @@
+<?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 "Runbook.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-Runbook-Overview" lang="en-US">
+ <!-- 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.
+ --> <title>Overview</title>
+ <para>
+ Infrastructure-as-a-Service (IaaS) clouds can be a complex thing to build, and by definition they have a plethora of options, which often lead to confusion for even experienced admins who are newcomers to building cloud platforms. The goal for this runbook is to provide a straightforward set of instructions to get you up and running with CloudStack with a minimum amount of trouble.
+ </para>
+ <section id="sect-Runbook-Overview-What_building">
+ <title>What exactly are we building?</title>
+ <para>
+ This runbook will focus on building a CloudStack cloud using KVM with CentOS 6.2 with NFS storage on a flat layer-2 network utilizing layer-3 network isolation (aka Security Groups), and doing it all on a single piece of hardware.
+ </para>
+ <para>
+ KVM, or Kernel-based Virtual Machine is a virtualization technology for the Linux kernel. KVM supports native virtualization atop processors with hardware virtualization extensions.
+ </para>
+ <para>
+ Security Groups act as distributed firewalls that control access to a group of virtual machines.
+ </para>
+
+ </section>
+
+ <section id="sect-Runbook-Overview-hilevel">
+ <title>High level overview of the process</title>
+ <para>
+ Before we actually get to installing CloudStack, we'll start with installing our base operating system, and then configuring that to act as an NFS server for several types of storage. We'll install the management server, download the systemVMs, and finally install the agent software. Finally we'll spend a good deal of time configuring the entire cloud in the CloudStack web interface.
+ </para>
+
+ </section>
+
+ <section id="sect-Runbook-Overview-prereqs">
+ <title>Prerequisites</title>
+ <para>
+ To complete this runbook you'll need the following items:
+ <orderedlist>
+ <listitem>
+ <para>
+ At least one computer which supports hardware virtualization.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ The <ulink url="http://mirrors.kernel.org/centos/6.2/isos/x86_64/CentOS-6.2-x86_64-minimal.iso"> CentOS 6.2 x86_64 minimal install CD </ulink>
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ A /24 network with the gateway being at xxx.xxx.xxx.1, no DHCP should be on this network and none of the computers running CloudStack may have a dynamic address.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Copy of <ulink url="http://sourceforge.net/projects/cloudstack/files/CloudStack%20Acton/3.0.2/CloudStack-oss-3.0.2-1-rhel6.2.tar.gz/download"> CloudStack 3.0.2 for RHEL and CentOS 6.2 </ulink>
+ </para>
+
+ </listitem>
+
+ </orderedlist>
+
+ </para>
+
+ </section>
+
+
+</chapter>
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/8e353282/docs/runbook/tmp/en-US/xml/Preface.xml
----------------------------------------------------------------------
diff --git a/docs/runbook/tmp/en-US/xml/Preface.xml b/docs/runbook/tmp/en-US/xml/Preface.xml
new file mode 100644
index 0000000..556e212
--- /dev/null
+++ b/docs/runbook/tmp/en-US/xml/Preface.xml
@@ -0,0 +1,29 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Runbook.ent">
+%BOOK_ENTITIES;
+]>
+<preface id="pref-Runbook-Preface" lang="en-US">
+ <!-- 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.
+ --> <title>Preface</title>
+ <xi:include href="Common_Content/Conventions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude"><xi:fallback xmlns:xi="http://www.w3.org/2001/XInclude"><xi:include href="Common_Content/Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ </xi:fallback>
+ </xi:include>
+</preface>
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/8e353282/docs/runbook/tmp/en-US/xml/Revision_History.xml
----------------------------------------------------------------------
diff --git a/docs/runbook/tmp/en-US/xml/Revision_History.xml b/docs/runbook/tmp/en-US/xml/Revision_History.xml
new file mode 100644
index 0000000..1927b3c
--- /dev/null
+++ b/docs/runbook/tmp/en-US/xml/Revision_History.xml
@@ -0,0 +1,43 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Runbook.ent">
+%BOOK_ENTITIES;
+]>
+<appendix id="appe-Runbook-Revision_History" lang="en-US">
+ <!-- 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.
+ --> <title>Revision History</title>
+ <simpara>
+ <revhistory>
+ <revision>
+ <revnumber>0-0</revnumber>
+ <date>Mon Jun 25 2012</date>
+ <revdescription>
+ <simplelist>
+ <member>Initial creation of book by publican</member>
+
+ </simplelist>
+
+ </revdescription>
+
+ </revision>
+
+ </revhistory>
+
+ </simpara>
+</appendix>
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/8e353282/docs/runbook/tmp/en-US/xml/Runbook.ent
----------------------------------------------------------------------
diff --git a/docs/runbook/tmp/en-US/xml/Runbook.ent b/docs/runbook/tmp/en-US/xml/Runbook.ent
new file mode 100644
index 0000000..cdc00b0
--- /dev/null
+++ b/docs/runbook/tmp/en-US/xml/Runbook.ent
@@ -0,0 +1,22 @@
+<!-- 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.
+-->
+
+<!ENTITY PRODUCT "Apache CloudStack">
+<!ENTITY BOOKID "Runbook">
+<!ENTITY YEAR "2012">
+<!ENTITY HOLDER "Apache Software Foundation">