openbsd-ports/databases/gnats/pkg
2010-11-23 18:14:19 +00:00
..
DESCR remove WWW lines 2003-12-15 21:42:08 +00:00
PLIST - switch to pkg-readmes 2010-11-09 21:33:24 +00:00
README style 2010-11-23 18:14:19 +00:00

$OpenBSD: README,v 1.3 2010/11/23 18:14:19 jasper Exp $

Running GNATS on OpenBSD
========================

Post-installation steps:
------------------------
1. Add the following to /etc/services:

support         1529/tcp                # GNATS

2. Add the following to /etc/inetd.conf and HUP inetd:

support         stream  tcp     nowait  _gnats	${TRUEPREFIX}/libexec/gnats/gnatsd	gnatsd

3. Edit the config files in ${TRUEPREFIX}/share/gnats/gnats-db/gnats-adm
   (see the GNATS info documentation and online HTML documentation)
   to your liking, then run (as root):

	su -m _gnats -c '${TRUEPREFIX}/libexec/gnats/mkcat --directory=${TRUEPREFIX}/share/gnats/gnats-db'

4. As root, do

	crontab -e -u _gnats

   and add the following entry:

0,10,20,30,40,50 * * * * ${TRUEPREFIX}/libexec/gnats/queue-pr --run

5. Add the following lines to /etc/mail/aliases and run 'newaliases':

# GNATS support
gnats-admin: root
bugs:   "|${TRUEPREFIX}/libexec/gnats/queue-pr -q"
monkey-gnats: bugs

   where 'monkey' is replaced with the configured value of GNATS_SITE in
   ${TRUEPREFIX}/share/gnats/gnats-db/gnats-adm/config.

6. If you want to run gnatsweb, add

127.0.0.1:view:

to ${TRUEPREFIX}/share/gnats/gnats-db/gnats-adm/gnatsd.access. You may
increase privileges for all users of gnatsweb by changing 'view' to
'edit', or for individual users by adding rules to
${TRUEPREFIX}/share/gnats/gnats-db/gnats-adm/gnatsd.access.

References:
-----------
Additional documentation at  http://sunsite.ualberta.ca/Documentation/Gnu/gnats-3.113/