Howto Install and use the Roundup issue tracker

The Roundup Issue Tracker is a simple to use and install issue-tracking system with command-line, web and e-mail interfaces.

Roundup has been deployed for bug tracking and TODO list management, customer help desk support, issue management for IETF working groups , sales lead tracking, conference paper submission and double-blind referee management, weblogging, etc..

This article explains howto perform a fresh installation of Roundup and a step by step procedure for creating a tracker for a project.

• The root of the web server is /usr/local/www
• The roundup installation prefix is /usr/local/ (In Debian/Ubuntu, the default installation prefix is /usr/)

Adapt the procedure below according to your own system configuration.

apt-get install roundup

pkg_add -vrf roundup

This procedure should be performed for each project that you want to track using Roundup.

mkdir -p /usr/local/www/trackers/project
/usr/local/bin/roundup-admin install

The following fields must be set :

admin_email = contact@example.com
web = http://example.com/cgi-bin/roundup/adker-mit/
domain = example.com
local_hostname = localhost

/usr/local/bin/roundup-admin initialise

 cp /usr/local/share/roundup/cgi-bin/roundup.cgi /usr/local/www/cgi-bin/roundup.cgi

Note: The installation may place the original roundup.cgi in different location depending on your system settings

Make sure the cgi-bin directory is properly setup (assuming Apache).

<Directory "/usr/local/www/cgi-bin">
  Options +ExecCGI
 </Directory>

Add an entry in TRACKER_HOMES section

TRACKER_HOMES = {
     'adker-mit': '/usr/local/www/trackers/project'
 }

 chown -R www:www /usr/local/www/trackers

firefox http://example.com/cgi-bin/roundup

Also see : Configuring and using the Roundup e-mail interface

Labels: unix, howto, project-management