~~NOTOC~~



====== Howto Install and use the Roundup issue tracker ======

The [[http://roundup.sourceforge.net/|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.


===== Assumptions =====


  * 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.



===== Installing Roundup using package managers =====

==== Debian/Ubuntu ====

  apt-get install roundup

==== FreeBSD ====

  pkg_add -vrf roundup


===== Create a new tracker for a project =====

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

==== Prepare tracker files ====

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


==== Edit configuration file /usr/local/www/trackers/project/config.ini ====

The following fields must be set :

<code>

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

</code>

==== Initialize the new project tracker ====


  /usr/local/bin/roundup-admin initialise


===== Prepare the web interface =====
 
==== Copy the roundup.cgi script the the cgi-bin directory ====

   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 //

==== Edit /usr/local/etc/apache/httpd.conf ====

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

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

==== Edit /usr/local/www/cgi-bin/roundup.cgi ====

Add an entry in //TRACKER_HOMES// section

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

==== Make sure permissions are correctly set ====
 
   chown -R www:www /usr/local/www/trackers

==== Access the tracker list ====

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


//Also see : [[configuring_and_using_roundup_e-mail_interface|Configuring and using the Roundup e-mail interface]]//

{{tag>unix howto project-management}}

~~DISCUSSION~~