Bug#143381: quick start

[dannf@fc.hp.com (dann)]

Package: debbugs
Severity: minor

hey,
  i've set up debbugs a couple of times from the debian package
(bugs.parisc-linux.org is a public example).

the second time i set it up, i wrote up a quick start guide to
go along with it.  someone just recently asked me some questions
about setting it up & i noticed that i'm still running the latest
version of the deb, so this guide would still be relevant.  anyway,
here's the content.  some things aren't very general (for example,
it just describes postfix config - which wasn't described in the package).

Some of this content might be useful to be included in /usr/share/doc.

Steps taken to setup debbugs on ldl
1) dpkg -i debbugs-2.3-3 (stable has 2.3-1, which doesn't use
   /etc/debbugs/config file
2) edit /etc/debbugs/config
   a) add $gCGIbase variable to fix some broken links (see step 5)
3) #ln -s /var/lib/debbugs/www /var/www/bugs
4) #cp /var/lib/debbugs/www/cgi/* /usr/lib/cgi-bin/
   (i have some patches to the cgi tools, so i store them separately from
    where debbugs does - an apache ScriptAlias might make more sense for
    most users).  
5) In /usr/lib/cgi-bin/common.pl, I changed 3 lines similar to the following:
     return $debbugs::gCGIDomain . "bugreport.cgi" . "?" . "$params";
   to
     return $gCGIBase . "bugreport.cgi" . "?" . "$params";
   (see step 2a)
6) -postfix configuration-
   a) added the following lines to /etc/postfix/main.cf
   transport_maps = hash:$config_directory/transport
   virtual_maps = hash:$config_directory/virtual
   b) added the following line to /etc/postfix/virtual
   root@bughost.domain    root@realhost.domain
   c) added the following line to /etc/postfix/transport
   bughost.domain debbugs:
   d) added the following lines to /etc/postfix/master.cf
   debbugs   unix  -       n       n       -       -       pipe
    flags=F user=debbugs argv=/usr/lib/debbugs/receive $recipient
    
7) -apache configuration-
   added the following lines to /etc/apache/httpd.conf

   NameVirtualHost 192.168.1.1

   <VirtualHost 192.168.1.1>
   ServerAdmin webmaster@realhost.domain
   DocumentRoot /var/www
   ServerName realhost.domain
   </VirtualHost>

   <VirtualHost 192.168.1.1>
   ServerAdmin user@realhost.domain
   DocumentRoot /var/www/bugs
   ServerName bughost.domain
   </VirtualHost>

#8) added my python maintenance scripts to /usr/lib/debbugs
#   genindex.py
#   genpkglist.py

done with initial setup... debugging time

9) added user debbugs
10) # chown -R debbugs /var/lib/debbugs
11) # echo "10" > /var/lib/debbugs/spool/nextnumber

-- 
---------------------------
dann frazier
Hewlett-Packard
Linux Development Lab
dannf@ldl.fc.hp.com
(970) 898-0800


-- 
To UNSUBSCRIBE, email to debian-debbugs-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org