Package: roundup
Severity: normal
I am attempting to install roundup for the first time on an Ubuntu
Lucid system (N.B. I am reporting direct to the Debian BTS because as
far as I can see nothing has been changed about how roundup installs
on Ubuntu, so this bug is entirely relevant to Debian too, and I try
not to duplicate work for maintainers, by reporting it directly to
Debian.)
Fairly quickly, I have come across some apparent inconsistencies.
First, /etc/default/roundup says:
# USERUNIT: {1|0} integer value
# Setting this to 1 while having runit installed will create
# a link named /var/service/roundup to /etc/roundup/service
# that will then be used instead of the usual init mechanism.
# If you don't have runit installed, this variable has no
# effect. If you set it to 0, then runit is ignored.
This implies that if runit is not installed, then roundup will work.
Note in particular that USERUNIT defaults to 0.
However, README.Debian says:
To install the roundup server properly, install the `runit` package and
edit the file `/etc/roundup/service/run`.
and later:
An alternative way to daemonize the roundup-server is given using
start-stop-daemon(8). See the example script located at
`/usr/share/doc/roundup/examples/roundup.rc-debian`.
which suggests that runit is the default way to run roundup. It would
be nice to have a consistent indication of what is the expected
default, though of course it is a good thing to have an explanation of
an alternative method too.
Secondly, README.Debian says:
NOTE from your package maintainer: Installing as a CGI is not supported
by the Debian package.
but then later it also says:
II. Web gateway as CGI script
i.e. it seems to give instructions for how to install roundup as a
CGI. If it is not supported, then these instructions should be
removed. Note, this is the README.Debian file, not the general README
file, so there’s no need to document here things that the Debian
package does not support.
Thirdly, README.Debian says:
IMPORTANT: Don't forget to chown the database directory (usually
'db' in the tracker's home) to the roundup user, as roundup will
otherwise not be able to write to the database, and hence bail out:
# chown -R roundup /var/lib/roundup/trackers/your-tracker-home
(Side question: why does the text talk about the “db” subdirectory,
but the example command chown’s the entire tracker directory?)
But then later we have:
Since the server won't run as root, you must use a different user, eg.
www-data (the Debian standard web server's user id):
# chown -R www-data:www-data /var/lib/roundup/trackers/mytracker
i.e. a different user. Why not recommend running as roundup in both
cases? Then it would only be necessary to have the chown command once,
and there would be no confusion.
Finally, section 3 of README.Debian says:
3. Long running roundup-server instances
========================================
Note that long running Python processes may deplete your system memory
since the current [1]C Python implementation never free()s allocated
memory.
[1] http://evanjones.ca/python-memory.html
but going to the link [1] and reading the page there says:
[Note: This problem is fixed in Python 2.5]
i.e. this problem has been fixed for a long time. Hence, this section
could usefully be deleted. (That does not include the last two lines
of README.Debian, which do not seem to belong to section 3.)
-- System Information:
Debian Release: squeeze/sid
APT prefers maverick-updates
APT policy: (500, 'maverick-updates'), (500, 'maverick-security'), (500,
'maverick-backports'), (500, 'maverick')
Architecture: i386 (i686)
Kernel: Linux 2.6.35-23-generic (SMP w/2 CPU cores)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Versions of packages roundup depends on:
ii adduser 3.112ubuntu1 add and remove users and groups
ii python 2.6.6-2ubuntu1 interactive high-level object-orie
ii python-support 1.0.9ubuntu1 automated rebuilding support for P
roundup recommends no packages.
Versions of packages roundup suggests:
pn libapache2-mod-python <none> (no description available)
ii python-gdbm 2.6.6-0ubuntu1 GNU dbm database support for Pytho
pn python-mysqldb <none> (no description available)
ii python-openssl 0.10-1 Python wrapper around the OpenSSL
pn python-psycopg2 <none> (no description available)
pn python-pyme <none> (no description available)
ii python-tz 2010b-1 Python version of the Olson timezo
ii python-xapian 1.0.20-1 Xapian search engine interface for
pn runit <none> (no description available)
--
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]
