@@ -2124,10 +2124,28 @@ addresses, databases to back up, etc.
2124
2124
Platform-Specific Notes
2125
2125
=======================
2126
2126
2127
+
2128
+ Windows
2129
+ -------
2130
+
2131
+ .. index:: windows; choose non-default session/otk database
2132
+
2133
+ Configure session database
2134
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~
2135
+
2136
+ By default the session and one time key (OTK) databases default to
2137
+ using anydbm as the session store. Because GNU dbm and Ndbm are
2138
+ available on Linux, this is a reasonable default. However Windows
2139
+ doesn't have compiled libraries for these databases. So it defaults to
2140
+ "dumb" dbm which is written in Python and is slow. So we recommend
2141
+ using `some other backend for your session database`_. SQLite or Redis
2142
+ can be used if you don't want to run a separate supported RDBMS
2143
+ database server.
2144
+
2127
2145
.. index:: windows; add Roundup to path
2128
2146
2129
2147
Windows command-line tools
2130
- --------------------------
2148
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~
2131
2149
2132
2150
To make the command-line tools accessible in Windows, you need to update
2133
2151
the "Path" environment variable in the Registry via a dialog box.
@@ -2151,7 +2169,7 @@ Panel" is directly accessible from "Start".
2151
2169
I do not believe this is possible to do in previous versions of Windows.
2152
2170
2153
2171
Use pip to install pyreadline3 for roundup-admin line editing
2154
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
2172
+
2155
2173
2156
2174
If you install pyreadline3_ using pip, roundup-admin will support
2157
2175
command line editing and history.
@@ -2163,7 +2181,7 @@ This will remove the dreaded::
2163
2181
warning when starting roundup-admin.
2164
2182
2165
2183
Windows Server
2166
- --------------
2184
+ ~~~~~~~~~~~~~~
2167
2185
2168
2186
To have the Roundup web server start up when your machine boots up, there
2169
2187
are two different methods, the scheduler and installing the service.
@@ -2173,7 +2191,7 @@ are two different methods, the scheduler and installing the service.
2173
2191
.. _Using the Windows scheduler:
2174
2192
2175
2193
1. Using the Windows scheduler
2176
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
2194
+ ''''''''''''''''''''''''''''''
2177
2195
2178
2196
Set up the following in Scheduled Tasks (note, the following is for a
2179
2197
cygwin setup):
@@ -2205,7 +2223,7 @@ Schedule
2205
2223
.. index:: windows; setup Roundup a service
2206
2224
2207
2225
2. Installing the roundup server as a Windows service
2208
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
2226
+ '''''''''''''''''''''''''''''''''''''''''''''''''''''
2209
2227
2210
2228
This is more Windows oriented and will make the Roundup server run as
2211
2229
soon as the PC starts up without any need for a login or such. It will
@@ -2246,8 +2264,13 @@ If you are using Apache as the webserver you might want to use it with
2246
2264
mod_python instead to serve out Roundup. In that case see the mod_python
2247
2265
instructions above for details.
2248
2266
2267
+ Linux
2268
+ -----
2269
+
2270
+ Make sure you read the instructions under `UNIX environment steps`_.
2271
+
2249
2272
Sendmail smrsh
2250
- --------------
2273
+ ~~~~~~~~~~~~~~
2251
2274
2252
2275
If you use Sendmail's ``smrsh`` mechanism, you will need to tell
2253
2276
smrsh that roundup-mailgw is a valid/trusted mail handler
@@ -2262,11 +2285,6 @@ This is usually done via the following 2 steps:
2262
2285
2. change your alias to ``"|roundup-mailgw <tracker_home>"``
2263
2286
2264
2287
2265
- Linux
2266
- -----
2267
-
2268
- Make sure you read the instructions under `UNIX environment steps`_.
2269
-
2270
2288
2271
2289
Solaris
2272
2290
-------
@@ -2321,6 +2339,8 @@ the test.
2321
2339
.. _`preventing spam`: customizing.html#preventing-spam
2322
2340
.. _`Adding a new field to the classic schema`:
2323
2341
customizing.html#adding-a-new-field-to-the-classic-schema
2342
+ .. _`some other backend for your session database`:
2343
+ admin_guide.html#configuring-session-databases
2324
2344
.. _`Tracking different types of issues`:
2325
2345
customizing.html#tracking-different-types-of-issues
2326
2346
.. _`customising roundup`: customizing.html
0 commit comments