README
1==============================================
2 Running a GTK+ build slave under daemontools
3==============================================
4
5This directory contains several scripts which can be used to run a WebKitGTK+
6build slave under daemontools [1]. This is convenient because daemontools
7will automatically restart services when they die, and that means less human
8intervention is needed.
9
10
11Dependencies
12============
13
14In order to use the provided service control files, you will need the
15following:
16
17* The GNU Bash shell (the scripts contain some bash-isms)
18
19* The daemontools package (or one of its drop-in replacements, like runit
20 or freedt; but only daemontools has been tested so far).
21
22* The crash dump monitor also uses "inotifywait" (part of inotify-tools [2])
23
24In short, in a Debian-based system you can ensure you have the needed bits
25with the following command:
26
27 apt-get install inotify-tools daemontools-run
28
29
30Setup
31=====
32
331. Follow the instructions at http://trac.webkit.org/wiki/BuildBot
34
352. Install the dependencies outlined above.
36
373. Copy "daemontools-buildbot.conf" to "/etc/daemontools-buildbot.conf"
38
394. Edit the configuration file to suit your needs, the comments should
40 be self-explanatory.
41
425. Drop the "buildbot", "pulseaudio" and "xvfb" directories (plus
43 "crashmon", if desired) to the service control directory of
44 daemontools; for Debian-based setups that would be "/etc/service"
45
46
47References
48==========
49
50[1] http://cr.yp.to/daemontools.html
51[2] http://wiki.github.com/rvoicilas/inotify-tools/
52
53