Skip to content

Commit 11fd1d1

Browse files
committed
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.
1 parent 9173136 commit 11fd1d1

File tree

3 files changed

+24
-3
lines changed

3 files changed

+24
-3
lines changed

CHANGES.txt

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -269,6 +269,12 @@ Fixed:
269269
starting roundup-server on different ports/ip addresses. Also
270270
updated man page to include default use of localhost for -n and use
271271
of -n 0.0.0.0 to bind to all addresses on the host. (John Rouillard)
272+
- issue2550827, issue2550718. Doc additions so people know that a
273+
python 32 bit installation may be required for windows. Additional
274+
documentation on the requirement of pywin32 for running roundup as a
275+
windows service. Also the windows installer must be run as
276+
administrator and strong encouragement for installing the pytz
277+
module added to ``doc/installation.txt``.
272278

273279
2016-01-11: 1.5.1
274280

doc/admin_guide.txt

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -398,8 +398,10 @@ Windows
398398
-------
399399

400400
On Windows, the roundup-server program runs as a Windows Service, and
401-
therefore may be controlled through the Services control panel. The
402-
roundup-server program may also control the service directly:
401+
therefore may be controlled through the Services control panel. Note
402+
that you **must** install the pywin32 package to allow roundup to
403+
run as a service. The roundup-server program may also control the
404+
service directly:
403405

404406
**install the service**
405407
``roundup-server -C /path/to/my/roundup-server.ini -c install``

doc/installation.txt

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,14 @@ Some variants of Linux will need an additional "python dev" package
4040
installed for Roundup installation to work. Debian and derivatives, are
4141
known to require this.
4242

43+
If you are using the Roundup Windows installer on a 64 bit system and
44+
you get the error message::
45+
46+
"No Python installation found in the registry"
47+
48+
you need to install a 32 bit version of python. The 64 bit versions
49+
use a different registry key that the installer doesn't detect. See:
50+
http://issues.roundup-tracker.org/issue2550718 for details.
4351

4452
Optional Components
4553
===================
@@ -50,7 +58,8 @@ Timezone Definitions
5058
Full timezone support requires pytz_ module (version 2005i or later)
5159
which brings the `Olson tz database`_ into Python. If pytz_ is not
5260
installed, timezones may be specified as numeric hour offsets only.
53-
61+
This is optional but strongly suggested.
62+
5463
An RDBMS
5564
Sqlite, MySQL and Postgresql are all supported by Roundup and will be
5665
used if available. One of these is recommended if you are anticipating a
@@ -105,6 +114,7 @@ jinja2
105114

106115
Windows Service
107116
You can run Roundup as a Windows service if pywin32_ is installed.
117+
Otherwise it must be started manually.
108118

109119
.. _Xapian: http://xapian.org/
110120
.. _Whoosh: https://bitbucket.org/mchaput/whoosh/wiki/Home
@@ -165,6 +175,9 @@ installation:
165175
For information about how Roundup installs, see the `administration
166176
guide`_.
167177

178+
The following assumes that you are using the source distribution. If
179+
you are using the Windows installer, run it with Administrator
180+
privileges so it can correctly update the registry.
168181

169182
Basic Installation Steps
170183
------------------------

0 commit comments

Comments
 (0)