Skip to content

Commit fc934df

Browse files
author
Richard Jones
committed
Fixed the ROUNDUPS decl in roundup-server
Move the installation notes to INSTALL
1 parent bd5a2b2 commit fc934df

File tree

2 files changed

+13
-77
lines changed

2 files changed

+13
-77
lines changed

README

Lines changed: 6 additions & 73 deletions
Original file line numberDiff line numberDiff line change
@@ -11,78 +11,9 @@ The stylesheet included with this package has been copied from the Zope
1111
management interface and presumably belongs to Digital Creations.
1212

1313

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

8718

8819
3. Usage
@@ -92,8 +23,9 @@ interface.
9223

9324
3.1 Command-line
9425
----------------
95-
The command-line tool is called "roundup.py" and is used for most low-level
26+
The command-line tool is called "roundup-admin" and is used for most low-level
9627
database manipulations such as:
28+
. creating a database instance
9729
. redefining the list of products ("create" and "retire" commands)
9830
. adding users manually, or setting their passwords ("create" and "set")
9931
. other stuff - run it with no arguments to get a better description of
@@ -102,7 +34,7 @@ database manipulations such as:
10234

10335
3.2 E-mail
10436
----------
105-
See the docstring at the start of the roundup-mailgw.py source file.
37+
See the docstring at the start of the roundup/mailgw.py source file.
10638

10739

10840
3.3 Web
@@ -220,5 +152,6 @@ [email protected]
220152
=========
221153
Well, Ping, of course ;)
222154

223-
Anthony Baxter, for some good first-release feedback.
155+
Anthony Baxter, for some good first-release feedback. And then continuing
156+
support through development on sourceforge.
224157

roundup-server

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
44
Stolen from CGIHTTPServer
55
6-
$Id: roundup-server,v 1.2 2001-07-23 04:05:05 anthonybaxter Exp $
6+
$Id: roundup-server,v 1.3 2001-07-23 08:53:44 richard Exp $
77
88
"""
99
import sys
@@ -31,7 +31,7 @@ from roundup import date, hyperdb, hyper_bsddb, roundupdb, htmltemplate
3131
#
3232

3333
# This indicates where the Roundup instance lives
34-
ROUNDUPS = {
34+
ROUNDUP_INSTANCE_HOMES = {
3535
'test': '/tmp/roundup_test',
3636
}
3737

@@ -98,8 +98,8 @@ class RoundupRequestHandler(SimpleHTTPServer.SimpleHTTPRequestHandler):
9898
raise ValueError, 'No instance specified'
9999
l_path = string.split(rest, '/')
100100
instance = urllib.unquote(l_path[1])
101-
if ROUNDUPS.has_key(instance):
102-
instance_home = ROUNDUPS[instance]
101+
if ROUNDUP_INSTANCE_HOMES.has_key(instance):
102+
instance_home = ROUNDUP_INSTANCE_HOMES[instance]
103103
module_path, instance = os.path.split(instance_home)
104104
sys.path.insert(0, module_path)
105105
try:
@@ -220,6 +220,9 @@ if __name__ == '__main__':
220220

221221
#
222222
# $Log: not supported by cvs2svn $
223+
# Revision 1.2 2001/07/23 04:05:05 anthonybaxter
224+
# actually quit if python version wrong
225+
#
223226
# Revision 1.1 2001/07/23 03:46:48 richard
224227
# moving the bin files to facilitate out-of-the-boxness
225228
#

0 commit comments

Comments
 (0)