Implementing Open Source Defect Tracking as a Corporate Tool – An Update

Note: This article was started around March or April of this year – and I just got the motivation to finish it – because I thought it was important. I hope I did the original idea justice all these months later.

Back in October of 2007 I had written about starting to implement the Eventum Defect Tracking System in place of the defect tracking system that we had been using for about 8-9 years. I thought I’d throw up an update on how we’re doing, and what advantages we are seeing from taking the Open Source route over the proprietary route.

Let me start off by saying that the more we use Eventum, the more impressed I am with the thought that went into the development of the application. There were only a few minor tweaks that we had to do in order to get it working in a way that we could be much more productive. These tweaks were things like enabling basic LDAP authentication on the application and most recently enabling email integration and source control integration, which are actually already implemented in the system. Some little tweaks for our environment to alleviate the change required were necessary, but as you will see, these tweaks were small.

Basic Install and Feedback Process

I had the basic install of Eventum up in about thirty minutes. I then sent the link to the application out to small pieces of the team in order to receive targeted feedback. Most of the feedback revolved around things that were missing that people were used to in the current application – but these things were largely why I wanted to remove it in the first place. They caused a lot of extra work. I made some tweaks to add custom fields, and sent it out to another small group. Once everyone had a chance to play with it a bit, I assembled the team to talk about what we needed to do to cut over. Much of the conversation was around how the new process would work and some were around tweaks that I had made that people didn’t feel we needed (which came directly from feedback from the team). Some of the tweaks were undone and we decided to move ahead with cutover on the next build cycle.

A conscious decision was made to just get the system up and people to start using it without all of the bells and whistles like email integration, which I would add incrementally as I had the time to do so. The next section will talk about some of the things we did in order to expedite the enabling of email integration.

Some of the initial feedback that we received on the tool was that the “screen was too cluttered” or people didn’t understand the states. Much of this, I knew, was simply because the tool was unfamiliar. People do not like change. I spent a lot of time reassuring people and asking them to “hang in there” as we familiarized ourselves with the tool and the new processes that would evolve through its use. To their credit, they did.

Enabling Email Integration

One of the reasons I chose Eventum from the many defect tracking systems I looked at was the capability to integrate email conversations at the ticket level. In April of 2007, I wrote an article called Metrics as a Side Effect in which I talked about how I would love to see metrics be able to be updated without having to make a concerted effort to switch contexts in order to do so. I viewed conversations around a particular ticket the same way – and wanted a system that would record all email conversations with the ticket so that we had something to refer to as things went live, were closed, or were killed. The thought behind this is that if you are required to go into the system in order to document a conversation, chances are you won’t. The conversation needs to be recorded as a side-effect of normal work activities.

One of the killer features Eventum offered was this capability. Unfortunately, the documented ways to enable it were a little unclear and required changes to the mail server in order to enable it. Eventum uses custom email addresses like or to do email association. Common solutions require setting up blanket aliases (issue-*) or using ‘+’ addresses in your mail server to be able to intercept these issues. Also, POP3 or IMAP mailboxes are required. Neither of these were options for us, as we do not control the email servers. We had to find a work around – since we only had one email address for our “build system” and I didn’t want to have the myriad of conversations that I knew I would have to have to create these blanket aliases on the corporate server.

As it turns out, tweaking Eventum only took commenting out a few lines in the notification class and a small procmail recipe to allow the integration without touching the existing mail server configuration.

The code changes look like this, starting at line 159 in class.notification.php and consisted of commenting out 5 lines:

  // RCB:  Don't use custom from addresses
  //      if (@$setup[$routing]['status'] != 'enabled') {
            // let's use the custom outgoing sender address
            $project_info = Project::getOutgoingSenderAddress($project_id);
            if (empty($project_info['email'])) {
                /// no project email, use main email address
                $from_email = $setup['smtp']['from'];
            } else {
                $from_email = $project_info['email'];
   //     } else {
   //         $from_email = $setup[$routing]['address_prefix'] . $issue_id . 
   //                               "@" . $setup[$routing]['address_host'];
   //     }
        if (empty($info['sender_name'])) {
            // no sender name, check if this email address belongs to a user and if so use that
            $usr_id = User::getUserIDByEmail($info['email']);
            if (!empty($usr_id)) {
                $info['sender_name'] = User::getFullName($usr_id);
            } else {
                // no name exists, use email address for name as well
                $info['sender_name'] = $info['email'];

These changes force the application to, instead of setting the outgoing sender address to, to send it using the default project email address.

The next problem to face was intercepting these emails and processing them as Eventum would when pulling them from a POP3 or IMAP inbox. Luckily, our system uses procmail quite extensively to process emails for software deployments, and other update notifications for things like branches that are created, etc. We just had to add two procmail receipes and a perl script that looks like the following:

* ^Subject:.*[#[0-9]+] Note: .*$
	| $HOME/ | /usr/local/bin/php /path/to/eventum/misc/route_notes.php

* ^Subject:.*[#[0-9]+].*$
	| $HOME/ | /usr/local/bin/php /path/to/eventum/misc/route_emails.php

These recipes look at the subject and check to see if there is an issue number in it – as well as whether it has the word ‘Note:’ in it. If they do, they pipe the message to the following perl script, which acts as an email filter, translating the from address from our blanket address to the issue specific address and in turn piping it to the Eventum script to process the email:

# This script is called by procmail when Eventum recipes are fired.  It pulls the 
# issue id from the subject line and manufactures an issue or note email address, basically
# faking Eventum into thinking that it is routing an issue specific email, without having to 
# change the mail server.
# This is basically a filter.   It reads from stdin and writes to stdout, so that procmail
# can process the message and send it to the appropriate routing script.
# The procmail rules look like this:
# :0
# * ^Subject:.*[#[0-9]+] Note: .*$
#   | $HOME/ | /usr/local/bin/php /path/to/eventum/misc/route_notes.php
# :0
# * ^Subject:.*[#[0-9]+].*$
#   | $HOME/ | /usr/local/bin/php //path/to/eventum/misc/route_emails.php
@contents = ;

# grab the full email into one big buffer ...
$mailContents = join('', @contents);

# grab the issue number and note designation (if present)
if ($mailContents =~ m/Subject:.*[#(d+)] (Note:)*.*$/mi) {
    # strip the issue number of leading and trailing spaces
    $issueNumber = $1;
    $issueNumber =~ s/^s+//sig;
    $issueNumber =~ s/s+$//sig;
    # if the note designation was in the subject, create an email address of 
    #   If not, its an email, so use
    if ($2 eq "Note:") {
        $newEmail = "note_" . $issueNumber . "";
    } else {
        $newEmail = "issue_" . $issueNumber . "";
# Find the To: header and replace the umbrella email address with the issue specific
# one and write the email back out to stdout line by line.   This will then be fed
# by procmail to the appropriate routing script (see module comments above)
foreach (@contents) {
    if (m/^To:/sig) {
    print $_;

The Eventum settings are set just like you are using address based routing, and these scripts do the rest to fake it.

Now, once again, modifying the code directly – probably not the best way to do it. But it was the fastest and allowed us to make changes independently, without having to make changes to the corporate mail server.

Now we did find another issue once email association was working. There were some emails that were coming in that had pieces of the issue id missing. So we had one more tweak to make, again in class.notification.php in the block starting at line 952:

if ($type == 'notes') {
$extra_subject = $data['note']['not_title'];
// don't add the "[#3333] Note: "
// prefix to messages that already have that in the subject line
if (strstr($extra_subject, "[#$issue_id] $subject: ")) {
// RCB: 12-13-2008: This code was lopping off the issue id, which breaks email
// association.
//$pos = strpos($extra_subject, "[#$issue_id] $subject: ");
//$full_subject = substr($extra_subject, 4);
// keep the full subject instead
$full_subject = $extra_subject;
} else {
$full_subject = "[#$issue_id] $subject: $extra_subject";
} elseif (($type == 'new_issue') && ($is_assigned)) {
$full_subject = "[#$issue_id] New Issue Assigned: " . $data['iss_summary'];
} else {
$extra_subject = $data['iss_summary'];
$full_subject = "[#$issue_id] $subject: $extra_subject";

I’m not entirely sure what this was doing and why the hardcoded ‘4’ is in line 959, but its definitely a bug, which I submitted to the Eventum project as a fix. I’m not sure if it was ever corrected.

The benefit that these changes give us, however, is that now when an internal note or email is sent from the Eventum tool and an email is sent out, the default behavior of people to respond to the email rather than go into the tool still results in an updated conversation about the item in question. No longer are decisions made without documentation – the documentation is created as a side effect.

Enabling Source Control Integration

The final piece to the puzzle was source control integration. We use Subversion for our source control system and ViewVC as a means to browse the source code (both using mod_ldap and mod_svn_authz to authenticate with the corporate LDAP store). Eventum includes a script that you can use in your Subversion post-commit hook to log each commit targeted to a particular issue (specified in the commit comments) that automatically logs commits to a particular issue. You can then set up patterns to build URL’s to your repository so that from each issue a user can view the particular commits through this URL. We set this up to link to our ViewVC application so that each commit will link to the diff of the commit. This allows us to streamline our code review process by being able to view each commit to an issue in context. This has proven to be a huge win – at least for me when I want to see what is going on for a particular issue.

Getting The Business Users Involved in the Process

The biggest benefit I believe we have received from switching to Eventum is that, while it looks complex at the beginning, once you start using it it is quite easy to learn. So much so, that for the first time that I can remember, we have our business users engaged in the defect tracking system to approve work that they feel are a priority. Some of this is still a manual process, but being able to distribute the entry and maintenance of items has been a big win for us, removing a bottleneck that we had of one person on the team designated as the “issue generator” for other teams. We now have our business users engaged in the process – everywhere from entering tickets themselves, to responding to issue emails and having the discussions automatically logged for historical purposes. This is something we had tried to do with our previous tool, but was unsuccessful due to the complexity of the tool and licensing costs involved in deploying the tool (or licenses) to people outside of our group – since ultimately these costs hit our (IT’s) budget. We can now add as many users to the system as we want and let them begin engaging in the actual work being done – rather than being passive participants.

Huge win.


We started with Eventum 2.0.1 and had multiple “projects” set up. The main project was the work queue for the group, with a few specialized projects that might have unique items, or may have to be re-entered into the main project for the development team to have visibility to (each group wanted to work from one specific queue – not check multiple projects for work to be done). The 2.1 release of Eventum included the functionality to be able to move items between projects – which for us was a big deal – as we were re-entering items when they were applicable to the main project and not specific to the sub-project they were entered into.

With this one feature alone, its given us the ability to set up multiple work queues, in which we can begin to segment “nice to haves” from musts – and move these “nice to haves” into the main work flow when they become things our users want to address. This will, in the future, also be a big win for us, as we can segment the demand and begin to have the development teams focus on the things that are important now, while enabling our business users to continue to queue work for us without creating additional noise in the main work queue.


For us, moving from proprietary software with licensing limitations to open source software has been a big win in changing the way we work. The absence of licensing costs has enabled us to engage our users in ways we couldn’t before, while the ability to integrate email and source control has enabled us to collect information as a side effect of our teams normal work process rather than adding additional record keeping work to their duties. The fact that we have the source code has enabled us to customize the software in small ways to our environment, avoiding cross functional work that could take longer to implement due to the additional hand offs between groups – and there is always the possibility that a change to the email server could be viewed as something that shouldn’t be done. Access to source code allowed us to work around that.

Overall, in my view, the implementation of Eventum for work tracking has had a huge positive effect on the way we work. Hopefully, this article summarizes the benefits that we’ve seen in a way that encourages people to give open source a shot in their corporate environments.

I would encourage members of my team to respond to this post as well to keep me honest. What I see may be very different than how it works “in real life” – but I think what I’ve documented here is pretty accurate.

More on Mind Mapping and MindManager

I’ve been playing around with MindJet MindManager over the last week or so and I have to say, overall I really like it. Mindmapping provides a great mechanism in getting your thoughts down on paper and establishing relationships between different concepts, especially for someone who suffers from “chronic editor” syndrome such as myself.

I’d love to post some examples of some of the things that I have been working on, but the only real “work neutral” mindmap I have available is the one I previously posted. Some really good examples can be found in the mindmaps that Cote produces. These are some really good examples of the complexity that can be represented using this technique.

I had first read about mindmapping quite a few years ago in the book Quantum Learning: Unleashing the Genius in You by Bobbi Deporter (with Mike Hernacki). Deporter and Hernacki describe the Mind Mapping technique as “a whole brain technique using visual images and other graphic devices to form impressions”. The key piece of this, for me, has been the connection and breakdown of different concepts into sub concepts. The graphical nature of a mind-map, coupled with the distilling of the key concepts and relationships and visual representation, have allowed me to retain much more information while taking notes over the past week than I have previously experienced.

I had attempted mind-mapping when reading Quantum Learning, but the extremely manual process (actual drawing) turned me off immediately. For me, it just seemed like too much work.

That’s where Mind Manager comes in. With a few natural keystrokes you can string all of these concepts together, attach images or URL’s to the key concepts for further reference material, and flag concepts as priorities or something to pay attention to. The additional benefit of a tool to do this stuff is the ability to dynamically refactor your mind maps without having to throw away your piece of paper and recopy everything. The refactoring of these concepts has been something that I have been doing quite a bit.

The folks at MindJet were nice enough to give me complimentary licenses for both the Macintosh and Windows environments. Since buying a Mac in June, I have decided to use it exclusively at home in order to learn as much about the environment as possible (and, of course, to justify the investment). So, I have had the opportunity to work on a few mind maps across the two environments. There is no ‘import’ or conversion necessary. I store the maps on my thumb drive, work on them at home, take them to work, and they just load and are ready for continued editing on the Windows platform.

There are some differences between the two versions of the product. The Windows version has quite a bit of Microsoft Office integration. You can export your mind maps to Visio, Word, Excel and even Microsoft Project, in addition to JPG and PNG image formats and PDF. Both versions allow you to add task information to map nodes, including flagging nodes as resources and flagging them as quarter, half, three quarters done, as well as completed. I have not experimented with taking these types of mind maps and exporting them to project, but I’m assuming these move along with them (I can mess with it later and validate this).

The Macintosh version has a more limited set of export formats. JPG and PNG are supported along with multiple flavors of RTF (Word, TextEdit) and PDF.

For me, the use of this tool over the past week has been a really positive experience – on the Macintosh. The Windows version has some pretty major performance issues that are being talked about in the support forums as well as being addressed specifically by the Vice President of Engineering on the companies blog.

The Windows machine that I am running MindManager on has 2G of memory and 80G of hard drive space. When docked, I run at a pretty high screen resolution (1280×1024 – maybe even higher). Docked, the software runs well enough to do the work I need to do as another connected concept hits me on some of the things I am working on.

The strange part is that as soon as I undock and run in ‘laptop’ mode at the standard 1024×768 resolution, performance drops to the point where the software isn’t even usable. I’m not sure why this is the case, but at a seminar the other day with the Windows laptop, I was unable to take notes using the software whatsoever, as the software began exhibiting the symptoms mentioned in the above links.

Overall, the technique of mind mapping is proving extremely helpful to me. As mentioned earlier, using the technique has increased the retention that I am experiencing while thinking through problems. The MindManager software is excellent – on a Mac. The Windows version needs some work to fix some of the performance challenges that I am experiencing.

The price tag for the software is not the cheapest in the world either. A single user license for MindManager 6.0 Pro weighs in at a whopping $349, with the Basic and Macintosh versions available at $229. The question then becomes is the price tag worth the value received from the software. While I’m receiving a ton of value from using the software, the price of a single user license would definitely stop me from even taking the time to try it in the first place. While the company does make trial software available (both a 5 day express trial with no registration required and a 21 day “premium trial” of which the premium is registering with the company), I rarely “do” trials on products in this price range for the fear of getting addicted to them and having to pay for them.

So the real question for me as I use the software further is whether I will buy it. Time will tell. I like to (and see it as an obligation) to support software I find useful with my wallet. The only real guarantee that useful software will continue to be available is if there is a community behind it, or, in the case of commercial software, people actually buy it. Once the “newness” of the software wears off, we’ll see if I continue to see value in the process and whether I keep using the software. At the point that I find it indispensable, I will definitely shell out the money to show my support for the product.

And when that happens, you’ll definitely be the first to know.

Related Links