1 files changed, 81 insertions, 0 deletions
diff --git a/doc/installation/packages.txt b/doc/installation/packages.txt
new file mode 100644
index 000000000..a15e3e98e
--- /dev/null
+++ b/doc/installation/packages.txt
@@ -0,0 +1,81 @@
+.. -*- mode: rst -*-
+
+.. _packages:
+
+.. _CentOS: http://www.centos.org/
+.. _Red Hat/RHEL: http://www.redhat.com/rhel/
+.. _Scientific Linux: http://www.scientificlinux.org/
+.. _EPEL: http://fedoraproject.org/wiki/EPEL
+.. _RPMForge: https://rpmrepo.org/RPMforge
+
+
+Building packages from source
+=============================
+
+The Bcfg2 distribution contains two different spec files.
+
+Building from Tarball
+---------------------
+
+* Copy the tarball to `/usr/src/packages/SOURCES/`
+* Extract another copy of it somewhere else (eg: `/tmp`) and retrieve
+  the `misc/bcfg2.spec` file
+* Run ::
+
+   rpmbuild -ba bcfg2.spec
+
+* The resulting RPMs will be in `/usr/src/packages/RPMS/` and SRPMs 
+  in `/usr/src/packages/SRPMS`
+
+Building from an GIT Checkout
+-----------------------------
+
+* Change to the `redhat/` directory in the working copy
+* Run ::
+
+    make
+
+* The resulting RPMs will be in `/usr/src/redhat/RPMS/ `and SRPMs 
+  in `/usr/src/redhat/SRPMS` and will have the SVN revision appended 
+
+Building RPM packages with ``rpmbuild``
+---------------------------------------
+
+While you can go about building all these things from source, this
+how to will try and meet the dependencies using packages from EPEL_.
+The *el5* package should be compatible with CentOS 5.x.
+
+* Installation of the EPEL_ repository package ::
+
+   [root@centos ~]# rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm
+
+* Now you can install the rest of the prerequisites ::
+
+   [root@centos ~]# yum install python-genshi python-cheetah python-lxml
+
+* After installing git, check out the master branch ::
+
+   [root@centos redhat]# git clone git://git.mcs.anl.gov/bcfg2.git
+
+* Install the ``fedora-packager`` package ::
+
+   [root@centos ~]# yum install fedora-packager
+
+* A directory structure for the RPM build process has to be established. ::
+
+   [you@centos ~]$ rpmdev-setuptree
+
+* Change to the *redhat* directory of the checked out Bcfg2 source::
+
+   [you@centos ~]$ cd bcfg2/redhat/
+
+* In the particular directory is a ``Makefile`` which will do the job of 
+  building the RPM packages. You can do this as root, but it's not
+  recommanded ::
+
+   [you@centos redhat]$ make
+
+* Now the new RPM package can be installed. Please adjust the path to
+  your RPM package ::
+
+   [root@centos ~]# rpm -ihv /home/YOU/rpmbuild/RPMS/noarch/bcfg2-server-1.0.0-0.2r5835.noarch.rpm