incubator-cloudstack-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From j..@apache.org
Subject [34/52] [abbrv] [partial] CLOUDSTACK-444 Fix from Radhika PC against docs, adds network setup in the install guide.
Date Wed, 07 Nov 2012 18:01:12 GMT
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">


Mime
View raw message