contents

• javafreedom

home

contributors

• projects

bugtracker

(C) MMI javafreedom.org

1. Overview
2. Project Roadmap
3. Licensing
4. Requirements
5. Download Releases
6. CVS
7. Mail Lists
8. Documentation
9. Reporting Bugs
10. Screen shots

1. Overview: What is the Bugtracker?

The bugtracker is a web based tool to track the bugs in software development, as well as for reporting issues and new features for existing sites/software.

The bugtracker started life quickly thrown together out of Manik Surtani's sheer need for such a tool! :-) He was quite unhappy with GNATS, Bugzilla, Jitterbug, Scarab and all the other bugtrackers out there, and the Bugtracker was born!  Initially it was a quick, hard coded, database dependent, under-featured, tool for his initial use.  After he decided to open source it, other people started using it and the codebase grew in maturity and evolved in design.  Currently, this is based on a servlet and template framework (a far more flexible architecture than the initial JSP implementation), and contains a much richer set of features than early versions.

If anyone else wishes to help develop this further, please feel free to contact Manik Surtani. The help will be much appreciated. 

2. Project Roadmap

... is available here.

3. Licensing

The bugtracker is distributed with an Apache-style open-source license.  View the license here. 

4. Requirements: What does it run on?

The bugtracker was orignally written to run on Jakarta Tomcat 3.1, and runs very well on my current installation (RedHat 7.0, Apache 1.3.14, Tomcat 3.2.1, Sun JDK 1.3, MySQL 3.23.36).

Currently the bugtracker is in a state of flux and a major redesign is underway to utilise J2EE and Enterprise Javabeans to distribute the components of the core of the bugtracker.  This will allow multiple interfaces (not just a web based one) and lots of scalability and redundancy.  Using J2EE's transactions and the JDO model, we hope to provide transparent object persistence as well - making this more database-independent.

In a nutshell, you need MySQL >= 3.21.xx, a web server such as Apache or Microsoft's IIS, a servlet engine such as Jakarta Tomcat, and java2 compliant JDK such as SUN's J2SE.  Future releases would also require a J2EE compliant Enterprise Javabeans container such as jBoss.

5. Download releases

NOTE: Version 0.1 (the JSP based version) is deprecated and shouldn't be used.  The current version is 0.2beta3.

Source and binary packages can be downloaded here, courtesy of SourceForge.

6. CVS

The CVS repository is on SourceForge, and can be accessed here.

I would encourage people to help with the development effort - please contact me at manik@post1.com or on ICQ# 853533.

7.  Mail Lists

There are 3 mailing lists for this project.

bugtracker-users is for users of the bugtracker software, and can be used to discuss issues such as enhancements, features, issues, installation help, etc.

bugtracker-devs is for contributors involved in developing the bugtracker code.

bugtracker-announce is an announcement list which the bugtracker team would use to announce new releases, features, etc.  It is recommended that everyone sign up for this list.  This is a low-load list with less than 4 postings every month.

8. Documentation

... is pathetic at the moment.  A short INSTALL document is available.  Best bet is to look through the mailing list archives.  Volunteers to do some real documentation?  :-)

9. Reporting Bugs

Bugs on the bugtracker should be reported at http://bugs.javafreedom.espadanet.com (as you can see, we take our own medicine - we're using the bugtracker here!)  You will need to register with the bugtracker to submit bugs, feature requests and issues. 

10. Screen Shots

Here are a few sample screen shots.