How to create new OSGeo BuildBot instance

= Draft =

NOTE: This is a very first draft of the How-To Create BuildBot Instance

= Prerequisites =

First, it's very important to read the BuildBot Configuration document.

= Create BuildBot instance step-by-step =

Login on the server
ssh buildbot@xblade14-2

Go to OSGEOBUILDHOME
See OSGEOBUILDHOME to learn what's this location and environment variable used for.

$ cd $OSGEOBUILDHOME

Creating directory for project
New BuildBot instance directory for project, lowercase name:

$ mkdir

Assign new project id
Check Buildmaster ports to learn what is this project identifier used for.

Project id is a solid number 0 to 99 which identifies OGeo BuildBot instance for particular project and is used to calculate new TCP port numbers.

$ cd ${OSGEOBUILDHOME}/ $ echo ## > ID

where ## is project solid id'.

Create directory for buildmaster
$ mkdir buildmaster

Create directory for buildslave
$ mkdir buildslave

Create buildmaster
Run buildbot to create new buildmaster:

$ buildbot create-master ${OSGEOBUILDHOME}/ /buildmaster

Create buildslave
$ buildbot create-slave ${OSGEOBUILDHOME}/ /buildslave MASTERHOST:PORT SLAVENAME PASSWORD

PORT: 15XX where XX is subsequent number of BuildBot instance (between 0-99) SLAVENAME: osgeo- PASSWORD:

Configure BuildBot instance
Edit master.cfg

Run

 * Start

$OSGEOBUILDHOME/buildbot_start.sh


 * Stop

$OSGEOBUILDHOME/buildbot_stop.sh

Copy and edit README
$ cp $OSGEOBUILDHOME/admin/README $OSGEOBUILDHOME/