web/hosts/issues README,NONE,1.1

Update of /cvs/fresco/web/hosts/issues
In directory purcel:/tmp/cvs-serv21953

Added Files:
	README 
Log Message:
an attempt to document purcel's roundup installation and at the same time
help on http://issues.fresco.org/task91



--- NEW FILE: README ---
This is an attempt to document the installation of fresco's
roundup instance, i.e. all you need to know in order to maintain
and debug it...

1) roundup is installed with prefix "/org/fresco.org", i.e. with
   python 2.1 on purcel that puts the roundup module into
   "/org/fresco.org/lib/python2.1/site-packages/"

2) install an instance. Either install from scratch (use the roundup
   docs), or copy the purcel instance over (the directory /org/fresco.org/http/issues)

3) set up the mail interface:

3.1) modify the mail gateway so it finds the roundup module, i.e.
     insert into $(prefix)/bin/roundup-mailgw:

     import sys
     sys.path.insert(0, '/org/fresco.org/lib/python2.1/site-packages')

     (replace '/org/fresco.org' with your prefix)

3.2) set up thea mail alias to use that, i.e. on purcel I add the following
     line to the aliases file:

     issues:                 "|/org/fresco.org/bin/roundup-mailgw /org/fresco.org/http/issues"

     (the argument is the instance directory for the roundup instance you want to serve)
     Modify the $(instancedir)/config.py file such that the TRACKER_EMAIL variable contains
     the tracker's email address (the one you just added to the aliases file)

4) set up the cgi frontend

4.1) copy the roundup/cgi-bin/roundup.cgi file to a place where apache will find it
4.2) add some env variables to apache for roundup.cgi to use:

     The ones presently used on purcel are:

        SetEnv PYTHONPATH "/org/fresco.org/lib/python/site-packages"
        SetEnv ROUNDUP_LOG "/org/fresco.org/http/issues/log/roundup.log"
        SetEnv ROUNDUP_INSTANCE_HOMES "Default=/org/fresco.org/http/issues"
        SetEnv ROUNDUP_DEBUG "0"

   the ROUNDUP_INSTANCE_HOMES variable defines a dictionary of name=directory pairs.
   Normally rounfup.cgi presents then a page to choose one instance. On purcel the
   roundup.cgi script is modified to always jump to the 'Default' instance. Also,
   the DocumentRoot is set up to point to 
   '/org/fresco.org/http/issues/cgi-bin/roundup.cgi/issues', which does the same.

Please report any errors/missing data.

Good luck,
      Stefan