merging in changes from ~anso/nova/trunkdoc

6 files changed, 225 insertions, 20 deletions

diff --git a/doc/source/_static/tweaks.css b/doc/source/_static/tweaks.css
index b21c7a644..1a18dbac6 100644
--- a/doc/source/_static/tweaks.css
+++ b/doc/source/_static/tweaks.css
@@ -27,12 +27,12 @@ ul.todo_list li {
 }
 
 div.admonition {
-    border: 1px solid #E2ECEF;
+    border: 1px solid #8F1000;
 }
 
 div.admonition p.admonition-title {
-    background-color: #E2ECEF;
-    border-bottom: 1px solid #E2ECEF;
+    background-color: #8F1000;
+    border-bottom: 1px solid #8E8E8E;
 }
 
 a {
diff --git a/doc/source/adminguide/distros/others.rst b/doc/source/adminguide/distros/others.rst
index 9f678aec1..818f4dbce 100644
--- a/doc/source/adminguide/distros/others.rst
+++ b/doc/source/adminguide/distros/others.rst
@@ -1 +1,88 @@
-.. todo::
+Installation (Other distros like Debian, Fedora or CentOS )
+===========================================================
+
+Feel free to add additional notes for additional distributions.
+
+Nova installation on CentOS 5.5
+-------------------------------
+
+These are notes for installing OpenStack Compute on CentOS 5.5 and will be updated but are NOT final. Please test for accuracy and edit as you see fit.
+
+The principle botleneck for running nova on centos in python 2.6. Nova is written in python 2.6 and CentOS 5.5. comes with python 2.4. We can not update python system wide as some core utilities (like yum) is dependent on python 2.4. Also very few python 2.6 modules are available in centos/epel repos.
+
+Pre-reqs
+--------
+
+Add euca2ools and EPEL repo first.::
+
+    cat >/etc/yum.repos.d/euca2ools.repo << EUCA_REPO_CONF_EOF
+    [eucalyptus]
+    name=euca2ools
+    baseurl=http://www.eucalyptussoftware.com/downloads/repo/euca2ools/1.3.1/yum/centos/
+    enabled=1
+    gpgcheck=0
+
+    EUCA_REPO_CONF_EOF
+
+::
+
+    rpm -Uvh 'http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm'
+
+Now install python2.6, kvm and few other libraries through yum::
+
+    yum -y  install dnsmasq  vblade kpartx kvm gawk iptables ebtables  bzr screen euca2ools  curl rabbitmq-server gcc gcc-c++ autoconf automake swig  openldap openldap-servers nginx  python26 python26-devel python26-distribute git openssl-devel  python26-tools mysql-server qemu kmod-kvm libxml2 libxslt libxslt-devel mysql-devel
+
+Then download the latest aoetools and then build(and install) it, check for the latest version on sourceforge, exact url will change if theres a new release::
+
+    wget -c http://sourceforge.net/projects/aoetools/files/aoetools/32/aoetools-32.tar.gz/download
+    tar -zxvf aoetools-32.tar.gz
+    cd aoetools-32
+    make
+    make install
+
+Add the udev rules for aoetools::
+
+    cat > /etc/udev/rules.d/60-aoe.rules << AOE_RULES_EOF
+    SUBSYSTEM=="aoe", KERNEL=="discover",    NAME="etherd/%k", GROUP="disk", MODE="0220"
+    SUBSYSTEM=="aoe", KERNEL=="err",    NAME="etherd/%k", GROUP="disk", MODE="0440"
+    SUBSYSTEM=="aoe", KERNEL=="interfaces",    NAME="etherd/%k", GROUP="disk", MODE="0220"
+    SUBSYSTEM=="aoe", KERNEL=="revalidate",    NAME="etherd/%k", GROUP="disk", MODE="0220"
+    # aoe block devices
+    KERNEL=="etherd*",       NAME="%k", GROUP="disk"
+    AOE_RULES_EOF
+
+Load the kernel modules::
+
+    modprobe aoe
+
+::
+
+    modprobe kvm
+
+Now, install the python modules using easy_install-2.6, this ensures the installation are done against python 2.6
+
+
+easy_install-2.6     twisted sqlalchemy mox greenlet carrot daemon eventlet tornado IPy  routes  lxml MySQL-python
+python-gflags need to be downloaded and installed manually, use these commands (check the exact url for newer releases ):
+
+::
+
+    wget -c "http://python-gflags.googlecode.com/files/python-gflags-1.4.tar.gz"
+    tar -zxvf python-gflags-1.4.tar.gz
+    cd python-gflags-1.4
+    python2.6 setup.py install
+    cd ..
+
+Same for python2.6-libxml2 module, notice the --with-python and --prefix flags. --with-python ensures we are building it against python2.6 (otherwise it will build against python2.4, which is default)::
+
+    wget -c "ftp://xmlsoft.org/libxml2/libxml2-2.7.3.tar.gz"
+    tar -zxvf libxml2-2.7.3.tar.gz
+    cd libxml2-2.7.3
+    ./configure --with-python=/usr/bin/python26 --prefix=/usr
+    make all
+    make install
+    cd python
+    python2.6 setup.py install
+    cd ..
+
+Once you've done this, continue at Step 3 here: :doc:`../single.node.install`
diff --git a/doc/source/adminguide/distros/ubuntu.10.04.rst b/doc/source/adminguide/distros/ubuntu.10.04.rst
index 28cc09173..bdd9481d6 100644
--- a/doc/source/adminguide/distros/ubuntu.10.04.rst
+++ b/doc/source/adminguide/distros/ubuntu.10.04.rst
@@ -35,4 +35,4 @@ If you're running on Ubuntu 10.04, you'll need to install Twisted and python-gfl
     sudo apt-get update && sudo apt-get install python-gflags
 
 
-Once you've done this, continue here: :doc:`../single.node.install`
+Once you've done this, continue at Step 3 here: :doc:`../single.node.install`
diff --git a/doc/source/adminguide/distros/ubuntu.10.10.rst b/doc/source/adminguide/distros/ubuntu.10.10.rst
index 48cdce852..820c2be76 100644
--- a/doc/source/adminguide/distros/ubuntu.10.10.rst
+++ b/doc/source/adminguide/distros/ubuntu.10.10.rst
@@ -1 +1,41 @@
-placeholder
+Installing on Ubuntu Maverick 10.10
+====================================
+Single Machine Installation (Ubuntu 10.10)
+
+While we wouldn't expect you to put OpenStack Compute into production on a non-LTS version of Ubuntu, these instructions are up-to-date with the latest version of Ubuntu.
+
+Make sure you are running Ubuntu 10.10 so that the packages will be available. This install requires more than 70 MB of free disk space.
+
+These instructions are based on Soren Hansen's blog entry, Openstack on Maverick. A script is in progress as well.
+
+Step 1: Install required prerequisites
+--------------------------------------
+Nova requires rabbitmq for messaging and redis for storing state (for now), so we'll install these first.::
+
+    sudo apt-get install rabbitmq-server redis-server
+
+You'll see messages starting with "Reading package lists... Done" and you must confirm by typing Y that you want to continue.
+
+Step 2: Install Nova packages available in Maverick Meerkat
+-----------------------------------------------------------
+Type or copy/paste in the following line to get the packages that you use to run OpenStack Compute.::
+
+    sudo apt-get install python-nova
+    sudo apt-get install nova-api nova-objectstore nova-compute nova-scheduler nova-network euca2ools unzip
+
+You'll see messages starting with "Reading package lists... Done" and you must confirm by typing Y that you want to continue. This operation may take a while as many dependent packages will be installed. Note: there is a dependency problem with python-nova which can be worked around by installing first.
+
+When the installation is complete, you'll see the following lines confirming:::
+
+    Adding system user `nova' (UID 106) ...
+    Adding new user `nova' (UID 106) with group `nogroup' ...
+    Not creating home directory `/var/lib/nova'.
+    Setting up nova-scheduler (0.9.1~bzr331-0ubuntu2) ...
+     * Starting nova scheduler nova-scheduler
+    WARNING:root:Starting scheduler node
+       ...done.
+    Processing triggers for libc-bin ...
+    ldconfig deferred processing now taking place
+    Processing triggers for python-support ...
+
+Once you've done this, continue at Step 3 here: :doc:`../single.node.install`
diff --git a/doc/source/adminguide/managingsecurity.rst b/doc/source/adminguide/managingsecurity.rst
new file mode 100644
index 000000000..3b11b181a
--- /dev/null
+++ b/doc/source/adminguide/managingsecurity.rst
@@ -0,0 +1,39 @@
+..
+      Copyright 2010 United States Government as represented by the
+      Administrator of the National Aeronautics and Space Administration. 
+      All Rights Reserved.
+
+      Licensed under the Apache License, Version 2.0 (the "License"); you may
+      not use this file except in compliance with the License. You may obtain
+      a copy of the License at
+
+          http://www.apache.org/licenses/LICENSE-2.0
+
+      Unless required by applicable law or agreed to in writing, software
+      distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+      WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+      License for the specific language governing permissions and limitations
+      under the License.
+
+Security Considerations
+=======================
+
+.. todo:: This doc is vague and just high-level right now. Describe architecture that enables security.
+
+The goal of securing a cloud computing system involves both protecting the instances, data on the instances, and
+ensuring users are authenticated for actions and that borders are understood by the users and the system.
+Protecting the system from intrusion or attack involves authentication, network protections,  and
+compromise detection. 
+
+Key Concepts
+------------
+
+Authentication - Each instance is authenticated with a key pair. 
+
+Network - Instances can communicate with each other but you can configure the boundaries through firewall
+configuration. 
+
+Monitoring - Log all API commands and audit those logs. 
+
+Encryption - Data transfer between instances is not encrypted. 
+
diff --git a/doc/source/cloud101.rst b/doc/source/cloud101.rst
index 075159702..87db5af1e 100644
--- a/doc/source/cloud101.rst
+++ b/doc/source/cloud101.rst
@@ -18,29 +18,68 @@
 Cloud Computing 101
 ===================
 
-.. todo:: add in a brief tour of cloud computing concepts
+Originally the term cloud came from a diagram that contained a cloud-like shape to contain the 
+services that afforded computing power that was harnessed to get work done. Much like the electrical 
+power we receive each day, cloud computing is a model for enabling access to a shared collection of
+computing resources - networks for transfer, servers for storage, and applications or services for 
+completing work. 
 
+Why Cloud?
+----------
+Like humans supposedly only use 10% of their brain power, many of the computers in place in data 
+centers today are underutilized in computing power and networking bandwidth. People also may need a large 
+amount of computing capacity to complete a computation for example, but don't need the computing power
+once the computation is done. You want cloud computing when you want a service that's available 
+on-demand with the flexibility to bring it up or down through automation or with little intervention.
 
-Overview of Cloud Computing
-===========================
+Attributes of a Cloud
+---------------------
+On-demand self-service - A cloud should enable self-service, so that users can provision servers and networks with little 
+human intervention. 
 
+Network access - Any computing capabilities are available over the network and you can use many different
+devices through standardized mechanisms. 
 
-Why Cloud?
-==========
+Resource pooling - Clouds can serve multiple consumers according to demand. 
 
+Elasticity - Provisioning is rapid and scales out or in based on need. 
 
-Attributes of a Cloud
-=====================
+Metered or measured service - Just like utilities that are paid for by the hour, clouds should optimize
+resource use and control it for the level of service or type of servers such as storage or processing.
 
 Types of Cloud Services
+-----------------------
 
+Cloud computing offers different service models depending on the capabilities a consumer may require. 
+The US-based National Institute of Standards and Technology offers definitions for cloud computing
+and the service models that are emerging. 
 
-Work in the Clouds
-==================
-What people have done/sample projects
+SaaS - Software as a Service
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Provides the consumer the ability to use the software in a cloud environment, such as web-based email for example. 
+
+PaaS - Platform as a Service
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+Provides the consumer the ability to deploy applications through a programming language or tools supported
+by the cloud platform provider. An example of platform as a service is an Eclipse/Java programming
+platform provided with no downloads required.
+
+IaaS - Infrastructure as a Service
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Provides infrastructure such as computer instances, network connections, and storage so that people 
+can run any software or operating system.
+
+.. todo:: Use definitions from http://csrc.nist.gov/groups/SNS/cloud-computing/ and attribute NIST
+
+Types of Cloud Deployments
+--------------------------
+.. todo:: describe public/private/hybrid/etc
+
+
+Work in the Clouds
+------------------
 
-Types of Clouds 
-===============
-public/private/hybrid/etc
-Use definitions from http://csrc.nist.gov/groups/SNS/cloud-computing/
\ No newline at end of file
+.. todo:: What people have done/sample projects