Updates acknowledgements and preface
- 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
Andreas Jaeger
parent
7bf0e5ff70
commit
6f7dcfd440
@ -15,59 +15,65 @@
|
|||||||
<acknowledgements xmlns="http://docbook.org/ns/docbook"
|
<acknowledgements xmlns="http://docbook.org/ns/docbook"
|
||||||
xmlns:xi="http://www.w3.org/2001/XInclude"
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
||||||
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
|
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
|
||||||
xml:id="acknowledgments">
|
xml:id="acknowledgments">
|
||||||
<title>Acknowledgments</title>
|
<title>Acknowledgments</title>
|
||||||
<para>The OpenStack Foundation supported the creation of this
|
<para>The OpenStack Foundation supported the creation of this book with
|
||||||
book with plane tickets to Austin, lodging (including one
|
plane tickets to Austin, lodging (including one adventurous evening
|
||||||
adventurous evening without power after a windstorm), and
|
without power after a windstorm), and delicious food. For about USD
|
||||||
delicious food. For about USD $10,000, we could
|
$10,000, we could collaborate intensively for a week in the same room at
|
||||||
collaborate intensively for a week in the same room at the
|
the Rackspace Austin office. The authors are all members of the
|
||||||
Rackspace Austin office. The authors are all members of
|
OpenStack Foundation, which you can join. Go to the <link
|
||||||
the OpenStack Foundation, which you can join. Go to the
|
xlink:href="https://www.openstack.org/join">Foundation web
|
||||||
<link
|
site</link> at <uri>http://openstack.org/join</uri>.</para>
|
||||||
xlink:href="https://www.openstack.org/join">Foundation
|
<para>We want to acknowledge our excellent host Rackers at Rackspace in
|
||||||
web site</link> at <uri>http://openstack.org/join</uri>.</para>
|
Austin:</para>
|
||||||
<para>We want to acknowledge our excellent host Rackers at
|
<itemizedlist>
|
||||||
Rackspace in Austin: <itemizedlist>
|
<listitem>
|
||||||
<listitem>
|
<para>Emma Richards of Rackspace Guest Relations took excellent care
|
||||||
<para>Emma Richards of Rackspace Guest Relations
|
of our lunch orders and even set aside a pile of sticky notes
|
||||||
took excellent care of our lunch orders and
|
that had fallen off the walls.</para>
|
||||||
even set aside a pile of sticky notes that had
|
</listitem>
|
||||||
fallen off the walls.</para>
|
<listitem>
|
||||||
</listitem>
|
<para>Betsy Hagemeier, a Fanatical Executive Assistant, took care of
|
||||||
<listitem>
|
a room reshuffle and helped us settle in for the week.</para>
|
||||||
<para>Betsy Hagemeier, a Fanatical Executive
|
</listitem>
|
||||||
Assistant, took care of a room reshuffle and
|
<listitem>
|
||||||
helped us settle in for the week.</para>
|
<para>The Real Estate team at Rackspace in Austin, also known as
|
||||||
</listitem>
|
"The Victors," were super responsive.</para>
|
||||||
<listitem>
|
</listitem>
|
||||||
<para>The Real Estate team at Rackspace in Austin,
|
<listitem>
|
||||||
also known as "The Victors," were super
|
<para>Adam Powell in Racker IT supplied us with bandwidth each day
|
||||||
responsive.</para>
|
and second monitors for those of us needing more screens.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>Adam Powell in Racker IT supplied us with
|
<para>On Wednesday night we had a fun happy hour with the Austin
|
||||||
bandwidth each day and second monitors for
|
OpenStack Meetup group and Racker Katie Schmidt took great care
|
||||||
those of us needing more screens.</para>
|
of our group.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
</itemizedlist>
|
||||||
<para>On Wednesday night we had a fun happy hour
|
<para>We also had some excellent input from outside of the room:</para>
|
||||||
with the Austin OpenStack Meetup group and
|
<itemizedlist>
|
||||||
Racker Katie Schmidt took great care of our
|
<listitem>
|
||||||
group.</para>
|
<para>Tim Bell from CERN gave us feedback on the outline before we
|
||||||
</listitem>
|
started and reviewed it mid-week.</para>
|
||||||
<listitem>
|
</listitem>
|
||||||
<para>We also had some excellent input from
|
<listitem>
|
||||||
outside of the room. Tim Bell from CERN gave
|
<para>Sébastien Han has written excellent blogs and generously gave
|
||||||
us feedback on the outline before we started
|
his permission for re-use.</para>
|
||||||
and reviewed it mid-week.</para>
|
</listitem>
|
||||||
<para>Sébastien Han has written excellent blogs
|
<listitem>
|
||||||
and generously gave his permission for re-use.</para>
|
<para>Oisin Feeley read it, made some edits, and provided emailed
|
||||||
<para>Oisin Feeley read it, made some edits, and
|
feedback right when we asked.</para>
|
||||||
provided emailed feedback right when we asked.</para>
|
</listitem>
|
||||||
</listitem>
|
</itemizedlist>
|
||||||
</itemizedlist></para>
|
<para>Inside the book sprint room with us each day was our book
|
||||||
<para>We couldn't have pulled it off without so much
|
sprint facilitator Adam Hyde. Without his tireless support and
|
||||||
supportive help and encouragement.</para>
|
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>
|
</acknowledgements>
|
||||||
<!-- STATUS: OK for Havana -->
|
|
||||||
|
|||||||
@ -45,8 +45,21 @@
|
|||||||
operating OpenStack clouds.</para>
|
operating OpenStack clouds.</para>
|
||||||
</abstract>
|
</abstract>
|
||||||
<revhistory>
|
<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>
|
<revision>
|
||||||
<!-- ... continue adding more revisions here as you change this document using the markup shown below... -->
|
|
||||||
<date>2013-05-13</date>
|
<date>2013-05-13</date>
|
||||||
<revdescription>
|
<revdescription>
|
||||||
<itemizedlist spacing="compact">
|
<itemizedlist spacing="compact">
|
||||||
@ -55,7 +68,8 @@
|
|||||||
</listitem>
|
</listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</revdescription>
|
</revdescription>
|
||||||
</revision><revision>
|
</revision>
|
||||||
|
<revision>
|
||||||
<date>2013-04-02</date>
|
<date>2013-04-02</date>
|
||||||
<revdescription>
|
<revdescription>
|
||||||
<itemizedlist spacing="compact">
|
<itemizedlist spacing="compact">
|
||||||
@ -74,8 +88,6 @@
|
|||||||
<para>Stopped chunking in HTML
|
<para>Stopped chunking in HTML
|
||||||
output.</para>
|
output.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
|
|
||||||
|
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</revdescription>
|
</revdescription>
|
||||||
</revision>
|
</revision>
|
||||||
|
|||||||
@ -64,24 +64,139 @@
|
|||||||
great flexibility, but the number of options might be bewildering at
|
great flexibility, but the number of options might be bewildering at
|
||||||
first.</para>
|
first.</para>
|
||||||
</section>
|
</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
|
<para>This guide assumes that you are familiar with the Ubuntu
|
||||||
distribution of Linux, SQL databases, and virtualization. You
|
distribution of Linux, SQL databases, and virtualization. You must
|
||||||
must be comfortable administering and configuring multiple
|
be comfortable administering and configuring multiple Linux machines
|
||||||
Linux machines for networking. You must install and maintain a
|
for networking. You must install and maintain a MySQL database, and
|
||||||
MySQL database, and occasionally run SQL queries against it.
|
occasionally run SQL queries against it.</para>
|
||||||
</para>
|
|
||||||
<para>One of the most complex aspects of an OpenStack cloud is the
|
<para>One of the most complex aspects of an OpenStack cloud is the
|
||||||
networking configuration. You should be familiar with concepts such
|
networking configuration. You should be familiar with concepts such
|
||||||
as DHCP, Linux bridges, VLANs, and iptables. You must also have
|
as DHCP, Linux bridges, VLANs, and iptables. You must also have
|
||||||
access to a network hardware expert who can configure the switches
|
access to a network hardware expert who can configure the switches
|
||||||
and routers required in your OpenStack cloud.</para>
|
and routers required in your OpenStack cloud.</para>
|
||||||
<para>This book is for those of you starting to run OpenStack
|
<para>This book is for those of you starting to run OpenStack clouds as
|
||||||
clouds as well as those of you who were handed a running one and
|
well as those of you who were handed a running one and want to keep
|
||||||
want to keep it running well. Perhaps you're on a devops team,
|
it running well. Perhaps you're on a devops team, perhaps you are a
|
||||||
perhaps you are a system administrator starting to dabble in the
|
system administrator starting to dabble in the cloud, or maybe you
|
||||||
cloud, or maybe you want to get on that OpenStack cloud team at your
|
want to get on that OpenStack cloud team at your company. This book
|
||||||
company. This book is for all of you.</para></section>
|
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">
|
<section xml:id="how-this-book-is-organized">
|
||||||
<title>How This Book Is Organized</title>
|
<title>How This Book Is Organized</title>
|
||||||
<para>This book is organized in two parts, the architecture decisions
|
<para>This book is organized in two parts, the architecture decisions
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user