Skip to content

Commit cef5cc2

Browse files
author
Richard Jones
committed
renamed the text files so that they're recognised as text files on windows
added INSTALL.TXT
1 parent fc934df commit cef5cc2

File tree

3 files changed

+82
-0
lines changed

3 files changed

+82
-0
lines changed
File renamed without changes.

INSTALL.TXT

Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
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+
File renamed without changes.

0 commit comments

Comments
 (0)