From 1cff8250c64228cca52a7dd64820b030d3114db9 Mon Sep 17 00:00:00 2001 From: Pete Zaitcev Date: Thu, 5 Jan 2012 15:39:55 -0700 Subject: [PATCH] Add Fedora clauses to the installing document. This change resolves 2 Fedora-related todo items in installing.rst. It also cleans up a bit: - fixes weird grammar - fixes improper list numbering - uses proper name for Red Hat, where space is necessary - replaces A/B syntax with A, B This is my first commit and I am adding myself to Authors file on a suggestion by Brian Waldon. Change-Id: I398ae8150d7912e0b61375a7bdc5aab1101f34bc --- Authors | 1 + doc/source/installing.rst | 72 ++++++++++++++++++++++++++++++++------- 2 files changed, 60 insertions(+), 13 deletions(-) diff --git a/Authors b/Authors index 3b9e3652f3..603c9ae1ee 100644 --- a/Authors +++ b/Authors @@ -28,6 +28,7 @@ Mike Lundy Monty Taylor Pádraig Brady Paul Bourke +Pete Zaitcev Rick Clark Rick Harris Russell Bryant diff --git a/doc/source/installing.rst b/doc/source/installing.rst index 258186ed22..51f1c68ee8 100644 --- a/doc/source/installing.rst +++ b/doc/source/installing.rst @@ -21,10 +21,10 @@ Installing from packages ~~~~~~~~~~~~~~~~~~~~~~~~ To install the latest released version of Glance, -following the following instructions. +follow the following instructions. -Debian/Ubuntu -############# +Debian, Ubuntu +############## 1. Add the Glance PPA to your sources.lst:: @@ -35,10 +35,17 @@ Debian/Ubuntu $> sudo apt-get install glance -RedHat/Fedora -############# +Red Hat, Fedora +############### -.. todo:: Need some help on this one... +Only RHEL 6, Fedora 15, and newer releases have the necessary +components packaged. +On RHEL 6, enable the EPEL repository. + +Install Glance:: + + $ su - + # yum install openstack-glance Mac OSX ####### @@ -68,8 +75,8 @@ Installing from Git To install the latest version of Glance from the GitHub Git repositories, following the following instructions. -Debian/Ubuntu -############# +Debian, Ubuntu +############## 1. Install Git and build dependencies:: @@ -81,19 +88,58 @@ Debian/Ubuntu If you want to build the Glance documentation locally, you will also want to install the python-sphinx package -1. Clone Glance's trunk branch from GitHub:: +2. Clone Glance's trunk branch from GitHub:: $> git clone git://github.com/openstack/glance $> cd glance -1. Install Glance:: +3. Install Glance:: $> sudo python setup.py install -RedHat/Fedora -############# +Red Hat, Fedora +############### -.. todo:: Need some help on this one... +On Fedora, most developers and essentially all users install packages. +Instructions below are not commonly used, and even then typically in a +throw-away VM. + +Since normal build dependencies are resolved by mechanisms of RPM, +there is no one-line command to install everything needed by +the source repository in git. One common way to discover the dependencies +is to search for *BuildRequires:* in the specfile of openstack-glance +for the appropriate distro. + +In case of Fedora 16, for example, do this:: + + $ su - + # yum install git + # yum install python2-devel python-setuptools python-distutils-extra + # yum install python-webob python-eventlet python-boto + # yum install python-virtualenv + +Build Glance:: + + $ python setup.py build + +If any missing modules crop up, install them with yum, then retry the build. + +.. note:: + + If you want to build the Glance documentation, you will also want + to install the packages python-sphinx and graphviz, then run + "python setup.py build_sphinx". Due to required features of + python-sphinx 1.0 or better, documentation can only be built + on Fedora 15 or later. + +Test the build:: + + $ ./run_tests.sh -s + +Once Glance is built and tested, install it:: + + $ su - + # python setup.py install Mac OSX #######