mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-11-25 22:01:30 +00:00
110 lines
3.4 KiB
Plaintext
110 lines
3.4 KiB
Plaintext
#
|
|
# Tinderbox INSTALL guide
|
|
#
|
|
|
|
|
|
This is a quick guide for installing the tinderbox server.
|
|
|
|
|
|
1)
|
|
If you want to track checkins with tinderbox, you will need to
|
|
install Bonsai or ViewVC first.
|
|
|
|
2)
|
|
In order to tighten access to the tinderbox files, you will need to
|
|
create a tinderbox user & group for exclusive use by the tinderbox server.
|
|
|
|
3)
|
|
Checkout the latest copy of the tinderbox server:
|
|
cd /builds/cvs && cvs -z3 co mozilla/webtools/tinderbox
|
|
|
|
4)
|
|
Edit the tinderbox Makefile and set the variables in the
|
|
SERVER_CONFIGURATION as appropriate. Let's assume that you set:
|
|
TINDERBOX_DIR=/var/www/html/tinderbox
|
|
TINDERBOX_USER=tinderbox
|
|
TINDERBOX_GROUP=tinderbox
|
|
vi mozilla/webtools/tinderbox/Makefile
|
|
|
|
5)
|
|
Install the tinderbox server into the system directory
|
|
sudo make -C mozilla/webtools/tinderbox install
|
|
|
|
6)
|
|
Edit your webserver configuration file and setup the virtual server
|
|
for your tinderbox as well as limit permissions to certain sensitive files.
|
|
vi /etc/httpd/conf/httpd.conf
|
|
|
|
# Example Virtual host entry for tinderbox for apache 2.0.x
|
|
# Replace 'company.com' with your company and '/var/www/html' with the
|
|
# actual location of your tinderbox installation
|
|
#
|
|
<VirtualHost *:80>
|
|
ServerName tinderbox.company.com
|
|
ServerAlias tinderbox
|
|
DocumentRoot /var/www/html
|
|
SuexecUserGroup tinderbox tinderbox
|
|
RewriteEngine On
|
|
RewriteRule ^/$ http://tinderbox.company.com/tinderbox/ [R,L,NE]
|
|
<Directory /var/www/html/tinderbox/>
|
|
Options FollowSymLinks ExecCGI
|
|
AllowOverride None
|
|
AddHandler cgi-script .cgi
|
|
Allow from all
|
|
<FilesMatch "\.(pl|pm)$">
|
|
Deny from all
|
|
</FilesMatch>
|
|
</Directory>
|
|
# Deny access to private tree data
|
|
<Directory /var/www/html/tinderbox/*/>
|
|
<FilesMatch "^(ignorebuilds.pl|scrapebuilds|treedata|warningbuilds).pl$">
|
|
Deny from all
|
|
</FilesMatch>
|
|
<FilesMatch "\.(dat)$">
|
|
Deny from all
|
|
</FilesMatch>
|
|
</Directory>
|
|
<DirectoryMatch /var/www/html/tinderbox/(data|examples)>
|
|
Deny from all
|
|
</DirectoryMatch>
|
|
</VirtualHost>
|
|
# End tinderbox apache configuration
|
|
|
|
7)
|
|
Add an email alias for 'tinderbox-daemon' on the local server and pipe
|
|
all mail through the handemail.pl script.
|
|
Assuming that you're using sendmail, add the following line to /etc/aliases
|
|
|
|
tinderbox-daemon: "|/var/www/html/tinderbox/handlemail.pl"
|
|
|
|
If sendmail uses smrsh, you may need to create a symlink under /etc/smrsh.
|
|
ln -sf /var/www/html/tinderbox/handlemail.pl /etc/smrsh/handlemail.pl
|
|
|
|
8)
|
|
As the tinderbox user, add a cron job to call 'processbuild.pl'.
|
|
For example,
|
|
MAILTO="root"
|
|
USER=tinderbox
|
|
*/5 * * * * /var/www/html/tinderbox/processbuild.pl
|
|
This will cause the tinderbox mail to be processed every five minutes and
|
|
to mail the root user if any errors occur.
|
|
|
|
9)
|
|
Generate an admin password to be used to setup new trees
|
|
sudo make -C mozilla/webtools/tinderbox genpasswd
|
|
|
|
10)
|
|
Restart apache and go to http://tinderbox.company.com/tinderbox/ .
|
|
Click on 'Create new tree' and enter the information for your
|
|
new tinderbox tree.
|
|
|
|
11)
|
|
Pull the tinderbox client source and start sending build reports
|
|
to tinderbox-daemon@<tinderbox.server>
|
|
(cd /builds/cvs && cvs -z3 co mozilla/tools/tinderbox )
|
|
|
|
12)
|
|
If you are migrating from an older tinderbox installation, you may need
|
|
to run ./checksetup.pl to make sure that your trees are using the
|
|
correct treedata.pl format.
|