You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by se...@apache.org on 2013/05/08 18:20:56 UTC
git commit: updated refs/heads/ACS101 to 68877c8
Updated Branches:
refs/heads/ACS101 fcf628393 -> 68877c899
Adding new user guide to ACS101
Project: http://git-wip-us.apache.org/repos/asf/cloudstack/repo
Commit: http://git-wip-us.apache.org/repos/asf/cloudstack/commit/68877c89
Tree: http://git-wip-us.apache.org/repos/asf/cloudstack/tree/68877c89
Diff: http://git-wip-us.apache.org/repos/asf/cloudstack/diff/68877c89
Branch: refs/heads/ACS101
Commit: 68877c899c6461dc6bf9107b5793bb7d092af451
Parents: fcf6283
Author: Sebastien Goasguen <ru...@gmail.com>
Authored: Wed May 8 12:20:42 2013 -0400
Committer: Sebastien Goasguen <ru...@gmail.com>
Committed: Wed May 8 12:20:42 2013 -0400
----------------------------------------------------------------------
docs/acs101/en-US/ACS101.ent | 22 ++++++++++
docs/acs101/en-US/ACS101.xml | 36 +++++++++++++++++
docs/acs101/en-US/Author_Group.xml | 32 +++++++++++++++
docs/acs101/en-US/Book_Info.xml | 51 ++++++++++++++++++++++++
docs/acs101/en-US/Chapter.xml | 53 +++++++++++++++++++++++++
docs/acs101/en-US/Overview.xml | 56 +++++++++++++++++++++++++++
docs/acs101/en-US/Preface.xml | 33 ++++++++++++++++
docs/acs101/en-US/Revision_History.xml | 42 ++++++++++++++++++++
docs/acs101/publican.cfg | 22 ++++++++++
9 files changed, 347 insertions(+), 0 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/68877c89/docs/acs101/en-US/ACS101.ent
----------------------------------------------------------------------
diff --git a/docs/acs101/en-US/ACS101.ent b/docs/acs101/en-US/ACS101.ent
new file mode 100644
index 0000000..557060e
--- /dev/null
+++ b/docs/acs101/en-US/ACS101.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 "ACS101">
+<!ENTITY YEAR "2013">
+<!ENTITY HOLDER "Apache Software Foundation">
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/68877c89/docs/acs101/en-US/ACS101.xml
----------------------------------------------------------------------
diff --git a/docs/acs101/en-US/ACS101.xml b/docs/acs101/en-US/ACS101.xml
new file mode 100644
index 0000000..2a28955
--- /dev/null
+++ b/docs/acs101/en-US/ACS101.xml
@@ -0,0 +1,36 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ACS101.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.
+-->
+
+
+<book>
+ <xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+# <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Overview.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Installation.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Tools.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Development.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+<!-- <index /> -->
+</book>
+
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/68877c89/docs/acs101/en-US/Author_Group.xml
----------------------------------------------------------------------
diff --git a/docs/acs101/en-US/Author_Group.xml b/docs/acs101/en-US/Author_Group.xml
new file mode 100644
index 0000000..a380636
--- /dev/null
+++ b/docs/acs101/en-US/Author_Group.xml
@@ -0,0 +1,32 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ACS101.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.
+-->
+
+
+<authorgroup>
+ <author>
+ <firstname>Apache</firstname>
+ <surname>CloudStack</surname>
+ </author>
+</authorgroup>
+
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/68877c89/docs/acs101/en-US/Book_Info.xml
----------------------------------------------------------------------
diff --git a/docs/acs101/en-US/Book_Info.xml b/docs/acs101/en-US/Book_Info.xml
new file mode 100644
index 0000000..cc58dd1
--- /dev/null
+++ b/docs/acs101/en-US/Book_Info.xml
@@ -0,0 +1,51 @@
+<?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" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ACS101.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.
+-->
+
+
+<bookinfo id="book-ACS101-ACS101">
+ <title>ACS101</title>
+ <subtitle>Introduction to Apache CloudStack as a foundation for Cloud Computing environments.</subtitle>
+ <productname>Apache CloudStack</productname>
+ <productnumber>4.1.0</productnumber>
+ <edition>0</edition>
+ <pubsnumber>0</pubsnumber>
+ <abstract>
+ <para>
+ This book is aimed to be an introduction to Cloud Computing using Apache CloudStack as the foundation.
+ It covers general Cloud Computing information, &PRODUCT; specific installation, configuration and tuning information
+ as well as small recipes to build around &PRODUCT; deploy Big Data solutions, use of tools and other software that help
+ people build a complete Cloud environment.
+ </para>
+ </abstract>
+ <corpauthor>
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="Common_Content/images/title_logo.svg" format="SVG" />
+ </imageobject>
+ </inlinemediaobject>
+ </corpauthor>
+ <xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</bookinfo>
+
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/68877c89/docs/acs101/en-US/Chapter.xml
----------------------------------------------------------------------
diff --git a/docs/acs101/en-US/Chapter.xml b/docs/acs101/en-US/Chapter.xml
new file mode 100644
index 0000000..0028ffa
--- /dev/null
+++ b/docs/acs101/en-US/Chapter.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 "ACS101.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.
+-->
+
+
+<chapter id="chap-ACS101-Test_Chapter">
+ <title>Test Chapter</title>
+ <para>
+ This is a test paragraph
+ </para>
+ <section id="sect-Runbook-Test_Chapter-Test_Section_1">
+ <title>Test Section 1</title>
+ <para>
+ This is a test paragraph in a section
+ </para>
+ </section>
+
+ <section id="sect-Runbook-Test_Chapter-Test_Section_2">
+ <title>Test Section 2</title>
+ <para>
+ This is a test paragraph in Section 2
+ <orderedlist>
+ <listitem>
+ <para>
+ listitem text
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </section>
+
+</chapter>
+
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/68877c89/docs/acs101/en-US/Overview.xml
----------------------------------------------------------------------
diff --git a/docs/acs101/en-US/Overview.xml b/docs/acs101/en-US/Overview.xml
new file mode 100644
index 0000000..1111e8c
--- /dev/null
+++ b/docs/acs101/en-US/Overview.xml
@@ -0,0 +1,56 @@
+<?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 "ACS101.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.
+-->
+
+
+<chapter id="chap-ACS101-Overview">
+ <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>
+ </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>
+
+</chapter>
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/68877c89/docs/acs101/en-US/Preface.xml
----------------------------------------------------------------------
diff --git a/docs/acs101/en-US/Preface.xml b/docs/acs101/en-US/Preface.xml
new file mode 100644
index 0000000..c174888
--- /dev/null
+++ b/docs/acs101/en-US/Preface.xml
@@ -0,0 +1,33 @@
+<?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 "ACS101.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.
+-->
+
+
+<preface id="pref-Runbook-Preface">
+ <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/cloudstack/blob/68877c89/docs/acs101/en-US/Revision_History.xml
----------------------------------------------------------------------
diff --git a/docs/acs101/en-US/Revision_History.xml b/docs/acs101/en-US/Revision_History.xml
new file mode 100644
index 0000000..c50b973
--- /dev/null
+++ b/docs/acs101/en-US/Revision_History.xml
@@ -0,0 +1,42 @@
+<?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 "ACS101.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.
+-->
+
+
+<appendix id="appe-ACS101-Revision_History">
+ <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/cloudstack/blob/68877c89/docs/acs101/publican.cfg
----------------------------------------------------------------------
diff --git a/docs/acs101/publican.cfg b/docs/acs101/publican.cfg
new file mode 100644
index 0000000..72722cd
--- /dev/null
+++ b/docs/acs101/publican.cfg
@@ -0,0 +1,22 @@
+# Config::Simple 4.59
+# Fri May 25 12:50:59 2012
+# 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.
+
+xml_lang: "en-US"
+type: Book
+brand: cloudstack
+