Chapter 1. Installing and Using farbot

Table of Contents

Installation
Prerequisites
Installing with the Python Distutils
Configuring farbot
Introduction
Releases Configuration
Partitions Configuration
PackageSets Configuration
Installations Configuration
Example Configuration File
Configuring the Installation Host
NFS
DHCP
TFTP
Running farbot
Build all defined releases and packages, and setup the installation root
Rebuild just the installation configuration, using already built releases and packages

Installation

Prerequisites

farbot depends on the following components:

  • Python 2.4

  • Zconfig

  • FreeBSD is required to actually build installations. If you wish to build one or more releases from source rather than using a binary release from an ISO image, the system running farbot must have full sources installed in /usr/src, and /usr/obj must be populated from a "make buildworld" run on sources matching the currently running kernel.

Installing with the Python Distutils

farbot uses the standard Python distutils. To install, simply run setup.py:

./setup.py install

The farbot library will be installed in the Python site-packages directory. The farbot command line tool will be installed in the Python-specified bin directory. An example configuration file, farbot.conf, is supplied with the source distribution.

Farbot also includes some tests. These can be run before installing if desired with

./runtests.py