Edgewall Software

Changes between Version 2 and Version 3 of Bitten Install


Ignore:
Timestamp:
Sep 26, 2005, 11:44:23 AM (19 years ago)
Author:
cmlenz
Comment:

Synced with INSTALL file

Legend:

Unmodified
Added
Removed
Modified
  • Bitten Install

    v2 v3  
    99 * The web interface, which is implemented as an add-on to [http://trac.edgewall.com/ Trac] and provides a build management interface as well as presentation of build results.
    1010
    11 Both the build master and the web interface depend on Trac 0.9 beta 1, and need to be installed on the same machine, together with the [http://subversion.tigris.org/ Subversion] repository. The build slave only requires [http://www.python.org/ Python] (>= 2.3) as well as the tools required by the build process itself. A build slave may be run on any machine that can connect to the server running the Bitten build master.
     11Both the build master and the web interface depend on Trac 0.9 beta 2, and need to be installed on the same machine, together with the [http://subversion.tigris.org/ Subversion] repository. The build slave only requires [http://www.python.org/ Python] (>= 2.3) and [http://peak.telecommunity.com/DevCenter/setuptools setuptools], as well as the tools required by the build process itself. A build slave may be run on any machine that can connect to the server running the Bitten build master.
    1212
    1313
    1414== Installation ==
    1515
    16 Bitten is written in Python, so make sure that you have Python installed. You'll need Python 2.3 or later. Also, make sure that [http://peak.telecommunity.com/DevCenter/setuptools setuptools] is installed.
     16Bitten is written in Python, so make sure that you have Python installed. You'll need Python 2.3 or later. Also, make sure that [http://peak.telecommunity.com/DevCenter/setuptools setuptools] (version 0.6a2 or later) is installed.
    1717
    1818If that's taken care of, you just need to download and unpack the Bitten distribution, and execute the command:
     
    3030What's left to do now depends on whether you want to use the build master and web interface, or just the build slave. In the latter case, you're already done. You might need to install software that the build of your project requires, but the Bitten build slave itself doesn't require anything extra.
    3131
    32 For the build master and web interface, you'll need to install [http://trac.edgewall.com/ Trac] 0.9 beta 1 and [http://www.sleepycat.com/products/xml.shtml Berkeley DB XML] >= 2.1.x, as well as their respective dependencies. Please refer to the documentation of those projects for information how they are installed.
     32For the build master and web interface, you'll also need to install [http://trac.edgewall.com/ Trac] 0.9 beta 1 and its dependencies. Please refer to the [http://projects.edgewall.com/trac/wiki/TracInstall Trac documentation] for information on how it is installed.
    3333
    3434
    3535== Build Master Configuration ==
    3636
    37 Once Bitten, Trac and BDB XML are installed and working, you'll have to introduce Bitten to your Trac project environment. If you don't have a  Trac project set up yet, you'll need to do so in order to use Bitten.
     37Once Bitten and Trac are installed and working, you'll have to introduce Bitten to your Trac project environment. If you don't have a  Trac project set up yet, you'll need to do so in order to use Bitten.
    3838
    3939If you already have a Trac project environment, the Trac web interface will inform you with an error message that the environment needs to be upgraded. To do this, run:
     
    5353== Running the Build Master ==
    5454
    55 At this point, you're ready to start the Bitten build master. The installation of Bitten should have put a `bitten-master` script on your path. If the script is not on your path, look for it in the `bin` or `scripts` subdirectory of your Python installation.
     55At this point, you're ready to start the Bitten build master. The installation of Bitten should have put a `bitten-master` executable on your path. If the script is not on your path, look for it in the `bin` or `scripts` subdirectory of your Python installation.
    5656
    57 To find out about the options and arguments of the script, execute it with the `--help` option as follows:
     57To find out about the options and arguments of the build master, execute it with the `--help` option as follows:
    5858{{{
    5959  $ bitten-master --help
     
    6767== Running the Build Slave ==
    6868
    69 The build slave can be run on any machine that can connect to the machine
    70 on which the build master is running. Just as with the build master script,
    71 you should find the build slave script on your path after the installation.
    72 The build slave script is called `bitten-slave`.
     69The build slave can be run on any machine that can connect to the machine on which the build master is running. Just as with the build master, you should find the build slave executable on your path after the installation. The executable file is called `bitten-slave`.
    7370
    74 To get a list of options for the build slave, execute it with the `--help`
    75 option:
     71To get a list of options for the build slave, execute it with the `--help` option:
    7672{{{
    7773  $ bitten-slave --help
    7874}}}
    7975
    80 To run the build slave against a slave installed on myproject.example.org,
    81 you'd run:
     76To run the build slave against a slave installed on myproject.example.org, you'd run:
    8277{{{
    8378  $ bitten-slave myproject.example.org