Installation

TracNav

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. 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.

Prerequisites

First, install the prerequisite libraries. See the Prerequisites? page for more information.

Distribution provided packages

The easiest way to install Bcfg2 is to use the Package Management Tool of your distribution. This way all needed dependencies are solved automatically. Often the Bcfg2 server package is named bcfg2-server and the client package just bcfg2.

From packages

If there are no packages for your distribution available or you want to run the latest version of bcfg2. You can grab packages (and source packages) for various OSes from the Precompiled Packages page. Install them as you would any other packages.

From source

The Bcfg2 source tarball can also be grabbed from the 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.

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

Configuration

Once Bcfg2 is installed, head over to the QuickStart? to get it configured and up-and-running.