Mercurial > p > roundup > code
annotate doc/installation.txt @ 6419:4d321d52d67d
fix broken link for pyopenssl
| author | John Rouillard <rouilj@ieee.org> |
|---|---|
| date | Sun, 23 May 2021 13:52:09 -0400 |
| parents | 205bc1d27985 |
| children | 8f1b91756457 |
| rev | line source |
|---|---|
|
6168
de9d602c8ce6
more index entries and CHANGES.txt update for them.
John Rouillard <rouilj@ieee.org>
parents:
6163
diff
changeset
|
1 .. index:: Installation |
|
de9d602c8ce6
more index entries and CHANGES.txt update for them.
John Rouillard <rouilj@ieee.org>
parents:
6163
diff
changeset
|
2 |
|
688
b38f4f95bffd
More doc tweaks
Richard Jones <richard@users.sourceforge.net>
parents:
686
diff
changeset
|
3 ================== |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
4 Installing Roundup |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
5 ================== |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
6 |
|
686
c52122f38c9b
Documentation cleanup, added info for potential (and current) developers
Richard Jones <richard@users.sourceforge.net>
parents:
659
diff
changeset
|
7 .. contents:: |
| 2409 | 8 :depth: 2 |
|
4890
609edf9de0a5
docs: Remove one nesting level from ToC on subpages
anatoly techtonik <techtonik@gmail.com>
parents:
4792
diff
changeset
|
9 :local: |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
10 |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
11 |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
12 Overview |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
13 ======== |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
14 |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
15 Broken out separately, there are several conceptual pieces to a |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
16 Roundup installation: |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
17 |
|
1221
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
18 Roundup trackers |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
19 Trackers consist of issues (be they bug reports or otherwise), tracker |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
20 configuration file(s), web HTML files etc. Roundup trackers are initialised |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
21 with a "Template" which defines the fields usable/assignable on a |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
22 per-issue basis. Descriptions of the provided templates are given in |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
23 `choosing your template`_. |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
24 |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
25 Roundup support code |
|
3297
8f7dc283bfa5
some more Xapian stuff (doc, test fixes)
Richard Jones <richard@users.sourceforge.net>
parents:
3296
diff
changeset
|
26 Installed into your Python install's lib directory. |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
27 |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
28 Roundup scripts |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
29 These include the email gateway, the roundup |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
30 HTTP server, the roundup administration command-line interface, etc. |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
31 |
|
1218
4c9882cb16a3
more docco work
Richard Jones <richard@users.sourceforge.net>
parents:
1170
diff
changeset
|
32 |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
33 Prerequisites |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
34 ============= |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
35 |
|
5526
df3f553fa414
Update documentation for Python 3 support (issue 2550968, issue 2550980).
Joseph Myers <jsm@polyomino.org.uk>
parents:
5510
diff
changeset
|
36 Roundup requires Python 2.7 or 3.4 or newer with a functioning |
|
5756
e48b039b0ec0
issue2550966: fix suboptimal links in docs.
John Rouillard <rouilj@ieee.org>
parents:
5610
diff
changeset
|
37 anydbm module. Download the latest version from https://www.python.org/. |
|
1965
43e1f2457bf2
info about how roundup is installed
Richard Jones <richard@users.sourceforge.net>
parents:
1939
diff
changeset
|
38 It is highly recommended that users install the latest patch version |
|
43e1f2457bf2
info about how roundup is installed
Richard Jones <richard@users.sourceforge.net>
parents:
1939
diff
changeset
|
39 of python as these contain many fixes to serious bugs. |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
40 |
|
3421
0d9406d14186
MySQL now creates String columns using the TEXT column type
Richard Jones <richard@users.sourceforge.net>
parents:
3417
diff
changeset
|
41 Some variants of Linux will need an additional "python dev" package |
|
0d9406d14186
MySQL now creates String columns using the TEXT column type
Richard Jones <richard@users.sourceforge.net>
parents:
3417
diff
changeset
|
42 installed for Roundup installation to work. Debian and derivatives, are |
|
0d9406d14186
MySQL now creates String columns using the TEXT column type
Richard Jones <richard@users.sourceforge.net>
parents:
3417
diff
changeset
|
43 known to require this. |
|
0d9406d14186
MySQL now creates String columns using the TEXT column type
Richard Jones <richard@users.sourceforge.net>
parents:
3417
diff
changeset
|
44 |
|
5140
7ea6bbf4286c
update docs for windows installer: 32 bit version of python, must run nstaller as administrator, ned pywin32 to run as service. Encourage installation of pytz.
John Rouillard <rouilj@ieee.org>
parents:
5138
diff
changeset
|
45 If you are using the Roundup Windows installer on a 64 bit system and |
|
7ea6bbf4286c
update docs for windows installer: 32 bit version of python, must run nstaller as administrator, ned pywin32 to run as service. Encourage installation of pytz.
John Rouillard <rouilj@ieee.org>
parents:
5138
diff
changeset
|
46 you get the error message:: |
|
7ea6bbf4286c
update docs for windows installer: 32 bit version of python, must run nstaller as administrator, ned pywin32 to run as service. Encourage installation of pytz.
John Rouillard <rouilj@ieee.org>
parents:
5138
diff
changeset
|
47 |
|
7ea6bbf4286c
update docs for windows installer: 32 bit version of python, must run nstaller as administrator, ned pywin32 to run as service. Encourage installation of pytz.
John Rouillard <rouilj@ieee.org>
parents:
5138
diff
changeset
|
48 "No Python installation found in the registry" |
|
7ea6bbf4286c
update docs for windows installer: 32 bit version of python, must run nstaller as administrator, ned pywin32 to run as service. Encourage installation of pytz.
John Rouillard <rouilj@ieee.org>
parents:
5138
diff
changeset
|
49 |
|
7ea6bbf4286c
update docs for windows installer: 32 bit version of python, must run nstaller as administrator, ned pywin32 to run as service. Encourage installation of pytz.
John Rouillard <rouilj@ieee.org>
parents:
5138
diff
changeset
|
50 you need to install a 32 bit version of python. The 64 bit versions |
|
7ea6bbf4286c
update docs for windows installer: 32 bit version of python, must run nstaller as administrator, ned pywin32 to run as service. Encourage installation of pytz.
John Rouillard <rouilj@ieee.org>
parents:
5138
diff
changeset
|
51 use a different registry key that the installer doesn't detect. See: |
|
5610
0df5f9eeefd4
Changed references to http://issues.roundup-tracker.org to https now
John Rouillard <rouilj@ieee.org>
parents:
5526
diff
changeset
|
52 https://issues.roundup-tracker.org/issue2550718 for details. |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
53 |
|
3296
d5fa5a0b5216
some minimalist docs for Xapian
Richard Jones <richard@users.sourceforge.net>
parents:
3153
diff
changeset
|
54 Optional Components |
|
d5fa5a0b5216
some minimalist docs for Xapian
Richard Jones <richard@users.sourceforge.net>
parents:
3153
diff
changeset
|
55 =================== |
|
d5fa5a0b5216
some minimalist docs for Xapian
Richard Jones <richard@users.sourceforge.net>
parents:
3153
diff
changeset
|
56 |
|
3297
8f7dc283bfa5
some more Xapian stuff (doc, test fixes)
Richard Jones <richard@users.sourceforge.net>
parents:
3296
diff
changeset
|
57 You may optionally install and use: |
|
3296
d5fa5a0b5216
some minimalist docs for Xapian
Richard Jones <richard@users.sourceforge.net>
parents:
3153
diff
changeset
|
58 |
|
3623
bef78d81b79c
added optional prerequisite: pytz
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3571
diff
changeset
|
59 Timezone Definitions |
|
3731
e6ef9abfe403
fix pytz requirement version and download URL for latest package
Richard Jones <richard@users.sourceforge.net>
parents:
3730
diff
changeset
|
60 Full timezone support requires pytz_ module (version 2005i or later) |
|
3730
8e3b881060b4
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
3729
diff
changeset
|
61 which brings the `Olson tz database`_ into Python. If pytz_ is not |
|
8e3b881060b4
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
3729
diff
changeset
|
62 installed, timezones may be specified as numeric hour offsets only. |
|
5140
7ea6bbf4286c
update docs for windows installer: 32 bit version of python, must run nstaller as administrator, ned pywin32 to run as service. Encourage installation of pytz.
John Rouillard <rouilj@ieee.org>
parents:
5138
diff
changeset
|
63 This is optional but strongly suggested. |
|
5321
4566360871dc
Raises python requirement to 2.7.
Bernhard Reiter <bernhard@intevation.de>
parents:
5300
diff
changeset
|
64 |
|
3296
d5fa5a0b5216
some minimalist docs for Xapian
Richard Jones <richard@users.sourceforge.net>
parents:
3153
diff
changeset
|
65 An RDBMS |
|
d5fa5a0b5216
some minimalist docs for Xapian
Richard Jones <richard@users.sourceforge.net>
parents:
3153
diff
changeset
|
66 Sqlite, MySQL and Postgresql are all supported by Roundup and will be |
|
d5fa5a0b5216
some minimalist docs for Xapian
Richard Jones <richard@users.sourceforge.net>
parents:
3153
diff
changeset
|
67 used if available. One of these is recommended if you are anticipating a |
|
d5fa5a0b5216
some minimalist docs for Xapian
Richard Jones <richard@users.sourceforge.net>
parents:
3153
diff
changeset
|
68 large user base (see `choosing your backend`_ below). |
|
3297
8f7dc283bfa5
some more Xapian stuff (doc, test fixes)
Richard Jones <richard@users.sourceforge.net>
parents:
3296
diff
changeset
|
69 |
|
6174
5522c950a2e4
Add indexing for roundup-admin references.
John Rouillard <rouilj@ieee.org>
parents:
6168
diff
changeset
|
70 .. index:: roundup-admin:: reindex subcommand |
|
5522c950a2e4
Add indexing for roundup-admin references.
John Rouillard <rouilj@ieee.org>
parents:
6168
diff
changeset
|
71 |
|
3296
d5fa5a0b5216
some minimalist docs for Xapian
Richard Jones <richard@users.sourceforge.net>
parents:
3153
diff
changeset
|
72 Xapian full-text indexer |
|
d5fa5a0b5216
some minimalist docs for Xapian
Richard Jones <richard@users.sourceforge.net>
parents:
3153
diff
changeset
|
73 The Xapian_ full-text indexer is also supported and will be used by |
|
d5fa5a0b5216
some minimalist docs for Xapian
Richard Jones <richard@users.sourceforge.net>
parents:
3153
diff
changeset
|
74 default if it is available. This is strongly recommended if you are |
|
3417
07c696890f55
mailgw subject parsing has configurable levels of strictness
Richard Jones <richard@users.sourceforge.net>
parents:
3405
diff
changeset
|
75 anticipating a large number of issues (> 5000). |
|
3296
d5fa5a0b5216
some minimalist docs for Xapian
Richard Jones <richard@users.sourceforge.net>
parents:
3153
diff
changeset
|
76 |
|
3297
8f7dc283bfa5
some more Xapian stuff (doc, test fixes)
Richard Jones <richard@users.sourceforge.net>
parents:
3296
diff
changeset
|
77 You may install Xapian at any time, even after a tracker has been |
|
8f7dc283bfa5
some more Xapian stuff (doc, test fixes)
Richard Jones <richard@users.sourceforge.net>
parents:
3296
diff
changeset
|
78 installed and used. You will need to run the "roundup-admin reindex" |
|
8f7dc283bfa5
some more Xapian stuff (doc, test fixes)
Richard Jones <richard@users.sourceforge.net>
parents:
3296
diff
changeset
|
79 command if the tracker has existing data. |
|
8f7dc283bfa5
some more Xapian stuff (doc, test fixes)
Richard Jones <richard@users.sourceforge.net>
parents:
3296
diff
changeset
|
80 |
|
4378
477f2a47cbca
- Indexer Xapian, made Xapian 1.2 compatible.
Bernhard Reiter <Bernhard.Reiter@intevation.de>
parents:
4355
diff
changeset
|
81 Roundup requires Xapian 1.0.0 or newer. |
|
3485
8d55b5db6365
xapian works, if you poke it enough
Richard Jones <richard@users.sourceforge.net>
parents:
3447
diff
changeset
|
82 |
|
5108
67fad01d2009
issue2550653: xapian search, stemming is not working
John Rouillard <rouilj@ieee.org>
parents:
5096
diff
changeset
|
83 Note that capitalization is not preserved by the Xapian search. |
|
67fad01d2009
issue2550653: xapian search, stemming is not working
John Rouillard <rouilj@ieee.org>
parents:
5096
diff
changeset
|
84 This is required to make the porter stemmer work so that searching |
|
67fad01d2009
issue2550653: xapian search, stemming is not working
John Rouillard <rouilj@ieee.org>
parents:
5096
diff
changeset
|
85 for silent also returns documents with the word silently. Note that |
|
67fad01d2009
issue2550653: xapian search, stemming is not working
John Rouillard <rouilj@ieee.org>
parents:
5096
diff
changeset
|
86 the current stemming implementation is designed for English. |
|
67fad01d2009
issue2550653: xapian search, stemming is not working
John Rouillard <rouilj@ieee.org>
parents:
5096
diff
changeset
|
87 |
|
5096
e74c3611b138
- issue2550636, issue2550909: Added support for Whoosh indexer.
John Rouillard <rouilj@ieee.org>
parents:
5083
diff
changeset
|
88 Whoosh full-text indexer |
|
e74c3611b138
- issue2550636, issue2550909: Added support for Whoosh indexer.
John Rouillard <rouilj@ieee.org>
parents:
5083
diff
changeset
|
89 The Whoosh_ full-text indexer is also supported and will be used by |
|
e74c3611b138
- issue2550636, issue2550909: Added support for Whoosh indexer.
John Rouillard <rouilj@ieee.org>
parents:
5083
diff
changeset
|
90 default if it is available (and Xapian is not installed). This is |
|
e74c3611b138
- issue2550636, issue2550909: Added support for Whoosh indexer.
John Rouillard <rouilj@ieee.org>
parents:
5083
diff
changeset
|
91 recommended if you are anticipating a large number of issues (> 5000). |
|
e74c3611b138
- issue2550636, issue2550909: Added support for Whoosh indexer.
John Rouillard <rouilj@ieee.org>
parents:
5083
diff
changeset
|
92 |
|
e74c3611b138
- issue2550636, issue2550909: Added support for Whoosh indexer.
John Rouillard <rouilj@ieee.org>
parents:
5083
diff
changeset
|
93 You may install Whoosh at any time, even after a tracker has been |
|
e74c3611b138
- issue2550636, issue2550909: Added support for Whoosh indexer.
John Rouillard <rouilj@ieee.org>
parents:
5083
diff
changeset
|
94 installed and used. You will need to run the "roundup-admin reindex" |
|
e74c3611b138
- issue2550636, issue2550909: Added support for Whoosh indexer.
John Rouillard <rouilj@ieee.org>
parents:
5083
diff
changeset
|
95 command if the tracker has existing data. |
|
e74c3611b138
- issue2550636, issue2550909: Added support for Whoosh indexer.
John Rouillard <rouilj@ieee.org>
parents:
5083
diff
changeset
|
96 |
|
e74c3611b138
- issue2550636, issue2550909: Added support for Whoosh indexer.
John Rouillard <rouilj@ieee.org>
parents:
5083
diff
changeset
|
97 Roundup was tested with Whoosh 2.5.7, but earlier versions in the |
|
e74c3611b138
- issue2550636, issue2550909: Added support for Whoosh indexer.
John Rouillard <rouilj@ieee.org>
parents:
5083
diff
changeset
|
98 2.0 series may work. Whoosh is a pure python indexer so it is slower |
|
e74c3611b138
- issue2550636, issue2550909: Added support for Whoosh indexer.
John Rouillard <rouilj@ieee.org>
parents:
5083
diff
changeset
|
99 than Xapian, but should be useful for moderately sized trackers. |
|
e74c3611b138
- issue2550636, issue2550909: Added support for Whoosh indexer.
John Rouillard <rouilj@ieee.org>
parents:
5083
diff
changeset
|
100 It uses the StandardAnalyzer which is suited for Western languages. |
|
e74c3611b138
- issue2550636, issue2550909: Added support for Whoosh indexer.
John Rouillard <rouilj@ieee.org>
parents:
5083
diff
changeset
|
101 |
|
3885
d4163100f4f3
add pyopenssl to optional components
Justus Pendleton <jpend@users.sourceforge.net>
parents:
3830
diff
changeset
|
102 pyopenssl |
|
d4163100f4f3
add pyopenssl to optional components
Justus Pendleton <jpend@users.sourceforge.net>
parents:
3830
diff
changeset
|
103 If pyopenssl_ is installed the roundup-server can be configured |
|
d4163100f4f3
add pyopenssl to optional components
Justus Pendleton <jpend@users.sourceforge.net>
parents:
3830
diff
changeset
|
104 to serve trackers over SSL. If you are going to serve roundup via |
|
d4163100f4f3
add pyopenssl to optional components
Justus Pendleton <jpend@users.sourceforge.net>
parents:
3830
diff
changeset
|
105 proxy through a server with SSL support (e.g. apache) then this is |
|
d4163100f4f3
add pyopenssl to optional components
Justus Pendleton <jpend@users.sourceforge.net>
parents:
3830
diff
changeset
|
106 unnecessary. |
|
d4163100f4f3
add pyopenssl to optional components
Justus Pendleton <jpend@users.sourceforge.net>
parents:
3830
diff
changeset
|
107 |
|
5494
b7fa56ced601
use gpg module instead of pyme module for PGP encryption
Christof Meerwald <cmeerw@cmeerw.org>
parents:
5486
diff
changeset
|
108 gpg |
|
b7fa56ced601
use gpg module instead of pyme module for PGP encryption
Christof Meerwald <cmeerw@cmeerw.org>
parents:
5486
diff
changeset
|
109 If gpg_ is installed you can configure the mail gateway to perform |
|
3922
586679a314f7
role checking for PGP mail and docs
Justus Pendleton <jpend@users.sourceforge.net>
parents:
3885
diff
changeset
|
110 verification or decryption of incoming OpenPGP MIME messages. When |
|
586679a314f7
role checking for PGP mail and docs
Justus Pendleton <jpend@users.sourceforge.net>
parents:
3885
diff
changeset
|
111 configured, you can require email to be cryptographically signed |
|
586679a314f7
role checking for PGP mail and docs
Justus Pendleton <jpend@users.sourceforge.net>
parents:
3885
diff
changeset
|
112 before roundup will allow it to make modifications to issues. |
|
586679a314f7
role checking for PGP mail and docs
Justus Pendleton <jpend@users.sourceforge.net>
parents:
3885
diff
changeset
|
113 |
|
5013
c1443d96ac94
jinja2: optional requirement added to installation.txt and link to wiki page.
Bernhard Reiter <bernhard@intevation.de>
parents:
4949
diff
changeset
|
114 jinja2 |
|
c1443d96ac94
jinja2: optional requirement added to installation.txt and link to wiki page.
Bernhard Reiter <bernhard@intevation.de>
parents:
4949
diff
changeset
|
115 To use the jinja2 template (may still be experimental, check out |
|
c1443d96ac94
jinja2: optional requirement added to installation.txt and link to wiki page.
Bernhard Reiter <bernhard@intevation.de>
parents:
4949
diff
changeset
|
116 its TEMPLATE-INFO.txt file) you need |
|
c1443d96ac94
jinja2: optional requirement added to installation.txt and link to wiki page.
Bernhard Reiter <bernhard@intevation.de>
parents:
4949
diff
changeset
|
117 to have the jinja2_ template engine installed. |
|
c1443d96ac94
jinja2: optional requirement added to installation.txt and link to wiki page.
Bernhard Reiter <bernhard@intevation.de>
parents:
4949
diff
changeset
|
118 |
|
5878
1b57d8f3eb97
Add rudimentery experiment JSON Web Token (jwt) support
John Rouillard <rouilj@ieee.org>
parents:
5756
diff
changeset
|
119 pyjwt |
|
6391
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
120 To use jwt tokens for login (experimental), install `pyjwt`_ |
|
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
121 (v1.7.1, v2.0.1 tested). If you don't have it installed, jwt |
|
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
122 tokens are not supported. |
|
5911
133efe1fbff7
doc/installation.txt: replace tabs, remove trailing spaces
Thomas Arendsen Hein <thomas@intevation.de>
parents:
5910
diff
changeset
|
123 |
|
6097
90a1470edbea
added markdown rendering support using either markdown2 or markdown
Christof Meerwald <cmeerw@cmeerw.org>
parents:
5940
diff
changeset
|
124 docutils |
|
6391
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
125 To use ReStructuredText rendering you need to have the `docutils`_ |
|
6097
90a1470edbea
added markdown rendering support using either markdown2 or markdown
Christof Meerwald <cmeerw@cmeerw.org>
parents:
5940
diff
changeset
|
126 package installed. |
|
90a1470edbea
added markdown rendering support using either markdown2 or markdown
Christof Meerwald <cmeerw@cmeerw.org>
parents:
5940
diff
changeset
|
127 |
|
6099
55c56ceacb8e
escape HTML tags in markdown content
Christof Meerwald <cmeerw@cmeerw.org>
parents:
6097
diff
changeset
|
128 markdown, markdown2 or mistune |
|
6391
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
129 To use markdown rendering you need to have the markdown_, markdown2_ |
|
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
130 or mistune_ (v0.8.4 tested) package installed. |
|
6097
90a1470edbea
added markdown rendering support using either markdown2 or markdown
Christof Meerwald <cmeerw@cmeerw.org>
parents:
5940
diff
changeset
|
131 |
|
4686
4e740f02e165
Remove pywin32 installation dependency by porting portalocker.py to ctypes.
anatoly techtonik <techtonik@gmail.com>
parents:
4672
diff
changeset
|
132 Windows Service |
|
4e740f02e165
Remove pywin32 installation dependency by porting portalocker.py to ctypes.
anatoly techtonik <techtonik@gmail.com>
parents:
4672
diff
changeset
|
133 You can run Roundup as a Windows service if pywin32_ is installed. |
|
5140
7ea6bbf4286c
update docs for windows installer: 32 bit version of python, must run nstaller as administrator, ned pywin32 to run as service. Encourage installation of pytz.
John Rouillard <rouilj@ieee.org>
parents:
5138
diff
changeset
|
134 Otherwise it must be started manually. |
|
4686
4e740f02e165
Remove pywin32 installation dependency by porting portalocker.py to ctypes.
anatoly techtonik <techtonik@gmail.com>
parents:
4672
diff
changeset
|
135 |
|
998
a1922b2521a7
reordering to make a little more sense
Richard Jones <richard@users.sourceforge.net>
parents:
991
diff
changeset
|
136 Getting Roundup |
|
a1922b2521a7
reordering to make a little more sense
Richard Jones <richard@users.sourceforge.net>
parents:
991
diff
changeset
|
137 =============== |
|
a1922b2521a7
reordering to make a little more sense
Richard Jones <richard@users.sourceforge.net>
parents:
991
diff
changeset
|
138 |
|
2742
8ac87d4092e2
more install doc tweaks
Richard Jones <richard@users.sourceforge.net>
parents:
2741
diff
changeset
|
139 .. note:: |
|
8ac87d4092e2
more install doc tweaks
Richard Jones <richard@users.sourceforge.net>
parents:
2741
diff
changeset
|
140 Some systems, such as Debian and NetBSD, already have Roundup |
|
8ac87d4092e2
more install doc tweaks
Richard Jones <richard@users.sourceforge.net>
parents:
2741
diff
changeset
|
141 installed. Try running the command "roundup-admin" with no arguments, |
|
8ac87d4092e2
more install doc tweaks
Richard Jones <richard@users.sourceforge.net>
parents:
2741
diff
changeset
|
142 and if it runs you may skip the `Basic Installation Steps`_ |
|
8ac87d4092e2
more install doc tweaks
Richard Jones <richard@users.sourceforge.net>
parents:
2741
diff
changeset
|
143 below and go straight to `configuring your first tracker`_. |
|
8ac87d4092e2
more install doc tweaks
Richard Jones <richard@users.sourceforge.net>
parents:
2741
diff
changeset
|
144 |
|
6265
b2eb59ada444
Replace http:....roundup-tracker.org with https. Also fix wiki links.
John Rouillard <rouilj@ieee.org>
parents:
6262
diff
changeset
|
145 Download the latest version from https://www.roundup-tracker.org/. |
|
998
a1922b2521a7
reordering to make a little more sense
Richard Jones <richard@users.sourceforge.net>
parents:
991
diff
changeset
|
146 |
|
1576
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
147 For The Really Impatient |
|
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
148 ======================== |
|
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
149 |
|
4688
80f9a1fbc0cc
doc: Remove WinZip tutorial and mention demo.py becoming 'roundup-demo'
anatoly techtonik <techtonik@gmail.com>
parents:
4686
diff
changeset
|
150 If you just want to give Roundup a whirl Right Now, then simply unpack |
|
80f9a1fbc0cc
doc: Remove WinZip tutorial and mention demo.py becoming 'roundup-demo'
anatoly techtonik <techtonik@gmail.com>
parents:
4686
diff
changeset
|
151 and run ``demo.py`` (it will be available as ``roundup-demo`` script |
|
80f9a1fbc0cc
doc: Remove WinZip tutorial and mention demo.py becoming 'roundup-demo'
anatoly techtonik <techtonik@gmail.com>
parents:
4686
diff
changeset
|
152 after installation). |
| 2401 | 153 |
|
3571
f0b1c8ff4a2a
Note: demo runs on localhost
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3528
diff
changeset
|
154 This will set up a simple demo tracker on your machine. [1]_ |
|
f0b1c8ff4a2a
Note: demo runs on localhost
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3528
diff
changeset
|
155 When it's done, it'll print out a URL to point your web browser at |
|
f0b1c8ff4a2a
Note: demo runs on localhost
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3528
diff
changeset
|
156 so you may start playing. Three users will be set up: |
|
1576
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
157 |
|
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
158 1. anonymous - the "default" user with permission to do very little |
|
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
159 2. demo (password "demo") - a normal user who may create issues |
|
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
160 3. admin (password "admin") - an administrative user who has complete |
|
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
161 access to the tracker |
|
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
162 |
|
3571
f0b1c8ff4a2a
Note: demo runs on localhost
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3528
diff
changeset
|
163 .. [1] Demo tracker is set up to be accessed by localhost browser. |
|
f0b1c8ff4a2a
Note: demo runs on localhost
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3528
diff
changeset
|
164 If you run demo on a server host, please stop the demo when |
|
f0b1c8ff4a2a
Note: demo runs on localhost
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3528
diff
changeset
|
165 it has shown startup notice, open file ``demo/config.ini`` with |
|
f0b1c8ff4a2a
Note: demo runs on localhost
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3528
diff
changeset
|
166 your editor, change host name in the ``web`` option in section |
|
f0b1c8ff4a2a
Note: demo runs on localhost
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3528
diff
changeset
|
167 ``[tracker]``, save the file, then re-run the demo program. |
|
1576
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
168 |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
169 Installation |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
170 ============ |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
171 |
|
2991
b9a55628a78d
more doc fixes
Richard Jones <richard@users.sourceforge.net>
parents:
2988
diff
changeset
|
172 Set aside 15-30 minutes. There's several steps to follow in your |
| 1228 | 173 installation: |
| 1049 | 174 |
|
1590
198dbefc1d5a
more installation doc cleanups
Richard Jones <richard@users.sourceforge.net>
parents:
1588
diff
changeset
|
175 1. `basic installation steps`_ if Roundup is not installed on your system |
|
198dbefc1d5a
more installation doc cleanups
Richard Jones <richard@users.sourceforge.net>
parents:
1588
diff
changeset
|
176 2. `configuring your first tracker`_ that all installers must follow |
|
198dbefc1d5a
more installation doc cleanups
Richard Jones <richard@users.sourceforge.net>
parents:
1588
diff
changeset
|
177 3. then optionally `configure a web interface`_ |
|
198dbefc1d5a
more installation doc cleanups
Richard Jones <richard@users.sourceforge.net>
parents:
1588
diff
changeset
|
178 4. and optionally `configure an email interface`_ |
|
1939
1303c208419d
some updates that were sitting on disk
Richard Jones <richard@users.sourceforge.net>
parents:
1913
diff
changeset
|
179 5. `UNIX environment steps`_ to take if you're installing on a shared |
|
1240
606522be902a
merged fix from maint-0-5
Richard Jones <richard@users.sourceforge.net>
parents:
1228
diff
changeset
|
180 UNIX machine and want to restrict local access to roundup |
| 1049 | 181 |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
1965
diff
changeset
|
182 For information about how Roundup installs, see the `administration |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
1965
diff
changeset
|
183 guide`_. |
|
1965
43e1f2457bf2
info about how roundup is installed
Richard Jones <richard@users.sourceforge.net>
parents:
1939
diff
changeset
|
184 |
|
5140
7ea6bbf4286c
update docs for windows installer: 32 bit version of python, must run nstaller as administrator, ned pywin32 to run as service. Encourage installation of pytz.
John Rouillard <rouilj@ieee.org>
parents:
5138
diff
changeset
|
185 The following assumes that you are using the source distribution. If |
|
7ea6bbf4286c
update docs for windows installer: 32 bit version of python, must run nstaller as administrator, ned pywin32 to run as service. Encourage installation of pytz.
John Rouillard <rouilj@ieee.org>
parents:
5138
diff
changeset
|
186 you are using the Windows installer, run it with Administrator |
|
7ea6bbf4286c
update docs for windows installer: 32 bit version of python, must run nstaller as administrator, ned pywin32 to run as service. Encourage installation of pytz.
John Rouillard <rouilj@ieee.org>
parents:
5138
diff
changeset
|
187 privileges so it can correctly update the registry. |
| 1049 | 188 |
| 189 Basic Installation Steps | |
|
1089
43ab730ee194
instance -> tracker, node -> item
Richard Jones <richard@users.sourceforge.net>
parents:
1078
diff
changeset
|
190 ------------------------ |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
191 |
|
1590
198dbefc1d5a
more installation doc cleanups
Richard Jones <richard@users.sourceforge.net>
parents:
1588
diff
changeset
|
192 To install the Roundup support code into your Python tree and |
| 3524 | 193 Roundup scripts into /usr/bin (substitute that path for whatever is |
|
1590
198dbefc1d5a
more installation doc cleanups
Richard Jones <richard@users.sourceforge.net>
parents:
1588
diff
changeset
|
194 appropriate on your system). You need to have write permissions |
|
198dbefc1d5a
more installation doc cleanups
Richard Jones <richard@users.sourceforge.net>
parents:
1588
diff
changeset
|
195 for these locations, eg. being root on unix:: |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
196 |
|
1590
198dbefc1d5a
more installation doc cleanups
Richard Jones <richard@users.sourceforge.net>
parents:
1588
diff
changeset
|
197 python setup.py install |
|
198dbefc1d5a
more installation doc cleanups
Richard Jones <richard@users.sourceforge.net>
parents:
1588
diff
changeset
|
198 |
|
198dbefc1d5a
more installation doc cleanups
Richard Jones <richard@users.sourceforge.net>
parents:
1588
diff
changeset
|
199 If you would like to place the Roundup scripts in a directory other |
| 3524 | 200 than ``/usr/bin``, then specify the preferred location with |
|
3949
29dfb873b32e
Small documentation cleanup
Justus Pendleton <jpend@users.sourceforge.net>
parents:
3935
diff
changeset
|
201 ``--install-scripts``. For example, to install them in |
|
1590
198dbefc1d5a
more installation doc cleanups
Richard Jones <richard@users.sourceforge.net>
parents:
1588
diff
changeset
|
202 ``/opt/roundup/bin``:: |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
203 |
|
1590
198dbefc1d5a
more installation doc cleanups
Richard Jones <richard@users.sourceforge.net>
parents:
1588
diff
changeset
|
204 python setup.py install --install-scripts=/opt/roundup/bin |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
205 |
|
1590
198dbefc1d5a
more installation doc cleanups
Richard Jones <richard@users.sourceforge.net>
parents:
1588
diff
changeset
|
206 You can also use the ``--prefix`` option to use a completely different |
|
198dbefc1d5a
more installation doc cleanups
Richard Jones <richard@users.sourceforge.net>
parents:
1588
diff
changeset
|
207 base directory, if you do not want to use administrator rights. If you |
|
2449
706031763266
clarification
Richard Jones <richard@users.sourceforge.net>
parents:
2409
diff
changeset
|
208 choose to do this, you may have to change Python's search path (sys.path) |
|
706031763266
clarification
Richard Jones <richard@users.sourceforge.net>
parents:
2409
diff
changeset
|
209 yourself. |
|
1282
2feb3e0a9955
included doc ideas from Bernhard Reiter
Richard Jones <richard@users.sourceforge.net>
parents:
1245
diff
changeset
|
210 |
|
1590
198dbefc1d5a
more installation doc cleanups
Richard Jones <richard@users.sourceforge.net>
parents:
1588
diff
changeset
|
211 |
|
198dbefc1d5a
more installation doc cleanups
Richard Jones <richard@users.sourceforge.net>
parents:
1588
diff
changeset
|
212 Configuring your first tracker |
|
198dbefc1d5a
more installation doc cleanups
Richard Jones <richard@users.sourceforge.net>
parents:
1588
diff
changeset
|
213 ------------------------------ |
|
198dbefc1d5a
more installation doc cleanups
Richard Jones <richard@users.sourceforge.net>
parents:
1588
diff
changeset
|
214 |
|
198dbefc1d5a
more installation doc cleanups
Richard Jones <richard@users.sourceforge.net>
parents:
1588
diff
changeset
|
215 1. To create a Roundup tracker (necessary to do before you can |
|
1576
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
216 use the software in any real fashion), you need to set up a "tracker |
|
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
217 home": |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
218 |
|
1089
43ab730ee194
instance -> tracker, node -> item
Richard Jones <richard@users.sourceforge.net>
parents:
1078
diff
changeset
|
219 a. (Optional) If you intend to keep your roundup trackers |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
220 under one top level directory which does not exist yet, |
| 1228 | 221 you should create that directory now. Example:: |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
222 |
|
1089
43ab730ee194
instance -> tracker, node -> item
Richard Jones <richard@users.sourceforge.net>
parents:
1078
diff
changeset
|
223 mkdir /opt/roundup/trackers |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
224 |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
225 b. Either add the Roundup script location to your ``PATH`` |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
226 environment variable or specify the full path to |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
227 the command in the next step. |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
228 |
|
6174
5522c950a2e4
Add indexing for roundup-admin references.
John Rouillard <rouilj@ieee.org>
parents:
6168
diff
changeset
|
229 .. index:: roundup-admin; install subcommand |
|
5522c950a2e4
Add indexing for roundup-admin references.
John Rouillard <rouilj@ieee.org>
parents:
6168
diff
changeset
|
230 |
| 1228 | 231 c. Install a new tracker with the command ``roundup-admin install``. |
|
1221
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
232 You will be asked a series of questions. Descriptions of the provided |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
233 templates can be found in `choosing your template`_ below. Descriptions |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
234 of the available backends can be found in `choosing your backend`_ |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
235 below. The questions will be something like (you may have more |
| 1228 | 236 templates or backends available):: |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
237 |
|
1089
43ab730ee194
instance -> tracker, node -> item
Richard Jones <richard@users.sourceforge.net>
parents:
1078
diff
changeset
|
238 Enter tracker home: /opt/roundup/trackers/support |
|
1221
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
239 Templates: classic |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
240 Select template [classic]: classic |
|
2818
2317e43609cb
remove bsddb; suggest using sqlite better than metakit
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2742
diff
changeset
|
241 Back ends: anydbm, mysql, sqlite |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
242 Select backend [anydbm]: anydbm |
|
738
7e093cbaaa98
split instance initialisation into two steps...
Richard Jones <richard@users.sourceforge.net>
parents:
729
diff
changeset
|
243 |
|
2818
2317e43609cb
remove bsddb; suggest using sqlite better than metakit
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2742
diff
changeset
|
244 Note: "Back ends" selection list depends on availability of |
|
2317e43609cb
remove bsddb; suggest using sqlite better than metakit
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2742
diff
changeset
|
245 third-party database modules. Standard python distribution |
|
2317e43609cb
remove bsddb; suggest using sqlite better than metakit
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2742
diff
changeset
|
246 includes anydbm module only. |
|
2317e43609cb
remove bsddb; suggest using sqlite better than metakit
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2742
diff
changeset
|
247 |
|
1571
8b5ff6ca0674
more doc fixes
Richard Jones <richard@users.sourceforge.net>
parents:
1560
diff
changeset
|
248 The "support" part of the tracker name can be anything you want - it |
|
8b5ff6ca0674
more doc fixes
Richard Jones <richard@users.sourceforge.net>
parents:
1560
diff
changeset
|
249 is going to be used as the directory that the tracker information |
|
8b5ff6ca0674
more doc fixes
Richard Jones <richard@users.sourceforge.net>
parents:
1560
diff
changeset
|
250 will be stored in. |
|
8b5ff6ca0674
more doc fixes
Richard Jones <richard@users.sourceforge.net>
parents:
1560
diff
changeset
|
251 |
|
1089
43ab730ee194
instance -> tracker, node -> item
Richard Jones <richard@users.sourceforge.net>
parents:
1078
diff
changeset
|
252 You will now be directed to edit the tracker configuration and |
|
3303
520eef0e0e91
fix installation docs referring to old-style configuration variables
Richard Jones <richard@users.sourceforge.net>
parents:
3297
diff
changeset
|
253 initial schema. At a minimum, you must set "main :: admin_email" |
|
520eef0e0e91
fix installation docs referring to old-style configuration variables
Richard Jones <richard@users.sourceforge.net>
parents:
3297
diff
changeset
|
254 (that's the "admin_email" option in the "main" section) "mail :: |
|
520eef0e0e91
fix installation docs referring to old-style configuration variables
Richard Jones <richard@users.sourceforge.net>
parents:
3297
diff
changeset
|
255 host", "tracker :: web" and "mail :: domain". If you get stuck, |
|
520eef0e0e91
fix installation docs referring to old-style configuration variables
Richard Jones <richard@users.sourceforge.net>
parents:
3297
diff
changeset
|
256 and get configuration file errors, then see the `tracker |
|
520eef0e0e91
fix installation docs referring to old-style configuration variables
Richard Jones <richard@users.sourceforge.net>
parents:
3297
diff
changeset
|
257 configuration`_ section of the `customisation documentation`_. |
|
1245
d8c98af869ff
merge from maint-0-5
Richard Jones <richard@users.sourceforge.net>
parents:
1244
diff
changeset
|
258 |
|
1574
67af854f4c33
more installation hintage
Richard Jones <richard@users.sourceforge.net>
parents:
1571
diff
changeset
|
259 If you just want to get set up to test things quickly (and follow |
|
67af854f4c33
more installation hintage
Richard Jones <richard@users.sourceforge.net>
parents:
1571
diff
changeset
|
260 the instructions in step 3 below), you can even just set the |
|
3303
520eef0e0e91
fix installation docs referring to old-style configuration variables
Richard Jones <richard@users.sourceforge.net>
parents:
3297
diff
changeset
|
261 "tracker :: web" variable to:: |
|
1244
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1240
diff
changeset
|
262 |
|
3303
520eef0e0e91
fix installation docs referring to old-style configuration variables
Richard Jones <richard@users.sourceforge.net>
parents:
3297
diff
changeset
|
263 web = http://localhost:8080/support/ |
|
1244
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1240
diff
changeset
|
264 |
|
1310
ff7b08d9ceb5
more URL trailing-/ requirements
Richard Jones <richard@users.sourceforge.net>
parents:
1300
diff
changeset
|
265 The URL *must* end in a '/', or your web interface *will not work*. |
|
ff7b08d9ceb5
more URL trailing-/ requirements
Richard Jones <richard@users.sourceforge.net>
parents:
1300
diff
changeset
|
266 See `Customising Roundup`_ for details on configuration and schema |
| 2409 | 267 changes. You may change any of the configuration after |
|
1310
ff7b08d9ceb5
more URL trailing-/ requirements
Richard Jones <richard@users.sourceforge.net>
parents:
1300
diff
changeset
|
268 you've initialised the tracker - it's just better to have valid values |
|
ff7b08d9ceb5
more URL trailing-/ requirements
Richard Jones <richard@users.sourceforge.net>
parents:
1300
diff
changeset
|
269 for this stuff now. |
|
738
7e093cbaaa98
split instance initialisation into two steps...
Richard Jones <richard@users.sourceforge.net>
parents:
729
diff
changeset
|
270 |
|
6174
5522c950a2e4
Add indexing for roundup-admin references.
John Rouillard <rouilj@ieee.org>
parents:
6168
diff
changeset
|
271 .. index:: roundup-admin; initialise subcommand |
|
5522c950a2e4
Add indexing for roundup-admin references.
John Rouillard <rouilj@ieee.org>
parents:
6168
diff
changeset
|
272 |
| 1228 | 273 d. Initialise the tracker database with ``roundup-admin initialise``. |
| 274 You will need to supply an admin password at this step. You will be | |
| 275 prompted:: | |
|
738
7e093cbaaa98
split instance initialisation into two steps...
Richard Jones <richard@users.sourceforge.net>
parents:
729
diff
changeset
|
276 |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
277 Admin Password: |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
278 Confirm: |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
279 |
| 2401 | 280 Note: running this command will *destroy any existing data in the |
| 4355 | 281 database*. In the case of MySQL and PostgreSQL, any existing database |
| 2401 | 282 will be dropped and re-created. |
| 283 | |
|
4792
1a0cf0345465
issue2550789 document how to initialize a tracker without exposing the admin password
John Rouillard <rouilj@ieee.org>
parents:
4688
diff
changeset
|
284 Once this is done, the tracker has been created. See the note in |
|
1a0cf0345465
issue2550789 document how to initialize a tracker without exposing the admin password
John Rouillard <rouilj@ieee.org>
parents:
4688
diff
changeset
|
285 the user_guide on how to initialise a tracker without being |
|
1a0cf0345465
issue2550789 document how to initialize a tracker without exposing the admin password
John Rouillard <rouilj@ieee.org>
parents:
4688
diff
changeset
|
286 prompted for the password or exposing the password on the command |
|
1a0cf0345465
issue2550789 document how to initialize a tracker without exposing the admin password
John Rouillard <rouilj@ieee.org>
parents:
4688
diff
changeset
|
287 line. |
|
738
7e093cbaaa98
split instance initialisation into two steps...
Richard Jones <richard@users.sourceforge.net>
parents:
729
diff
changeset
|
288 |
|
1590
198dbefc1d5a
more installation doc cleanups
Richard Jones <richard@users.sourceforge.net>
parents:
1588
diff
changeset
|
289 2. At this point, your tracker is set up, but doesn't have a nice user |
|
1244
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1240
diff
changeset
|
290 interface. To set that up, we need to `configure a web interface`_ and |
|
1316
dd43853684d4
don't undersell the roundup-server
Richard Jones <richard@users.sourceforge.net>
parents:
1310
diff
changeset
|
291 optionally `configure an email interface`_. If you want to try your |
|
3303
520eef0e0e91
fix installation docs referring to old-style configuration variables
Richard Jones <richard@users.sourceforge.net>
parents:
3297
diff
changeset
|
292 new tracker out, assuming "tracker :: web" is set to |
|
1316
dd43853684d4
don't undersell the roundup-server
Richard Jones <richard@users.sourceforge.net>
parents:
1310
diff
changeset
|
293 ``'http://localhost:8080/support/'``, run:: |
|
1244
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1240
diff
changeset
|
294 |
|
1574
67af854f4c33
more installation hintage
Richard Jones <richard@users.sourceforge.net>
parents:
1571
diff
changeset
|
295 roundup-server support=/opt/roundup/trackers/support |
|
1244
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1240
diff
changeset
|
296 |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1240
diff
changeset
|
297 then direct your web browser at: |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1240
diff
changeset
|
298 |
|
1845
3c6dd167a744
Fix typo in server address [SF#822967].
Johannes Gijsbers <jlgijsbers@users.sourceforge.net>
parents:
1839
diff
changeset
|
299 http://localhost:8080/support/ |
|
1244
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1240
diff
changeset
|
300 |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1240
diff
changeset
|
301 and you should see the tracker interface. |
| 1049 | 302 |
|
5138
c54720396f40
issue2550882. Reported by Karl-Philipp Richter. Fixed
John Rouillard <rouilj@ieee.org>
parents:
5108
diff
changeset
|
303 To run your tracker on some interface other than 127.0.0.1 and port |
|
c54720396f40
issue2550882. Reported by Karl-Philipp Richter. Fixed
John Rouillard <rouilj@ieee.org>
parents:
5108
diff
changeset
|
304 8080 (make sure you change the "tracker :: web" changes to match) use:: |
| 1049 | 305 |
|
5138
c54720396f40
issue2550882. Reported by Karl-Philipp Richter. Fixed
John Rouillard <rouilj@ieee.org>
parents:
5108
diff
changeset
|
306 roundup-server -p 1080 -n 0.0.0.0 support=/opt/roundup/trackers/support |
|
c54720396f40
issue2550882. Reported by Karl-Philipp Richter. Fixed
John Rouillard <rouilj@ieee.org>
parents:
5108
diff
changeset
|
307 |
|
c54720396f40
issue2550882. Reported by Karl-Philipp Richter. Fixed
John Rouillard <rouilj@ieee.org>
parents:
5108
diff
changeset
|
308 to run the server at port 1080 and bind to all ip addresses on your system. |
|
c54720396f40
issue2550882. Reported by Karl-Philipp Richter. Fixed
John Rouillard <rouilj@ieee.org>
parents:
5108
diff
changeset
|
309 Then direct your web browser to ``http://your_host_name:1080/support``. |
|
5321
4566360871dc
Raises python requirement to 2.7.
Bernhard Reiter <bernhard@intevation.de>
parents:
5300
diff
changeset
|
310 |
|
1221
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
311 Choosing Your Template |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
312 ---------------------- |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
313 |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
314 Classic Template |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
315 ~~~~~~~~~~~~~~~~ |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
316 |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
317 The classic template is the one defined in the `Roundup Specification`_. It |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
318 holds issues which have priorities and statuses. Each issue may also have a |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
319 set of messages which are disseminated to the issue's list of nosy users. |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
320 |
|
1227
92d8e1aad2e9
added mention of the new "minimal" template...
Richard Jones <richard@users.sourceforge.net>
parents:
1221
diff
changeset
|
321 Minimal Template |
|
92d8e1aad2e9
added mention of the new "minimal" template...
Richard Jones <richard@users.sourceforge.net>
parents:
1221
diff
changeset
|
322 ~~~~~~~~~~~~~~~~ |
|
92d8e1aad2e9
added mention of the new "minimal" template...
Richard Jones <richard@users.sourceforge.net>
parents:
1221
diff
changeset
|
323 |
|
92d8e1aad2e9
added mention of the new "minimal" template...
Richard Jones <richard@users.sourceforge.net>
parents:
1221
diff
changeset
|
324 The minimal template has the minimum setup required for a tracker |
|
92d8e1aad2e9
added mention of the new "minimal" template...
Richard Jones <richard@users.sourceforge.net>
parents:
1221
diff
changeset
|
325 installation. That is, it has the configuration files, defines a user database |
|
92d8e1aad2e9
added mention of the new "minimal" template...
Richard Jones <richard@users.sourceforge.net>
parents:
1221
diff
changeset
|
326 and the basic HTML interface to that. It's a completely clean slate for you to |
|
92d8e1aad2e9
added mention of the new "minimal" template...
Richard Jones <richard@users.sourceforge.net>
parents:
1221
diff
changeset
|
327 create your tracker on. |
|
92d8e1aad2e9
added mention of the new "minimal" template...
Richard Jones <richard@users.sourceforge.net>
parents:
1221
diff
changeset
|
328 |
| 6163 | 329 .. index:: database; choosing your backend |
|
1221
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
330 |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
331 Choosing Your Backend |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
332 --------------------- |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
333 |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
334 The actual storage of Roundup tracker information is handled by backends. |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
335 There's several to choose from, each with benefits and limitations: |
|
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
336 |
|
2179
5aa74f9879ac
rework the backend selection bit
Richard Jones <richard@users.sourceforge.net>
parents:
2161
diff
changeset
|
337 ========== =========== ===== ============================== |
|
5aa74f9879ac
rework the backend selection bit
Richard Jones <richard@users.sourceforge.net>
parents:
2161
diff
changeset
|
338 Name Speed Users Support |
|
5aa74f9879ac
rework the backend selection bit
Richard Jones <richard@users.sourceforge.net>
parents:
2161
diff
changeset
|
339 ========== =========== ===== ============================== |
|
5aa74f9879ac
rework the backend selection bit
Richard Jones <richard@users.sourceforge.net>
parents:
2161
diff
changeset
|
340 anydbm Slowest Few Always available |
|
3729
60d3865b3cb6
grammar R us
Richard Jones <richard@users.sourceforge.net>
parents:
3728
diff
changeset
|
341 sqlite Fastest(*) Few May need install (PySQLite_) |
|
2179
5aa74f9879ac
rework the backend selection bit
Richard Jones <richard@users.sourceforge.net>
parents:
2161
diff
changeset
|
342 postgresql Fast Many Needs install/admin (psycopg_) |
|
5aa74f9879ac
rework the backend selection bit
Richard Jones <richard@users.sourceforge.net>
parents:
2161
diff
changeset
|
343 mysql Fast Many Needs install/admin (MySQLdb_) |
|
5aa74f9879ac
rework the backend selection bit
Richard Jones <richard@users.sourceforge.net>
parents:
2161
diff
changeset
|
344 ========== =========== ===== ============================== |
|
5aa74f9879ac
rework the backend selection bit
Richard Jones <richard@users.sourceforge.net>
parents:
2161
diff
changeset
|
345 |
|
3728
b476fef16ccc
fixed support for pysqlite2 (version 2.1.0 is the minimum version supported)
Richard Jones <richard@users.sourceforge.net>
parents:
3722
diff
changeset
|
346 **sqlite** |
|
3935
1dab48842cbd
Throwing up hands in resignation and finally deleting the metakit backend.
Richard Jones <richard@users.sourceforge.net>
parents:
3922
diff
changeset
|
347 This uses the embedded database engine PySQLite_ to provide a very fast |
|
1dab48842cbd
Throwing up hands in resignation and finally deleting the metakit backend.
Richard Jones <richard@users.sourceforge.net>
parents:
3922
diff
changeset
|
348 backend. This is not suitable for trackers which will have many |
|
1dab48842cbd
Throwing up hands in resignation and finally deleting the metakit backend.
Richard Jones <richard@users.sourceforge.net>
parents:
3922
diff
changeset
|
349 simultaneous users, but requires much less installation and maintenance |
|
1dab48842cbd
Throwing up hands in resignation and finally deleting the metakit backend.
Richard Jones <richard@users.sourceforge.net>
parents:
3922
diff
changeset
|
350 effort than more scalable postgresql and mysql backends. |
|
3728
b476fef16ccc
fixed support for pysqlite2 (version 2.1.0 is the minimum version supported)
Richard Jones <richard@users.sourceforge.net>
parents:
3722
diff
changeset
|
351 |
|
b476fef16ccc
fixed support for pysqlite2 (version 2.1.0 is the minimum version supported)
Richard Jones <richard@users.sourceforge.net>
parents:
3722
diff
changeset
|
352 SQLite is supported via PySQLite versions 1.1.7, 2.1.0 and sqlite3 (the last |
|
b476fef16ccc
fixed support for pysqlite2 (version 2.1.0 is the minimum version supported)
Richard Jones <richard@users.sourceforge.net>
parents:
3722
diff
changeset
|
353 being bundled with Python 2.5+) |
|
3794
f5ddd1639a15
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
3754
diff
changeset
|
354 |
|
f5ddd1639a15
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
3754
diff
changeset
|
355 Installed SQLite should be the latest version available (3.3.8 is known |
|
f5ddd1639a15
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
3754
diff
changeset
|
356 to work, 3.1.3 is known to have problems). |
|
2179
5aa74f9879ac
rework the backend selection bit
Richard Jones <richard@users.sourceforge.net>
parents:
2161
diff
changeset
|
357 **postgresql** |
|
5aa74f9879ac
rework the backend selection bit
Richard Jones <richard@users.sourceforge.net>
parents:
2161
diff
changeset
|
358 Backend for popular RDBMS PostgreSQL. You must read doc/postgresql.txt for |
|
2921
ad4fb8a14a97
more doc updates, not so many TODOs any more
Richard Jones <richard@users.sourceforge.net>
parents:
2818
diff
changeset
|
359 additional installation steps and requirements. You must also configure |
|
3666
8304a1c1cc98
encourage use of latest psycopg
Richard Jones <richard@users.sourceforge.net>
parents:
3647
diff
changeset
|
360 the ``rdbms`` section of your tracker's ``config.ini``. It is recommended |
|
8304a1c1cc98
encourage use of latest psycopg
Richard Jones <richard@users.sourceforge.net>
parents:
3647
diff
changeset
|
361 that you use at least version 1.1.21 of psycopg. |
|
1507
3481507d6098
Advertising mysql
Andrey Lebedev <kedder@users.sourceforge.net>
parents:
1317
diff
changeset
|
362 **mysql** |
|
2179
5aa74f9879ac
rework the backend selection bit
Richard Jones <richard@users.sourceforge.net>
parents:
2161
diff
changeset
|
363 Backend for popular RDBMS MySQL. You must read doc/mysql.txt for additional |
|
2921
ad4fb8a14a97
more doc updates, not so many TODOs any more
Richard Jones <richard@users.sourceforge.net>
parents:
2818
diff
changeset
|
364 installation steps and requirements. You must also configure the ``rdbms`` |
|
ad4fb8a14a97
more doc updates, not so many TODOs any more
Richard Jones <richard@users.sourceforge.net>
parents:
2818
diff
changeset
|
365 section of your tracker's ``config.ini`` |
|
1221
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
366 |
|
2179
5aa74f9879ac
rework the backend selection bit
Richard Jones <richard@users.sourceforge.net>
parents:
2161
diff
changeset
|
367 You may defer your decision by setting your tracker up with the anydbm |
|
5aa74f9879ac
rework the backend selection bit
Richard Jones <richard@users.sourceforge.net>
parents:
2161
diff
changeset
|
368 backend (which is guaranteed to be available) and switching to one of the |
|
5aa74f9879ac
rework the backend selection bit
Richard Jones <richard@users.sourceforge.net>
parents:
2161
diff
changeset
|
369 other backends at any time using the instructions in the `administration |
|
5aa74f9879ac
rework the backend selection bit
Richard Jones <richard@users.sourceforge.net>
parents:
2161
diff
changeset
|
370 guide`_. |
|
1221
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
371 |
| 2401 | 372 Regardless of which backend you choose, Roundup will attempt to initialise |
|
6174
5522c950a2e4
Add indexing for roundup-admin references.
John Rouillard <rouilj@ieee.org>
parents:
6168
diff
changeset
|
373 a new database for you when you run the "``roundup-admin initialise``" command. |
| 2401 | 374 In the case of MySQL and PostgreSQL you will need to have the appropriate |
| 375 privileges to create databases. | |
| 376 | |
|
1221
778297033003
cleanup of install docco
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
377 |
| 1228 | 378 Configure a Web Interface |
| 379 ------------------------- | |
| 380 | |
|
5486
a5edd6adff14
Change count of number of ways to run roundup to "multiple".
John Rouillard <rouilj@ieee.org>
parents:
5367
diff
changeset
|
381 There are multiple web interfaces to choose from: |
| 1228 | 382 |
| 383 1. `web server cgi-bin`_ | |
|
4324
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
384 2. `cgi-bin for limited-access hosting`_ |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
385 3. `stand-alone web server`_ |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
386 4. `Zope product - ZRoundup`_ |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
387 5. `Apache HTTP Server with mod_wsgi`_ |
|
5891
6e341009593b
Deprecate mod_python issue2551005
John Rouillard <rouilj@ieee.org>
parents:
5878
diff
changeset
|
388 6. `Apache HTTP Server with mod_python`_ (deprecated) |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
389 7. `WSGI Variations`_ |
| 1228 | 390 |
| 391 You may need to give the web server user permission to access the tracker home | |
|
1939
1303c208419d
some updates that were sitting on disk
Richard Jones <richard@users.sourceforge.net>
parents:
1913
diff
changeset
|
392 - see the `UNIX environment steps`_ for information. You may also need to |
|
1576
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
393 configure your system in some way - see `platform-specific notes`_. |
| 1228 | 394 |
| 6163 | 395 .. index:: pair: web interface; cgi |
| 1228 | 396 |
| 397 Web Server cgi-bin | |
| 398 ~~~~~~~~~~~~~~~~~~ | |
| 399 | |
| 400 A benefit of using the cgi-bin approach is that it's the easiest way to | |
| 401 restrict access to your tracker to only use HTTPS. Access will be slower | |
| 402 than through the `stand-alone web server`_ though. | |
| 403 | |
|
3754
9f4dd27ae843
documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents:
3736
diff
changeset
|
404 If your Python isn't installed as "python" then you'll need to edit |
|
1748
0f2678eeeac6
cgi-bin install note
Richard Jones <richard@users.sourceforge.net>
parents:
1747
diff
changeset
|
405 the ``roundup.cgi`` script to fix the first line. |
|
0f2678eeeac6
cgi-bin install note
Richard Jones <richard@users.sourceforge.net>
parents:
1747
diff
changeset
|
406 |
|
1540
3e65577ad6d7
minor changes
Richard Jones <richard@users.sourceforge.net>
parents:
1528
diff
changeset
|
407 If you're using IIS on a Windows platform, you'll need to run this command |
|
3e65577ad6d7
minor changes
Richard Jones <richard@users.sourceforge.net>
parents:
1528
diff
changeset
|
408 for the cgi to work (it turns on the PATH_INFO cgi variable):: |
|
3e65577ad6d7
minor changes
Richard Jones <richard@users.sourceforge.net>
parents:
1528
diff
changeset
|
409 |
|
3e65577ad6d7
minor changes
Richard Jones <richard@users.sourceforge.net>
parents:
1528
diff
changeset
|
410 adsutil.vbs set w3svc/AllowPathInfoForScriptMappings TRUE |
|
3e65577ad6d7
minor changes
Richard Jones <richard@users.sourceforge.net>
parents:
1528
diff
changeset
|
411 |
|
3799
ac4da2670516
trim trailing spaces
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3797
diff
changeset
|
412 The ``adsutil.vbs`` file can be found in either ``c:\inetpub\adminscripts`` |
|
1540
3e65577ad6d7
minor changes
Richard Jones <richard@users.sourceforge.net>
parents:
1528
diff
changeset
|
413 or ``c:\winnt\system32\inetsrv\adminsamples\`` or |
|
3e65577ad6d7
minor changes
Richard Jones <richard@users.sourceforge.net>
parents:
1528
diff
changeset
|
414 ``c:\winnt\system32\inetsrv\adminscripts\`` depending on your installation. |
|
3e65577ad6d7
minor changes
Richard Jones <richard@users.sourceforge.net>
parents:
1528
diff
changeset
|
415 |
|
6370
45e8d10a9609
Update links in documentation
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
416 See: |
|
45e8d10a9609
Update links in documentation
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
417 |
|
45e8d10a9609
Update links in documentation
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
418 https://docs.microsoft.com/en-us/iis/web-dev-reference/server-variables |
|
45e8d10a9609
Update links in documentation
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
419 |
|
2988
f4023f1cc1d6
apply IE caching "fix" to automatically serve up all pages expired
Richard Jones <richard@users.sourceforge.net>
parents:
2979
diff
changeset
|
420 More information about ISS setup may be found at: |
|
f4023f1cc1d6
apply IE caching "fix" to automatically serve up all pages expired
Richard Jones <richard@users.sourceforge.net>
parents:
2979
diff
changeset
|
421 |
|
6370
45e8d10a9609
Update links in documentation
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
422 https://docs.microsoft.com/en-us/iis/ |
|
2988
f4023f1cc1d6
apply IE caching "fix" to automatically serve up all pages expired
Richard Jones <richard@users.sourceforge.net>
parents:
2979
diff
changeset
|
423 |
|
3736
a2d22d0de0bc
WSGI support via roundup.cgi.wsgi_handler
Richard Jones <richard@users.sourceforge.net>
parents:
3731
diff
changeset
|
424 Copy the ``frontends/roundup.cgi`` file to your web server's ``cgi-bin`` |
| 1228 | 425 directory. You will need to configure it to tell it where your tracker home |
| 426 is. You can do this either: | |
| 427 | |
|
3303
520eef0e0e91
fix installation docs referring to old-style configuration variables
Richard Jones <richard@users.sourceforge.net>
parents:
3297
diff
changeset
|
428 Through an environment variable |
|
520eef0e0e91
fix installation docs referring to old-style configuration variables
Richard Jones <richard@users.sourceforge.net>
parents:
3297
diff
changeset
|
429 Set the variable TRACKER_HOMES to be a colon (":") separated list of |
|
520eef0e0e91
fix installation docs referring to old-style configuration variables
Richard Jones <richard@users.sourceforge.net>
parents:
3297
diff
changeset
|
430 name=home pairs (if you're using apache, the SetEnv directive can do this) |
|
520eef0e0e91
fix installation docs referring to old-style configuration variables
Richard Jones <richard@users.sourceforge.net>
parents:
3297
diff
changeset
|
431 |
|
520eef0e0e91
fix installation docs referring to old-style configuration variables
Richard Jones <richard@users.sourceforge.net>
parents:
3297
diff
changeset
|
432 Directly in the ``roundup.cgi`` file itself |
|
520eef0e0e91
fix installation docs referring to old-style configuration variables
Richard Jones <richard@users.sourceforge.net>
parents:
3297
diff
changeset
|
433 Add your instance to the TRACKER_HOMES variable as ``'name': 'home'`` |
| 1228 | 434 |
| 435 The "name" part of the configuration will appear in the URL and identifies the | |
| 436 tracker (so you may have more than one tracker per cgi-bin script). Make sure | |
| 437 there are no spaces or other illegal characters in it (to be safe, stick to | |
| 438 letters and numbers). The "name" forms part of the URL that appears in the | |
|
3303
520eef0e0e91
fix installation docs referring to old-style configuration variables
Richard Jones <richard@users.sourceforge.net>
parents:
3297
diff
changeset
|
439 tracker config "tracker :: web" variable, so make sure they match. The "home" |
| 1228 | 440 part of the configuration is the tracker home directory. |
| 441 | |
|
2665
7d6dda802ca0
cgi install tip
Richard Jones <richard@users.sourceforge.net>
parents:
2594
diff
changeset
|
442 If you're using Apache, you can use an additional trick to hide the |
|
7d6dda802ca0
cgi install tip
Richard Jones <richard@users.sourceforge.net>
parents:
2594
diff
changeset
|
443 ``.cgi`` extension of the cgi script. Place the ``roundup.cgi`` script |
|
3754
9f4dd27ae843
documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents:
3736
diff
changeset
|
444 wherever you want it to be, rename it to just ``roundup``, and add a |
|
2665
7d6dda802ca0
cgi install tip
Richard Jones <richard@users.sourceforge.net>
parents:
2594
diff
changeset
|
445 couple lines to your Apache configuration:: |
|
3799
ac4da2670516
trim trailing spaces
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3797
diff
changeset
|
446 |
|
2665
7d6dda802ca0
cgi install tip
Richard Jones <richard@users.sourceforge.net>
parents:
2594
diff
changeset
|
447 <Location /path/to/roundup> |
|
7d6dda802ca0
cgi install tip
Richard Jones <richard@users.sourceforge.net>
parents:
2594
diff
changeset
|
448 SetHandler cgi-script |
|
7d6dda802ca0
cgi install tip
Richard Jones <richard@users.sourceforge.net>
parents:
2594
diff
changeset
|
449 </Location> |
|
7d6dda802ca0
cgi install tip
Richard Jones <richard@users.sourceforge.net>
parents:
2594
diff
changeset
|
450 |
|
7d6dda802ca0
cgi install tip
Richard Jones <richard@users.sourceforge.net>
parents:
2594
diff
changeset
|
451 |
|
4324
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
452 CGI-bin for Limited-Access Hosting |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
453 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
454 |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
455 If you are running in a shared-hosting environment or otherwise don't have |
|
4656
bce631d8f24d
issue2550738: Fixes for various documentation typos, thanks Nathan Russell
John Kristensen <john@jerrykan.com>
parents:
4510
diff
changeset
|
456 permission to edit the system web server's configuration, but can create a |
|
4324
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
457 ``.htaccess`` file then you may be able to use this approach. |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
458 |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
459 1. Install flup_ |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
460 2. Create a script ``roundup_stub`` in your server's ``cgi-bin`` directory |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
461 containing:: |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
462 |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
463 #!/usr/bin/env python |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
464 |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
465 # if necessary modify the Python path to include the place you |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
466 # installed Roundup |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
467 #import sys |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
468 #sys.path.append('...') |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
469 |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
470 # cgitb is needed for debugging in browser only |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
471 #import cgitb |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
472 #cgitb.enable() |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
473 |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
474 # obtain the WSGI request dispatcher |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
475 from roundup.cgi.wsgi_handler import RequestDispatcher |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
476 tracker_home = '/path/to/tracker/home' |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
477 app = RequestDispatcher(tracker_home) |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
478 |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
479 from flup.server.cgi import WSGIServer |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
480 WSGIServer(app).run() |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
481 |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
482 3. Modify or created the ``.htaccess`` file in the desired (sub-)domain |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
483 directory to contain:: |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
484 |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
485 RewriteEngine On |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
486 RewriteBase / |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
487 RewriteRule ^(.*)$ /cgi-bin/roundup_stub/$1 [L] |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
488 |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
489 Now loading the (sub-)domain in a browser should load the tracker web |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
490 interface. If you get a "500" error then enable the "cgitb" lines in the |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
491 stub to get some debugging information. |
|
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
492 |
| 6163 | 493 .. index:: pair: web interface; stand alone server |
|
4324
c70762f2be4e
flup setup docs from Christian Glass
Richard Jones <richard@users.sourceforge.net>
parents:
4317
diff
changeset
|
494 |
| 1228 | 495 Stand-alone Web Server |
| 496 ~~~~~~~~~~~~~~~~~~~~~~ | |
| 497 | |
|
3754
9f4dd27ae843
documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents:
3736
diff
changeset
|
498 This approach will give you faster response than cgi-bin. You may |
| 1228 | 499 investigate using ProxyPass or similar configuration in apache to have your |
| 500 tracker accessed through the same URL as other systems. | |
| 501 | |
| 502 The stand-alone web server is started with the command ``roundup-server``. It | |
| 503 has several options - display them with ``roundup-server -h``. | |
| 504 | |
| 505 The tracker home configuration is similar to the cgi-bin - you may either edit | |
| 506 the script to change the TRACKER_HOMES variable or you may supply the | |
| 507 name=home values on the command-line after all the other options. | |
| 508 | |
| 509 To make the server run in the background, use the "-d" option, specifying the | |
| 510 name of a file to write the server process id (pid) to. | |
| 511 | |
| 512 | |
| 6163 | 513 .. index:: pair: web interface; Zope |
| 514 | |
| 1228 | 515 Zope Product - ZRoundup |
| 516 ~~~~~~~~~~~~~~~~~~~~~~~ | |
| 517 | |
| 518 ZRoundup installs as a regular Zope product. Copy the ZRoundup directory to | |
| 519 your Products directory either in INSTANCE_HOME/Products or the Zope | |
| 520 code tree lib/python/Products. | |
| 521 | |
| 522 When you next (re)start up Zope, you will be able to add a ZRoundup object | |
| 523 that interfaces to your new tracker. | |
| 524 | |
| 6163 | 525 .. index:: ! triple: web interface; apache; mod_wsgi |
| 526 ! single: wsgi; apache | |
| 527 | |
|
5891
6e341009593b
Deprecate mod_python issue2551005
John Rouillard <rouilj@ieee.org>
parents:
5878
diff
changeset
|
528 Apache HTTP Server with mod_wsgi |
|
6e341009593b
Deprecate mod_python issue2551005
John Rouillard <rouilj@ieee.org>
parents:
5878
diff
changeset
|
529 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
6e341009593b
Deprecate mod_python issue2551005
John Rouillard <rouilj@ieee.org>
parents:
5878
diff
changeset
|
530 |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
531 This is a work in progress thanks to Garth Jensen. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
532 |
|
5909
d57347ae6f25
Typo fixes in installation.txt doc.
John Rouillard <rouilj@ieee.org>
parents:
5908
diff
changeset
|
533 See the main web site for `mod_wsgi`_ which include directions for |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
534 using mod_wsgi-express which is easier if you are not used to apache |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
535 configuration. Also there is the |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
536 `main mod_wsgi <https://modwsgi.readthedocs.io/en/develop/>`_ for more |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
537 detailed directions. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
538 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
539 Background |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
540 ^^^^^^^^^^ |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
541 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
542 These notes were developed on a Microsoft Azure VM running Ubuntu |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
543 18.04 LTS. The instructions below assume: |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
544 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
545 - python and roundup are already installed |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
546 - roundup is running in the system python instance (e.g. no virtual |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
547 environment) |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
548 - the tracker ``mytracker`` is installed in the ``trackers`` folder of |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
549 home directory of a user called ``admin``. Thus, the absolute path to |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
550 the tracker home directory is ``/home/admin/trackers/mytracker``. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
551 - the server has a static public IP address of 11.11.11.101 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
552 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
553 Install mod-wsgi |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
554 ^^^^^^^^^^^^^^^^ |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
555 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
556 You can install/build it using the python package manager pip, or |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
557 install using the OS package manager (apt). |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
558 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
559 Pip install of mod_wsgi |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
560 ''''''''''''''''''''''' |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
561 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
562 This is the tested method, and offers an easier path to get started, |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
563 but it does mean that you will need to keep up to date with any |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
564 security or other issues. If you use the packages supplied by your OS |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
565 vendor, you may get more timely updates and notifications. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
566 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
567 The mod_wsgi docs talk about two installation methods: (1) the |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
568 so-called CMMI method or (2) with pip. The pip method also provides an |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
569 admin script called ``mod_wsgi-express`` that can start up a |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
570 standalone instance of Apache directly from the command line with an |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
571 auto generated configuration. These instructions follow the pip |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
572 method. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
573 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
574 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
575 1. The `mod_wsgi`_ PyPi page lists prerequisites for various types of |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
576 systems. For Ubuntu, they are apache2 and apache2-dev. To see |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
577 installed apache packages, you can use ``dpkg -l | grep apache``. |
|
5909
d57347ae6f25
Typo fixes in installation.txt doc.
John Rouillard <rouilj@ieee.org>
parents:
5908
diff
changeset
|
578 If apache2 or apache2-dev are not installed, they install them |
|
d57347ae6f25
Typo fixes in installation.txt doc.
John Rouillard <rouilj@ieee.org>
parents:
5908
diff
changeset
|
579 with: |
|
5911
133efe1fbff7
doc/installation.txt: replace tabs, remove trailing spaces
Thomas Arendsen Hein <thomas@intevation.de>
parents:
5910
diff
changeset
|
580 |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
581 - ``sudo apt update`` |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
582 - ``sudo apt install apache2 apache2-dev`` |
|
5911
133efe1fbff7
doc/installation.txt: replace tabs, remove trailing spaces
Thomas Arendsen Hein <thomas@intevation.de>
parents:
5910
diff
changeset
|
583 |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
584 2. If ``pip`` is not already installed, install it with |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
585 ``sudo apt install python-pip`` |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
586 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
587 If you are using python 3, use ``sudo apt-install python3-pip`` and |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
588 change references to pip in the directions to pip3. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
589 3. ``sudo pip install mod_wsgi``. In my case, I got warnings about |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
590 the user not owning directories, but it said it completed |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
591 "successfully." |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
592 4. For testing, open port 8000 for TCP on the server. For an Azure VM, |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
593 this is done with Azure Portal under ``Networking`` > ``Add inbound port`` |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
594 rule. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
595 5. Test with ``mod_wsgi-express start-server``. This should serve |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
596 up content on localhost port 8000. You can then direct a browser on |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
597 the server itself to http://localhost:8000/ or on another machine at |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
598 the server's domain name or ip address followed by colon then 8000 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
599 (e.g. http://11.11.11.101:8000/). If successful, you should see a |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
600 Malt Whiskey image. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
601 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
602 Package manager install of mod_wsgi |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
603 ''''''''''''''''''''''''''''''''''' |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
604 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
605 On debian (which should work for Ubuntu), install apache2 with |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
606 libapache2-mod-wsgi: |
|
5891
6e341009593b
Deprecate mod_python issue2551005
John Rouillard <rouilj@ieee.org>
parents:
5878
diff
changeset
|
607 |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
608 - ``sudo apt update`` |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
609 - ``sudo apt install apache2 libapache2-mod-wsgi`` |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
610 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
611 this is the less tested method for installing mod_wsgi and may not |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
612 install mod_wsgi-express, which is used below. However there is an |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
613 example apache config included as part of `WSGI Variations`_ that can |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
614 be used to hand craft an apache config. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
615 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
616 You should make sure that the version you install is 3.5 or newer due |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
617 to security issues in older releases. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
618 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
619 Configure web interface via wsgi_handler |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
620 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
621 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
622 1. In the tracker's home directory create a ``wsgi.py`` file with the |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
623 following content (substituting ``/home/admin/trackers/mytracker`` |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
624 with the absolute path for your tracker's home directory): |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
625 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
626 .. code:: python |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
627 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
628 from roundup.cgi.wsgi_handler import RequestDispatcher |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
629 tracker_home = '/home/admin/trackers/mytracker' |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
630 application = RequestDispatcher(tracker_home) |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
631 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
632 To run the tracker on Port 8000 as a foreground process |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
633 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
634 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
635 1. Change the ``tracker.web`` url in ``config.ini`` to port 8000 at the |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
636 server domain name or ip address (e.g. http://11.11.11.101:8000/). |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
637 2. Open port 8000 for TCP on the server if you didn't already do so. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
638 3. ``cd`` to your tracker home directory, then run |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
639 ``mod_wsgi-express start-server wsgi.py``. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
640 4. Test by directing a browser on another machine to the url you set |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
641 ``tracker.web`` to in ``config.ini``. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
642 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
643 Run tracker as background daemon |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
644 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
645 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
646 To run the tracker on Port 80 or as a background process, you'll need |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
647 to configure a UNIX group with appropriate privileges as described in |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
648 `UNIX environment steps`_. These steps are summarized here: |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
649 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
650 1. To add a group named "mytrackergrp" run: ``sudo groupadd mytrackergrp``. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
651 2. Add the owner of the tracker home (admin in this example) run: |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
652 ``sudo usermod -a -G mytrackergrp admin`` |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
653 3. Add user that runs Apache (the default on Ubuntu is www-data) run: |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
654 ``sudo usermod -a -G mytrackergrp www-data`` |
|
5911
133efe1fbff7
doc/installation.txt: replace tabs, remove trailing spaces
Thomas Arendsen Hein <thomas@intevation.de>
parents:
5910
diff
changeset
|
655 4. Add user mail service runs as (e.g. daemon) run: |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
656 ``sudo usermod -a -G mytrackergrp daemon`` |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
657 5. Change group of the database in the tracker folder run: |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
658 ``sudo chgrp -R mytrackergrp ~/trackers/mytracker``. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
659 6. Make sure group can write to the database, and any new files created |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
660 in the database will be owned by the group run: |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
661 ``sudo chmod -R g+sw ~/trackers/mytracker/db`` |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
662 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
663 To run mod_wsgi on PORT 80 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
664 ^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
665 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
666 1. Change the ``tracker.web`` url in ``config.ini`` to the server url |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
667 with no port designator. E.g. http://11.11.11.101. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
668 2. Open port 80 on the server for TCP traffic if it isn't open already. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
669 3. Stop the system instance of Apache to make sure it isn't holding on |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
670 to port 80 run: ``sudo service apache2 stop``. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
671 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
672 To run as a foreground process |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
673 '''''''''''''''''''''''''''''' |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
674 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
675 1. From the tracker home directory, run |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
676 ``sudo mod_wsgi-express start-server wsgi.py --port 80 --user admin --group mytrackergrp`` |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
677 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
678 To run as a background process |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
679 '''''''''''''''''''''''''''''' |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
680 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
681 1. From the tracker home directory, bash |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
682 ``sudo mod_wsgi-express setup-server wsgi.py --port=80 --user admin --group mytrackergrp --server-root=/etc/mod_wsgi-express-80`` |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
683 2. Then, run ``sudo /etc/mod_wsgi-express-80/apachectl start`` |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
684 3. To stop, run ``sudo /etc/mod_wsgi-express-80/apachectl stop`` |
|
5891
6e341009593b
Deprecate mod_python issue2551005
John Rouillard <rouilj@ieee.org>
parents:
5878
diff
changeset
|
685 |
| 6163 | 686 .. index:: triple: web interface; apache; mod_python (depricated) |
| 687 | |
|
2554
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
688 Apache HTTP Server with mod_python |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
689 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
690 |
|
5891
6e341009593b
Deprecate mod_python issue2551005
John Rouillard <rouilj@ieee.org>
parents:
5878
diff
changeset
|
691 As of roundup 2.0, mod_python support is deprecated. The apache.py |
|
6e341009593b
Deprecate mod_python issue2551005
John Rouillard <rouilj@ieee.org>
parents:
5878
diff
changeset
|
692 file is still available, but may be limited to working for Python 2 |
|
6e341009593b
Deprecate mod_python issue2551005
John Rouillard <rouilj@ieee.org>
parents:
5878
diff
changeset
|
693 only. Using mod_wsgi with Apache is the recommended way to deploy |
|
6e341009593b
Deprecate mod_python issue2551005
John Rouillard <rouilj@ieee.org>
parents:
5878
diff
changeset
|
694 roundup under apache. |
|
6e341009593b
Deprecate mod_python issue2551005
John Rouillard <rouilj@ieee.org>
parents:
5878
diff
changeset
|
695 |
|
2554
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
696 `Mod_python`_ is an `Apache`_ module that embeds the Python interpreter |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
697 within the server. Running Roundup this way is much faster than all |
|
3754
9f4dd27ae843
documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents:
3736
diff
changeset
|
698 above options and, like `web server cgi-bin`_, allows you to use HTTPS |
|
2554
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
699 protocol. The drawback is that this setup is more complicated. |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
700 |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
701 The following instructions were tested on apache 2.0 with mod_python 3.1. |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
702 If you are using older versions, your mileage may vary. |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
703 |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
704 Mod_python uses OS threads. If your apache was built without threads |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
705 (quite commonly), you must load the threading library to run mod_python. |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
706 This is done by setting ``LD_PRELOAD`` to your threading library path |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
707 in apache ``envvars`` file. Example for gentoo linux (``envvars`` file |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
708 is located in ``/usr/lib/apache2/build/``):: |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
709 |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
710 LD_PRELOAD=/lib/libpthread.so.0 |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
711 export LD_PRELOAD |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
712 |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
713 Example for FreeBSD (``envvars`` is in ``/usr/local/sbin/``):: |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
714 |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
715 LD_PRELOAD=/usr/lib/libc_r.so |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
716 export LD_PRELOAD |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
717 |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
718 Next, you have to add Roundup trackers configuration to apache config. |
|
4249
87b3e905ae2e
fixed typos in the installation instructions
Bernhard Reiter <Bernhard.Reiter@intevation.de>
parents:
4226
diff
changeset
|
719 Roundup apache interface uses the following options specified with |
|
87b3e905ae2e
fixed typos in the installation instructions
Bernhard Reiter <Bernhard.Reiter@intevation.de>
parents:
4226
diff
changeset
|
720 ``PythonOption`` directives: |
|
2559
6c096b4aea67
added description and example of mod_python interface option TrackerLanguage
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2554
diff
changeset
|
721 |
|
6c096b4aea67
added description and example of mod_python interface option TrackerLanguage
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2554
diff
changeset
|
722 TrackerHome: |
|
6c096b4aea67
added description and example of mod_python interface option TrackerLanguage
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2554
diff
changeset
|
723 defines the tracker home directory - the directory that was specified |
|
6c096b4aea67
added description and example of mod_python interface option TrackerLanguage
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2554
diff
changeset
|
724 when you did ``roundup-admin init``. This option is required. |
|
6c096b4aea67
added description and example of mod_python interface option TrackerLanguage
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2554
diff
changeset
|
725 |
|
4249
87b3e905ae2e
fixed typos in the installation instructions
Bernhard Reiter <Bernhard.Reiter@intevation.de>
parents:
4226
diff
changeset
|
726 TrackerLanguage: |
|
2559
6c096b4aea67
added description and example of mod_python interface option TrackerLanguage
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2554
diff
changeset
|
727 defines web user interface language. mod_python applications do not |
|
6c096b4aea67
added description and example of mod_python interface option TrackerLanguage
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2554
diff
changeset
|
728 receive OS environment variables in the same way as command-line |
|
6c096b4aea67
added description and example of mod_python interface option TrackerLanguage
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2554
diff
changeset
|
729 programs, so the language cannot be selected by setting commonly |
|
6c096b4aea67
added description and example of mod_python interface option TrackerLanguage
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2554
diff
changeset
|
730 used variables like ``LANG`` or ``LC_ALL``. ``TrackerLanguage`` |
|
6c096b4aea67
added description and example of mod_python interface option TrackerLanguage
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2554
diff
changeset
|
731 value has the same syntax as values of these environment variables. |
|
6c096b4aea67
added description and example of mod_python interface option TrackerLanguage
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2554
diff
changeset
|
732 This option may be omitted. |
|
6c096b4aea67
added description and example of mod_python interface option TrackerLanguage
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2554
diff
changeset
|
733 |
|
2945
98efa80f0f90
added mod_python options TrackerDebug and TrackerTiming
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2921
diff
changeset
|
734 TrackerDebug: |
|
98efa80f0f90
added mod_python options TrackerDebug and TrackerTiming
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2921
diff
changeset
|
735 run the tracker in debug mode. Setting this option to ``yes`` or |
|
98efa80f0f90
added mod_python options TrackerDebug and TrackerTiming
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2921
diff
changeset
|
736 ``true`` has the same effect as running ``roundup-server -t debug``: |
|
98efa80f0f90
added mod_python options TrackerDebug and TrackerTiming
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2921
diff
changeset
|
737 the database schema and used html templates are rebuilt for each |
|
98efa80f0f90
added mod_python options TrackerDebug and TrackerTiming
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2921
diff
changeset
|
738 HTTP request. Values ``no`` or ``false`` mean that all html |
|
98efa80f0f90
added mod_python options TrackerDebug and TrackerTiming
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2921
diff
changeset
|
739 templates for the tracker are compiled and the database schema is |
|
98efa80f0f90
added mod_python options TrackerDebug and TrackerTiming
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2921
diff
changeset
|
740 checked once at startup. This is the default behaviour. |
|
98efa80f0f90
added mod_python options TrackerDebug and TrackerTiming
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2921
diff
changeset
|
741 |
|
98efa80f0f90
added mod_python options TrackerDebug and TrackerTiming
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2921
diff
changeset
|
742 TrackerTiming: |
|
98efa80f0f90
added mod_python options TrackerDebug and TrackerTiming
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2921
diff
changeset
|
743 has nearly the same effect as environment variable ``CGI_SHOW_TIMING`` |
|
98efa80f0f90
added mod_python options TrackerDebug and TrackerTiming
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2921
diff
changeset
|
744 for standalone roundup server. The difference is that setting this |
|
98efa80f0f90
added mod_python options TrackerDebug and TrackerTiming
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2921
diff
changeset
|
745 option to ``no`` or ``false`` disables timings display. Value |
|
98efa80f0f90
added mod_python options TrackerDebug and TrackerTiming
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2921
diff
changeset
|
746 ``comment`` writes request handling times in html comment, and |
|
98efa80f0f90
added mod_python options TrackerDebug and TrackerTiming
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2921
diff
changeset
|
747 any other non-empty value makes timing report visible. By default, |
|
98efa80f0f90
added mod_python options TrackerDebug and TrackerTiming
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2921
diff
changeset
|
748 timing display is disabled. |
|
98efa80f0f90
added mod_python options TrackerDebug and TrackerTiming
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2921
diff
changeset
|
749 |
|
2554
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
750 In the following example we have two trackers set up in |
|
3754
9f4dd27ae843
documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents:
3736
diff
changeset
|
751 ``/var/db/roundup/support`` and ``/var/db/roundup/devel`` and accessed |
|
2554
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
752 as ``https://my.host/roundup/support/`` and ``https://my.host/roundup/devel/`` |
|
3797
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
753 respectively (provided Apache has been set up for SSL of course). |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
754 Having them share same parent directory allows us to |
|
2559
6c096b4aea67
added description and example of mod_python interface option TrackerLanguage
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2554
diff
changeset
|
755 reduce the number of configuration directives. Support tracker has |
|
6c096b4aea67
added description and example of mod_python interface option TrackerLanguage
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2554
diff
changeset
|
756 russian user interface. The other tracker (devel) has english user |
|
6c096b4aea67
added description and example of mod_python interface option TrackerLanguage
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2554
diff
changeset
|
757 interface (default). |
|
2554
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
758 |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
759 Static files from ``html`` directory are served by apache itself - this |
|
4249
87b3e905ae2e
fixed typos in the installation instructions
Bernhard Reiter <Bernhard.Reiter@intevation.de>
parents:
4226
diff
changeset
|
760 is quicker and generally more robust than doing that from python. |
|
2554
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
761 Everything else is aliased to dummy (non-existing) ``py`` file, |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
762 which is handled by mod_python and our roundup module. |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
763 |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
764 Example mod_python configuration:: |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
765 |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
766 ################################################# |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
767 # Roundup Issue tracker |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
768 ################################################# |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
769 # enable Python optimizations (like 'python -O') |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
770 PythonOptimize On |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
771 # let apache handle static files from 'html' directories |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
772 AliasMatch /roundup/(.+)/@@file/(.*) /var/db/roundup/$1/html/$2 |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
773 # everything else is handled by roundup web UI |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
774 AliasMatch /roundup/([^/]+)/(?!@@file/)(.*) /var/db/roundup/$1/dummy.py/$2 |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
775 # roundup requires a slash after tracker name - add it if missing |
|
3965
248c3a7bc94d
seems like a reasonable patch
Richard Jones <richard@users.sourceforge.net>
parents:
3949
diff
changeset
|
776 RedirectMatch permanent ^/roundup/([^/]+)$ /roundup/$1/ |
|
2554
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
777 # common settings for all roundup trackers |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
778 <Directory /var/db/roundup/*> |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
779 Order allow,deny |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
780 Allow from all |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
781 AllowOverride None |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
782 Options None |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
783 AddHandler python-program .py |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
784 PythonHandler roundup.cgi.apache |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
785 # uncomment the following line to see tracebacks in the browser |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
786 # (note that *some* tracebacks will be displayed anyway) |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
787 #PythonDebug On |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
788 </Directory> |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
789 # roundup tracker homes |
|
2559
6c096b4aea67
added description and example of mod_python interface option TrackerLanguage
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2554
diff
changeset
|
790 <Directory /var/db/roundup/support> |
|
6c096b4aea67
added description and example of mod_python interface option TrackerLanguage
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2554
diff
changeset
|
791 PythonOption TrackerHome /var/db/roundup/support |
|
6c096b4aea67
added description and example of mod_python interface option TrackerLanguage
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2554
diff
changeset
|
792 PythonOption TrackerLanguage ru |
|
6c096b4aea67
added description and example of mod_python interface option TrackerLanguage
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2554
diff
changeset
|
793 </Directory> |
|
2554
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
794 <Directory /var/db/roundup/devel> |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
795 PythonOption TrackerHome /var/db/roundup/devel |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
796 </Directory> |
|
3965
248c3a7bc94d
seems like a reasonable patch
Richard Jones <richard@users.sourceforge.net>
parents:
3949
diff
changeset
|
797 |
| 3814 | 798 Notice that the ``/var/db/roundup`` path shown above refers to the directory |
|
3797
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
799 in which the tracker homes are stored. The actual value will thus depend on |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
800 your system. |
|
3799
ac4da2670516
trim trailing spaces
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3797
diff
changeset
|
801 |
|
3797
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
802 On Windows the corresponding lines will look similar to these:: |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
803 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
804 AliasMatch /roundup/(.+)/@@file/(.*) C:/DATA/roundup/$1/html/$2 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
805 AliasMatch /roundup/([^/]+)/(?!@@file/)(.*) C:/DATA/roundup/$1/dummy.py/$2 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
806 <Directory C:/DATA/roundup/*> |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
807 <Directory C:/DATA/roundup/support> |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
808 <Directory C:/DATA/roundup/devel> |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
809 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
810 In this example the directory hosting all of the tracker homes is |
|
3799
ac4da2670516
trim trailing spaces
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3797
diff
changeset
|
811 ``C:\DATA\roundup``. (Notice that you must use forward slashes in paths |
|
3797
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
812 inside the httpd.conf file!) |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
813 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
814 The URL for accessing these trackers then become: |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
815 `http://<roundupserver>/roundup/support/`` and |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
816 ``http://<roundupserver>/roundup/devel/`` |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
817 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
818 Note that in order to use https connections you must set up Apache for secure |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
819 serving with SSL. |
|
2554
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
820 |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
821 WSGI Variations |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
822 ~~~~~~~~~~~~~~~ |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
823 |
| 6163 | 824 .. index:: triple: web interface; apache; mod_wsgi |
| 825 single: wsgi; apache | |
| 826 | |
|
5938
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
827 Apache Alternate |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
828 ^^^^^^^^^^^^^^^^ |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
829 |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
830 This method from Thomas Arendsen Hein goes into a bit more detail and |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
831 is designed to allow you to run multiple roundup trackers each under |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
832 their own user. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
833 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
834 The tracker instances are read-only to the tracker user and located |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
835 under /srv/roundup/. The (writable) data files are stored in the home |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
836 directory of the user running the tracker. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
837 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
838 To install roundup, download and unpack a distribution tarball and run |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
839 the following as user "roundup":: |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
840 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
841 python setup.py build_doc |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
842 python setup.py sdist --manifest-only |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
843 python setup.py install --home="/home/roundup/install" --force |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
844 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
845 Create a user roundup-foo, group roundup-foo to run the tracker. Add |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
846 the following apache config to |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
847 /etc/apache2/sites-available/roundup-foo (under debian/Ubunutu, modify |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
848 as needed): |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
849 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
850 .. code:: xml |
|
3736
a2d22d0de0bc
WSGI support via roundup.cgi.wsgi_handler
Richard Jones <richard@users.sourceforge.net>
parents:
3731
diff
changeset
|
851 |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
852 ServerAdmin webmaster@example.com |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
853 ErrorLog /var/log/apache2/error.log |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
854 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
855 LogLevel notice |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
856 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
857 DocumentRoot /var/www/ |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
858 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
859 <VirtualHost *:80> |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
860 CustomLog /var/log/apache2/access.log vhost_combined |
|
3736
a2d22d0de0bc
WSGI support via roundup.cgi.wsgi_handler
Richard Jones <richard@users.sourceforge.net>
parents:
3731
diff
changeset
|
861 |
|
5911
133efe1fbff7
doc/installation.txt: replace tabs, remove trailing spaces
Thomas Arendsen Hein <thomas@intevation.de>
parents:
5910
diff
changeset
|
862 # allow access to roundup docs |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
863 Alias /doc/ /home/roundup/install/share/doc/roundup/html/ |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
864 |
|
5911
133efe1fbff7
doc/installation.txt: replace tabs, remove trailing spaces
Thomas Arendsen Hein <thomas@intevation.de>
parents:
5910
diff
changeset
|
865 # make apache serve static assets like css rather than |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
866 # having roundup serve the files |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
867 Alias /foo/@@file/ /srv/roundup/foo/html/ |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
868 |
|
5911
133efe1fbff7
doc/installation.txt: replace tabs, remove trailing spaces
Thomas Arendsen Hein <thomas@intevation.de>
parents:
5910
diff
changeset
|
869 # make /foo into /foo/ |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
870 RedirectMatch permanent ^/(foo)$ /$1/ |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
871 |
|
5911
133efe1fbff7
doc/installation.txt: replace tabs, remove trailing spaces
Thomas Arendsen Hein <thomas@intevation.de>
parents:
5910
diff
changeset
|
872 # start a wsgi daemon process running as user roundup-foo |
|
133efe1fbff7
doc/installation.txt: replace tabs, remove trailing spaces
Thomas Arendsen Hein <thomas@intevation.de>
parents:
5910
diff
changeset
|
873 # in group roundup-foo. This also changes directory to |
|
133efe1fbff7
doc/installation.txt: replace tabs, remove trailing spaces
Thomas Arendsen Hein <thomas@intevation.de>
parents:
5910
diff
changeset
|
874 # ~roundup-foo before it starts roundup.wsgi. |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
875 WSGIDaemonProcess roundup-foo display-name=roundup-foo user=roundup-foo group=roundup-foo threads=25 |
|
3736
a2d22d0de0bc
WSGI support via roundup.cgi.wsgi_handler
Richard Jones <richard@users.sourceforge.net>
parents:
3731
diff
changeset
|
876 |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
877 # make tracker available at /foo and tie it into the |
|
5911
133efe1fbff7
doc/installation.txt: replace tabs, remove trailing spaces
Thomas Arendsen Hein <thomas@intevation.de>
parents:
5910
diff
changeset
|
878 # wsgi script below. |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
879 WSGIScriptAlias /foo /srv/roundup/foo/roundup.wsgi |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
880 <Location /foo> |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
881 WSGIProcessGroup roundup-foo |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
882 </Location> |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
883 </VirtualHost> |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
884 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
885 The directory ~roundup-foo should have: |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
886 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
887 * a ``db`` subdirectory where messages and files will be stored |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
888 * a symbolic link called ``instance`` to /srv/roundup/foo which has |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
889 been initialized using ``roundup-admin``. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
890 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
891 The `Apache HTTP Server with mod_wsgi`_ section above has a simple |
|
5910
aec362e31fcd
doc/installation.txt: fix typo
Thomas Arendsen Hein <thomas@intevation.de>
parents:
5909
diff
changeset
|
892 WSGI handler. This is an enhanced version to be put into |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
893 ``/srv/roundup/foo/roundup.wsgi``. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
894 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
895 .. code:: python |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
896 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
897 import sys, os |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
898 sys.stdout = sys.stderr |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
899 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
900 enabled = True |
|
3736
a2d22d0de0bc
WSGI support via roundup.cgi.wsgi_handler
Richard Jones <richard@users.sourceforge.net>
parents:
3731
diff
changeset
|
901 |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
902 if enabled: |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
903 # Add the directory with the roundup installation |
|
5911
133efe1fbff7
doc/installation.txt: replace tabs, remove trailing spaces
Thomas Arendsen Hein <thomas@intevation.de>
parents:
5910
diff
changeset
|
904 # subdirectory to the python path. |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
905 sys.path.insert(0, '/home/roundup/install/lib/python') |
|
3736
a2d22d0de0bc
WSGI support via roundup.cgi.wsgi_handler
Richard Jones <richard@users.sourceforge.net>
parents:
3731
diff
changeset
|
906 |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
907 # obtain the WSGI request dispatcher |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
908 from roundup.cgi.wsgi_handler import RequestDispatcher |
|
5911
133efe1fbff7
doc/installation.txt: replace tabs, remove trailing spaces
Thomas Arendsen Hein <thomas@intevation.de>
parents:
5910
diff
changeset
|
909 |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
910 tracker_home = os.path.join(os.getcwd(), 'instance') |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
911 application = RequestDispatcher(tracker_home) |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
912 else: |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
913 def application(environ, start_response): |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
914 status = '503 Service Unavailable' |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
915 output = 'service is down for maintenance' |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
916 response_headers = [('Content-type', 'text/plain'), |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
917 ('Content-Length', str(len(output)))] |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
918 start_response(status, response_headers) |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
919 return [output] |
|
3736
a2d22d0de0bc
WSGI support via roundup.cgi.wsgi_handler
Richard Jones <richard@users.sourceforge.net>
parents:
3731
diff
changeset
|
920 |
|
5908
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
921 This handler allows you to temporarily disable the tracker by setting |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
922 "enabled = False", apache will automatically detect the changed |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
923 roundup.wsgi file and reload it. |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
924 |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
925 One last change is needed. In the tracker's config.ini change the db |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
926 parameter in the [main] section to be /home/roundup-foo/db. This will |
|
c7ab00dd6502
First pass at updated wsgi documentation
John Rouillard <rouilj@ieee.org>
parents:
5891
diff
changeset
|
927 put the files and messages in the db directory for the user. |
| 1228 | 928 |
| 6163 | 929 .. index:: pair: web interface; gunicorn |
| 930 single: wsgi; gunicorn | |
| 931 | |
|
5938
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
932 Gunicorn Installation |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
933 ^^^^^^^^^^^^^^^^^^^^^ |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
934 |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
935 To run with gunicorn use pip to install gunicorn. This configuration |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
936 uses a front end web server like nginx, hiawatha, apache configured as |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
937 a reverse proxy. See your web server's documentation on how to set it |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
938 up as a reverse proxy. |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
939 |
|
6390
7c852cad2ca8
Add wsgi.py to frontends. Update docs.
John Rouillard <rouilj@ieee.org>
parents:
6372
diff
changeset
|
940 The file wsgi.py (obtained from ``frontends/wsgi.py``) should be in |
|
7c852cad2ca8
Add wsgi.py to frontends. Update docs.
John Rouillard <rouilj@ieee.org>
parents:
6372
diff
changeset
|
941 the current directory with the contents:: |
|
5938
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
942 |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
943 # if roundup is not installed on the default PYTHONPATH |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
944 # set it here with: |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
945 import sys |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
946 sys.path.append('/path/to/roundup/install/directory') |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
947 |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
948 # obtain the WSGI request dispatcher |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
949 from roundup.cgi.wsgi_handler import RequestDispatcher |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
950 tracker_home = '/path/to/tracker/install/directory' |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
951 |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
952 app = RequestDispatcher(tracker_home) |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
953 |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
954 Assuming the proxy forwards /tracker, run gunicorn as:: |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
955 |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
956 SCRIPT_NAME=/tracker gunicorn --bind 127.0.0.1:8917 --timeout=10 wsgi:app |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
957 |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
958 this runs roundup at port 8917 on the loopback interface. You should |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
959 configure the reverse proxy to talk to 127.0.0.1 at port 8917. |
|
16eec1c41e0e
Add basic gunicorn configuration mechanism.
John Rouillard <rouilj@ieee.org>
parents:
5911
diff
changeset
|
960 |
| 6163 | 961 .. index:: pair: web interface; uWSGI |
| 962 single: wsgi; uWSGI | |
| 963 | |
| 5940 | 964 uWSGI Installation |
| 965 ^^^^^^^^^^^^^^^^^^ | |
| 966 | |
| 967 For a basic roundup install using uWSGI behind a front end server, | |
| 968 install uwsgi and the python3 (or python) plugin. Then run:: | |
| 969 | |
| 970 uwsgi --http-socket 127.0.0.1:8917 \ | |
| 971 --plugin python3 --mount=/tracker=wsgi.py \ | |
| 972 --manage-script-name --callable app | |
| 973 | |
| 974 using the same wsgi.py as was used for gunicorn. If you get path not | |
| 975 found errors, check the mount option. The /tracker entry must match | |
| 976 the path used for the [tracker] web value in the tracker's config.ini. | |
| 977 | |
| 1228 | 978 Configure an Email Interface |
| 979 ---------------------------- | |
| 980 | |
| 981 If you don't want to use the email component of Roundup, then remove the | |
|
1514
c706e55896d8
minor doc bug
Richard Jones <richard@users.sourceforge.net>
parents:
1507
diff
changeset
|
982 "``nosyreaction.py``" module from your tracker "``detectors``" directory. |
| 1228 | 983 |
|
1576
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
984 See `platform-specific notes`_ for steps that may be needed on your system. |
|
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
985 |
|
3754
9f4dd27ae843
documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents:
3736
diff
changeset
|
986 There are five supported ways to get emailed issues into the |
| 1228 | 987 Roundup tracker. You should pick ONE of the following, all |
| 988 of which will continue my example setup from above: | |
| 989 | |
|
3799
ac4da2670516
trim trailing spaces
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3797
diff
changeset
|
990 As a mail alias pipe process |
| 1228 | 991 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 992 | |
| 993 Set up a mail alias called "issue_tracker" as (include the quote marks): | |
| 3524 | 994 "``|/usr/bin/python /usr/bin/roundup-mailgw <tracker_home>``" |
| 995 (substitute ``/usr/bin`` for wherever roundup-mailgw is installed). | |
| 1228 | 996 |
|
3754
9f4dd27ae843
documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents:
3736
diff
changeset
|
997 In some installations (e.g. RedHat Linux and Fedora Core) you'll need to |
|
9f4dd27ae843
documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents:
3736
diff
changeset
|
998 set up smrsh so sendmail will accept the pipe command. In that case, |
|
9f4dd27ae843
documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents:
3736
diff
changeset
|
999 symlink ``/etc/smrsh/roundup-mailgw`` to "``/usr/bin/roundup-mailgw``" |
|
9f4dd27ae843
documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents:
3736
diff
changeset
|
1000 and change the command to:: |
| 1228 | 1001 |
| 1002 |roundup-mailgw /opt/roundup/trackers/support | |
|
3799
ac4da2670516
trim trailing spaces
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3797
diff
changeset
|
1003 |
| 1228 | 1004 To test the mail gateway on unix systems, try:: |
| 1005 | |
| 1006 echo test |mail -s '[issue] test' support@YOUR_DOMAIN_HERE | |
| 1007 | |
|
3722
41feeed84caa
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
3666
diff
changeset
|
1008 Be careful that some mail systems (postfix for example) will impost a |
|
41feeed84caa
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
3666
diff
changeset
|
1009 limits on processes they spawn. In particular postfix can set a file size |
|
41feeed84caa
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
3666
diff
changeset
|
1010 limit. *This can cause your Roundup database to become corrupted.* |
|
41feeed84caa
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
3666
diff
changeset
|
1011 |
|
41feeed84caa
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
3666
diff
changeset
|
1012 |
|
3447
83e358352e6e
minor correction to recent addition by Faheem Mitha
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3446
diff
changeset
|
1013 As a custom router/transport using a pipe process (Exim4 specific) |
|
3444
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1014 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1015 |
|
3446
2325b221bf47
link to exim site
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3444
diff
changeset
|
1016 The following configuration snippets for `Exim 4`_ configuration |
|
3444
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1017 implement a custom router & transport to accomplish mail delivery to |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1018 roundup-mailgw. A configuration for Exim3 is similar but not |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1019 included, since Exim3 is considered obsolete. |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1020 |
|
3446
2325b221bf47
link to exim site
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3444
diff
changeset
|
1021 .. _Exim 4: http://www.exim.org/ |
|
2325b221bf47
link to exim site
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3444
diff
changeset
|
1022 |
|
3444
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1023 This configuration is similar to the previous section, in that it uses |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1024 a pipe process. However, there are advantages to using a custom |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1025 router/transport process, if you are using Exim. |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1026 |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1027 * This avoids privilege escalation, since otherwise the pipe process |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1028 will run as the mail user, typically mail. The transport can be |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1029 configured to run as the user appropriate for the task at hand. In the |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1030 transport described in this section, Exim4 runs as the unprivileged |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1031 user ``roundup``. |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1032 |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1033 * Separate configuration is not required for each tracker |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1034 instance. When a email arrives at the server, Exim passes it through |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1035 the defined routers. The roundup_router looks for a match with one of |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1036 the roundup directories, and if there is one it is passed to the |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1037 roundup_transport, which uses the pipe process described in the |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1038 previous section (`As a mail alias pipe process`_). |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1039 |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1040 The matching is done in the line:: |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1041 |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1042 require_files = /usr/bin/roundup-mailgw:ROUNDUP_HOME/$local_part/schema.py |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1043 |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1044 The following configuration has been tested on Debian Sarge with |
|
3799
ac4da2670516
trim trailing spaces
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3797
diff
changeset
|
1045 Exim4. |
|
3444
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1046 |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1047 .. note:: |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1048 Note that the Debian Exim4 packages don't allow pipes in alias files |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1049 by default, so the method described in the section `As a mail alias |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1050 pipe process`_ will not work with the default configuration. However, |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1051 the method described in this section does. See the discussion in |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1052 ``/usr/share/doc/exim4-config/README.system_aliases`` on any Debian |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1053 system with Exim4 installed. |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1054 |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1055 For more Debian-specific information, see suggested addition to |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1056 README.Debian in |
|
5756
e48b039b0ec0
issue2550966: fix suboptimal links in docs.
John Rouillard <rouilj@ieee.org>
parents:
5610
diff
changeset
|
1057 https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=343283, which will |
|
3444
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1058 hopefully be merged into the Debian package eventually. |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1059 |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1060 This config makes a few assumptions: |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1061 |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1062 * That the mail address corresponding to the tracker instance has the |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1063 same name as the directory of the tracker instance, i.e. the mail |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1064 interface address corresponding to a Roundup instance called |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1065 ``/var/lib/roundup/trackers/mytracker`` is ``mytracker@your.host``. |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1066 |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1067 * That (at least) all the db subdirectories of all the tracker |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1068 instances (ie. ``/var/lib/roundup/trackers/*/db``) are owned by the same |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1069 user, in this case, 'roundup'. |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1070 |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1071 * That if the ``schema.py`` file exists, then the tracker is ready for |
|
3754
9f4dd27ae843
documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents:
3736
diff
changeset
|
1072 use. Another option is to use the ``config.ini`` file (this changed |
|
9f4dd27ae843
documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents:
3736
diff
changeset
|
1073 in 0.8 from ``config.py``). |
|
3444
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1074 |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1075 Macros for Roundup router/transport. Should be placed in the macros |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1076 section of the Exim4 config:: |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1077 |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1078 # Home dir for your Roundup installation |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1079 ROUNDUP_HOME=/var/lib/roundup/trackers |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1080 |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1081 # User and group for Roundup. |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1082 ROUNDUP_USER=roundup |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1083 ROUNDUP_GROUP=roundup |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1084 |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1085 Custom router for Roundup. This will (probably) work if placed at the |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1086 beginning of the router section of the Exim4 config:: |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1087 |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1088 roundup_router: |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1089 driver = accept |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1090 # The config file config.ini seems like a more natural choice, but the |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1091 # file config.py was replaced by config.ini in 0.8, and schema.py needs |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1092 # to be present too. |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1093 require_files = /usr/bin/roundup-mailgw:ROUNDUP_HOME/$local_part/schema.py |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1094 transport = roundup_transport |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1095 |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1096 Custom transport for Roundup. This will (probably) work if placed at |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1097 the beginning of the router section of the Exim4 config:: |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1098 |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1099 roundup_transport: |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1100 driver = pipe |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1101 command = /usr/bin/python /usr/bin/roundup-mailgw ROUNDUP_HOME/$local_part/ |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1102 current_directory = ROUNDUP_HOME |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1103 home_directory = ROUNDUP_HOME |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1104 user = ROUNDUP_USER |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1105 group = ROUNDUP_GROUP |
|
0da93b338457
exim configuration instructions (from [SF#1393860])
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3421
diff
changeset
|
1106 |
|
1317
28ae91aae74f
clarifications
Richard Jones <richard@users.sourceforge.net>
parents:
1316
diff
changeset
|
1107 As a regular job using a mailbox source |
|
28ae91aae74f
clarifications
Richard Jones <richard@users.sourceforge.net>
parents:
1316
diff
changeset
|
1108 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 1228 | 1109 |
|
3405
292fbed108ca
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
3335
diff
changeset
|
1110 Set ``roundup-mailgw`` up to run every 10 minutes or so. For example |
| 3524 | 1111 (substitute ``/usr/bin`` for wherever roundup-mailgw is installed):: |
| 1228 | 1112 |
| 3524 | 1113 0,10,20,30,40,50 * * * * /usr/bin/roundup-mailgw /opt/roundup/trackers/support mailbox <mail_spool_file> |
| 1228 | 1114 |
| 1115 Where the ``mail_spool_file`` argument is the location of the roundup submission | |
| 1116 user's mail spool. On most systems, the spool for a user "issue_tracker" | |
| 1117 will be "``/var/mail/issue_tracker``". | |
| 1118 | |
|
1317
28ae91aae74f
clarifications
Richard Jones <richard@users.sourceforge.net>
parents:
1316
diff
changeset
|
1119 As a regular job using a POP source |
|
28ae91aae74f
clarifications
Richard Jones <richard@users.sourceforge.net>
parents:
1316
diff
changeset
|
1120 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 1228 | 1121 |
|
3405
292fbed108ca
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
3335
diff
changeset
|
1122 To retrieve from a POP mailbox, use a *cron* entry similar to the mailbox |
| 3524 | 1123 one (substitute ``/usr/bin`` for wherever roundup-mailgw is |
|
3405
292fbed108ca
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
3335
diff
changeset
|
1124 installed):: |
| 1228 | 1125 |
| 3524 | 1126 0,10,20,30,40,50 * * * * /usr/bin/roundup-mailgw /opt/roundup/trackers/support pop <pop_spec> |
|
1317
28ae91aae74f
clarifications
Richard Jones <richard@users.sourceforge.net>
parents:
1316
diff
changeset
|
1127 |
| 1228 | 1128 where pop_spec is "``username:password@server``" that specifies the roundup |
| 1129 submission user's POP account name, password and server. | |
| 1130 | |
|
1317
28ae91aae74f
clarifications
Richard Jones <richard@users.sourceforge.net>
parents:
1316
diff
changeset
|
1131 On windows, you would set up the command using the windows scheduler. |
|
28ae91aae74f
clarifications
Richard Jones <richard@users.sourceforge.net>
parents:
1316
diff
changeset
|
1132 |
|
2211
272b654b1227
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2186
diff
changeset
|
1133 As a regular job using an IMAP source |
|
272b654b1227
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2186
diff
changeset
|
1134 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
272b654b1227
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2186
diff
changeset
|
1135 |
|
272b654b1227
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2186
diff
changeset
|
1136 To retrieve from an IMAP mailbox, use a *cron* entry similar to the |
| 3524 | 1137 POP one (substitute ``/usr/bin`` for wherever roundup-mailgw is |
|
3405
292fbed108ca
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
3335
diff
changeset
|
1138 installed):: |
|
2211
272b654b1227
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2186
diff
changeset
|
1139 |
| 3524 | 1140 0,10,20,30,40,50 * * * * /usr/bin/roundup-mailgw /opt/roundup/trackers/support imap <imap_spec> |
|
2211
272b654b1227
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2186
diff
changeset
|
1141 |
|
272b654b1227
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2186
diff
changeset
|
1142 where imap_spec is "``username:password@server``" that specifies the roundup |
|
272b654b1227
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2186
diff
changeset
|
1143 submission user's IMAP account name, password and server. You may |
|
272b654b1227
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2186
diff
changeset
|
1144 optionally include a mailbox to use other than the default ``INBOX`` with |
|
272b654b1227
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2186
diff
changeset
|
1145 "``imap username:password@server mailbox``". |
|
272b654b1227
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2186
diff
changeset
|
1146 |
|
272b654b1227
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2186
diff
changeset
|
1147 If you have a secure (ie. HTTPS) IMAP server then you may use ``imaps`` |
|
272b654b1227
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2186
diff
changeset
|
1148 in place of ``imap`` in the command to use a secure connection. |
|
272b654b1227
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2186
diff
changeset
|
1149 |
|
272b654b1227
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2186
diff
changeset
|
1150 As with the POP job, on windows, you would set up the command using the |
|
272b654b1227
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2186
diff
changeset
|
1151 windows scheduler. |
|
272b654b1227
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2186
diff
changeset
|
1152 |
| 1228 | 1153 |
|
1939
1303c208419d
some updates that were sitting on disk
Richard Jones <richard@users.sourceforge.net>
parents:
1913
diff
changeset
|
1154 UNIX Environment Steps |
|
1303c208419d
some updates that were sitting on disk
Richard Jones <richard@users.sourceforge.net>
parents:
1913
diff
changeset
|
1155 ---------------------- |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1156 |
|
1089
43ab730ee194
instance -> tracker, node -> item
Richard Jones <richard@users.sourceforge.net>
parents:
1078
diff
changeset
|
1157 Each tracker ideally should have its own UNIX group, so create |
| 1049 | 1158 a UNIX group (edit ``/etc/group`` or your appropriate NIS map if |
| 1159 you're using NIS). To continue with my examples so far, I would | |
| 1160 create the UNIX group 'support', although the name of the UNIX | |
|
1089
43ab730ee194
instance -> tracker, node -> item
Richard Jones <richard@users.sourceforge.net>
parents:
1078
diff
changeset
|
1161 group does not have to be the same as the tracker name. To this |
| 1049 | 1162 'support' group I then add all of the UNIX usernames who will be |
|
1089
43ab730ee194
instance -> tracker, node -> item
Richard Jones <richard@users.sourceforge.net>
parents:
1078
diff
changeset
|
1163 working with this Roundup tracker. In addition to 'real' users, |
| 1049 | 1164 the Roundup email gateway will need to have permissions to this |
| 1165 area as well, so add the user your mail service runs as to the | |
|
1574
67af854f4c33
more installation hintage
Richard Jones <richard@users.sourceforge.net>
parents:
1571
diff
changeset
|
1166 group (typically "mail" or "daemon"). The UNIX group might then |
|
67af854f4c33
more installation hintage
Richard Jones <richard@users.sourceforge.net>
parents:
1571
diff
changeset
|
1167 look like:: |
| 1049 | 1168 |
| 1169 support:*:1002:jblaine,samh,geezer,mail | |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1170 |
| 1049 | 1171 If you intend to use the web interface (as most people do), you |
| 1172 should also add the username your web server runs as to the group. | |
| 1173 My group now looks like this:: | |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1174 |
| 1049 | 1175 support:*:1002:jblaine,samh,geezer,mail,apache |
| 1176 | |
|
1089
43ab730ee194
instance -> tracker, node -> item
Richard Jones <richard@users.sourceforge.net>
parents:
1078
diff
changeset
|
1177 The tracker "db" directory should be chmod'ed g+sw so that the group can |
|
1078
344bad728d10
more tweakage of help display and style issues
Richard Jones <richard@users.sourceforge.net>
parents:
1049
diff
changeset
|
1178 write to the database, and any new files created in the database will be owned |
|
344bad728d10
more tweakage of help display and style issues
Richard Jones <richard@users.sourceforge.net>
parents:
1049
diff
changeset
|
1179 by the group. |
|
344bad728d10
more tweakage of help display and style issues
Richard Jones <richard@users.sourceforge.net>
parents:
1049
diff
changeset
|
1180 |
|
2594
c0d6d5004464
rdbms doc updates
Richard Jones <richard@users.sourceforge.net>
parents:
2559
diff
changeset
|
1181 If you're using the mysql or postgresql backend then you'll need to ensure |
|
c0d6d5004464
rdbms doc updates
Richard Jones <richard@users.sourceforge.net>
parents:
2559
diff
changeset
|
1182 that the tracker user has appropriate permissions to create/modify the |
|
c0d6d5004464
rdbms doc updates
Richard Jones <richard@users.sourceforge.net>
parents:
2559
diff
changeset
|
1183 database. If you're using roundup.cgi, the apache user needs permissions |
|
c0d6d5004464
rdbms doc updates
Richard Jones <richard@users.sourceforge.net>
parents:
2559
diff
changeset
|
1184 to modify the database. Alternatively, explicitly specify a database login |
|
2921
ad4fb8a14a97
more doc updates, not so many TODOs any more
Richard Jones <richard@users.sourceforge.net>
parents:
2818
diff
changeset
|
1185 in ``rdbms`` -> ``user`` and ``password`` in ``config.ini``. |
|
2594
c0d6d5004464
rdbms doc updates
Richard Jones <richard@users.sourceforge.net>
parents:
2559
diff
changeset
|
1186 |
| 1049 | 1187 An alternative to the above is to create a new user who has the sole |
| 1188 responsibility of running roundup. This user: | |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1189 |
| 1049 | 1190 1. runs the CGI interface daemon |
| 1191 2. runs regular polls for email | |
| 1192 3. runs regular checks (using cron) to ensure the daemon is up | |
| 1193 4. optionally has no login password so that nobody but the "root" user | |
| 1194 may actually login and play with the roundup setup. | |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1195 |
|
3754
9f4dd27ae843
documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents:
3736
diff
changeset
|
1196 If you're using a Linux system (e.g. Fedora Core) with SELinux enabled, |
|
9f4dd27ae843
documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents:
3736
diff
changeset
|
1197 you will need to ensure that the db directory has a context that |
|
9f4dd27ae843
documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents:
3736
diff
changeset
|
1198 permits the web server to modify and create files. If you're using the |
|
9f4dd27ae843
documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents:
3736
diff
changeset
|
1199 mysql or postgresql backend you may also need to update your policy to |
|
9f4dd27ae843
documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents:
3736
diff
changeset
|
1200 allow the web server to access the database socket. |
|
9f4dd27ae843
documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents:
3736
diff
changeset
|
1201 |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1202 |
|
3830
a48c514c465f
Add simple anti-spam recipe to docs
Richard Jones <richard@users.sourceforge.net>
parents:
3814
diff
changeset
|
1203 Public Tracker Considerations |
|
a48c514c465f
Add simple anti-spam recipe to docs
Richard Jones <richard@users.sourceforge.net>
parents:
3814
diff
changeset
|
1204 ----------------------------- |
|
a48c514c465f
Add simple anti-spam recipe to docs
Richard Jones <richard@users.sourceforge.net>
parents:
3814
diff
changeset
|
1205 |
|
a48c514c465f
Add simple anti-spam recipe to docs
Richard Jones <richard@users.sourceforge.net>
parents:
3814
diff
changeset
|
1206 If you run a public tracker, you will eventually have to think about |
|
a48c514c465f
Add simple anti-spam recipe to docs
Richard Jones <richard@users.sourceforge.net>
parents:
3814
diff
changeset
|
1207 dealing with spam entered through both the web and mail interfaces. |
|
a48c514c465f
Add simple anti-spam recipe to docs
Richard Jones <richard@users.sourceforge.net>
parents:
3814
diff
changeset
|
1208 |
|
5300
d8ed32b297e2
Update to migrating backend and tweak to install doc.
John Rouillard <rouilj@ieee.org>
parents:
5140
diff
changeset
|
1209 See the section on `Preventing SPAM`_ in the |
|
d8ed32b297e2
Update to migrating backend and tweak to install doc.
John Rouillard <rouilj@ieee.org>
parents:
5140
diff
changeset
|
1210 `customisation documentation`_ that has a simple detector |
|
d8ed32b297e2
Update to migrating backend and tweak to install doc.
John Rouillard <rouilj@ieee.org>
parents:
5140
diff
changeset
|
1211 that will block lot of spam attempts. |
|
3830
a48c514c465f
Add simple anti-spam recipe to docs
Richard Jones <richard@users.sourceforge.net>
parents:
3814
diff
changeset
|
1212 |
|
2069
d8c7fd205cd8
info for installing the CSV module
Richard Jones <richard@users.sourceforge.net>
parents:
2003
diff
changeset
|
1213 |
| 1228 | 1214 Maintenance |
| 1215 =========== | |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1216 |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
1965
diff
changeset
|
1217 Read the separate `administration guide`_ for information about how to |
| 1228 | 1218 perform common maintenance tasks with Roundup. |
| 1049 | 1219 |
|
782
6f6eb43d9d86
Moved the MIGRATION text in with the rest of the docco, fixed up for 0.4.2
Richard Jones <richard@users.sourceforge.net>
parents:
753
diff
changeset
|
1220 |
|
6f6eb43d9d86
Moved the MIGRATION text in with the rest of the docco, fixed up for 0.4.2
Richard Jones <richard@users.sourceforge.net>
parents:
753
diff
changeset
|
1221 Upgrading |
|
6f6eb43d9d86
Moved the MIGRATION text in with the rest of the docco, fixed up for 0.4.2
Richard Jones <richard@users.sourceforge.net>
parents:
753
diff
changeset
|
1222 ========= |
|
6f6eb43d9d86
Moved the MIGRATION text in with the rest of the docco, fixed up for 0.4.2
Richard Jones <richard@users.sourceforge.net>
parents:
753
diff
changeset
|
1223 |
|
882
b99948d32a2d
clearing up ambiguous ref name
Richard Jones <richard@users.sourceforge.net>
parents:
798
diff
changeset
|
1224 Read the separate `upgrading document`_, which describes the steps needed to |
|
1089
43ab730ee194
instance -> tracker, node -> item
Richard Jones <richard@users.sourceforge.net>
parents:
1078
diff
changeset
|
1225 upgrade existing tracker trackers for each version of Roundup that is |
|
782
6f6eb43d9d86
Moved the MIGRATION text in with the rest of the docco, fixed up for 0.4.2
Richard Jones <richard@users.sourceforge.net>
parents:
753
diff
changeset
|
1226 released. |
|
6f6eb43d9d86
Moved the MIGRATION text in with the rest of the docco, fixed up for 0.4.2
Richard Jones <richard@users.sourceforge.net>
parents:
753
diff
changeset
|
1227 |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1228 |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1229 Further Reading |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1230 =============== |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1231 |
|
3528
762d65fefea5
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
3524
diff
changeset
|
1232 If you intend to use Roundup with anything other than the default |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1233 templates, if you would like to hack on Roundup, or if you would |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1234 like implementation details, you should read `Customising Roundup`_. |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1235 |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1236 |
|
1576
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
1237 Running Multiple Trackers |
|
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
1238 ========================= |
|
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
1239 |
|
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
1240 Things to think about before you jump off the deep end and install |
|
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
1241 multiple trackers, which involve additional URLs, user databases, email |
|
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
1242 addresses, databases to back up, etc. |
|
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
1243 |
|
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
1244 1. Do you want a tracker per product you sell/support? You can just add |
|
2161
98656054ccfa
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2069
diff
changeset
|
1245 a new property to your issues called Product, and filter by that. See |
|
98656054ccfa
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2069
diff
changeset
|
1246 the customisation example `adding a new field to the classic schema`_. |
|
1576
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
1247 2. Do you want to track internal software development issues and customer |
|
2186
3f89c8ffe4f1
version info in scripts
Richard Jones <richard@users.sourceforge.net>
parents:
2179
diff
changeset
|
1248 support issues separately? You can just set up an additional "issue" |
|
1576
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
1249 class called "cust_issues" in the same tracker, mimicing the normal |
|
2161
98656054ccfa
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2069
diff
changeset
|
1250 "issue" class, but with different properties. See the customisation |
|
98656054ccfa
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2069
diff
changeset
|
1251 example `tracking different types of issues`_. |
|
1576
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
1252 |
|
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
1253 |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1254 Platform-Specific Notes |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1255 ======================= |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1256 |
|
1649
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1257 Windows command-line tools |
|
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1258 -------------------------- |
|
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1259 |
|
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1260 To make the command-line tools accessible in Windows, you need to update |
|
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1261 the "Path" environment variable in the Registry via a dialog box. |
|
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1262 |
|
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1263 On Windows 2000 and later: |
|
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1264 |
|
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1265 1) Press the "Start" button. |
|
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1266 2) Choose "Settings" |
|
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1267 3) Choose "Control Panel" |
|
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1268 4) Choose "System" |
|
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1269 5) Choose "Advanced" |
|
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1270 6) Choose "Environmental Variables" |
|
1746
9c1da921cd35
minor rest tweak
Richard Jones <richard@users.sourceforge.net>
parents:
1688
diff
changeset
|
1271 7) Add: "<dir>\Scripts" to the "Path" environmental variable. |
|
1649
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1272 |
| 1747 | 1273 Where <dir> in 7) is the root directory (e.g., ``C:\Python22\Scripts``) |
|
1649
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1274 of your Python installation. |
|
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1275 |
|
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1276 I understand that in XP, 2) above is not needed as "Control |
|
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1277 Panel" is directly accessible from "Start". |
|
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1278 |
|
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1279 I do not believe this is possible to do in previous versions of Windows. |
|
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1280 |
|
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1281 |
|
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1282 Windows Server |
|
6d392197daa3
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
1648
diff
changeset
|
1283 -------------- |
|
1576
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
1284 |
|
3797
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1285 To have the Roundup web server start up when your machine boots up, there |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1286 are two different methods, the scheduler and installing the service. |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1287 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1288 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1289 1. Using the Windows scheduler |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1290 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1291 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1292 Set up the following in Scheduled Tasks (note, the following is for a |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1293 cygwin setup): |
|
1576
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
1294 |
|
3797
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1295 **Run** |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1296 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1297 ``c:\cygwin\bin\bash.exe -c "roundup-server TheProject=/opt/roundup/trackers/support"`` |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1298 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1299 **Start In** |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1300 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1301 ``C:\cygwin\opt\roundup\bin`` |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1302 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1303 **Schedule** |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1304 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1305 At System Startup |
|
1576
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
1306 |
|
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
1307 To have the Roundup mail gateway run periodically to poll a POP email address, |
|
3797
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1308 set up the following in Scheduled Tasks: |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1309 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1310 **Run** |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1311 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1312 ``c:\cygwin\bin\bash.exe -c "roundup-mailgw /opt/roundup/trackers/support pop roundup:roundup@mail-server"`` |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1313 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1314 **Start In** |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1315 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1316 ``C:\cygwin\opt\roundup\bin`` |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1317 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1318 **Schedule** |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1319 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1320 Every 10 minutes from 5:00AM for 24 hours every day |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1321 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1322 Stop the task if it runs for 8 minutes |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1323 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1324 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1325 2. Installing the roundup server as a Windows service |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1326 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1327 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1328 This is more Windows oriented and will make the Roundup server run as |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1329 soon as the PC starts up without any need for a login or such. It will |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1330 also be available in the normal Windows Administrative Tools. |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1331 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1332 For this you need first to create a service ini file containing the |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1333 relevant settings. |
|
1588
1ac46e7e4150
more doc work - new improved overview doc
Richard Jones <richard@users.sourceforge.net>
parents:
1576
diff
changeset
|
1334 |
|
3797
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1335 1. It is created if you execute the following command from within the |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1336 scripts directory (notice the use of backslashes):: |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1337 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1338 roundup-server -S -C <trackersdir>\server.ini -n <servername> -p 8080 -l <trackersdir>\trackerlog.log software=<trackersdir>\Software |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1339 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1340 where the item ``<trackersdir>`` is replaced with the physical directory |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1341 that hosts all of your trackers. The ``<servername>`` item is the name |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1342 of your roundup server PC, such as w2003srv or similar. |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1343 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1344 2. Next open the now created file ``C:\DATA\roundup\server.ini`` file |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1345 (if your ``<trackersdir>`` is ``C:\DATA\roundup``). |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1346 Check the entries for correctness, especially this one:: |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1347 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1348 [trackers] |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1349 software = C:\DATA\Roundup\Software |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1350 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1351 (this is an example where the tracker is named software and its home is |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1352 ``C:\DATA\Roundup\Software``) |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1353 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1354 3. Next give the commands that actually installs and starts the service:: |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1355 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1356 roundup-server -C C:\DATA\Roundup\server.ini -c install |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1357 roundup-server -c start |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1358 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1359 4. Finally open the AdministrativeTools/Services applet and locate the |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1360 Roundup service entry. Open its properties and change it to start |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1361 automatically instead of manually. |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1362 |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1363 If you are using Apache as the webserver you might want to use it with |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1364 mod_python instead to serve out Roundup. In that case see the mod_python |
|
bb6e8fafa341
Updated Windows installation docs (thanks Bo Berglund)
Richard Jones <richard@users.sourceforge.net>
parents:
3794
diff
changeset
|
1365 instructions above for details. |
|
1576
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
1366 |
|
80519db85eac
More tweaks to the licensing to make the Debian folks happy :)
Richard Jones <richard@users.sourceforge.net>
parents:
1574
diff
changeset
|
1367 |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1368 Sendmail smrsh |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1369 -------------- |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1370 |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1371 If you use Sendmail's ``smrsh`` mechanism, you will need to tell |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1372 smrsh that roundup-mailgw is a valid/trusted mail handler |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1373 before it will work. |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1374 |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1375 This is usually done via the following 2 steps: |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1376 |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1377 1. make a symlink in ``/etc/smrsh`` called ``roundup-mailgw`` |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1378 which points to the full path of your actual ``roundup-mailgw`` |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1379 script. |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1380 |
|
1089
43ab730ee194
instance -> tracker, node -> item
Richard Jones <richard@users.sourceforge.net>
parents:
1078
diff
changeset
|
1381 2. change your alias to ``"|roundup-mailgw <tracker_home>"`` |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1382 |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1383 |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1384 Linux |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1385 ----- |
|
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1386 |
|
1939
1303c208419d
some updates that were sitting on disk
Richard Jones <richard@users.sourceforge.net>
parents:
1913
diff
changeset
|
1387 Make sure you read the instructions under `UNIX environment steps`_. |
|
1574
67af854f4c33
more installation hintage
Richard Jones <richard@users.sourceforge.net>
parents:
1571
diff
changeset
|
1388 |
|
67af854f4c33
more installation hintage
Richard Jones <richard@users.sourceforge.net>
parents:
1571
diff
changeset
|
1389 |
|
67af854f4c33
more installation hintage
Richard Jones <richard@users.sourceforge.net>
parents:
1571
diff
changeset
|
1390 Solaris |
|
67af854f4c33
more installation hintage
Richard Jones <richard@users.sourceforge.net>
parents:
1571
diff
changeset
|
1391 ------- |
|
67af854f4c33
more installation hintage
Richard Jones <richard@users.sourceforge.net>
parents:
1571
diff
changeset
|
1392 |
|
67af854f4c33
more installation hintage
Richard Jones <richard@users.sourceforge.net>
parents:
1571
diff
changeset
|
1393 You'll need to build Python. |
|
67af854f4c33
more installation hintage
Richard Jones <richard@users.sourceforge.net>
parents:
1571
diff
changeset
|
1394 |
|
1939
1303c208419d
some updates that were sitting on disk
Richard Jones <richard@users.sourceforge.net>
parents:
1913
diff
changeset
|
1395 Make sure you read the instructions under `UNIX environment steps`_. |
|
1303c208419d
some updates that were sitting on disk
Richard Jones <richard@users.sourceforge.net>
parents:
1913
diff
changeset
|
1396 |
|
1574
67af854f4c33
more installation hintage
Richard Jones <richard@users.sourceforge.net>
parents:
1571
diff
changeset
|
1397 |
|
2972
dd558120d927
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2945
diff
changeset
|
1398 Problems? Testing your Python... |
|
dd558120d927
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2945
diff
changeset
|
1399 ================================ |
|
dd558120d927
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2945
diff
changeset
|
1400 |
|
dd558120d927
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2945
diff
changeset
|
1401 .. note:: |
|
6297
a635a60ffb84
Remove standalone pytest run_tests.py bundle
John Rouillard <rouilj@ieee.org>
parents:
6265
diff
changeset
|
1402 The ``run_tests.py`` script is not packaged in Roundup's source |
|
a635a60ffb84
Remove standalone pytest run_tests.py bundle
John Rouillard <rouilj@ieee.org>
parents:
6265
diff
changeset
|
1403 distribution anymore. You should install pytest using your |
|
a635a60ffb84
Remove standalone pytest run_tests.py bundle
John Rouillard <rouilj@ieee.org>
parents:
6265
diff
changeset
|
1404 distributions package manger or using pip/pip2/pip3 to install |
|
a635a60ffb84
Remove standalone pytest run_tests.py bundle
John Rouillard <rouilj@ieee.org>
parents:
6265
diff
changeset
|
1405 pytest for your python version. See the `administration guide`_ |
|
a635a60ffb84
Remove standalone pytest run_tests.py bundle
John Rouillard <rouilj@ieee.org>
parents:
6265
diff
changeset
|
1406 for details. |
|
2972
dd558120d927
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2945
diff
changeset
|
1407 |
|
4317
15834821b8c7
- fix explicit python version description...
Ralf Schlatterbeck <schlatterbeck@users.sourceforge.net>
parents:
4315
diff
changeset
|
1408 Remember to have a database user 'rounduptest' prepared (with |
|
15834821b8c7
- fix explicit python version description...
Ralf Schlatterbeck <schlatterbeck@users.sourceforge.net>
parents:
4315
diff
changeset
|
1409 password 'rounduptest'). This user |
|
4315
cfb01b2bc730
Fix documentation on user required to run the tests, fixes issue2550618.
Ralf Schlatterbeck <schlatterbeck@users.sourceforge.net>
parents:
4249
diff
changeset
|
1410 must have at least the rights to create and drop databases. |
|
cfb01b2bc730
Fix documentation on user required to run the tests, fixes issue2550618.
Ralf Schlatterbeck <schlatterbeck@users.sourceforge.net>
parents:
4249
diff
changeset
|
1411 Documentation: details on `adding MySQL users`_, |
|
cfb01b2bc730
Fix documentation on user required to run the tests, fixes issue2550618.
Ralf Schlatterbeck <schlatterbeck@users.sourceforge.net>
parents:
4249
diff
changeset
|
1412 for PostgreSQL you want to call the ``createuser`` command with the |
|
cfb01b2bc730
Fix documentation on user required to run the tests, fixes issue2550618.
Ralf Schlatterbeck <schlatterbeck@users.sourceforge.net>
parents:
4249
diff
changeset
|
1413 ``-d`` option to allow database creation. |
|
cfb01b2bc730
Fix documentation on user required to run the tests, fixes issue2550618.
Ralf Schlatterbeck <schlatterbeck@users.sourceforge.net>
parents:
4249
diff
changeset
|
1414 |
|
6297
a635a60ffb84
Remove standalone pytest run_tests.py bundle
John Rouillard <rouilj@ieee.org>
parents:
6265
diff
changeset
|
1415 Once you've unpacked roundup's source, if you have pytest installed, |
|
a635a60ffb84
Remove standalone pytest run_tests.py bundle
John Rouillard <rouilj@ieee.org>
parents:
6265
diff
changeset
|
1416 run ``python -m pytest /test`` in the source directory and make sure |
|
a635a60ffb84
Remove standalone pytest run_tests.py bundle
John Rouillard <rouilj@ieee.org>
parents:
6265
diff
changeset
|
1417 there are no errors. If there are errors, please let us know! |
|
2972
dd558120d927
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2945
diff
changeset
|
1418 |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1419 .. _`table of contents`: index.html |
|
1287
5402a6f2a754
Added quotes around python interpreter in windows bat [SF#623963]
Richard Jones <richard@users.sourceforge.net>
parents:
1282
diff
changeset
|
1420 .. _`user guide`: user_guide.html |
|
4949
c3a90535f7a7
Backed out changeset 4a3a35192ad1
John Rouillard <rouilj@ieee.org>
parents:
4948
diff
changeset
|
1421 .. _`roundup specification`: spec.html |
|
1245
d8c98af869ff
merge from maint-0-5
Richard Jones <richard@users.sourceforge.net>
parents:
1244
diff
changeset
|
1422 .. _`tracker configuration`: customizing.html#tracker-configuration |
|
d8c98af869ff
merge from maint-0-5
Richard Jones <richard@users.sourceforge.net>
parents:
1244
diff
changeset
|
1423 .. _`customisation documentation`: customizing.html |
|
5300
d8ed32b297e2
Update to migrating backend and tweak to install doc.
John Rouillard <rouilj@ieee.org>
parents:
5140
diff
changeset
|
1424 .. _`preventing spam`: customizing.html#preventing-spam |
|
2161
98656054ccfa
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2069
diff
changeset
|
1425 .. _`Adding a new field to the classic schema`: |
|
98656054ccfa
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2069
diff
changeset
|
1426 customizing.html#adding-a-new-field-to-the-classic-schema |
|
98656054ccfa
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2069
diff
changeset
|
1427 .. _`Tracking different types of issues`: |
|
98656054ccfa
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2069
diff
changeset
|
1428 customizing.html#tracking-different-types-of-issues |
|
659
e429649ed124
More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1429 .. _`customising roundup`: customizing.html |
|
882
b99948d32a2d
clearing up ambiguous ref name
Richard Jones <richard@users.sourceforge.net>
parents:
798
diff
changeset
|
1430 .. _`upgrading document`: upgrading.html |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
1965
diff
changeset
|
1431 .. _`administration guide`: admin_guide.html |
|
2554
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
1432 |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
1433 |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
1434 .. _External hyperlink targets: |
|
52944e87909c
added mod_python setup example
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
2449
diff
changeset
|
1435 |
|
6391
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
1436 |
|
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
1437 |
|
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
1438 .. _`adding MySQL users`: |
|
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
1439 https://dev.mysql.com/doc/refman/8.0/en/creating-accounts.html |
|
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
1440 .. _apache: https://httpd.apache.org/ |
|
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
1441 .. _docutils: https://pypi.org/project/docutils/ |
|
5337
01dabc0483b0
more changes to prep for 1.6 release.
John Rouillard <rouilj@ieee.org>
parents:
5321
diff
changeset
|
1442 .. _flup: https://pypi.org/project/flup/ |
|
6391
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
1443 .. _gpg: https://www.gnupg.org/software/gpgme/index.html |
|
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
1444 .. _jinja2: https://palletsprojects.com/p/jinja/ |
|
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
1445 .. _markdown: https://python-markdown.github.io/ |
|
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
1446 .. _markdown2: https://github.com/trentm/python-markdown2 |
|
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
1447 .. _mistune: https://pypi.org/project/mistune/ |
|
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
1448 .. _mod_python: https://github.com/grisha/mod_python |
|
5891
6e341009593b
Deprecate mod_python issue2551005
John Rouillard <rouilj@ieee.org>
parents:
5878
diff
changeset
|
1449 .. _mod_wsgi: https://pypi.org/project/mod-wsgi/ |
|
5510
e2978ed3b550
update link to new mysqlclient module and recommend update in upgrading.txt
Christof Meerwald <cmeerw@cmeerw.org>
parents:
5494
diff
changeset
|
1450 .. _MySQLdb: https://pypi.org/project/mysqlclient/ |
|
6391
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
1451 .. _Olson tz database: https://www.iana.org/time-zones |
|
6262
ba82fb74f806
Update psycopg link to: https://www.psycopg.org/
John Rouillard <rouilj@ieee.org>
parents:
6221
diff
changeset
|
1452 .. _Psycopg: https://www.psycopg.org/ |
|
6391
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
1453 .. _pyjwt: https://pypi.org/project/PyJWT/ |
|
6419
4d321d52d67d
fix broken link for pyopenssl
John Rouillard <rouilj@ieee.org>
parents:
6391
diff
changeset
|
1454 .. _pyopenssl: https://pypi.org/project/pyOpenSSL/ |
|
5756
e48b039b0ec0
issue2550966: fix suboptimal links in docs.
John Rouillard <rouilj@ieee.org>
parents:
5610
diff
changeset
|
1455 .. _pysqlite: https://pysqlite.org/ |
|
6391
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
1456 .. _pytz: https://pypi.org/project/pytz/ |
|
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
1457 .. _pywin32: https://pypi.org/project/pywin32/ |
|
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
1458 .. _Whoosh: https://whoosh.readthedocs.org/en/latest |
|
205bc1d27985
Added links for pyjwt, markdown libs, rearranged links.
John Rouillard <rouilj@ieee.org>
parents:
6390
diff
changeset
|
1459 .. _Xapian: https://xapian.org/ |