Mercurial > p > roundup > code
annotate INSTALL.txt @ 656:eae9b69a0115
[SF#527416] roundup-admin uses undefined value
[SF#527503] unfriendly init blowup when parent dir
(also handles UsageError correctly now in init)
| author | Richard Jones <richard@users.sourceforge.net> |
|---|---|
| date | Tue, 12 Mar 2002 22:51:47 +0000 |
| parents | bd07a077464e |
| children |
| 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 |
|
503
25f2a3405739
Fix requirements in INSTALL.
Engelbert Gruber <grubert@users.sourceforge.net>
parents:
438
diff
changeset
|
7 that these systems don't come with python 2.1.1 or newer installed, so you'll |
|
94
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 ------------- |
|
503
25f2a3405739
Fix requirements in INSTALL.
Engelbert Gruber <grubert@users.sourceforge.net>
parents:
438
diff
changeset
|
13 Python 2.1.1 or newer. |
|
25f2a3405739
Fix requirements in INSTALL.
Engelbert Gruber <grubert@users.sourceforge.net>
parents:
438
diff
changeset
|
14 |
|
25f2a3405739
Fix requirements in INSTALL.
Engelbert Gruber <grubert@users.sourceforge.net>
parents:
438
diff
changeset
|
15 Note: Python 2.1.1 shipped with SuSE7.3 might miss module _weakref. |
|
94
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
16 |
|
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
17 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
|
18 |
|
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 Testing the Software |
|
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
21 -------------------- |
|
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
22 |
|
597
43046d1b2dd5
mention run_tests in "Testing the Software".
Engelbert Gruber <grubert@users.sourceforge.net>
parents:
503
diff
changeset
|
23 Either run "run_tests" or "python -c 'import test;test.go()'" and make sure |
|
43046d1b2dd5
mention run_tests in "Testing the Software".
Engelbert Gruber <grubert@users.sourceforge.net>
parents:
503
diff
changeset
|
24 there's no errors. If there are errors, please let us know! |
|
94
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
25 |
|
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
26 Installing the Software |
|
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 |
|
101
f55b8be00de5
more notes for installation
Richard Jones <richard@users.sourceforge.net>
parents:
94
diff
changeset
|
29 1. Run: |
|
f55b8be00de5
more notes for installation
Richard Jones <richard@users.sourceforge.net>
parents:
94
diff
changeset
|
30 |
|
f55b8be00de5
more notes for installation
Richard Jones <richard@users.sourceforge.net>
parents:
94
diff
changeset
|
31 python setup.py install |
|
f55b8be00de5
more notes for installation
Richard Jones <richard@users.sourceforge.net>
parents:
94
diff
changeset
|
32 |
|
102
0b250446cf8b
Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents:
101
diff
changeset
|
33 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
|
34 /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
|
35 |
|
0b250446cf8b
Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents:
101
diff
changeset
|
36 python setup.py install --install-scripts=<dir> |
|
101
f55b8be00de5
more notes for installation
Richard Jones <richard@users.sourceforge.net>
parents:
94
diff
changeset
|
37 |
|
102
0b250446cf8b
Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents:
101
diff
changeset
|
38 The command: |
|
0b250446cf8b
Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents:
101
diff
changeset
|
39 |
|
0b250446cf8b
Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents:
101
diff
changeset
|
40 python setup.py install --help |
|
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 gives all the options available for installation. |
|
94
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
43 |
|
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
44 |
|
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 Initial Setup |
|
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 |
|
102
0b250446cf8b
Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents:
101
diff
changeset
|
49 The following instructions assume that you have installed roundup. If you |
|
620
bd07a077464e
Altered to include correct invocation for when roundup isn't installed.
Richard Jones <richard@users.sourceforge.net>
parents:
597
diff
changeset
|
50 haven't, you may still proceed - the commands will change though. Where you |
|
bd07a077464e
Altered to include correct invocation for when roundup isn't installed.
Richard Jones <richard@users.sourceforge.net>
parents:
597
diff
changeset
|
51 see: |
|
bd07a077464e
Altered to include correct invocation for when roundup isn't installed.
Richard Jones <richard@users.sourceforge.net>
parents:
597
diff
changeset
|
52 |
|
bd07a077464e
Altered to include correct invocation for when roundup isn't installed.
Richard Jones <richard@users.sourceforge.net>
parents:
597
diff
changeset
|
53 roundup-admin init |
|
bd07a077464e
Altered to include correct invocation for when roundup isn't installed.
Richard Jones <richard@users.sourceforge.net>
parents:
597
diff
changeset
|
54 |
|
bd07a077464e
Altered to include correct invocation for when roundup isn't installed.
Richard Jones <richard@users.sourceforge.net>
parents:
597
diff
changeset
|
55 you will need to execute: |
|
bd07a077464e
Altered to include correct invocation for when roundup isn't installed.
Richard Jones <richard@users.sourceforge.net>
parents:
597
diff
changeset
|
56 |
|
bd07a077464e
Altered to include correct invocation for when roundup isn't installed.
Richard Jones <richard@users.sourceforge.net>
parents:
597
diff
changeset
|
57 PYTHONPATH=. python roundup/scripts/roundup_admin.py init |
|
bd07a077464e
Altered to include correct invocation for when roundup isn't installed.
Richard Jones <richard@users.sourceforge.net>
parents:
597
diff
changeset
|
58 |
|
bd07a077464e
Altered to include correct invocation for when roundup isn't installed.
Richard Jones <richard@users.sourceforge.net>
parents:
597
diff
changeset
|
59 where "python" is your python 2.x interpreter ("python2" on redhat |
|
bd07a077464e
Altered to include correct invocation for when roundup isn't installed.
Richard Jones <richard@users.sourceforge.net>
parents:
597
diff
changeset
|
60 systems). Note the dash is changed to an underscore - the same pattern |
|
bd07a077464e
Altered to include correct invocation for when roundup isn't installed.
Richard Jones <richard@users.sourceforge.net>
parents:
597
diff
changeset
|
61 holds for the roundup-server and roundup-mailgw scripts. |
|
102
0b250446cf8b
Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents:
101
diff
changeset
|
62 |
|
0b250446cf8b
Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents:
101
diff
changeset
|
63 |
|
94
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
64 Instance |
|
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
65 -------- |
|
102
0b250446cf8b
Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents:
101
diff
changeset
|
66 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
|
67 |
|
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
68 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
|
69 It may have the following variable declarations: |
|
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 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
|
72 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
|
73 |
|
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
74 Any further configuration should be possible by editing the instance home's |
|
431
a28a80b714f9
Eliminate database close method by using weakrefs.
Richard Jones <richard@users.sourceforge.net>
parents:
370
diff
changeset
|
75 instance_config.py directly. |
|
94
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 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
|
78 |
|
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
79 issue_tracker@MAIL_DOMAIN - submissions of issues |
|
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
80 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
|
81 |
|
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
82 |
|
236
8827f5931ea8
Fixed CGI client change messages...
Richard Jones <richard@users.sourceforge.net>
parents:
219
diff
changeset
|
83 Note: |
|
8827f5931ea8
Fixed CGI client change messages...
Richard Jones <richard@users.sourceforge.net>
parents:
219
diff
changeset
|
84 We run the instance as group "issue_tracker" and add the mail and web user |
|
8827f5931ea8
Fixed CGI client change messages...
Richard Jones <richard@users.sourceforge.net>
parents:
219
diff
changeset
|
85 ("mail" and "apache" on our RedHat 7.1 system) to that group, as well as |
|
8827f5931ea8
Fixed CGI client change messages...
Richard Jones <richard@users.sourceforge.net>
parents:
219
diff
changeset
|
86 any admin people. |
|
8827f5931ea8
Fixed CGI client change messages...
Richard Jones <richard@users.sourceforge.net>
parents:
219
diff
changeset
|
87 |
|
8827f5931ea8
Fixed CGI client change messages...
Richard Jones <richard@users.sourceforge.net>
parents:
219
diff
changeset
|
88 |
|
94
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
89 Mail |
|
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
90 ---- |
|
370
745f9cacfba0
Info on setting up a local spool handling mail gateway.
Richard Jones <richard@users.sourceforge.net>
parents:
361
diff
changeset
|
91 |
|
745f9cacfba0
Info on setting up a local spool handling mail gateway.
Richard Jones <richard@users.sourceforge.net>
parents:
361
diff
changeset
|
92 Setup 1: As a mail alias pipe process |
|
745f9cacfba0
Info on setting up a local spool handling mail gateway.
Richard Jones <richard@users.sourceforge.net>
parents:
361
diff
changeset
|
93 - - - - - - - - - - - - - - - - - - - |
|
94
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
94 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
|
95 "|/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
|
96 |
|
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
97 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
|
98 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
|
99 /etc/smrsh/roundup-mailgw to /usr/local/bin/roundup-mailgw and change the |
|
438
9d97c1a4ddad
Notes from changes.
Richard Jones <richard@users.sourceforge.net>
parents:
431
diff
changeset
|
100 command to (include the quote marks): |
|
217
b02a69130c91
more install note changes
Richard Jones <richard@users.sourceforge.net>
parents:
216
diff
changeset
|
101 "|roundup-mailgw <instance_home>" |
|
94
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
102 |
|
219
2482585afdbb
included some instructions on how to test mailgw
Richard Jones <richard@users.sourceforge.net>
parents:
217
diff
changeset
|
103 To test the mail gateway on unix systems, try: |
|
2482585afdbb
included some instructions on how to test mailgw
Richard Jones <richard@users.sourceforge.net>
parents:
217
diff
changeset
|
104 |
|
2482585afdbb
included some instructions on how to test mailgw
Richard Jones <richard@users.sourceforge.net>
parents:
217
diff
changeset
|
105 echo test |mail -s '[issue] test' issue_tracker@your.domain |
|
2482585afdbb
included some instructions on how to test mailgw
Richard Jones <richard@users.sourceforge.net>
parents:
217
diff
changeset
|
106 |
|
2482585afdbb
included some instructions on how to test mailgw
Richard Jones <richard@users.sourceforge.net>
parents:
217
diff
changeset
|
107 |
|
370
745f9cacfba0
Info on setting up a local spool handling mail gateway.
Richard Jones <richard@users.sourceforge.net>
parents:
361
diff
changeset
|
108 Setup 2: As a regular cron job |
|
745f9cacfba0
Info on setting up a local spool handling mail gateway.
Richard Jones <richard@users.sourceforge.net>
parents:
361
diff
changeset
|
109 - - - - - - - - - - - - - - - |
|
745f9cacfba0
Info on setting up a local spool handling mail gateway.
Richard Jones <richard@users.sourceforge.net>
parents:
361
diff
changeset
|
110 Set the roundup-mailgw up to run every 10 minutes or so. For example: |
|
745f9cacfba0
Info on setting up a local spool handling mail gateway.
Richard Jones <richard@users.sourceforge.net>
parents:
361
diff
changeset
|
111 10 * * * * /usr/local/bin/roundup-mailgw <instance_home> <mail_spool_file> |
|
745f9cacfba0
Info on setting up a local spool handling mail gateway.
Richard Jones <richard@users.sourceforge.net>
parents:
361
diff
changeset
|
112 |
|
745f9cacfba0
Info on setting up a local spool handling mail gateway.
Richard Jones <richard@users.sourceforge.net>
parents:
361
diff
changeset
|
113 Where the mail_spool_file argument is the location of the roundup |
|
745f9cacfba0
Info on setting up a local spool handling mail gateway.
Richard Jones <richard@users.sourceforge.net>
parents:
361
diff
changeset
|
114 submission user's mail spool. On most systems, the spool for a user |
|
745f9cacfba0
Info on setting up a local spool handling mail gateway.
Richard Jones <richard@users.sourceforge.net>
parents:
361
diff
changeset
|
115 "issue_tracker" will be "/var/mail/issue_tracker". |
|
745f9cacfba0
Info on setting up a local spool handling mail gateway.
Richard Jones <richard@users.sourceforge.net>
parents:
361
diff
changeset
|
116 |
|
745f9cacfba0
Info on setting up a local spool handling mail gateway.
Richard Jones <richard@users.sourceforge.net>
parents:
361
diff
changeset
|
117 |
|
94
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
118 |
|
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
119 Web Interface |
|
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
120 ------------- |
|
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
121 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
|
122 |
|
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
123 Stand-alone: |
|
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
124 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
|
125 about your instance. |
|
102
0b250446cf8b
Fixed some problems with installation.
Richard Jones <richard@users.sourceforge.net>
parents:
101
diff
changeset
|
126 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
|
127 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
|
128 name you nominated in ROUNDUP_INSTANCE_HOMES. |
|
94
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
129 |
|
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
130 Apache: |
|
328
ff35f683fc9d
Fixed manifest template
Richard Jones <richard@users.sourceforge.net>
parents:
236
diff
changeset
|
131 1. The CGI script is found in the cgi-bin directory of the roundup |
|
ff35f683fc9d
Fixed manifest template
Richard Jones <richard@users.sourceforge.net>
parents:
236
diff
changeset
|
132 distribution. |
|
ff35f683fc9d
Fixed manifest template
Richard Jones <richard@users.sourceforge.net>
parents:
236
diff
changeset
|
133 2. Make sure roundup.cgi is executable. Edit it at the top - |
|
94
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
134 ROUNDUP_INSTANCE_HOMES needs to know about your instance. |
|
328
ff35f683fc9d
Fixed manifest template
Richard Jones <richard@users.sourceforge.net>
parents:
236
diff
changeset
|
135 3. Edit your /etc/httpd/conf/httpd.conf and make sure that the |
|
94
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
136 /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
|
137 script. |
|
328
ff35f683fc9d
Fixed manifest template
Richard Jones <richard@users.sourceforge.net>
parents:
236
diff
changeset
|
138 4. Re-start your apache to re-load the config if necessary. |
|
216
dbb35b638e88
further clarification for gettnig started
Richard Jones <richard@users.sourceforge.net>
parents:
209
diff
changeset
|
139 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
|
140 instance name is the name you nominated in ROUNDUP_INSTANCE_HOMES. |
|
359
3903aaaef4e1
Added samples for "external" CGI config
Jürgen Hermann <jhermann@users.sourceforge.net>
parents:
328
diff
changeset
|
141 6. To use the CGI script unchanged, which allows much easier updates, |
|
3903aaaef4e1
Added samples for "external" CGI config
Jürgen Hermann <jhermann@users.sourceforge.net>
parents:
328
diff
changeset
|
142 add these directives to your "httpd.conf": |
|
3903aaaef4e1
Added samples for "external" CGI config
Jürgen Hermann <jhermann@users.sourceforge.net>
parents:
328
diff
changeset
|
143 SetEnv ROUNDUP_LOG "/var/log/roundup.log" |
|
361
5a1c284dabea
Changed samples to use "share/roundup" paths
Jürgen Hermann <jhermann@users.sourceforge.net>
parents:
359
diff
changeset
|
144 SetEnv ROUNDUP_INSTANCE_HOMES "Default=/usr/local/share/roundup/instances/Default" |
|
359
3903aaaef4e1
Added samples for "external" CGI config
Jürgen Hermann <jhermann@users.sourceforge.net>
parents:
328
diff
changeset
|
145 SetEnv ROUNDUP_DEBUG "0" |
|
3903aaaef4e1
Added samples for "external" CGI config
Jürgen Hermann <jhermann@users.sourceforge.net>
parents:
328
diff
changeset
|
146 7. On Windows, write a batch file "roundup.bat" similar to the one below |
|
3903aaaef4e1
Added samples for "external" CGI config
Jürgen Hermann <jhermann@users.sourceforge.net>
parents:
328
diff
changeset
|
147 and place it into your cgi-bin directory: |
|
3903aaaef4e1
Added samples for "external" CGI config
Jürgen Hermann <jhermann@users.sourceforge.net>
parents:
328
diff
changeset
|
148 @echo off |
|
361
5a1c284dabea
Changed samples to use "share/roundup" paths
Jürgen Hermann <jhermann@users.sourceforge.net>
parents:
359
diff
changeset
|
149 set ROUNDUP_LOG=c:\Python21\share\roundup\cgi.log |
|
5a1c284dabea
Changed samples to use "share/roundup" paths
Jürgen Hermann <jhermann@users.sourceforge.net>
parents:
359
diff
changeset
|
150 set ROUNDUP_INSTANCE_HOMES=Default=c:\Python21\share\roundup\instances\Default; |
|
359
3903aaaef4e1
Added samples for "external" CGI config
Jürgen Hermann <jhermann@users.sourceforge.net>
parents:
328
diff
changeset
|
151 set ROUNDUP_DEBUG=0 |
|
361
5a1c284dabea
Changed samples to use "share/roundup" paths
Jürgen Hermann <jhermann@users.sourceforge.net>
parents:
359
diff
changeset
|
152 c:\Python21\python.exe c:\Python21\share\roundup\cgi-bin\roundup.cgi |
|
94
9cf5229397fc
name changes to make distutils happy
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
153 |
