diff options
Diffstat (limited to 'doc/unsorted/install.txt')
-rw-r--r-- | doc/unsorted/install.txt | 47 |
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 |