<html lang="en">
<head>
<title>Installing the code - BuildBot Manual - 0.8.4p1</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="BuildBot Manual - 0.8.4p1">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Installation.html#Installation" title="Installation">
<link rel="prev" href="Requirements.html#Requirements" title="Requirements">
<link rel="next" href="Running-Buildbot_0027s-Tests-_0028optional_0029.html#Running-Buildbot_0027s-Tests-_0028optional_0029" title="Running Buildbot's Tests (optional)">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
This is the BuildBot manual for Buildbot version 0.8.4p1.
Copyright (C) 2005, 2006, 2009, 2010 Brian Warner
Copying and distribution of this file, with or without
modification, are permitted in any medium without royalty
provided the copyright notice and this notice are preserved.-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
<a name="Installing-the-code"></a>
<p>
Next: <a rel="next" accesskey="n" href="Running-Buildbot_0027s-Tests-_0028optional_0029.html#Running-Buildbot_0027s-Tests-_0028optional_0029">Running Buildbot's Tests (optional)</a>,
Previous: <a rel="previous" accesskey="p" href="Requirements.html#Requirements">Requirements</a>,
Up: <a rel="up" accesskey="u" href="Installation.html#Installation">Installation</a>
<hr>
</div>
<h3 class="section">2.3 Installing the code</h3>
<h3 class="heading">The Distribution Packages</h3>
<p><a name="index-Packages-3"></a><a name="index-Installation-4"></a><a name="index-PyPI-5"></a>
Buildbot comes in two parts: <code>buildbot</code> (the master) and
<code>buildbot-slave</code> (the slave). The two can be installed individually or
together.
<h3 class="heading">Installation From PyPI</h3>
<p>The easiest way to install Buildbot is using 'pip'. For the master:
<pre class="example"> pip install buildbot
</pre>
<p>and for the slave:
<pre class="example"> pip install buildbot-slave
</pre>
<h3 class="heading">Installation From Tarballs</h3>
<p>Buildbot and Buildslave can also be installed using the standard python
<code>distutils</code> process. For either component (buildbot or buildbot-slave),
after unpacking the tarball, the process is:
<pre class="example"> python setup.py build
python setup.py install
</pre>
<p>where the install step may need to be done as root. This will put the bulk of
the code in somewhere like <code>/usr/lib/python2.3/site-packages/buildbot</code>. It
will also install the <code>buildbot</code> command-line tool in
<code>/usr/bin/buildbot</code>.
<p>If the environment variable <code>$NO_INSTALL_REQS</code> is set to '1', then
<code>setup.py</code> will not try to install Buildbot's requirements. This is
usually only useful when building a Buildbot package.
<p>To test this, shift to a different directory (like <code>/tmp</code>), and run:
<pre class="example"> buildbot --version
# or
buildslave --version
</pre>
<p>If it shows you the versions of Buildbot and Twisted, the install went
ok. If it says <code>no such command</code> or it gets an <code>ImportError</code>
when it tries to load the libaries, then something went wrong.
<code>pydoc buildbot</code> is another useful diagnostic tool.
<p>Windows users will find these files in other places. You will need to
make sure that python can find the libraries, and will probably find
it convenient to have <code>buildbot</code> on your PATH.
</body></html>
