mirror of https://github.com/apache/cloudstack.git
first round of changes to names
This commit is contained in:
David Nalley
parent
35bd910e83
commit
742e47e4b2
|
|
@ -1,6 +1,6 @@
|
|||
<?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 "Runbook.ent">
|
||||
<!ENTITY % BOOK_ENTITIES SYSTEM "qig.ent">
|
||||
%BOOK_ENTITIES;
|
||||
]>
|
||||
|
||||
|
|
@ -23,16 +23,16 @@
|
|||
-->
|
||||
|
||||
|
||||
<bookinfo id="book-Runbook-Runbook">
|
||||
<title>Runbook</title>
|
||||
<bookinfo id="book-qig-qig">
|
||||
<title>Quick Install Guide</title>
|
||||
<subtitle>Prescriptive instructions for deploying Apache CloudStack</subtitle>
|
||||
<productname>Apache CloudStack</productname>
|
||||
<productnumber>4.0.0-incubating</productnumber>
|
||||
<productnumber>4.0.1-incubating</productnumber>
|
||||
<edition>0</edition>
|
||||
<pubsnumber>0</pubsnumber>
|
||||
<abstract>
|
||||
<para>
|
||||
These runbooks are designed to provide a strict environment to guarantee
|
||||
This guide is designed to provide a strict environment to guarantee
|
||||
a higher degree of success in initial deployments of Apache CloudStack.
|
||||
All of the elements of the environment will be provided to you.
|
||||
Apache CloudStack is capable of much more complex configurations,
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
<?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">
|
||||
<!ENTITY % BOOK_ENTITIES SYSTEM "qig.ent">
|
||||
%BOOK_ENTITIES;
|
||||
]>
|
||||
|
||||
|
|
@ -23,13 +23,13 @@
|
|||
-->
|
||||
|
||||
|
||||
<chapter id="chap-Runbook-Environment">
|
||||
<chapter id="chap-qig-Environment">
|
||||
<title>Environment</title>
|
||||
<para>
|
||||
Before you begin, you need to prepare the environment before you install CloudStack.
|
||||
We will go over the steps to prepare now.
|
||||
</para>
|
||||
<section id="sect-Runbook-Environment-operatingsys">
|
||||
<section id="sect-qig-Environment-operatingsys">
|
||||
<title>Operating System</title>
|
||||
<para>
|
||||
Using the CentOS 6.3 x86_64 minimal install ISO, you'll need to install CentOS
|
||||
|
|
@ -41,7 +41,7 @@
|
|||
logins in a production environment, so be sure to turn off remote logins once you
|
||||
have finished the installation and configuration.
|
||||
</para>
|
||||
<section id="sect-Runbook-Environment-operatingsys-network">
|
||||
<section id="sect-qig-Environment-operatingsys-network">
|
||||
<title>Configuring the network</title>
|
||||
<para>
|
||||
By default the network will not come up on your hardware and you
|
||||
|
|
@ -103,7 +103,7 @@ DNS2=8.8.4.4
|
|||
<screen><prompt># </prompt><userinput><command>chkconfig</command> network on</userinput></screen>
|
||||
<screen><prompt># </prompt><userinput><command>service</command> network start</userinput></screen>
|
||||
</section>
|
||||
<section id="sect-Runbook-Environment-operatingsys-hostname">
|
||||
<section id="sect-qig-Environment-operatingsys-hostname">
|
||||
<title>Hostname</title>
|
||||
<para>
|
||||
Cloudstack requires that the hostname be properly set. If you used the default
|
||||
|
|
@ -123,7 +123,7 @@ DNS2=8.8.4.4
|
|||
<para>Now recheck with the <command>hostname --fqdn</command> command and ensure that it returns
|
||||
a FQDN response</para>
|
||||
</section>
|
||||
<section id="sect-Runbook-Environment-operatingsys-selinux">
|
||||
<section id="sect-qig-Environment-operatingsys-selinux">
|
||||
<title>SELinux</title>
|
||||
<para>At the moment, for CloudStack to work properly SELinux must be
|
||||
set to permissive. We want to both configure this for future boots and modify it
|
||||
|
|
@ -151,7 +151,7 @@ SELINUXTYPE=targeted
|
|||
</screen>
|
||||
|
||||
</section>
|
||||
<section id="sect-Runbook-Environment-operatingsys-ntp">
|
||||
<section id="sect-qig-Environment-operatingsys-ntp">
|
||||
<title>NTP</title>
|
||||
<para>NTP configuration is a necessity for keeping all of the clocks in your cloud
|
||||
servers in sync. However, NTP is not installed by default. So we'll install and
|
||||
|
|
@ -163,7 +163,7 @@ SELINUXTYPE=targeted
|
|||
<screen><prompt># </prompt><userinput><command>chkconfig</command> ntpd on</userinput></screen>
|
||||
<screen><prompt># </prompt><userinput><command>service</command> ntpd start</userinput></screen>
|
||||
</section>
|
||||
<section id="sect-Runbook-Environment-operatingsys-repoconfig">
|
||||
<section id="sect-qig-Environment-operatingsys-repoconfig">
|
||||
<title>Configuring the CloudStack Package Repository</title>
|
||||
<para>
|
||||
We need to configure the machine to use a CloudStack package repository.
|
||||
|
|
@ -188,7 +188,7 @@ gpgcheck=0
|
|||
</programlisting>
|
||||
</section>
|
||||
</section>
|
||||
<section id="sect-Runbook-Environment-nfs">
|
||||
<section id="sect-qig-Environment-nfs">
|
||||
<title>NFS</title>
|
||||
<para>
|
||||
Our configuration is going to use NFS for both primary and secondary
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
<?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">
|
||||
<!ENTITY % BOOK_ENTITIES SYSTEM "qig.ent">
|
||||
%BOOK_ENTITIES;
|
||||
]>
|
||||
|
||||
|
|
@ -23,13 +23,13 @@
|
|||
-->
|
||||
|
||||
|
||||
<chapter id="chap-Runbook-Management">
|
||||
<chapter id="chap-qig-Management">
|
||||
<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">
|
||||
<section id="sect-qig-Management-database">
|
||||
<title>Database Installation and Configuration</title>
|
||||
<para>
|
||||
We'll start out by installing <application>MySQL</application> and configuring
|
||||
|
|
@ -61,7 +61,7 @@ binlog-format = 'ROW'
|
|||
|
||||
</section>
|
||||
|
||||
<section id="sect-Runbook-Management-installation">
|
||||
<section id="sect-qig-Management-installation">
|
||||
<title>Installation</title>
|
||||
<para>We are now going to install the management server. We do that by executing the following command:
|
||||
<screen><prompt># </prompt><userinput><command>yum</command> -y install cloud-client</userinput></screen>
|
||||
|
|
@ -75,7 +75,7 @@ binlog-format = 'ROW'
|
|||
<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-management</command></userinput></screen>
|
||||
</section>
|
||||
<section id="sect-Runbook-Management-templatesetup">
|
||||
<section id="sect-qig-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
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
<?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">
|
||||
<!ENTITY % BOOK_ENTITIES SYSTEM "qig.ent">
|
||||
%BOOK_ENTITIES;
|
||||
]>
|
||||
|
||||
|
|
@ -23,7 +23,7 @@
|
|||
-->
|
||||
|
||||
|
||||
<chapter id="chap-Runbook-Overview">
|
||||
<chapter id="chap-qig-Overview">
|
||||
<title>Overview</title>
|
||||
<para>
|
||||
Infrastructure-as-a-Service (IaaS) clouds can be a complex thing to build,
|
||||
|
|
@ -32,7 +32,7 @@
|
|||
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">
|
||||
<section id="sect-qig-Overview-What_building">
|
||||
<title>What exactly are we building?</title>
|
||||
<para>
|
||||
This runbook will focus on building a CloudStack cloud using KVM with
|
||||
|
|
@ -50,7 +50,7 @@
|
|||
to a group of virtual machines.
|
||||
</para>
|
||||
</section>
|
||||
<section id="sect-Runbook-Overview-hilevel">
|
||||
<section id="sect-qig-Overview-hilevel">
|
||||
<title>High level overview of the process</title>
|
||||
<para>
|
||||
Before we actually get to installing CloudStack, we'll start with
|
||||
|
|
@ -61,7 +61,7 @@
|
|||
cloud in the CloudStack web interface.
|
||||
</para>
|
||||
</section>
|
||||
<section id="sect-Runbook-Overview-prereqs">
|
||||
<section id="sect-qig-Overview-prereqs">
|
||||
<title>Prerequisites</title>
|
||||
<para>
|
||||
To complete this runbook you'll need the following items:
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
<?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">
|
||||
<!ENTITY % BOOK_ENTITIES SYSTEM "qig.ent">
|
||||
%BOOK_ENTITIES;
|
||||
]>
|
||||
|
||||
|
|
@ -23,7 +23,7 @@
|
|||
-->
|
||||
|
||||
|
||||
<preface id="pref-Runbook-Preface">
|
||||
<preface id="pref-qig-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" />
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
<?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">
|
||||
<!ENTITY % BOOK_ENTITIES SYSTEM "qig.ent">
|
||||
%BOOK_ENTITIES;
|
||||
]>
|
||||
|
||||
|
|
@ -23,7 +23,7 @@
|
|||
-->
|
||||
|
||||
|
||||
<appendix id="appe-Runbook-Revision_History">
|
||||
<appendix id="appe-qig-Revision_History">
|
||||
<title>Revision History</title>
|
||||
<simpara>
|
||||
<revhistory>
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
<?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">
|
||||
<!ENTITY % BOOK_ENTITIES SYSTEM "qig.ent">
|
||||
%BOOK_ENTITIES;
|
||||
]>
|
||||
|
||||
|
|
@ -23,7 +23,7 @@
|
|||
-->
|
||||
|
||||
|
||||
<chapter id="chap-Runbook-Config">
|
||||
<chapter id="chap-qig-Config">
|
||||
<title>Configuration</title>
|
||||
<para>
|
||||
As we noted before we will be using security groups to provide isolation
|
||||
|
|
@ -31,7 +31,7 @@
|
|||
It also means that the simplicity of our setup means that we can use the
|
||||
quick installer.
|
||||
</para>
|
||||
<section id="sect-Runbook-Config-UI_Access">
|
||||
<section id="sect-qig-Config-UI_Access">
|
||||
<title>UI Access</title>
|
||||
<para>
|
||||
To get access to CloudStack's web interface, merely point your
|
||||
|
|
@ -46,7 +46,7 @@
|
|||
the admin user. Please do so.
|
||||
</para>
|
||||
</section>
|
||||
<section id="sect-Runbook-Config-Zone">
|
||||
<section id="sect-qig-Config-Zone">
|
||||
<title>Setting up a Zone</title>
|
||||
<para>
|
||||
A zone is the largest organization entity in CloudStack - and we'll be creating one, this
|
||||
|
|
@ -86,7 +86,7 @@
|
|||
</para>
|
||||
</note>
|
||||
</section>
|
||||
<section id="sect-Runbook-Config-Pod">
|
||||
<section id="sect-qig-Config-Pod">
|
||||
<title>Pod Configuration</title>
|
||||
<para>Now that we've added a Zone, the next step that comes up is a prompt
|
||||
for information regading a pod. Which is looking for 4 items.
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
<?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">
|
||||
<!ENTITY % BOOK_ENTITIES SYSTEM "qig.ent">
|
||||
%BOOK_ENTITIES;
|
||||
]>
|
||||
|
||||
|
|
@ -23,7 +23,7 @@
|
|||
-->
|
||||
|
||||
|
||||
<chapter id="chap-Runbook-KVM">
|
||||
<chapter id="chap-qig-KVM">
|
||||
<title>KVM Setup and installation</title>
|
||||
<para>
|
||||
KVM is the hypervisor we'll be using - we will recover the initial setup
|
||||
|
|
@ -31,7 +31,7 @@
|
|||
of the agent software, you can use the same steps to add additional KVM
|
||||
nodes to your CloudStack environment.
|
||||
</para>
|
||||
<section id="sect-Runbook-KVM-Prerequisites">
|
||||
<section id="sect-qig-KVM-Prerequisites">
|
||||
<title>Prerequisites</title>
|
||||
<para>
|
||||
We explicitly are using the management server as a compute node as well,
|
||||
|
|
@ -41,27 +41,27 @@
|
|||
<orderedlist>
|
||||
<listitem>
|
||||
<para>
|
||||
<xref linkend="sect-Runbook-Environment-operatingsys-network" />
|
||||
<xref linkend="sect-qig-Environment-operatingsys-network" />
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
<xref linkend="sect-Runbook-Environment-operatingsys-hostname" />
|
||||
<xref linkend="sect-qig-Environment-operatingsys-hostname" />
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
<xref linkend="sect-Runbook-Environment-operatingsys-selinux" />
|
||||
<xref linkend="sect-qig-Environment-operatingsys-selinux" />
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
<xref linkend="sect-Runbook-Environment-operatingsys-ntp" />
|
||||
<xref linkend="sect-qig-Environment-operatingsys-ntp" />
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
<xref linkend="sect-Runbook-Environment-operatingsys-repoconfig" />
|
||||
<xref linkend="sect-qig-Environment-operatingsys-repoconfig" />
|
||||
</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
|
|
@ -72,14 +72,14 @@
|
|||
</para>
|
||||
</section>
|
||||
|
||||
<section id="sect-Runbook-KVM-Installation">
|
||||
<section id="sect-qig-KVM-Installation">
|
||||
<title>Installation</title>
|
||||
<para>Installation of the KVM agent is trivial with just a single command, but afterwards we'll need to configure a few things.</para>
|
||||
<screen><prompt># </prompt><userinput><command>yum</command> -y install cloud-agent</userinput></screen>
|
||||
<section id="sect-Runbook-KVM-Configuration">
|
||||
<section id="sect-qig-KVM-Configuration">
|
||||
<title>KVM Configuration</title>
|
||||
<para>We have two different parts of KVM to configure, libvirt, and QEMU.</para>
|
||||
<section id="sect-Runbook-KVM-Configuration-qemu">
|
||||
<section id="sect-qig-KVM-Configuration-qemu">
|
||||
<title>QEMU Configuration</title>
|
||||
<para>
|
||||
KVM configuration is relatively simple at only a single item. We need to
|
||||
|
|
@ -89,7 +89,7 @@
|
|||
<screen>vnc_listen=0.0.0.0</screen>
|
||||
</para>
|
||||
</section>
|
||||
<section id="sect-Runbook-KVM-Configuration-libvirt">
|
||||
<section id="sect-qig-KVM-Configuration-libvirt">
|
||||
<title>Libvirt Configuration</title>
|
||||
<para>
|
||||
CloudStack uses libvirt for managing virtual machines. Therefore it
|
||||
|
|
@ -130,7 +130,7 @@
|
|||
</listitem>
|
||||
</orderedlist>
|
||||
</section>
|
||||
<section id="sect-Runbook-KVM-Configuration-finish">
|
||||
<section id="sect-qig-KVM-Configuration-finish">
|
||||
<title>KVM configuration complete</title>
|
||||
<para>
|
||||
That concludes our installation and configuration of KVM, and we'll now move to using the CloudStack UI
|
||||
Loading…
Reference in New Issue