summaryrefslogtreecommitdiffstats
path: root/doc/source/installing.rst
diff options
context:
space:
mode:
authorAnne Gentle <anne.gentle@rackspace.com>2011-09-26 11:32:53 -0500
committerDolph Mathews <dolph.mathews@gmail.com>2011-09-28 13:21:32 -0500
commit6bb2ba8ddbccbd68e288cc9579ae489e415a2ff1 (patch)
tree59d8e3d56eca1eab6166d7ef6ea8e7d2eeb29066 /doc/source/installing.rst
parent908088bd7c0724438c9421364593f99117ba1033 (diff)
downloadkeystone-6bb2ba8ddbccbd68e288cc9579ae489e415a2ff1.tar.gz
keystone-6bb2ba8ddbccbd68e288cc9579ae489e415a2ff1.tar.xz
keystone-6bb2ba8ddbccbd68e288cc9579ae489e415a2ff1.zip
Adds list of dependencies to dev install
Change-Id: I96450d614209ec9e7f1c51f72805d5d7495728ff
Diffstat (limited to 'doc/source/installing.rst')
-rw-r--r--doc/source/installing.rst41
1 files changed, 29 insertions, 12 deletions
diff --git a/doc/source/installing.rst b/doc/source/installing.rst
index 86c57c5c..6de4028c 100644
--- a/doc/source/installing.rst
+++ b/doc/source/installing.rst
@@ -35,10 +35,24 @@ Debian/Ubuntu
$> sudo apt-get install keystone
+
RedHat/Fedora
#############
-.. todo:: Need some help on this one...
+On some OSes, specifically Fedora 15, the current versions of
+greenlet/eventlet segfault when running keystone. To fix this, install
+the development versions of greenlet and eventlet::
+
+ $ pip uninstall greenlet eventlet
+ $ cd <appropriate working directory>
+ $ hg clone https://bitbucket.org/ambroff/greenlet
+ $ cd greenlet
+ $ sudo python setup.py install
+
+ $ cd <appropriate working directory>
+ $ hg clone https://bitbucket.org/which_linden/eventlet
+ $ cd greenlet
+ $ sudo python setup.py install
Mac OSX
#######
@@ -51,13 +65,17 @@ Installing from source tarballs
To install the latest version of Keystone from the Launchpad Bazaar repositories,
following the following instructions.
-1. Grab the source tarball from `Github <https://github.com/openstack/keystone>`_
+#. Grab the source tarball from `Github <https://github.com/openstack/keystone>`_
-2. Untar the source tarball::
+#. Untar the source tarball::
$> tar -xzf <FILE>
-3. Change into the package directory and build/install::
+#. Install dependencies::
+
+ $> sudo apt-get install -y git python-pip gcc python-lxml libxml2 python-greenlet-dbg python-dev libsqlite3-dev libldap2-dev libssl-dev libxml2-dev libxslt1-dev libsasl2-dev
+
+#. Change into the package directory and build/install::
$> cd keystone-<RELEASE>
$> sudo python setup.py install
@@ -71,22 +89,21 @@ see the following instructions.
Debian/Ubuntu
#############
-1. Install Git and build dependencies::
+.. note::
+ If you want to build the Keystone documentation locally, you will also want
+ to install the python-sphinx package in the first step.
+
+#. Install Git and build dependencies::
$> sudo apt-get install git python-eventlet python-routes python-greenlet swift
$> sudo apt-get install python-argparse python-sqlalchemy python-wsgiref python-pastedeploy
-.. note::
-
- If you want to build the Keystone documentation locally, you will also want
- to install the python-sphinx package
-
-1. Branch Keystone's trunk branch:: (see http://wiki.openstack.org/GerritWorkflow to get the project initially setup)::
+#. Branch Keystone's trunk branch:: (see http://wiki.openstack.org/GerritWorkflow to get the project initially setup)::
$> git checkout master
$> git pull origin master
-1. Install Keystone::
+#. Install Keystone::
$> sudo python setup.py install