openstack/operations-guide
Code Issues Proposed changes

Updates acknowledgements and preface

Browse Source 
- Ensure to add Adam Hyde, sorts lists better
 - Adding to Preface to situate this Guide amongst other OpenStack
   Guides
 - Adds to doc history table

Change-Id: I1f8c21457deaa835cedcf30a13c5a2fe840673bb
This commit is contained in:
annegentle 2013-12-12 16:43:50 -06:00 committed by Andreas Jaeger
parent 7bf0e5ff70
commit 6f7dcfd440
3 changed files with 203 additions and 70 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

114
doc/openstack-ops/acknowledgements.xml
View File

@ -15,59 +15,65 @@
<acknowledgements 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="acknowledgments">
xml:id="acknowledgments">
<title>Acknowledgments</title>
<para>The OpenStack Foundation supported the creation of this
book with plane tickets to Austin, lodging (including one
adventurous evening without power after a windstorm), and
delicious food. For about USD $10,000, we could
collaborate intensively for a week in the same room at the
Rackspace Austin office. The authors are all members of
the OpenStack Foundation, which you can join. Go to the
<link
xlink:href="https://www.openstack.org/join">Foundation
web site</link> at <uri>http://openstack.org/join</uri>.</para>
<para>We want to acknowledge our excellent host Rackers at
Rackspace in Austin: <itemizedlist>
<listitem>
<para>Emma Richards of Rackspace Guest Relations
took excellent care of our lunch orders and
even set aside a pile of sticky notes that had
fallen off the walls.</para>
</listitem>
<listitem>
<para>Betsy Hagemeier, a Fanatical Executive
Assistant, took care of a room reshuffle and
helped us settle in for the week.</para>
</listitem>
<listitem>
<para>The Real Estate team at Rackspace in Austin,
also known as "The Victors," were super
responsive.</para>
</listitem>
<listitem>
<para>Adam Powell in Racker IT supplied us with
bandwidth each day and second monitors for
those of us needing more screens.</para>
</listitem>
<listitem>
<para>On Wednesday night we had a fun happy hour
with the Austin OpenStack Meetup group and
Racker Katie Schmidt took great care of our
group.</para>
</listitem>
<listitem>
<para>We also had some excellent input from
outside of the room. Tim Bell from CERN gave
us feedback on the outline before we started
and reviewed it mid-week.</para>
<para>Sébastien Han has written excellent blogs
and generously gave his permission for re-use.</para>
<para>Oisin Feeley read it, made some edits, and
provided emailed feedback right when we asked.</para>
</listitem>
</itemizedlist></para>
<para>We couldn't have pulled it off without so much
supportive help and encouragement.</para>
<para>The OpenStack Foundation supported the creation of this book with
plane tickets to Austin, lodging (including one adventurous evening
without power after a windstorm), and delicious food. For about USD
$10,000, we could collaborate intensively for a week in the same room at
the Rackspace Austin office. The authors are all members of the
OpenStack Foundation, which you can join. Go to the <link
xlink:href="https://www.openstack.org/join">Foundation web
site</link> at <uri>http://openstack.org/join</uri>.</para>
<para>We want to acknowledge our excellent host Rackers at Rackspace in
Austin:</para>
<itemizedlist>
<listitem>
<para>Emma Richards of Rackspace Guest Relations took excellent care
of our lunch orders and even set aside a pile of sticky notes
that had fallen off the walls.</para>
</listitem>
<listitem>
<para>Betsy Hagemeier, a Fanatical Executive Assistant, took care of
a room reshuffle and helped us settle in for the week.</para>
</listitem>
<listitem>
<para>The Real Estate team at Rackspace in Austin, also known as
"The Victors," were super responsive.</para>
</listitem>
<listitem>
<para>Adam Powell in Racker IT supplied us with bandwidth each day
and second monitors for those of us needing more screens.</para>
</listitem>
<listitem>
<para>On Wednesday night we had a fun happy hour with the Austin
OpenStack Meetup group and Racker Katie Schmidt took great care
of our group.</para>
</listitem>
</itemizedlist>
<para>We also had some excellent input from outside of the room:</para>
<itemizedlist>
<listitem>
<para>Tim Bell from CERN gave us feedback on the outline before we
started and reviewed it mid-week.</para>
</listitem>
<listitem>
<para>Sébastien Han has written excellent blogs and generously gave
his permission for re-use.</para>
</listitem>
<listitem>
<para>Oisin Feeley read it, made some edits, and provided emailed
feedback right when we asked.</para>
</listitem>
</itemizedlist>
<para>Inside the book sprint room with us each day was our book
sprint facilitator Adam Hyde. Without his tireless support and
encouragement, we would have thought a book of this scope was
impossible in five days. Adam has proven the book sprint
method effectively again and again. He creates both tools and
faith in collaborative authoring at <link
xlink:href="http://www.booksprints.net/"
>www.booksprints.net</link>.</para>
<para>We couldn't have pulled it off without so much supportive help and
encouragement.</para>
</acknowledgements>
<!-- STATUS: OK for Havana -->

20
doc/openstack-ops/bk_ops_guide.xml
View File

@ -45,8 +45,21 @@
operating OpenStack clouds.</para>
</abstract>
<revhistory>
<!-- ... continue adding more revisions here as you change this
document using the markup shown below... -->
<revision>
<date>2013-12-12</date>
<revdescription>
<itemizedlist spacing="compact">
<listitem>
<para>Additions to acknowledgements and preface to
situate this guide relative to other OpenStack
guides.</para>
</listitem>
</itemizedlist>
</revdescription>
</revision>
<revision>
<!-- ... continue adding more revisions here as you change this document using the markup shown below... -->
<date>2013-05-13</date>
<revdescription>
<itemizedlist spacing="compact">
@ -55,7 +68,8 @@
</listitem>
</itemizedlist>
</revdescription>
</revision><revision>
</revision>
<revision>
<date>2013-04-02</date>
<revdescription>
<itemizedlist spacing="compact">
@ -74,8 +88,6 @@
<para>Stopped chunking in HTML
output.</para>
</listitem>
</itemizedlist>
</revdescription>
</revision>

139
doc/openstack-ops/preface_ops.xml
View File

@ -64,24 +64,139 @@
great flexibility, but the number of options might be bewildering at
first.</para>
</section>
<section xml:id="who-this-book-is-for"><title>Who This Book Is For</title>
<section xml:id="who-this-book-is-for">
<title>Who This Book Is For</title>
<para>This guide assumes that you are familiar with the Ubuntu
distribution of Linux, SQL databases, and virtualization. You
must be comfortable administering and configuring multiple
Linux machines for networking. You must install and maintain a
MySQL database, and occasionally run SQL queries against it.
</para>
distribution of Linux, SQL databases, and virtualization. You must
be comfortable administering and configuring multiple Linux machines
for networking. You must install and maintain a MySQL database, and
occasionally run SQL queries against it.</para>
<para>One of the most complex aspects of an OpenStack cloud is the
networking configuration. You should be familiar with concepts such
as DHCP, Linux bridges, VLANs, and iptables. You must also have
access to a network hardware expert who can configure the switches
and routers required in your OpenStack cloud.</para>
<para>This book is for those of you starting to run OpenStack
clouds as well as those of you who were handed a running one and
want to keep it running well. Perhaps you're on a devops team,
perhaps you are a system administrator starting to dabble in the
cloud, or maybe you want to get on that OpenStack cloud team at your
company. This book is for all of you.</para></section>
<para>This book is for those of you starting to run OpenStack clouds as
well as those of you who were handed a running one and want to keep
it running well. Perhaps you're on a devops team, perhaps you are a
system administrator starting to dabble in the cloud, or maybe you
want to get on that OpenStack cloud team at your company. This book
is for all of you.</para>
<para>There are other books on the OpenStack documentation web site at
<link xlink:href="http://docs.openstack.org"
>docs.openstack.org</link> that can help you get the job
done.</para>
<variablelist>
<title>OpenStack Guides</title>
<varlistentry>
<term>OpenStack Installation Guides</term>
<listitem>
<para>Describe a manual install process, as in, by hand, no
automation, for multiple distributions based on packaging
system:</para>
<itemizedlist>
<listitem>
<para><link
xlink:href="http://docs.openstack.org/havana/install-guide/install/apt-debian/content/"
>Installation Guide for Debian 7.0</link>
</para>
</listitem>
<listitem>
<para><link
xlink:href="http://docs.openstack.org/havana/install-guide/install/zypper/content/"
>Installation Guide for openSUSE and SUSE
Linux Enterprise Server</link>
</para>
</listitem>
<listitem>
<para><link
xlink:href="http://docs.openstack.org/havana/install-guide/install/yum/content/"
>Installation Guide for Red Hat Enterprise
Linux, CentOS, and Fedora</link></para>
</listitem>
<listitem>
<para><link
xlink:href="http://docs.openstack.org/havana/install-guide/install/apt/content/"
>Installation Guide for Ubuntu 12.04 (LTS)
Server</link></para>
</listitem>
</itemizedlist>
</listitem>
</varlistentry>
<varlistentry>
<term><link
xlink:href="http://docs.openstack.org/havana/config-reference/content/"
>OpenStack Configuration Reference</link>
</term>
<listitem>
<para>Contains a reference listing of all configuration
options for core and integrated OpenStack services by
release version.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><link
xlink:href="http://docs.openstack.org/admin-guide-cloud/content/"
>OpenStack Cloud Administrator Guide</link></term>
<listitem>
<para>Contains how-to information for managing an OpenStack
cloud as needed for your use cases, such as storage,
computing, or software-defined-networking.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><link
xlink:href="http://docs.openstack.org/high-availability-guide/content/index.html"
>OpenStack High Availability Guide</link>
</term>
<listitem>
<para>Describes potential strategies for making your
OpenStack services and related controllers and data
stores highly available.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><link xlink:href="http://docs.openstack.org/sec/"
>OpenStack Security Guide</link></term>
<listitem>
<para>Provide best practices and conceptual information
about securing an OpenStack cloud.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><link xlink:href="http://docs.openstack.org/image-guide/content/">Virtual Machine Image Guide</link></term>
<listitem>
<para>Shows you how to obtain, create, and modify virtual
machine images that are compatible with
OpenStack.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><link xlink:href="http://docs.openstack.org/user-guide/content/">OpenStack End User Guide</link></term>
<listitem>
<para>Shows OpenStack end users how to create and manage
resources in an OpenStack cloud with the OpenStack
dashboard and OpenStack client commands.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><link xlink:href="http://docs.openstack.org/user-guide-admin/content/">OpenStack Admin User Guide</link></term>
<listitem>
<para>Shows OpenStack administrators how to create and
manage resources in an OpenStack cloud with the
OpenStack dashboard and OpenStack client
commands.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><link xlink:href="http://docs.openstack.org/api/quick-start/content/">OpenStack API Quick Start</link></term>
<listitem>
<para>A brief overview of how to send REST API requests to
endpoints for OpenStack services.</para>
</listitem>
</varlistentry>
</variablelist>
</section>
<section xml:id="how-this-book-is-organized">
<title>How This Book Is Organized</title>
<para>This book is organized in two parts, the architecture decisions