2000-08-14 22:22:15 +00:00
|
|
|
Currently this is Alpha/Beta code, because no one but me is using it
|
|
|
|
yet (and even I am not using all the features I have tested). If you
|
|
|
|
are not really comfortable coding in perl I suggest you wait until
|
|
|
|
more people are using it and we get the minor kinks worked out of the
|
|
|
|
code and documentation.
|
|
|
|
|
|
|
|
|
|
|
|
To install:
|
2000-06-22 04:17:19 +00:00
|
|
|
|
2000-09-22 15:07:28 +00:00
|
|
|
1) read and edit the variables found in the files ./src/lib/* particularly:
|
|
|
|
|
|
|
|
TinderConfig.pm: general configuration settings
|
|
|
|
Error_Parse.pm: the regular expressions for highlighting errors
|
|
|
|
FileStructure.pm: filesystem (storage) and global/per-project settings
|
|
|
|
BTData.pm: bug tracking configuration
|
|
|
|
TreeData.pm: version control configuration
|
2000-06-22 04:17:19 +00:00
|
|
|
|
|
|
|
2) run ./configure
|
|
|
|
|
|
|
|
3) run make
|
|
|
|
|
2000-08-14 22:22:15 +00:00
|
|
|
4) run the test programs as described in /build/test/ReadMe to ensure
|
|
|
|
that you have configured the program correctly.
|
|
|
|
|
|
|
|
5) run make install
|
2000-06-22 04:17:19 +00:00
|
|
|
|
2000-08-14 22:22:15 +00:00
|
|
|
6) set up a cron job to run $prefix/bin/tinder.cgi --daemon-mode
|
2000-09-10 17:33:42 +00:00
|
|
|
every five minutes.
|
|
|
|
set up a cron job to run $prefix/bin/tinder.cgi/rmlogs once a day.
|
|
|
|
six am is a good time to run this as the machine load is light and
|
|
|
|
will avoids any day light savings problems.
|
2000-06-22 04:17:19 +00:00
|
|
|
|
2000-09-22 15:07:28 +00:00
|
|
|
7) set up the $prefix/bin/processmail* programs to receive the
|
|
|
|
incoming tinderbox mail. We use the mail address 'tinderbox_builds'
|
|
|
|
for build information destined for the webserver (similarly the bug
|
|
|
|
tracking system sends mail to 'tinderbox_bugs' on the webserver). The
|
|
|
|
process id which receives and process the mail must be the the same id
|
|
|
|
which runs the cron job. (currently I have a program called
|
|
|
|
'processmail' it will eventually be renamed to 'processmail_builds')
|
2000-06-22 04:17:19 +00:00
|
|
|
|
2000-08-14 22:22:15 +00:00
|
|
|
8) if you are using VC_CVS.pm then you will need to put a ~/.cvspass
|
2000-08-11 00:27:27 +00:00
|
|
|
for tinderbox to use. Log into the CVS repository yourself, once for
|
|
|
|
each tree you have defined. This must be done exactly as you wrote it
|
|
|
|
in TreeData. Then copy your ~/.cvspass into tinderbox home directory.
|
|
|
|
This is the REAL home of the Tinderbox daemon, as listed in
|
|
|
|
/etc/passwd/ and set in the $HOME environmental variable for
|
|
|
|
tinder.cgi.
|
|
|
|
|
2000-08-14 22:22:15 +00:00
|
|
|
9) setup the build machines to mail their build logs
|
2000-09-22 15:07:28 +00:00
|
|
|
(with tinderbox variables on the top) to the web server machine.
|
|
|
|
New builds must not start earlier then 6 minutes after the
|
|
|
|
last build started.
|
2000-08-30 02:14:14 +00:00
|
|
|
|
|
|
|
10) Check that the time on your webserver and your build machine is in
|
|
|
|
sync. Check that mail if build mail bounces either on the build
|
|
|
|
machine or on the webserver machine, that it will be recieved by
|
|
|
|
someone who can act on it.
|
2000-06-22 04:17:19 +00:00
|
|
|
|