64b6c9261e
Current folder name New folder name Book title ---------------------------------------------------------- basic-install DELETE cli-guide DELETE common common NEW admin-guide-cloud Cloud Administrators Guide docbkx-example DELETE openstack-block-storage-admin DELETE openstack-compute-admin DELETE openstack-config config-reference OpenStack Configuration Reference openstack-ha high-availability-guide OpenStack High Availabilty Guide openstack-image image-guide OpenStack Virtual Machine Image Guide openstack-install install-guide OpenStack Installation Guide openstack-network-connectivity-admin admin-guide-network OpenStack Networking Administration Guide openstack-object-storage-admin DELETE openstack-security security-guide OpenStack Security Guide openstack-training training-guide OpenStack Training Guide openstack-user user-guide OpenStack End User Guide openstack-user-admin user-guide-admin OpenStack Admin User Guide glossary NEW OpenStack Glossary bug: #1220407 Change-Id: Id5ffc774b966ba7b9a591743a877aa10ab3094c7 author: diane fleming
167 lines
7.3 KiB
XML
167 lines
7.3 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<chapter xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
|
|
xml:id="ch_installing-openstack-overview">
|
|
<title>Installing OpenStack Walk-through</title>
|
|
<para>The OpenStack Compute and Image services work together to
|
|
provide access to virtual servers and images through REST
|
|
APIs. The Identity Service provides a common authorization
|
|
layer for all OpenStack services. You must use the Identity
|
|
Service to install the OpenStack Dashboard, which offers a
|
|
web-based user interface for OpenStack components. The
|
|
OpenStack Object Storage service provides not only a storage
|
|
method for virtual images but also a cloud-based object
|
|
storage system with a REST API to store and retrieve objects
|
|
such as images or videos. This walk-through starts with
|
|
Identity, then goes through Image and Compute and also
|
|
provides deployment information about an Object Storage
|
|
installation.</para>
|
|
<para>If you are interested in how to plan for and operate an
|
|
OpenStack cloud, see the <link
|
|
xlink:href="http://docs.openstack.org/ops/"><citetitle>OpenStack
|
|
Operations Guide</citetitle></link>.</para>
|
|
<para>Here are the overall steps for a manual install:</para>
|
|
<orderedlist>
|
|
<listitem>
|
|
<para>Review the most supported platforms. Red Hat
|
|
Enterprise Linux, Scientific Linux, CentOS, Fedora,
|
|
Debian, Ubuntu, openSUSE and SUSE Linux Enterprise
|
|
are the most tested platforms
|
|
currently.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Install the Identity Service (Keystone).</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Configure the Identity Service.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Install the Image Service (Glance).</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Configure the Image Service.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Install Compute (Nova).</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Review the assumptions made in this installation for
|
|
Compute.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Configure Compute with FlatDHCP networking using
|
|
<literal>192.168.100.0/24</literal> as the fixed
|
|
range for our guest VMs on a bridge named
|
|
<literal>br100</literal>.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Create and initialize the Compute database with
|
|
MySQL. PostgreSQL is also documented but all examples
|
|
follow MySQL as an assumed default.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Add images.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>(optional) Install OpenStack Object Storage
|
|
(Swift).</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Install the OpenStack Dashboard.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Launch the Dashboard.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Add a keypair through the Dashboard.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Launch an image through the Dashboard to verify the
|
|
entire installation.</para>
|
|
</listitem>
|
|
</orderedlist>
|
|
<section xml:id="installing-openstack-compute-on-ubuntu"
|
|
os="ubuntu">
|
|
<title>Installing on Ubuntu</title>
|
|
<para>How you go about installing OpenStack Compute depends on
|
|
your goals for the installation. You can use an ISO image,
|
|
you can use a scripted installation, and you can manually
|
|
install with a step-by-step installation as described in
|
|
this manual.</para>
|
|
<section xml:id="iso-ubuntu-installation" os="ubuntu">
|
|
<title>ISO Installation</title>
|
|
<para>See <link
|
|
xlink:href="http://www.rackspace.com/knowledge_center/article/installing-rackspace-private-cloud-on-physical-hardware"
|
|
>Installing Rackspace Private Cloud on Physical
|
|
Hardware</link> for download links and
|
|
instructions for the Rackspace Private Cloud ISO. For
|
|
documentation on the Rackspace, see <link
|
|
xlink:href="http://www.rackspace.com/cloud/private"
|
|
>http://www.rackspace.com/cloud/private</link>.
|
|
</para>
|
|
</section>
|
|
|
|
<section xml:id="manual-ubuntu-installation" os="ubuntu">
|
|
<title>Manual Installation on Ubuntu</title>
|
|
|
|
<para>The manual installation involves installing from
|
|
packages backported on Ubuntu 12.04 LTS using the Cloud
|
|
Archive as a user with root (or sudo) permission. This
|
|
guide provides instructions for installing using
|
|
Ubuntu packages.</para>
|
|
</section>
|
|
</section>
|
|
<section xml:id="scripted-dev-installation">
|
|
<title>Scripted Development Installation</title>
|
|
|
|
<para>You can download a script for a standalone install
|
|
for proof-of-concept, learning, or for development
|
|
purposes for Ubuntu 12.04, Fedora 16 or openSUSE 12.3 at <link
|
|
xlink:href="http://devstack.org"
|
|
>https://devstack.org</link>.</para>
|
|
|
|
<orderedlist>
|
|
<listitem>
|
|
<para>Install Ubuntu 12.04 or Fedora 16 or openSUSE 12.3:</para>
|
|
|
|
<para>In order to correctly install all the
|
|
dependencies, we assume a specific version of
|
|
the OS to make it as easy as possible.</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>Download DevStack:</para>
|
|
|
|
<screen><prompt>$</prompt> <userinput>git clone git://github.com/openstack-dev/devstack.git</userinput></screen>
|
|
|
|
<para>The devstack repository contains a script
|
|
that installs OpenStack Compute, Object
|
|
Storage, the Image Service, Volumes, the
|
|
Dashboard and the Identity Service and offers
|
|
templates for configuration files plus data
|
|
scripts.</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>Start the install:</para>
|
|
|
|
<screen><prompt>$</prompt> <userinput>cd devstack; ./stack.sh</userinput></screen>
|
|
|
|
<para>It takes a few minutes. We recommend <link
|
|
xlink:href="http://devstack.org/stack.sh.html"
|
|
>reading the well-documented script</link>
|
|
while it is building to learn more about what
|
|
is going on.</para>
|
|
</listitem>
|
|
</orderedlist>
|
|
</section>
|
|
<xi:include href="section_example-installation-arch.xml"/>
|
|
<xi:include href="section_service-arch.xml"/>
|
|
<xi:include href="section_compute-sys-requirements.xml"/>
|
|
<xi:include href="section_compute-network-planning.xml"/>
|
|
<xi:include href="section_installing-ntp.xml"/>
|
|
<xi:include href="section_installing-mysql.xml"/>
|
|
<xi:include href="section_installing-rabbitmq.xml"/>
|
|
</chapter>
|