|
| 1 | + Roundup |
| 2 | + ======= |
| 3 | + |
| 4 | + |
| 5 | +Installation |
| 6 | +=============== |
| 7 | +These instructions work on redhat 6.2 and mandrake 8.0 - with the caveat |
| 8 | +that these systems don't come with python 2.0 or newer installed, so you'll |
| 9 | +have to upgrade python before this stuff will work. |
| 10 | + |
| 11 | +Roundup is configurable using a localconfig.py file in the instance home. |
| 12 | +It may have the following variable declarations: |
| 13 | + |
| 14 | + MAILHOST - The SMTP mail host that roundup will use to send mail |
| 15 | + MAIL_DOMAIN - The domain name used for email addresses |
| 16 | + |
| 17 | +Any further configuration should be possible by editing the instance home's |
| 18 | +__init__.py directly. |
| 19 | + |
| 20 | +The email addresses used by the system by default are: |
| 21 | + |
| 22 | + issue_tracker@MAIL_DOMAIN - submissions of issues |
| 23 | + roundup-admin@MAIL_DOMAIN - roundup's internal use (problems, etc) |
| 24 | + |
| 25 | + |
| 26 | +Prerequisites |
| 27 | +----------------- |
| 28 | +Either: |
| 29 | + . Python 2.0 with pydoc installed. See http://www.lfw.org/ for pydoc. |
| 30 | +or |
| 31 | + . Python 2.1 |
| 32 | + |
| 33 | +Both need the anydbm or bsddb module. |
| 34 | + |
| 35 | + |
| 36 | + |
| 37 | +Initial Setup |
| 38 | +============= |
| 39 | + |
| 40 | +Instance |
| 41 | +-------- |
| 42 | +Try "./roundup-admin init" :) |
| 43 | + |
| 44 | + |
| 45 | +Mail |
| 46 | +---- |
| 47 | +Set up a mail alias called "issue_tracker" as: |
| 48 | + "|/usr/bin/python /home/httpd/html/roundup/roundup-mailgw <instance_home>" |
| 49 | + |
| 50 | +In some installations (e.g. RedHat 6.2 I think) you'll need to set up smrsh |
| 51 | +so sendmail will accept the pipe command. In that case, symlink |
| 52 | +/etc/smrsh/python to /usr/bin/python and change the command to: |
| 53 | + "|python /home/httpd/html/roundup/roundup-mailgw <instance_home>" |
| 54 | + |
| 55 | + |
| 56 | +Web Interface |
| 57 | +------------- |
| 58 | +This software will work through apache or stand-alone. |
| 59 | + |
| 60 | +Stand-alone: |
| 61 | + 1. Edit roundup-server at the top - ROUNDUP_INSTANCE_HOMES needs to know |
| 62 | + about your instance. |
| 63 | + 2. "./roundup-server [hostname port]" (hostname may be "") |
| 64 | + 3. Load up the page "/" using the port number you set. |
| 65 | + |
| 66 | +Apache: |
| 67 | + 1. Make sure roundup.cgi is executable. Edit it at the top - |
| 68 | + ROUNDUP_INSTANCE_HOMES needs to know about your instance. |
| 69 | + 2. Edit your /etc/httpd/conf/httpd.conf and make sure that the |
| 70 | + /home/httpd/html/roundup/roundup.cgi script will be treated as a CGI |
| 71 | + script. |
| 72 | + 3. Add the following to your /etc/httpd/conf/httpd.conf: |
| 73 | +------8<------- snip here ------8<------- |
| 74 | +RewriteEngine on |
| 75 | +RewriteCond %{HTTP:Authorization} ^(.*) |
| 76 | +RewriteRule ^/roundup/roundup.cgi(.*) /home/httpd/html/roundup/roundup.cgi$1 [e=HTTP_CGI_AUTHORIZATION:%1,t=application/x-httpd-cgi,l] |
| 77 | +------8<------- snip here ------8<------- |
| 78 | + note: the RewriteRule must be on one line - no breaks |
| 79 | + 4. Re-start your apache to re-load the config |
| 80 | + 5. Load up the page "/roundup/roundup.cgi/" |
| 81 | + |
| 82 | + |
0 commit comments