Mercurial > p > roundup > code
annotate doc/admin_guide.txt @ 5201:a9ace22e0a2f
issue 2550690 - Adding anti-csrf measures to roundup following
https://www.owasp.org/index.php/Cross-Site_Request_Forgery_(CSRF)_Prevention_Cheat_Sheet
and
https://seclab.stanford.edu/websec/csrf/csrf.pdf
Basically implement Synchronizer (CSRF) Tokens per form on a page.
Single use (destroyed once used). Random input data for the token
includes:
system random implementation in python using /dev/urandom
(fallback to random based on timestamp as the seed. Not
as good, but should be ok for the short lifetime of the
token??)
the id (in cpython it's the memory address) of the object
requesting a token. In theory this depends on memory layout, the
history of the process (how many previous objects have been
allocated from the heap etc.) I claim without any proof that for
long running processes this is another source of randomness. For
short running processes with little activity it could be guessed.
last the floating point time.time() value is added. This may
only have 1 second resolution so may be guessable.
Hopefully for a short lived (2 week by default) token this is
sufficient. Also in the current implementation the user is notified when
validation fails and is told why. This allows the roundup admin to find
the log entry (at error level) and try to resolve the issue. In the
future user notification may change but for now this is probably best.
| author | John Rouillard <rouilj@ieee.org> |
|---|---|
| date | Sat, 18 Mar 2017 16:59:01 -0400 |
| parents | 7ea6bbf4286c |
| children | d8ed32b297e2 |
| rev | line source |
|---|---|
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1 ==================== |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
2 Administration Guide |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
3 ==================== |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
4 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
5 .. contents:: |
|
4890
609edf9de0a5
docs: Remove one nesting level from ToC on subpages
anatoly techtonik <techtonik@gmail.com>
parents:
4786
diff
changeset
|
6 :local: |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
7 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
8 What does Roundup install? |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
9 ========================== |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
10 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
11 There's two "installations" that we talk about when using Roundup: |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
12 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
13 1. The installation of the software and its support files. This uses the |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
14 standard Python mechanism called "distutils" and thus Roundup's core code, |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
15 executable scripts and support data files are installed in Python's |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
16 directories. On Windows, this is typically: |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
17 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
18 Scripts |
|
2068
65b5297b488f
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2005
diff
changeset
|
19 ``<python dir>\scripts\...`` |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
20 Core code |
|
2068
65b5297b488f
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2005
diff
changeset
|
21 ``<python dir>\lib\site-packages\roundup\...`` |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
22 Support files |
|
2068
65b5297b488f
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2005
diff
changeset
|
23 ``<python dir>\share\roundup\...`` |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
24 |
|
2005
fc52d57c6c3e
documentation cleanup
Richard Jones <richard@users.sourceforge.net>
parents:
2003
diff
changeset
|
25 and on Unix-like systems (eg. Linux): |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
26 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
27 Scripts |
|
2068
65b5297b488f
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2005
diff
changeset
|
28 ``<python root>/bin/...`` |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
29 Core code |
|
2068
65b5297b488f
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2005
diff
changeset
|
30 ``<python root>/lib-<python version>/site-packages/roundup/...`` |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
31 Support files |
|
2068
65b5297b488f
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2005
diff
changeset
|
32 ``<python root>/share/roundup/...`` |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
33 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
34 2. The installation of a specific tracker. When invoking the roundup-admin |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
35 "inst" (and "init") commands, you're creating a new Roundup tracker. This |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
36 installs configuration files, HTML templates, detector code and a new |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
37 database. You have complete control over where this stuff goes through |
|
2921
ad4fb8a14a97
more doc updates, not so many TODOs any more
Richard Jones <richard@users.sourceforge.net>
parents:
2632
diff
changeset
|
38 both choosing your "tracker home" and the ``main`` -> ``database`` variable |
|
3780
158e31bbf86a
recent patch had lines longer than 80 chars - rewrap; trim trailing spaces
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3779
diff
changeset
|
39 in the tracker's config.ini. |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
40 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
41 |
|
2572
d15b71b8a85a
more logging goodness
Richard Jones <richard@users.sourceforge.net>
parents:
2479
diff
changeset
|
42 Configuring Roundup's Logging of Messages For Sysadmins |
|
d15b71b8a85a
more logging goodness
Richard Jones <richard@users.sourceforge.net>
parents:
2479
diff
changeset
|
43 ======================================================= |
|
d15b71b8a85a
more logging goodness
Richard Jones <richard@users.sourceforge.net>
parents:
2479
diff
changeset
|
44 |
|
2921
ad4fb8a14a97
more doc updates, not so many TODOs any more
Richard Jones <richard@users.sourceforge.net>
parents:
2632
diff
changeset
|
45 You may configure where Roundup logs messages in your tracker's config.ini |
|
4786
6018617c55ab
Removing remains of "rlog" module, fixes db unit test debug logging via environment variable.
Bernhard Reiter <bernhard@intevation.de>
parents:
4567
diff
changeset
|
46 file. Roundup will use the standard Python (2.3+) logging implementation. |
|
2572
d15b71b8a85a
more logging goodness
Richard Jones <richard@users.sourceforge.net>
parents:
2479
diff
changeset
|
47 |
|
2921
ad4fb8a14a97
more doc updates, not so many TODOs any more
Richard Jones <richard@users.sourceforge.net>
parents:
2632
diff
changeset
|
48 Configuration for standard "logging" module: |
|
2572
d15b71b8a85a
more logging goodness
Richard Jones <richard@users.sourceforge.net>
parents:
2479
diff
changeset
|
49 - tracker configuration file specifies the location of a logging |
|
2921
ad4fb8a14a97
more doc updates, not so many TODOs any more
Richard Jones <richard@users.sourceforge.net>
parents:
2632
diff
changeset
|
50 configration file as ``logging`` -> ``config`` |
|
2572
d15b71b8a85a
more logging goodness
Richard Jones <richard@users.sourceforge.net>
parents:
2479
diff
changeset
|
51 - ``roundup-server`` specifies the location of a logging configuration |
|
d15b71b8a85a
more logging goodness
Richard Jones <richard@users.sourceforge.net>
parents:
2479
diff
changeset
|
52 file on the command line |
|
d15b71b8a85a
more logging goodness
Richard Jones <richard@users.sourceforge.net>
parents:
2479
diff
changeset
|
53 Configuration for "BasicLogging" implementation: |
|
d15b71b8a85a
more logging goodness
Richard Jones <richard@users.sourceforge.net>
parents:
2479
diff
changeset
|
54 - tracker configuration file specifies the location of a log file |
|
2921
ad4fb8a14a97
more doc updates, not so many TODOs any more
Richard Jones <richard@users.sourceforge.net>
parents:
2632
diff
changeset
|
55 ``logging`` -> ``filename`` |
|
2572
d15b71b8a85a
more logging goodness
Richard Jones <richard@users.sourceforge.net>
parents:
2479
diff
changeset
|
56 - tracker configuration file specifies the level to log to as |
|
2921
ad4fb8a14a97
more doc updates, not so many TODOs any more
Richard Jones <richard@users.sourceforge.net>
parents:
2632
diff
changeset
|
57 ``logging`` -> ``level`` |
|
2572
d15b71b8a85a
more logging goodness
Richard Jones <richard@users.sourceforge.net>
parents:
2479
diff
changeset
|
58 - ``roundup-server`` specifies the location of a log file on the command |
|
d15b71b8a85a
more logging goodness
Richard Jones <richard@users.sourceforge.net>
parents:
2479
diff
changeset
|
59 line |
|
d15b71b8a85a
more logging goodness
Richard Jones <richard@users.sourceforge.net>
parents:
2479
diff
changeset
|
60 - ``roundup-server`` specifies the level to log to on the command line |
|
d15b71b8a85a
more logging goodness
Richard Jones <richard@users.sourceforge.net>
parents:
2479
diff
changeset
|
61 |
|
d15b71b8a85a
more logging goodness
Richard Jones <richard@users.sourceforge.net>
parents:
2479
diff
changeset
|
62 (``roundup-mailgw`` always logs to the tracker's log file) |
|
d15b71b8a85a
more logging goodness
Richard Jones <richard@users.sourceforge.net>
parents:
2479
diff
changeset
|
63 |
|
d15b71b8a85a
more logging goodness
Richard Jones <richard@users.sourceforge.net>
parents:
2479
diff
changeset
|
64 In both cases, if no logfile is specified then logging will simply be sent |
|
d15b71b8a85a
more logging goodness
Richard Jones <richard@users.sourceforge.net>
parents:
2479
diff
changeset
|
65 to sys.stderr with only logging of ERROR messages. |
|
d15b71b8a85a
more logging goodness
Richard Jones <richard@users.sourceforge.net>
parents:
2479
diff
changeset
|
66 |
| 3250 | 67 |
|
2632
9c55f2bc5961
roundup-server now has a configuration file (-C option)
Richard Jones <richard@users.sourceforge.net>
parents:
2572
diff
changeset
|
68 Configuring roundup-server |
|
9c55f2bc5961
roundup-server now has a configuration file (-C option)
Richard Jones <richard@users.sourceforge.net>
parents:
2572
diff
changeset
|
69 ========================== |
|
9c55f2bc5961
roundup-server now has a configuration file (-C option)
Richard Jones <richard@users.sourceforge.net>
parents:
2572
diff
changeset
|
70 |
|
5102
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
71 The basic configuration file is as follows (taken from the |
|
2632
9c55f2bc5961
roundup-server now has a configuration file (-C option)
Richard Jones <richard@users.sourceforge.net>
parents:
2572
diff
changeset
|
72 ``roundup-server.ini.example`` file in the "doc" directory):: |
|
9c55f2bc5961
roundup-server now has a configuration file (-C option)
Richard Jones <richard@users.sourceforge.net>
parents:
2572
diff
changeset
|
73 |
|
5102
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
74 [main] |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
75 |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
76 # Host name of the Roundup web server instance. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
77 # If left unconfigured (no 'host' setting) the default |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
78 # will be used. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
79 # If empty, listen on all network interfaces. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
80 # If you want to explicitly listen on all |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
81 # network interfaces, the address 0.0.0.0 is a more |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
82 # explicit way to achieve this, the use of an empty |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
83 # string for this purpose is deprecated and will go away |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
84 # in a future release. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
85 # Default: localhost |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
86 host = localhost |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
87 |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
88 # Port to listen on. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
89 # Default: 8080 |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
90 port = 8017 |
|
2632
9c55f2bc5961
roundup-server now has a configuration file (-C option)
Richard Jones <richard@users.sourceforge.net>
parents:
2572
diff
changeset
|
91 |
|
5102
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
92 # Path to favicon.ico image file. If unset, built-in favicon.ico is used. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
93 # The path may be either absolute or relative |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
94 # to the directory containing this config file. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
95 # Default: favicon.ico |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
96 favicon = favicon.ico |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
97 |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
98 # User ID as which the server will answer requests. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
99 # In order to use this option, the server must be run initially as root. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
100 # Availability: Unix. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
101 # Default: |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
102 user = roundup |
|
2632
9c55f2bc5961
roundup-server now has a configuration file (-C option)
Richard Jones <richard@users.sourceforge.net>
parents:
2572
diff
changeset
|
103 |
|
5102
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
104 # Group ID as which the server will answer requests. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
105 # In order to use this option, the server must be run initially as root. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
106 # Availability: Unix. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
107 # Default: |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
108 group = |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
109 |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
110 # don't fork (this overrides the pidfile mechanism)' |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
111 # Allowed values: yes, no |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
112 # Default: no |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
113 nodaemon = no |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
114 |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
115 # Log client machine names instead of IP addresses (much slower) |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
116 # Allowed values: yes, no |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
117 # Default: no |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
118 log_hostnames = no |
|
2632
9c55f2bc5961
roundup-server now has a configuration file (-C option)
Richard Jones <richard@users.sourceforge.net>
parents:
2572
diff
changeset
|
119 |
|
5102
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
120 # File to which the server records the process id of the daemon. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
121 # If this option is not set, the server will run in foreground |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
122 # |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
123 # The path may be either absolute or relative |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
124 # to the directory containing this config file. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
125 # Default: |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
126 pidfile = |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
127 |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
128 # Log file path. If unset, log to stderr. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
129 # The path may be either absolute or relative |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
130 # to the directory containing this config file. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
131 # Default: |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
132 logfile = |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
133 |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
134 # Set processing of each request in separate subprocess. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
135 # Allowed values: debug, none, thread, fork. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
136 # Default: fork |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
137 multiprocess = fork |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
138 |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
139 # Tracker index template. If unset, built-in will be used. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
140 # The path may be either absolute or relative |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
141 # to the directory containing this config file. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
142 # Default: |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
143 template = |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
144 |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
145 # Enable SSL support (requires pyopenssl) |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
146 # Allowed values: yes, no |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
147 # Default: no |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
148 ssl = no |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
149 |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
150 # PEM file used for SSL. A temporary self-signed certificate |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
151 # will be used if left blank. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
152 # The path may be either absolute or relative |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
153 # to the directory containing this config file. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
154 # Default: |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
155 pem = |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
156 |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
157 # Roundup trackers to serve. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
158 # Each option in this section defines single Roundup tracker. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
159 # Option name identifies the tracker and will appear in the URL. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
160 # Option value is tracker home directory path. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
161 # The path may be either absolute or relative |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
162 # to the directory containing this config file. |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
163 [trackers] |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
164 |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
165 demo = /trackers/demo |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
166 sysadmin = /trackers/sysadmin |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
167 |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
168 Additional notes for each keyword: |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
169 |
|
3880
2359d6304a4f
Allow template for tracker index page
Justus Pendleton <jpend@users.sourceforge.net>
parents:
3781
diff
changeset
|
170 **template** |
|
2359d6304a4f
Allow template for tracker index page
Justus Pendleton <jpend@users.sourceforge.net>
parents:
3781
diff
changeset
|
171 Specifies a template used for displaying the tracker index when |
|
5102
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
172 multiple trackers are being used. It is processed by TAL and |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
173 the variable "trackers" is available to the template and is a |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
174 dict of all configured trackers. |
|
3883
679118b572d5
add SSL to roundup-server via pyopenssl
Justus Pendleton <jpend@users.sourceforge.net>
parents:
3880
diff
changeset
|
175 **ssl** |
|
679118b572d5
add SSL to roundup-server via pyopenssl
Justus Pendleton <jpend@users.sourceforge.net>
parents:
3880
diff
changeset
|
176 Enables the use of SSL to secure the connection to the roundup-server. |
|
679118b572d5
add SSL to roundup-server via pyopenssl
Justus Pendleton <jpend@users.sourceforge.net>
parents:
3880
diff
changeset
|
177 If you enable this, ensure that your tracker's config.ini specifies |
|
679118b572d5
add SSL to roundup-server via pyopenssl
Justus Pendleton <jpend@users.sourceforge.net>
parents:
3880
diff
changeset
|
178 an *https* URL. |
|
679118b572d5
add SSL to roundup-server via pyopenssl
Justus Pendleton <jpend@users.sourceforge.net>
parents:
3880
diff
changeset
|
179 **pem** |
|
679118b572d5
add SSL to roundup-server via pyopenssl
Justus Pendleton <jpend@users.sourceforge.net>
parents:
3880
diff
changeset
|
180 If specified, the SSL PEM file containing the private key and certificate. |
|
679118b572d5
add SSL to roundup-server via pyopenssl
Justus Pendleton <jpend@users.sourceforge.net>
parents:
3880
diff
changeset
|
181 If not specified, roundup will generate a temporary, self-signed certificate |
|
679118b572d5
add SSL to roundup-server via pyopenssl
Justus Pendleton <jpend@users.sourceforge.net>
parents:
3880
diff
changeset
|
182 for use. |
|
3465
81542d49c8cb
fix admin doc description of roundup-server config file
Richard Jones <richard@users.sourceforge.net>
parents:
3341
diff
changeset
|
183 **trackers** section |
|
81542d49c8cb
fix admin doc description of roundup-server config file
Richard Jones <richard@users.sourceforge.net>
parents:
3341
diff
changeset
|
184 Each line denotes a mapping from a URL component to a tracker home. |
|
81542d49c8cb
fix admin doc description of roundup-server config file
Richard Jones <richard@users.sourceforge.net>
parents:
3341
diff
changeset
|
185 Make sure the name part doesn't include any url-unsafe characters like |
|
81542d49c8cb
fix admin doc description of roundup-server config file
Richard Jones <richard@users.sourceforge.net>
parents:
3341
diff
changeset
|
186 spaces. Stick to alphanumeric characters and you'll be ok. |
|
2632
9c55f2bc5961
roundup-server now has a configuration file (-C option)
Richard Jones <richard@users.sourceforge.net>
parents:
2572
diff
changeset
|
187 |
|
5102
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
188 To generate a config.ini in the current directory (note it will |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
189 overwrite an existing file) from the roundup-server command line use:: |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
190 |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
191 roundup_server -p 8017 -u roundup --save-config demo=/trackers/demo \ |
|
96dc9f07340a
issue2161722: oudated docs
John Rouillard <rouilj@ieee.org>
parents:
4891
diff
changeset
|
192 sysadmin=/trackers/sysadmin |
|
2572
d15b71b8a85a
more logging goodness
Richard Jones <richard@users.sourceforge.net>
parents:
2479
diff
changeset
|
193 |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
194 Users and Security |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
195 ================== |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
196 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
197 Roundup holds its own user database which primarily contains a username, |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
198 password and email address for the user. Roundup *must* have its own user |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
199 listing, in order to maintain internal consistency of its data. It is a |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
200 relatively simple exercise to update this listing on a regular basis, or on |
|
4891
ad3d628e73f2
docs: Link custom authentication examples in admin guide
anatoly techtonik <techtonik@gmail.com>
parents:
4890
diff
changeset
|
201 demand, so that it matches an external listing (eg. |
|
ad3d628e73f2
docs: Link custom authentication examples in admin guide
anatoly techtonik <techtonik@gmail.com>
parents:
4890
diff
changeset
|
202 :ref:`unix passwd file<external-authentication>`, |
|
ad3d628e73f2
docs: Link custom authentication examples in admin guide
anatoly techtonik <techtonik@gmail.com>
parents:
4890
diff
changeset
|
203 `LDAP <http://www.roundup-tracker.org/cgi-bin/moin.cgi/LDAPLogin>`_, etc.) |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
204 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
205 Roundup identifies users in a number of ways: |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
206 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
207 1. Through the web, users may be identified by either HTTP Basic |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
208 Authentication or cookie authentication. If you are running the web |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
209 server (roundup-server) through another HTTP server (eg. apache or IIS) |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
210 then that server may require HTTP Basic Authentication, and it will pass |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
211 the ``REMOTE_USER`` variable through to Roundup. If this variable is not |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
212 present, then Roundup defaults to using its own cookie-based login |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
213 mechanism. |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
214 2. In email messages handled by roundup-mailgw, users are identified by the |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
215 From address in the message. |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
216 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
217 In both cases, Roundup's behaviour when dealing with unknown users is |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
218 controlled by Permissions defined in the "SECURITY SETTINGS" section of the |
|
2983
9614a101b68f
Stuff from the train ride this morning:
Richard Jones <richard@users.sourceforge.net>
parents:
2921
diff
changeset
|
219 tracker's ``schema.py`` module: |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
220 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
221 Web Registration |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
222 If granted to the Anonymous Role, then anonymous users will be able to |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
223 register through the web. |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
224 Email Registration |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
225 If granted to the Anonymous Role, then email messages from unknown users |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
226 will result in those users being registered with the tracker. |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
227 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
228 More information about how to customise your tracker's security settings |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
229 may be found in the `customisation documentation`_. |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
230 |
|
2572
d15b71b8a85a
more logging goodness
Richard Jones <richard@users.sourceforge.net>
parents:
2479
diff
changeset
|
231 |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
232 Tasks |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
233 ===== |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
234 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
235 Maintenance of Roundup can involve one of the following: |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
236 |
|
3780
158e31bbf86a
recent patch had lines longer than 80 chars - rewrap; trim trailing spaces
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3779
diff
changeset
|
237 1. `tracker backup`_ |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
238 2. `software upgrade`_ |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
239 3. `migrating backends`_ |
|
2005
fc52d57c6c3e
documentation cleanup
Richard Jones <richard@users.sourceforge.net>
parents:
2003
diff
changeset
|
240 4. `moving a tracker`_ |
| 3250 | 241 5. `migrating from other software`_ |
|
3341
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
242 6. `adding a user from the command-line`_ |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
243 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
244 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
245 Tracker Backup |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
246 -------------- |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
247 |
|
3959
f764931f2c67
more words about backing up
Richard Jones <richard@users.sourceforge.net>
parents:
3883
diff
changeset
|
248 The roundup-admin import and export commands are **not** recommended for |
|
f764931f2c67
more words about backing up
Richard Jones <richard@users.sourceforge.net>
parents:
3883
diff
changeset
|
249 performing backup. |
|
f764931f2c67
more words about backing up
Richard Jones <richard@users.sourceforge.net>
parents:
3883
diff
changeset
|
250 |
|
f764931f2c67
more words about backing up
Richard Jones <richard@users.sourceforge.net>
parents:
3883
diff
changeset
|
251 Optionally stop the web and email frontends and to copy the contents of the |
|
f764931f2c67
more words about backing up
Richard Jones <richard@users.sourceforge.net>
parents:
3883
diff
changeset
|
252 tracker home directory to some other place using standard backup tools. |
|
f764931f2c67
more words about backing up
Richard Jones <richard@users.sourceforge.net>
parents:
3883
diff
changeset
|
253 This means using |
|
f764931f2c67
more words about backing up
Richard Jones <richard@users.sourceforge.net>
parents:
3883
diff
changeset
|
254 *pg_dump* to take a snapshot of your Postgres backend database, for example. |
|
f764931f2c67
more words about backing up
Richard Jones <richard@users.sourceforge.net>
parents:
3883
diff
changeset
|
255 A simple copy of the tracker home (and files storage area if you've configured |
|
f764931f2c67
more words about backing up
Richard Jones <richard@users.sourceforge.net>
parents:
3883
diff
changeset
|
256 it to be elsewhere) will then complete the backup. |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
257 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
258 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
259 Software Upgrade |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
260 ---------------- |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
261 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
262 Always make a backup of your tracker before upgrading software. Steps you may |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
263 take: |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
264 |
|
2478
3ab2b91cdd2c
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2474
diff
changeset
|
265 1. Ensure that the unit tests run on your system:: |
| 2474 | 266 |
| 267 python run_tests.py | |
| 268 | |
|
2387
4962f99aaa27
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2203
diff
changeset
|
269 2. If you're using an RDBMS backend, make a backup of its contents now. |
|
2478
3ab2b91cdd2c
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2474
diff
changeset
|
270 3. Make a backup of the tracker home itself. |
|
3ab2b91cdd2c
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2474
diff
changeset
|
271 4. Stop the tracker web and email frontends. |
|
4014
b80224c1f4e3
fix poor docs
Richard Jones <richard@users.sourceforge.net>
parents:
3963
diff
changeset
|
272 5. Install the new version of the software:: |
|
b80224c1f4e3
fix poor docs
Richard Jones <richard@users.sourceforge.net>
parents:
3963
diff
changeset
|
273 |
|
b80224c1f4e3
fix poor docs
Richard Jones <richard@users.sourceforge.net>
parents:
3963
diff
changeset
|
274 python setup.py install |
|
b80224c1f4e3
fix poor docs
Richard Jones <richard@users.sourceforge.net>
parents:
3963
diff
changeset
|
275 |
|
b80224c1f4e3
fix poor docs
Richard Jones <richard@users.sourceforge.net>
parents:
3963
diff
changeset
|
276 6. Follow the steps in the `upgrading documentation`_ for the new version of |
|
2387
4962f99aaa27
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2203
diff
changeset
|
277 the software in the copied. |
|
3963
3230f9c88086
Fix race condition for key properties in rdbms backends [SF#1876683]
Richard Jones <richard@users.sourceforge.net>
parents:
3959
diff
changeset
|
278 |
|
3230f9c88086
Fix race condition for key properties in rdbms backends [SF#1876683]
Richard Jones <richard@users.sourceforge.net>
parents:
3959
diff
changeset
|
279 Usually you will be asked to run `roundup_admin migrate` on your tracker |
|
3230f9c88086
Fix race condition for key properties in rdbms backends [SF#1876683]
Richard Jones <richard@users.sourceforge.net>
parents:
3959
diff
changeset
|
280 before you allow users to start accessing the tracker. |
|
3230f9c88086
Fix race condition for key properties in rdbms backends [SF#1876683]
Richard Jones <richard@users.sourceforge.net>
parents:
3959
diff
changeset
|
281 |
|
3230f9c88086
Fix race condition for key properties in rdbms backends [SF#1876683]
Richard Jones <richard@users.sourceforge.net>
parents:
3959
diff
changeset
|
282 It's safe to run this even if it's not required, so just get into the |
|
3230f9c88086
Fix race condition for key properties in rdbms backends [SF#1876683]
Richard Jones <richard@users.sourceforge.net>
parents:
3959
diff
changeset
|
283 habit. |
|
4014
b80224c1f4e3
fix poor docs
Richard Jones <richard@users.sourceforge.net>
parents:
3963
diff
changeset
|
284 7. Restart your tracker web and email frontends. |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
285 |
| 2474 | 286 If something bad happens, you may reinstate your backup of the tracker and |
| 287 reinstall the older version of the sofware using the same install command:: | |
| 288 | |
| 289 python setup.py install | |
| 290 | |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
291 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
292 Migrating Backends |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
293 ------------------ |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
294 |
|
3781
e03014a96a95
doc improvement
Richard Jones <richard@users.sourceforge.net>
parents:
3780
diff
changeset
|
295 1. Stop the existing tracker web and email frontends (preventing changes). |
|
e03014a96a95
doc improvement
Richard Jones <richard@users.sourceforge.net>
parents:
3780
diff
changeset
|
296 2. Use the roundup-admin tool "export" command to export the contents of |
|
e03014a96a95
doc improvement
Richard Jones <richard@users.sourceforge.net>
parents:
3780
diff
changeset
|
297 your tracker to disk. |
|
e03014a96a95
doc improvement
Richard Jones <richard@users.sourceforge.net>
parents:
3780
diff
changeset
|
298 3. Copy the tracker home to a new directory. |
|
e03014a96a95
doc improvement
Richard Jones <richard@users.sourceforge.net>
parents:
3780
diff
changeset
|
299 4. Delete the "db" directory from the new directory. |
|
e03014a96a95
doc improvement
Richard Jones <richard@users.sourceforge.net>
parents:
3780
diff
changeset
|
300 5. Enter the new backend name in the tracker home ``db/backend_name`` file. |
|
e03014a96a95
doc improvement
Richard Jones <richard@users.sourceforge.net>
parents:
3780
diff
changeset
|
301 6. Use the roundup-admin "import" command to import the previous export with |
|
e03014a96a95
doc improvement
Richard Jones <richard@users.sourceforge.net>
parents:
3780
diff
changeset
|
302 the new tracker home. If non-interactively:: |
|
e03014a96a95
doc improvement
Richard Jones <richard@users.sourceforge.net>
parents:
3780
diff
changeset
|
303 |
|
e03014a96a95
doc improvement
Richard Jones <richard@users.sourceforge.net>
parents:
3780
diff
changeset
|
304 roundup-admin -i <tracker home> import <tracker export dir> |
|
e03014a96a95
doc improvement
Richard Jones <richard@users.sourceforge.net>
parents:
3780
diff
changeset
|
305 |
|
4567
32b24abfe98e
Documentation polishing.
Eric S. Raymond <esr@thyrsus.com>
parents:
4489
diff
changeset
|
306 If interactively, enter 'commit' before exiting. |
|
3781
e03014a96a95
doc improvement
Richard Jones <richard@users.sourceforge.net>
parents:
3780
diff
changeset
|
307 7. Test each of the admin tool, web interface and mail gateway using the new |
|
e03014a96a95
doc improvement
Richard Jones <richard@users.sourceforge.net>
parents:
3780
diff
changeset
|
308 backend. |
|
e03014a96a95
doc improvement
Richard Jones <richard@users.sourceforge.net>
parents:
3780
diff
changeset
|
309 8. Move the old tracker home out of the way (rename to "tracker.old") and |
|
e03014a96a95
doc improvement
Richard Jones <richard@users.sourceforge.net>
parents:
3780
diff
changeset
|
310 move the new tracker home into its place. |
|
e03014a96a95
doc improvement
Richard Jones <richard@users.sourceforge.net>
parents:
3780
diff
changeset
|
311 9. Restart web and email frontends. |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
312 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
313 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
314 Moving a Tracker |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
315 ---------------- |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
316 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
317 If you're moving the tracker to a similar machine, you should: |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
318 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
319 1. install Roundup on the new machine and test that it works there, |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
320 2. stop the existing tracker web and email frontends (preventing changes), |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
321 3. copy the tracker home directory over to the new machine, and |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
322 4. start the tracker web and email frontends on the new machine. |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
323 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
324 Most of the backends are actually portable across platforms (ie. from Unix to |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
325 Windows to Mac). If this isn't the case (ie. the tracker doesn't work when |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
326 moved using the above steps) then you'll need to: |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
327 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
328 1. install Roundup on the new machine and test that it works there, |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
329 2. stop the existing tracker web and email frontends (preventing changes), |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
330 3. use the roundup-admin tool "export" command to export the contents of |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
331 the existing tracker, |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
332 4. copy the export to the new machine, |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
333 5. use the roundup-admin "import" command to import the tracker on the new |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
334 machine, and |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
335 6. start the tracker web and email frontends on the new machine. |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
336 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
337 |
| 3250 | 338 Migrating From Other Software |
| 339 ----------------------------- | |
| 340 | |
| 341 You have a couple of choices. You can either use a CSV import into Roundup, | |
| 342 or you can write a simple Python script which uses the Roundup API | |
| 343 directly. The latter is almost always simpler -- see the "scripts" | |
| 344 directory in the Roundup source for some example uses of the API. | |
| 345 | |
|
3780
158e31bbf86a
recent patch had lines longer than 80 chars - rewrap; trim trailing spaces
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3779
diff
changeset
|
346 "roundup-admin import" will import data into your tracker from a |
| 3250 | 347 directory containing files with the following format: |
| 348 | |
| 349 - one colon-separated-values file per Class with columns for each property, | |
| 350 named <classname>.csv | |
| 351 - one colon-separated-values file per Class with journal information, | |
| 352 named <classname>-journals.csv (this is required, even if it's empty) | |
|
3780
158e31bbf86a
recent patch had lines longer than 80 chars - rewrap; trim trailing spaces
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3779
diff
changeset
|
353 - if the Class is a FileClass, you may have the "content" property |
| 3250 | 354 stored in separate files from the csv files. This goes in a directory |
| 355 structure:: | |
| 356 | |
| 357 <classname>-files/<N>/<designator> | |
| 358 | |
| 359 where ``<designator>`` is the item's ``<classname><id>`` combination. | |
| 360 The ``<N>`` value is ``int(<id> / 1000)``. | |
| 361 | |
| 362 | |
|
3341
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
363 Adding A User From The Command-Line |
|
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
364 ----------------------------------- |
|
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
365 |
|
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
366 The ``roundup-admin`` program can create any data you wish to in the |
|
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
367 database. To create a new user, use:: |
|
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
368 |
|
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
369 roundup-admin create user |
|
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
370 |
|
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
371 To figure out what good values might be for some of the fields (eg. Roles) |
|
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
372 you can just display another user:: |
|
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
373 |
|
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
374 roundup-admin list user |
|
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
375 |
|
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
376 (or if you know their username, and it happens to be "richard"):: |
|
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
377 |
|
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
378 roundup-admin find username=richard |
|
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
379 |
|
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
380 then using the user id you get from one of the above commands, you may |
|
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
381 display the user's details:: |
|
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
382 |
|
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
383 roundup-admin display <userid> |
|
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
384 |
|
df693c0aaba9
more admin guide goodness
Richard Jones <richard@users.sourceforge.net>
parents:
3282
diff
changeset
|
385 |
|
2177
a276e2531321
info about running roundup-server... more needed :)
Richard Jones <richard@users.sourceforge.net>
parents:
2068
diff
changeset
|
386 Running the Servers |
|
a276e2531321
info about running roundup-server... more needed :)
Richard Jones <richard@users.sourceforge.net>
parents:
2068
diff
changeset
|
387 =================== |
|
a276e2531321
info about running roundup-server... more needed :)
Richard Jones <richard@users.sourceforge.net>
parents:
2068
diff
changeset
|
388 |
|
a276e2531321
info about running roundup-server... more needed :)
Richard Jones <richard@users.sourceforge.net>
parents:
2068
diff
changeset
|
389 Unix |
|
a276e2531321
info about running roundup-server... more needed :)
Richard Jones <richard@users.sourceforge.net>
parents:
2068
diff
changeset
|
390 ---- |
|
a276e2531321
info about running roundup-server... more needed :)
Richard Jones <richard@users.sourceforge.net>
parents:
2068
diff
changeset
|
391 |
|
a276e2531321
info about running roundup-server... more needed :)
Richard Jones <richard@users.sourceforge.net>
parents:
2068
diff
changeset
|
392 On Unix systems, use the scripts/server-ctl script to control the |
|
a276e2531321
info about running roundup-server... more needed :)
Richard Jones <richard@users.sourceforge.net>
parents:
2068
diff
changeset
|
393 roundup-server server. Copy it somewhere and edit the variables at the top |
|
a276e2531321
info about running roundup-server... more needed :)
Richard Jones <richard@users.sourceforge.net>
parents:
2068
diff
changeset
|
394 to reflect your specific installation. |
|
a276e2531321
info about running roundup-server... more needed :)
Richard Jones <richard@users.sourceforge.net>
parents:
2068
diff
changeset
|
395 |
|
a276e2531321
info about running roundup-server... more needed :)
Richard Jones <richard@users.sourceforge.net>
parents:
2068
diff
changeset
|
396 |
|
a276e2531321
info about running roundup-server... more needed :)
Richard Jones <richard@users.sourceforge.net>
parents:
2068
diff
changeset
|
397 Windows |
|
a276e2531321
info about running roundup-server... more needed :)
Richard Jones <richard@users.sourceforge.net>
parents:
2068
diff
changeset
|
398 ------- |
|
a276e2531321
info about running roundup-server... more needed :)
Richard Jones <richard@users.sourceforge.net>
parents:
2068
diff
changeset
|
399 |
|
3780
158e31bbf86a
recent patch had lines longer than 80 chars - rewrap; trim trailing spaces
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3779
diff
changeset
|
400 On Windows, the roundup-server program runs as a Windows Service, and |
|
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:
5102
diff
changeset
|
401 therefore may be controlled through the Services control panel. Note |
|
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:
5102
diff
changeset
|
402 that you **must** install the pywin32 package to allow roundup to |
|
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:
5102
diff
changeset
|
403 run as a service. The roundup-server program may also control the |
|
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:
5102
diff
changeset
|
404 service directly: |
|
2177
a276e2531321
info about running roundup-server... more needed :)
Richard Jones <richard@users.sourceforge.net>
parents:
2068
diff
changeset
|
405 |
|
2405
1736886eefb3
more windows info
Richard Jones <richard@users.sourceforge.net>
parents:
2387
diff
changeset
|
406 **install the service** |
|
3779
ee73abcc95d2
Sorry, another mega-patch:
Richard Jones <richard@users.sourceforge.net>
parents:
3465
diff
changeset
|
407 ``roundup-server -C /path/to/my/roundup-server.ini -c install`` |
|
2405
1736886eefb3
more windows info
Richard Jones <richard@users.sourceforge.net>
parents:
2387
diff
changeset
|
408 **start the service** |
|
1736886eefb3
more windows info
Richard Jones <richard@users.sourceforge.net>
parents:
2387
diff
changeset
|
409 ``roundup-server -c start`` |
|
1736886eefb3
more windows info
Richard Jones <richard@users.sourceforge.net>
parents:
2387
diff
changeset
|
410 **stop the service** |
|
1736886eefb3
more windows info
Richard Jones <richard@users.sourceforge.net>
parents:
2387
diff
changeset
|
411 ``roundup-server -c stop`` |
|
2177
a276e2531321
info about running roundup-server... more needed :)
Richard Jones <richard@users.sourceforge.net>
parents:
2068
diff
changeset
|
412 |
|
2405
1736886eefb3
more windows info
Richard Jones <richard@users.sourceforge.net>
parents:
2387
diff
changeset
|
413 To bring up the services panel: |
|
2177
a276e2531321
info about running roundup-server... more needed :)
Richard Jones <richard@users.sourceforge.net>
parents:
2068
diff
changeset
|
414 |
|
2405
1736886eefb3
more windows info
Richard Jones <richard@users.sourceforge.net>
parents:
2387
diff
changeset
|
415 Windows 2000 and later |
|
1736886eefb3
more windows info
Richard Jones <richard@users.sourceforge.net>
parents:
2387
diff
changeset
|
416 Start/Control Panel/Administrative Tools/Services |
|
1736886eefb3
more windows info
Richard Jones <richard@users.sourceforge.net>
parents:
2387
diff
changeset
|
417 Windows NT4 |
|
1736886eefb3
more windows info
Richard Jones <richard@users.sourceforge.net>
parents:
2387
diff
changeset
|
418 Start/Control Panel/Services |
|
2177
a276e2531321
info about running roundup-server... more needed :)
Richard Jones <richard@users.sourceforge.net>
parents:
2068
diff
changeset
|
419 |
|
3780
158e31bbf86a
recent patch had lines longer than 80 chars - rewrap; trim trailing spaces
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3779
diff
changeset
|
420 You will need a server configuration file (as described in |
|
158e31bbf86a
recent patch had lines longer than 80 chars - rewrap; trim trailing spaces
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3779
diff
changeset
|
421 `Configuring roundup-server`_) for specifying tracker homes |
|
158e31bbf86a
recent patch had lines longer than 80 chars - rewrap; trim trailing spaces
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3779
diff
changeset
|
422 and other roundup-server configuration. Specify the name of |
|
158e31bbf86a
recent patch had lines longer than 80 chars - rewrap; trim trailing spaces
Alexander Smishlajev <a1s@users.sourceforge.net>
parents:
3779
diff
changeset
|
423 this file using the ``-C`` switch when installing the service. |
|
3779
ee73abcc95d2
Sorry, another mega-patch:
Richard Jones <richard@users.sourceforge.net>
parents:
3465
diff
changeset
|
424 |
|
2203
4a157c198585
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2177
diff
changeset
|
425 Running the Mail Gateway Script |
|
4a157c198585
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2177
diff
changeset
|
426 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
4a157c198585
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2177
diff
changeset
|
427 |
|
4a157c198585
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2177
diff
changeset
|
428 The mail gateway script should be scheduled to run regularly on your |
|
4a157c198585
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2177
diff
changeset
|
429 Windows server. Normally this will result in a window popping up. The |
|
4a157c198585
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2177
diff
changeset
|
430 solution to this is to: |
|
4a157c198585
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2177
diff
changeset
|
431 |
|
4a157c198585
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2177
diff
changeset
|
432 1. Create a new local account on the Roundup server |
|
4a157c198585
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2177
diff
changeset
|
433 2. Set the scheduled task to run in the context of this user instead |
|
4a157c198585
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2177
diff
changeset
|
434 of your normal login |
|
4a157c198585
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2177
diff
changeset
|
435 |
|
2177
a276e2531321
info about running roundup-server... more needed :)
Richard Jones <richard@users.sourceforge.net>
parents:
2068
diff
changeset
|
436 |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
437 .. _`customisation documentation`: customizing.html |
|
2387
4962f99aaa27
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2203
diff
changeset
|
438 .. _`upgrading documentation`: upgrading.html |
