freebsd-ports/ports-mgmt/tinderbox-devel/files/pkg-message.in
Ion-Mihai Tetcu 1b23215da8 Update to 2.4.3.
If all goes well, this will be the last 2.x release before a 3.0 major release.

The 2.4.3 release is primarily aimed at fixing bugs, but a few small features
have been added:
* Treat the -u argument to sendBuildCompletionMail as a username rather than an
arbitrary database ID.  Also, do better error checking in case a user has not
been defined in the datastore.
* Add -b <build name> support to the listBuildPortsQueue command.
* Add a new tc command, getPortLastBuiltStatus to get a port's last status.
* Properly quote the UPDATE_CMD argument in the *PortsTreeUpdate hooks.
* Add a new tbkill.sh tool to terminate a running tinderbuild.
* Add a new tinderbuild option, -norebuild, which will prevent tinderbuild from
forcing a rebuild of any packages specified on the command line.
* Add the build platform and release level to the logs.
* Add support for listing total ports per Build in the www-exp frontend.
* Some other minor bugs have been fixed.

Plus 3 local (port) patches:
* in "Current and Latest Builds" (?action=latest_buildports) increase the number
of ports displayed  from 20 to 30
* in ports built for a build view (?action=list_buildports&build=something)
when sorting is done by Last Build Attempt sort descending (latest build first).
* in build logs, add: [1]
 - building for: (ie: "6.3-STABLE amd64")
 - Makefile ident: (ie: "$FreeBSD: ports/ports-mgmt/tinderbox/Makefile,v 1.41 2008/05/19 20:00:16 itetcu Exp $")
 - prefixes: (ie: "LOCALBASE=usr/local X11BASE=usr/local")
 - NO* env vars: (ie: "NOPORTDOCS=yes NOPORTEXAMPLES=yes NOPORTDATA=yes")

This release would not have been possible without the contributions of
Alexander Loginov, miwi, Chess Griffin, itetcu, Dmitriy Kirhlarov,
Robert Gogolok, and ade.

- Fix a few typos in pkg-message. [2]

PR:		ports/123957 [2]
Submited by:	Wen heping <wenheping@gmail.com> [2],
		idea from miwi@'s patch for HEAD [1]
2008-06-03 13:24:58 +00:00

138 lines
4.9 KiB
Text

===============================================================================
ports-mgmt/tinderbox is now installed, but it requires some additional setup.
****************************************************
Additional info: %%PREFIX%%/tinderbox/scripts/README
****************************************************
The following walkthrough is for PostgreSQL databases:
- First, run the setup program:
%%PREFIX%%/tinderbox/scripts/setup.sh
Enter database driver (mysql pgsql): pgsql
If the database is running on the same server as you're on now,
and you have administrator access to it, answer this question
with yes:
"Does this host have access to connect to the Tinderbox database as a database administrator?"
Enter database admin user [root]: pgsql
Enter the desired username for the Tinderbox database : tinderbox
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
The other questions should just be entered through.
The following walkthrough is for MySQL databases:
- First, run the setup program:
%%PREFIX%%/tinderbox/scripts/setup.sh
Enter database driver (mysql pgsql): mysql
If the database is running on the same server as you're on now,
and you have administrator access to it, answer this question
with yes:
"Does this host have access to connect to the Tinderbox database as a database administrator?"
Enter the desired username for the Tinderbox database : tinderbox
The other questions should just be entered through.
The following walkthrough is the tinderbox environment setup:
- Edit the file %%PREFIX%%/tinderbox/scripts/tinderbox.ph (copy from
tinderbox.ph.dist)
- $BUILD_ROOT should be "%%PREFIX%%/tinderbox"
- $SUBJECT should be "My Tinderbox"
- $SENDER should be your email address
- $SMTP_HOST should be your SMTP server (localhost?)
- $SERVER_HOST should be the name your machine is known as. If
it is your own machine and your access it directory, try localhost
here if nothing else sounds reasonable.
- $TINDERBOX_URI should be "/tb".
- Comment out the lines after "for www", and uncomment the lines "for www-exp".
- Edit the file %%PREFIX%%/tinderbox/scripts/www-exp/inc_ds.php
(copy from inc_ds.php.dist)
- $DB_HOST should be localhost
- $DB_DRIVER should be pgsql
- $DB_USER should be tinderbox
- Edit the file %%PREFIX%%/tinderbox/scripts/www-exp/inc_tinderbox.php
(copy from inc_tinderbox.php.dist)
- $rootdir should be %%PREFIX%%/tinderbox
- $wwwrooturi should be /tb
- $tinderbox_name should be "My Tinderbox"
- $tinderbox_title should be "FreeBSD Packages"
The following walkthrough is the initial tinderbox population setup
and should be executed in %%PREFIX%%/tinderbox/scripts.
- ./tc init
- Create a jail. A jail is a chrooted version of the FreeBSD operating
system, for example 7-STABLE or 7.0-RELEASE:
./create Jail -j 7 -d "FreeBSD 7.0-RELEASE" -t RELENG_7_0_0_RELEASE -u CVSUP
You can have multiple jails on a single machine.
This takes a while.
- Create a ports tree:
./create PortsTree -p FreeBSD -d "FreeBSD ports tree" -w http://www.freebsd.org/cgi/cvsweb.cgi/ports/
This takes a while.
- And then link the two together in a build:
./create Build -b 7.0-FreeBSD -j 7 -p FreeBSD -d "7.0-RELEASE with FreeBSD ports tree"
The following walkthrough is the webserver setup:
- In your Apache configuration, add the following lines:
Alias /tb/logs/ "%%PREFIX%%/tinderbox/logs/"
Alias /tb/packages/ "%%PREFIX%%/tinderbox/packages/"
Alias /tb/errors/ "%%PREFIX%%/tinderbox/errors/"
Alias /tb/ "%%PREFIX%%/tinderbox/scripts/www-exp/"
<Directory "%%PREFIX%%/tinderbox/">
Order allow,deny
Allow from all
</Directory>
- In your Lighttpd configuration:
Turn on "mod_alias" and add the following lines:
alias.url = ( "/tb/logs/" => "%%PREFIX%%/tinderbox/logs/",
"/tb/packages/" => "%%PREFIX%%/tinderbox/packages/",
"/tb/errors/" => "%%PREFIX%%/tinderbox/errors/",
"/tb/" => "%%PREFIX%%/tinderbox/scripts/www-exp/" )
dir-listing.activate = "enable"
Check your system by going to http://localhost/tb/
The following walkthrough is the first run for a port in the
tinderbox and should be executed in %%PREFIX%%/tinderbox/scripts.
- See the documents %%PREFIX%%/tinderbox/scripts/README and the
"Using Tinderbox" section for more information.
- Add the port and its dependencies to the database:
./tc addPort -b 5.4-FreeBSD -d net/dhcpdump -r
- On the website you see now five ports on the build page.
- Start the build:
./tinderbuild -nullfs -b 5.4-FreeBSD dns/dnstracer
- On the page "Current and latest builds in this build" you see the
current being-built port and the last n ports built.
- At a certain moment, when you refresh the page, you see that it
has changed.
=============================================================================