<html lang="en">
<head>
<title>Setting the PB Port for Slaves - 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="Global-Configuration.html#Global-Configuration" title="Global Configuration">
<link rel="prev" href="Prioritizing-Builders.html#Prioritizing-Builders" title="Prioritizing Builders">
<link rel="next" href="Defining-Global-Properties.html#Defining-Global-Properties" title="Defining Global Properties">
<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="Setting-the-PB-Port-for-Slaves"></a>
<p>
Next: <a rel="next" accesskey="n" href="Defining-Global-Properties.html#Defining-Global-Properties">Defining Global Properties</a>,
Previous: <a rel="previous" accesskey="p" href="Prioritizing-Builders.html#Prioritizing-Builders">Prioritizing Builders</a>,
Up: <a rel="up" accesskey="u" href="Global-Configuration.html#Global-Configuration">Global Configuration</a>
<hr>
</div>
<h4 class="subsection">4.6.8 Setting the PB Port for Slaves</h4>
<p><a name="index-c_005b_0027slavePortnum_0027_005d-35"></a>
<pre class="example"> c['slavePortnum'] = 10000
</pre>
<p>The buildmaster will listen on a TCP port of your choosing for
connections from buildslaves. It can also use this port for
connections from remote Change Sources, status clients, and debug
tools. This port should be visible to the outside world, and you'll
need to tell your buildslave admins about your choice.
<p>It does not matter which port you pick, as long it is externally
visible, however you should probably use something larger than 1024,
since most operating systems don't allow non-root processes to bind to
low-numbered ports. If your buildmaster is behind a firewall or a NAT
box of some sort, you may have to configure your firewall to permit
inbound connections to this port.
<p><code>c['slavePortnum']</code> is a <em>strports</em> specification string,
defined in the <code>twisted.application.strports</code> module (try
<samp><span class="command">pydoc twisted.application.strports</span></samp> to get documentation on
the format). This means that you can have the buildmaster listen on a
localhost-only port by doing:
<pre class="example"> c['slavePortnum'] = "tcp:10000:interface=127.0.0.1"
</pre>
<p>This might be useful if you only run buildslaves on the same machine,
and they are all configured to contact the buildmaster at
<code>localhost:10000</code>.
</body></html>
