Mercurial > p > roundup > code

annotate INSTALL.txt @ 217:b02a69130c91

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
more install note changes
author Richard Jones <richard@users.sourceforge.net>
date Tue, 07 Aug 2001 04:17:39 +0000
parents dbb35b638e88
children 2482585afdbb
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
94
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
1 Roundup
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
2 =======
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
3
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
4 Installation
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
5 ===============
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
6 These instructions work on redhat 6.2 and mandrake 8.0 - with the caveat
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
7 that these systems don't come with python 2.0 or newer installed, so you'll
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
8 have to upgrade python before this stuff will work.
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
9
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
10
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
11 Prerequisites
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
12 -------------
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
13 Either:
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
14 . Python 2.0 with pydoc installed. See http://www.lfw.org/ for pydoc.
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
15 or
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
16 . Python 2.1
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
17
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
18 You will need either the anydbm or bsddb module.
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
19
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
20
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
21 Testing the Software
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
22 --------------------
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
23
102
0b250446cf8b Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents: 101
diff changeset
24 Run "python -c 'import test;test.go()'" and make sure there's no errors.
94
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
25 If there are errors, please let us know!
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
26
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
27
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
28 Installing the Software
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
29 -----------------------
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
30
101
f55b8be00de5 more notes for installation
Richard Jones <richard@users.sourceforge.net>
parents: 94
diff changeset
31 1. Run:
f55b8be00de5 more notes for installation
Richard Jones <richard@users.sourceforge.net>
parents: 94
diff changeset
32
f55b8be00de5 more notes for installation
Richard Jones <richard@users.sourceforge.net>
parents: 94
diff changeset
33 python setup.py install
f55b8be00de5 more notes for installation
Richard Jones <richard@users.sourceforge.net>
parents: 94
diff changeset
34
102
0b250446cf8b Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents: 101
diff changeset
35 If you would prefer the scripts installed in somewhere other than
0b250446cf8b Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents: 101
diff changeset
36 /usr/local/bin, add "--install-scripts=<dir>" to the command:
0b250446cf8b Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents: 101
diff changeset
37
0b250446cf8b Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents: 101
diff changeset
38 python setup.py install --install-scripts=<dir>
101
f55b8be00de5 more notes for installation
Richard Jones <richard@users.sourceforge.net>
parents: 94
diff changeset
39
102
0b250446cf8b Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents: 101
diff changeset
40 The command:
0b250446cf8b Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents: 101
diff changeset
41
0b250446cf8b Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents: 101
diff changeset
42 python setup.py install --help
0b250446cf8b Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents: 101
diff changeset
43
0b250446cf8b Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents: 101
diff changeset
44 gives all the options available for installation.
94
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
45
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
46
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
47
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
48 Initial Setup
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
49 =============
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
50
102
0b250446cf8b Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents: 101
diff changeset
51 The following instructions assume that you have installed roundup. If you
0b250446cf8b Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents: 101
diff changeset
52 haven't, you may still proceed - just preface all commands with "./"
0b250446cf8b Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents: 101
diff changeset
53 ie. "./roundup-admin init".
0b250446cf8b Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents: 101
diff changeset
54
0b250446cf8b Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents: 101
diff changeset
55
94
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
56 Instance
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
57 --------
102
0b250446cf8b Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents: 101
diff changeset
58 Run "roundup-admin init". This initialises a roundup instance.
94
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
59
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
60 Roundup is configurable using a localconfig.py file in the instance home.
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
61 It may have the following variable declarations:
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
62
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
63 MAILHOST - The SMTP mail host that roundup will use to send mail
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
64 MAIL_DOMAIN - The domain name used for email addresses
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
65
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
66 Any further configuration should be possible by editing the instance home's
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
67 __init__.py directly.
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
68
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
69 The email addresses used by the system by default are:
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
70
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
71 issue_tracker@MAIL_DOMAIN - submissions of issues
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
72 roundup-admin@MAIL_DOMAIN - roundup's internal use (problems, etc)
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
73
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
74
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
75 Mail
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
76 ----
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
77 Set up a mail alias called "issue_tracker" as:
216
dbb35b638e88 further clarification for gettnig started
Richard Jones <richard@users.sourceforge.net>
parents: 209
diff changeset
78 "|/usr/bin/python /usr/local/bin/roundup-mailgw <instance_home>"
94
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
79
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
80 In some installations (e.g. RedHat 6.2 I think) you'll need to set up smrsh
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
81 so sendmail will accept the pipe command. In that case, symlink
217
b02a69130c91 more install note changes
Richard Jones <richard@users.sourceforge.net>
parents: 216
diff changeset
82 /etc/smrsh/roundup-mailgw to /usr/local/bin/roundup-mailgw and change the
b02a69130c91 more install note changes
Richard Jones <richard@users.sourceforge.net>
parents: 216
diff changeset
83 command to:
b02a69130c91 more install note changes
Richard Jones <richard@users.sourceforge.net>
parents: 216
diff changeset
84 "|roundup-mailgw <instance_home>"
94
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
85
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
86
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
87 Web Interface
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
88 -------------
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
89 This software will work through apache or stand-alone.
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
90
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
91 Stand-alone:
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
92 1. Edit roundup-server at the top - ROUNDUP_INSTANCE_HOMES needs to know
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
93 about your instance.
102
0b250446cf8b Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents: 101
diff changeset
94 2. "roundup-server [hostname port]" (hostname may be "")
216
dbb35b638e88 further clarification for gettnig started
Richard Jones <richard@users.sourceforge.net>
parents: 209
diff changeset
95 3. Load up the page "/<instance name>/index" where instance name is the
dbb35b638e88 further clarification for gettnig started
Richard Jones <richard@users.sourceforge.net>
parents: 209
diff changeset
96 name you nominated in ROUNDUP_INSTANCE_HOMES.
94
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
97
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
98 Apache:
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
99 1. Make sure roundup.cgi is executable. Edit it at the top -
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
100 ROUNDUP_INSTANCE_HOMES needs to know about your instance.
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
101 2. Edit your /etc/httpd/conf/httpd.conf and make sure that the
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
102 /home/httpd/html/roundup/roundup.cgi script will be treated as a CGI
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
103 script.
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
104 3. Add the following to your /etc/httpd/conf/httpd.conf:
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
105 ------8<------- snip here ------8<-------
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
106 RewriteEngine on
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
107 RewriteCond %{HTTP:Authorization} ^(.*)
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
108 RewriteRule ^/roundup/roundup.cgi(.*) /home/httpd/html/roundup/roundup.cgi$1 [e=HTTP_CGI_AUTHORIZATION:%1,t=application/x-httpd-cgi,l]
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
109 ------8<------- snip here ------8<-------
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
110 note: the RewriteRule must be on one line - no breaks
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
111 4. Re-start your apache to re-load the config
216
dbb35b638e88 further clarification for gettnig started
Richard Jones <richard@users.sourceforge.net>
parents: 209
diff changeset
112 5. Load up the page "/roundup/roundup.cgi/<instance name>/index" where
dbb35b638e88 further clarification for gettnig started
Richard Jones <richard@users.sourceforge.net>
parents: 209
diff changeset
113 instance name is the name you nominated in ROUNDUP_INSTANCE_HOMES.
94
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
114
9cf5229397fc name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
115
Roundup Issue Tracker: http://roundup-tracker.org/