From 7233ed2e35e3829b05a6b229af9d3a243da744fb Mon Sep 17 00:00:00 2001 From: Anne Gentle Date: Wed, 20 Oct 2010 17:06:51 -0500 Subject: [PATCH] Made updates based on review comments. --- doc/source/getting.started.rst | 22 ++++++++++------------ doc/source/index.rst | 11 ++++++----- 2 files changed, 16 insertions(+), 17 deletions(-) diff --git a/doc/source/getting.started.rst b/doc/source/getting.started.rst index 4610a9a5ae1a..2df4a45ea51a 100644 --- a/doc/source/getting.started.rst +++ b/doc/source/getting.started.rst @@ -26,22 +26,22 @@ Dependencies Related servers we rely on * RabbitMQ: messaging queue, used for all communication between components -* OpenLDAP: users, groups Optional servers -* ReDIS: Remote Dictionary Store (for fast, shared state data) -* nginx: HTTP server to handle serving large files +* OpenLDAP: By default, the auth server uses the RDBMS-backed datastore by setting FLAGS.auth_driver to 'nova.auth.dbdriver.DbDriver'. But OpenLDAP (or LDAP) could be configured. +* ReDIS: By default, this is not enabled as the auth driver. Python libraries we don't vendor * M2Crypto: python library interface for openssl * curl -* XenAPI: Needed only for Xen Cloud Platform or XenServer support. Available from http://wiki.xensource.com/xenwiki/XCP_SDK or http://community.citrix.com/cdn/xs/sdks. +* XenAPI: Needed only for Xen Cloud Platform or XenServer support. Available from http://wiki.xensource.com/xenwiki/XCP_SDK or http://community.citrix.com/cdn/xs/sdks. Vendored python libaries (don't require any installation) * Twisted: just for the twisted.internet.defer package +* Tornado: scalable non blocking web server for api requests * boto: python api for aws api * IPy: library for managing ip addresses @@ -54,19 +54,19 @@ Recommended Installation -------------- -:: - Due to many changes it's best to rely on the 'OpenStack wiki ' for installation instructions. + Due to many changes it's best to rely on the `OpenStack wiki `_ for installation instructions. Configuration --------------- -These instructions are incomplete, but we are actively updating the 'OpenStack wiki ' with more configuration information. +These instructions are incomplete, but we are actively updating the `OpenStack wiki `_ with more configuration information. On the cloud controller * Add yourself to the libvirtd group, log out, and log back in -* fix hardcoded ec2 metadata/userdata uri ($IP is the IP of the cloud), and masqurade all traffic from launched instances +* Fix hardcoded ec2 metadata/userdata uri ($IP is the IP of the cloud), and masqurade all traffic from launched instances + :: iptables -t nat -A PREROUTING -s 0.0.0.0/0 -d 169.254.169.254/32 -p tcp -m tcp --dport 80 -j DNAT --to-destination $IP:8773 @@ -94,9 +94,9 @@ On the cloud controller } } -ON VOLUME NODE +On the volume node -* create a filesystem (you can use an actual disk if you have one spare, default is /dev/sdb) +* Create a filesystem (you can use an actual disk if you have one spare, default is /dev/sdb) :: @@ -113,8 +113,6 @@ Launch servers * rabbitmq * redis (optional) -* slapd -* nginx Launch nova components diff --git a/doc/source/index.rst b/doc/source/index.rst index 56f2e6b88a24..1109e9011830 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -22,11 +22,12 @@ Nova is a cloud computing fabric controller (the main part of an IaaS system). It is written in Python and relies on the standard AMQP messaging protocol, uses the Twisted framework, and optionally uses the Redis distributed key value store for authorization. -Nova is intended to be easy to extend and adapt. For example, it currently uses -an LDAP server for users and groups, but also includes a fake LDAP server, -that stores data in Redis. It has extensive test coverage, and uses the -Sphinx toolkit (the same as Python itself) for code and developer documentation. -Additional documentation is available on the +Nova is intended to be easy to extend and adapt. For example, authentication and authorization +requests by default use an RDBMS-backed datastore driver. However, there is already support +for using LDAP backing authentication (slapd) and if you wish to "fake" LDAP, there is a module +available that uses ReDIS to store authentication information in an LDAP-like backing datastore. +It has extensive test coverage, and uses the Sphinx toolkit (the same as Python itself) for code +and developer documentation. Additional documentation is available on the 'OpenStack wiki '_. While Nova is currently in Beta use within several organizations, the codebase is very much under active development - please test it and log bugs!