README
1 ==============================================
2 Running a GTK+ build slave under daemontools
3 ==============================================
4
5 This directory contains several scripts which can be used to run a WebKitGTK+
6 build slave under daemontools [1]. This is convenient because daemontools
7 will automatically restart services when they die, and that means less human
8 intervention is needed.
9
10
11 Dependencies
12 ============
13
14 In order to use the provided service control files, you will need the
15 following:
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
24 In short, in a Debian-based system you can ensure you have the needed bits
25 with the following command:
26
27 apt-get install inotify-tools daemontools-run
28
29
30 Setup
31 =====
32
33 1. Follow the instructions at http://trac.webkit.org/wiki/BuildBot
34
35 2. Install the dependencies outlined above.
36
37 3. Copy "daemontools-buildbot.conf" to "/etc/daemontools-buildbot.conf"
38
39 4. Edit the configuration file to suit your needs, the comments should
40 be self-explanatory.
41
42 5. 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
47 References
48 ==========
49
50 [1] http://cr.yp.to/daemontools.html
51 [2] http://wiki.github.com/rvoicilas/inotify-tools/
52
53