summaryrefslogtreecommitdiffstats
path: root/doc/unsorted/install.txt
diff options
context:
space:
mode:
Diffstat (limited to 'doc/unsorted/install.txt')
-rw-r--r--doc/unsorted/install.txt47
1 files changed, 47 insertions, 0 deletions
diff --git a/doc/unsorted/install.txt b/doc/unsorted/install.txt
new file mode 100644
index 000000000..56a4b9ebf
--- /dev/null
+++ b/doc/unsorted/install.txt
@@ -0,0 +1,47 @@
+.. -*- mode: rst -*-
+
+.. _unsorted-install:
+
+============
+Installation
+============
+
+Prerequisites
+=============
+
+First, install the prerequisite libraries. See the [wiki:Prereqs] page for more information.
+
+Bcfg2
+=====
+
+Before installing, you will need to choose a machine to be the Bcfg2 server. We recommend a Linux-based machine for this purpose, but the server will work on any supported operating system. Note that you may eventually want to run a web server on this machine for reporting and serving up package repositories.
+
+* '''From packages:''' The easiest way to install Bcfg2 is from packages for your operating system. You can grab packages (and source packages) for various OSes from the [wiki:Download] page. Install them as you would any other packages. The server package only needs to be installed on your designated Bcfg2 server machine; the clients package needs to be installed on any machine you plan to manage by Bcfg2.
+* '''From source:''' The Bcfg2 source tarball can also be grabbed from the [wiki:Download] page. After untarring the file, you can build Bcfg2 with {{{python setup.py install --prefix=/install/prefix}}} This will install both the client and server on that machine.
+
+Configuration
+=============
+
+Once Bcfg2 is installed, head over to the [wiki:QuickStart] to get it configured and up-and-running.
+
+
+OS X
+====
+
+Using native OS X python
+------------------------
+
+First, make sure you have Xcode installed as you need `packagemaker` which comes bundled in the Developer tools.
+
+Check out the source from subversion::
+
+ svn co https://svn.mcs.anl.gov/repos/bcfg/trunk/bcfg2
+
+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).
+
+Using macports
+--------------
+
+Once macports is installed::
+
+ port install bcfg2