summaryrefslogtreecommitdiffstats
path: root/doc/installation/distro
diff options
context:
space:
mode:
Diffstat (limited to 'doc/installation/distro')
-rw-r--r--doc/installation/distro/archlinux.txt17
-rw-r--r--doc/installation/distro/debian.txt24
-rw-r--r--doc/installation/distro/fedora.txt23
-rw-r--r--doc/installation/distro/gentoo.txt27
-rw-r--r--doc/installation/distro/osx.txt29
-rw-r--r--doc/installation/distro/rhel.txt31
-rw-r--r--doc/installation/distro/ubuntu.txt36
7 files changed, 187 insertions, 0 deletions
diff --git a/doc/installation/distro/archlinux.txt b/doc/installation/distro/archlinux.txt
new file mode 100644
index 000000000..75ff59c49
--- /dev/null
+++ b/doc/installation/distro/archlinux.txt
@@ -0,0 +1,17 @@
+.. -*- mode: rst -*-
+
+.. _installation-archlinux:
+
+.. _Arch Linux: http://www.archlinux.org/
+.. _AUR: http://aur.archlinux.org/packages.php?ID=20979
+
+
+ArchLinux
+=========
+
+Packages for `Arch Linux`_ are available in the Arch User Repository (AUR_).
+Just use `pacman` to perform the installation ::
+
+ pacman -S bcfg2 bcfg2-server
+
+
diff --git a/doc/installation/distro/debian.txt b/doc/installation/distro/debian.txt
new file mode 100644
index 000000000..67a4f1d9d
--- /dev/null
+++ b/doc/installation/distro/debian.txt
@@ -0,0 +1,24 @@
+.. -*- mode: rst -*-
+
+.. _debian:
+
+.. _Wiki: http://trac.mcs.anl.gov/projects/bcfg2/wiki/PrecompiledPackages#UnofficialDebianRepository
+
+Debian
+======
+
+Packages of Bcfg2 are available for Debian Lenny, Debian Squeeze, and
+Debian Sid. The fastest way to get Bcfg2 onto your Debian system
+is to use `apt-get` or `aptitude`. ::
+
+ sudo aptitude install bcfg2 bcfg2-server
+
+If you want to use unofficial packages from Bcfg2. Add the following line
+to your `/etc/apt/sources.list` file ::
+
+ deb ftp://ftp.mcs.anl.gov/pub/bcfg/debian sarge/
+
+Now just run `aptitute` in the way it is mentioned above.
+
+For more details about running prerelease version of Bcfg2 on Debian
+systems, please refer to the Wiki_.
diff --git a/doc/installation/distro/fedora.txt b/doc/installation/distro/fedora.txt
new file mode 100644
index 000000000..92771b974
--- /dev/null
+++ b/doc/installation/distro/fedora.txt
@@ -0,0 +1,23 @@
+.. -*- mode: rst -*-
+
+.. _Packages: https://admin.fedoraproject.org/pkgdb/acls/name/bcfg2
+.. _Fedora: https://www.fedoraproject.org
+
+.. _fedora-installation:
+
+Fedora
+======
+
+The fastest way to get Bcfg2 Packages_ onto your Fedora_ system is to
+use `yum` or PackageKit. Yum will pull in all dependencies of Bcfg2
+automatically. ::
+
+ $ su -c 'yum install bcfg2-server bcfg2'
+
+Be aware that the latest release of Bcfg2 may only be available for the
+Development release of Fedora (Rawhide). With the activation of the
+Rawhide repository of Fedora you will be able to install it. ::
+
+ $ su -c 'yum install --enablerepo=rawhide bcfg2-server bcfg2'
+
+This way is not recommanded on productive systems. Only for testing.
diff --git a/doc/installation/distro/gentoo.txt b/doc/installation/distro/gentoo.txt
new file mode 100644
index 000000000..5497a01b2
--- /dev/null
+++ b/doc/installation/distro/gentoo.txt
@@ -0,0 +1,27 @@
+.. -*- mode: rst -*-
+
+.. _gentoo-installation:
+
+.. _Freenode: http://chat.freenode.net
+.. _#bcfg2: irc://chat.freenode.net/bcfg2
+
+
+Gentoo
+======
+
+Early in July 2008, Bcfg2 was added to the Gentoo portage tree. So far
+it's only keyworded for ~x86, but we hope to see it soon in the amd64 and
+x64-solaris ports. If you're using Gentoo on some other architecture, it
+should still work provided that you have a reasonably up to date Python;
+try adding `app-admin/bcfg2 ~*` to your `/etc/portage/package.keywords`
+file.
+
+If you don’t use portage to install Bcfg2, you’ll want to make sure you
+have all the prerequisites installed first. For a server, you’ll need:
+
+* ``app-admin/gamin`` or ``app-admin/fam``
+* ``dev-python/lxml``
+
+Clients will need at least:
+
+* ``app-portage/gentoolkit``
diff --git a/doc/installation/distro/osx.txt b/doc/installation/distro/osx.txt
new file mode 100644
index 000000000..8b7a5a95d
--- /dev/null
+++ b/doc/installation/distro/osx.txt
@@ -0,0 +1,29 @@
+.. -*- mode: rst -*-
+
+.. _osx-installation:
+
+.. _Freenode: http://chat.freenode.net
+.. _#bcfg2: irc://chat.freenode.net/bcfg2
+
+
+OS X
+====
+
+Once macports is installed::
+
+ port install bcfg2
+
+Using native OS X python
+------------------------
+
+First, make sure you have Xcode installed as you need `packagemaker` which
+comes bundled in the Developer tools.
+
+Clone the git source::
+
+ git clone git://git.mcs.anl.gov/bcfg2.git
+
+Change to the osx directory and type make. Your new package should be located
+at bcfg2-'''$VERSION'''.pkg (where '''$VERSION''' is that which is specified
+in setup.py).
+
diff --git a/doc/installation/distro/rhel.txt b/doc/installation/distro/rhel.txt
new file mode 100644
index 000000000..49e43179f
--- /dev/null
+++ b/doc/installation/distro/rhel.txt
@@ -0,0 +1,31 @@
+.. -*- mode: rst -*-
+
+.. _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
+
+.. _rhel-installation:
+
+RHEL / Centos / Scientific Linux
+================================
+
+While you can go about building all these things from source, this
+section will try and meet the dependencies using packages from EPEL_
+[#f1]_. The *el5* and the soon available *el6* package should be compatible
+with `CentOS`_ 5.x/6.x and `Scientific Linux`_.
+
+EPEL_::
+
+ [root@centos ~]# rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm
+
+Install the bcfg2-server and bcfg2 RPMs::
+
+ [root@centos ~]# yum install bcfg2-server bcfg2
+
+.. note::
+
+ The latest package for *el5* is only available in the testing repository.
+
+.. [#f1] For more details check the EPEL_ `instructions <http://fedoraproject.org/wiki/EPEL/FAQ#howtouse>`_
diff --git a/doc/installation/distro/ubuntu.txt b/doc/installation/distro/ubuntu.txt
new file mode 100644
index 000000000..694cce865
--- /dev/null
+++ b/doc/installation/distro/ubuntu.txt
@@ -0,0 +1,36 @@
+.. -*- mode: rst -*-
+
+.. _ubuntu-installation:
+
+.. _Ubuntu: http://www.ubuntu.com
+.. _Wiki: http://trac.mcs.anl.gov/projects/bcfg2/wiki/PrecompiledPackages#UbuntuLaunchpadBcfg2PPA
+
+Ubuntu
+======
+
+The steps to bring Bcfg2 onto your Ubuntu_ system depends on your
+release.
+
+* Dapper
+ Add the following lines to `/etc/apt/sources.list` ::
+
+ deb ftp://ftp.mcs.anl.gov/pub/bcfg/ubuntu dapper/
+ deb http://archive.ubuntu.com/ubuntu dapper universe
+ deb-src http://archive.ubuntu.com/ubuntu dapper universe
+
+* Edgy
+ Add the following lines to `/etc/apt/sources.list` ::
+
+ deb ftp://ftp.mcs.anl.gov/pub/bcfg/ubuntu edgy/
+ deb http://archive.ubuntu.com/ubuntu edgy universe
+ deb-src http://archive.ubuntu.com/ubuntu edgy universe
+
+* Feisty
+ Those packages are available from the Ubuntu_ repositories.
+
+To install the packages, just lauch the following command ::
+
+ sudo aptitude install bcfg2 bcfg2-server
+
+For more details about running prerelease version of Bcfg2 on Ubuntu_
+systems, please refer to the Wiki_.