From 6f7dcfd440b40d5e9084d32a049573dbc34eca68 Mon Sep 17 00:00:00 2001 From: annegentle Date: Thu, 12 Dec 2013 16:43:50 -0600 Subject: [PATCH] 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 --- doc/openstack-ops/acknowledgements.xml | 114 ++++++++++---------- doc/openstack-ops/bk_ops_guide.xml | 20 +++- doc/openstack-ops/preface_ops.xml | 139 ++++++++++++++++++++++--- 3 files changed, 203 insertions(+), 70 deletions(-) diff --git a/doc/openstack-ops/acknowledgements.xml b/doc/openstack-ops/acknowledgements.xml index 60561a11..7caacb28 100644 --- a/doc/openstack-ops/acknowledgements.xml +++ b/doc/openstack-ops/acknowledgements.xml @@ -15,59 +15,65 @@ + xml:id="acknowledgments"> Acknowledgments - 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 - Foundation - web site at http://openstack.org/join. - We want to acknowledge our excellent host Rackers at - Rackspace in Austin: - - 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. - - - Betsy Hagemeier, a Fanatical Executive - Assistant, took care of a room reshuffle and - helped us settle in for the week. - - - The Real Estate team at Rackspace in Austin, - also known as "The Victors," were super - responsive. - - - Adam Powell in Racker IT supplied us with - bandwidth each day and second monitors for - those of us needing more screens. - - - 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. - - - 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. - Sébastien Han has written excellent blogs - and generously gave his permission for re-use. - Oisin Feeley read it, made some edits, and - provided emailed feedback right when we asked. - - - We couldn't have pulled it off without so much - supportive help and encouragement. + 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 Foundation web + site at http://openstack.org/join. + We want to acknowledge our excellent host Rackers at Rackspace in + Austin: + + + 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. + + + Betsy Hagemeier, a Fanatical Executive Assistant, took care of + a room reshuffle and helped us settle in for the week. + + + The Real Estate team at Rackspace in Austin, also known as + "The Victors," were super responsive. + + + Adam Powell in Racker IT supplied us with bandwidth each day + and second monitors for those of us needing more screens. + + + 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. + + + 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. + + + Sébastien Han has written excellent blogs and generously gave + his permission for re-use. + + + Oisin Feeley read it, made some edits, and provided emailed + feedback right when we asked. + + + 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 www.booksprints.net. + We couldn't have pulled it off without so much supportive help and + encouragement. - diff --git a/doc/openstack-ops/bk_ops_guide.xml b/doc/openstack-ops/bk_ops_guide.xml index 1ccbb098..1da0de2b 100644 --- a/doc/openstack-ops/bk_ops_guide.xml +++ b/doc/openstack-ops/bk_ops_guide.xml @@ -45,8 +45,21 @@ operating OpenStack clouds. + + + 2013-12-12 + + + + Additions to acknowledgements and preface to + situate this guide relative to other OpenStack + guides. + + + + - 2013-05-13 @@ -55,7 +68,8 @@ - + + 2013-04-02 @@ -74,8 +88,6 @@ Stopped chunking in HTML output. - - diff --git a/doc/openstack-ops/preface_ops.xml b/doc/openstack-ops/preface_ops.xml index 2b44eb07..c9fe5aee 100644 --- a/doc/openstack-ops/preface_ops.xml +++ b/doc/openstack-ops/preface_ops.xml @@ -64,24 +64,139 @@ great flexibility, but the number of options might be bewildering at first. -
Who This Book Is For +
+ Who This Book Is For 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. - + 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. 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. - 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.
+ 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. + There are other books on the OpenStack documentation web site at + docs.openstack.org that can help you get the job + done. + + OpenStack Guides + + OpenStack Installation Guides + + Describe a manual install process, as in, by hand, no + automation, for multiple distributions based on packaging + system: + + + Installation Guide for Debian 7.0 + + + + Installation Guide for openSUSE and SUSE + Linux Enterprise Server + + + + Installation Guide for Red Hat Enterprise + Linux, CentOS, and Fedora + + + Installation Guide for Ubuntu 12.04 (LTS) + Server + + + + + + OpenStack Configuration Reference + + + Contains a reference listing of all configuration + options for core and integrated OpenStack services by + release version. + + + + OpenStack Cloud Administrator Guide + + Contains how-to information for managing an OpenStack + cloud as needed for your use cases, such as storage, + computing, or software-defined-networking. + + + + OpenStack High Availability Guide + + + Describes potential strategies for making your + OpenStack services and related controllers and data + stores highly available. + + + + OpenStack Security Guide + + Provide best practices and conceptual information + about securing an OpenStack cloud. + + + + Virtual Machine Image Guide + + Shows you how to obtain, create, and modify virtual + machine images that are compatible with + OpenStack. + + + + OpenStack End User Guide + + Shows OpenStack end users how to create and manage + resources in an OpenStack cloud with the OpenStack + dashboard and OpenStack client commands. + + + + OpenStack Admin User Guide + + Shows OpenStack administrators how to create and + manage resources in an OpenStack cloud with the + OpenStack dashboard and OpenStack client + commands. + + + + OpenStack API Quick Start + + A brief overview of how to send REST API requests to + endpoints for OpenStack services. + + + +
How This Book Is Organized This book is organized in two parts, the architecture decisions