Skip to main content

By clicking Submit, you agree to the developerWorks terms of use.

The first time you sign into developerWorks, a profile is created for you. Select information in your developerWorks profile is displayed to the public, but you may edit the information at any time. Your first name, last name (unless you choose to hide them), and display name will accompany the content that you post.

All information submitted is secure.

  • Close [x]

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerworks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

By clicking Submit, you agree to the developerWorks terms of use.

All information submitted is secure.

  • Close [x]

Zen and the art of installing Request Tracker 2.0.X

Jesse Tilly (jtilly@yahoo.com), Independent writer
Jesse Tilly is continually moving forward with his goal of retiring as a high school teacher (English or Math). The first step, as everyone knows, is to become a successfully published author (hmmm, or is that the requirement for a college professor? Oh well, too late now). This tutorial marks his third publication, his first two centering around the Java build tool, Ant. Jesse co-wrote (with Eric Burke) the O'Reilly book Ant: The Definitive Guide, has written for O'Reilly's OnJava online magazine, and made presentations about Configuration Management and JUnit at O'Reilly's 2002 Open Source convention. It was at that convention where he was introduced to Jesse Vincent and became interested in using and writing about RT. When he's not writing he's being a parent, husband, and teaching himself Japanese so he can play imported Japanese games on his Nintendo Gamecube.

Summary:  This tutorial is designed to be a thorough introduction and installation guide for the great issue tracking tool, Request Tracker (RT). RT fulfills a key need in a project's Configuration Management (CM) process. By the end of the tutorial, you will have a working installation of RT and ready to implement a CM process for your project. The primary focus is installing RT on the average GNU/Linux system.

Date:  05 Nov 2002
Level:  Advanced PDF:  A4 and Letter (754 KB | 42 pages)Get Adobe® Reader®

Activity:  4676 views
Comments:  

Introduction

Expectations

What this tutorial is about

This tutorial is designed to be a thorough introduction and installation guide for the great issue tracking tool, Request Tracker (RT). RT fulfills a key need in a project's Configuration Management (CM) process. By the end of the tutorial, you should have a working installation of RT and be ready to implement a CM process for your project. The primary focus of this tutorial is installing RT on the average GNU/Linux system. The tutorial also points out some of the many stumbling blocks involved with the various installation steps. The key word is many as there are quite a few installation steps. Of course, even with this effort to cover potential problems, it cannot possibly cover everything.

What this tutorial is not about

RT's dependence on several and equally complex libraries and tools makes the installation tricky. To guarantee successful completion of this tutorial, you are strongly advised to have some prior experience using and configuring GNU/Linux in general and Perl and Apache in particular. Some sendmail administration experience helps, but it is not as important. At the very least, it helps to have access to a person with such experience. See Resources to further your knowledge of RT, related tools, and configuration management.


Disclaimer about system requirements

Since I cannot safely establish what the average base system is for most users, I will tell you what I used to perform all of the tutorial's steps. I performed installations of RT on fresh installs of Red Hat 7.3, Red Hat 8.0, and Debian 3.0-stable (a total of two times on each system, except for Red Hat 7.3, where I did it three times).

Installation of RT on Red Hat 7.3 (I could generalize to 7.x) and Debian 3.0-stable work just fine with some additional package installations.

However, I should note that Red Hat 8.0 has problems, enough to not recommend it. Red Hat 8.0's default Apache installation version is 2.0. Additionally, 8.0's version of Apache has an embedded version of mod_perl that is incompatible with RT. As of this writing, a basic RT installation does not work with Apache 2.0 (although, some messages on the rt-user mailing list seem to indicate some people have successfully completed an installation). That is not to say RT cannot be installed on a Red Hat 8 machine. A viable workaround is to uninstall Apache 2.0 and install Apache 1.3 in its place. This tutorial, assumes that Red Hat 8.0 is not an acceptable system base for installation.

So what do I call the install base for this tutorial? I consider Red Hat 7.3 to be the working distribution in which these tutorial steps succeed 95% of the time. As for the tools and libraries, I will get into specific versions shortly. This tutorial uses generic package and file installation methods as much as possible, short of recompiling entire applications; it will not be too Red Hat specific.


Tutorial goals

This tutorial will:

  • Introduce you to Configuration Management, in general, and Request Tracker, in particular.
  • Explain to you the system requirements for installing RT.
  • Help you prepare RT's installation scripts for your system.
  • Help you install RT's Perl dependencies.
  • Help you install RT.
  • Help you configure your system for RT's e-mail and Web interfaces.
  • Introduce you to RT's command-line, e-mail and Web interfaces.
  • Using the command-line interface, add an RT ticket.
  • Using the e-mail interface, add an RT ticket.
  • Using the Web interface, add an RT queue.
  • Using the Web interface, add an RT group.
  • Using the Web interface, add an RT user.
  • Using the Web interface, configure a queue's rights.
  • Using the Web interface, create your first ticket.
  • Using the Web interface, get your first ticket search report on a queue.
  • Introduce to you some Japanese Kanji :-)

The tutorial assumes you have some GNU/Linux experience, including modifying Unix files, starting and stopping Unix daemons (this tutorial will assume SysVInit-based scripts), and some basic Unix administration skills. If you think your skillset is a bit limited for finishing this tutorial, consider visiting some of the GNU/Linux-related information in Resources, getting a friend to help, or both. The GNU/Linux resources are all great references for doing good GNU/Linux work.


Introduction to Request Tracker

You are going to focus on the first step to achieving project management utopia: installing RT, the issue tracking system. RT is an open source implementation of an issue tracker written primarily in Perl by Jesse Vincent.

So what, specifically, can RT do? Quite a lot actually. It has interfaces for command-line, e-mail, IRC and the Web. Typically, you will use the Web and command-line interfaces. RT audits all of its operations in a database, making it portable and expandable should your project management tasks grow beyond the capacity of the initial installation machine. Being an issue tracking system at the core, RT is a flexible tool capable of performing tasks unrelated to project management. You can use RT as a public task list, an administrative task manager and journal, or a help desk tool (many companies use RT just for help desk issues).

Installing RT is quite a lengthy task, so you might want to take a break before you move on to the installation section.

Incidentally, one of the great things about the RT project is that it attempts to promote the very concepts of CM that it intends to make better. RT 2.1 uses a revision tracking system called Aegis that, when it is eventually combined with RT, will take care of the software revision and feature tracking that should be coupled with issues. Check Resources for a link to RT's Aegis source project page.

1 of 6 | Next

Comments



Help: Update or add to My dW interests

What's this?

This little timesaver lets you update your My developerWorks profile with just one click! The general subject of this content (AIX and UNIX, Information Management, Lotus, Rational, Tivoli, WebSphere, Java, Linux, Open source, SOA and Web services, Web development, or XML) will be added to the interests section of your profile, if it's not there already. You only need to be logged in to My developerWorks.

And what's the point of adding your interests to your profile? That's how you find other users with the same interests as yours, and see what they're reading and contributing to the community. Your interests also help us recommend relevant developerWorks content to you.

View your My developerWorks profile

Return from help

Help: Remove from My dW interests

What's this?

Removing this interest does not alter your profile, but rather removes this piece of content from a list of all content for which you've indicated interest. In a future enhancement to My developerWorks, you'll be able to see a record of that content.

View your My developerWorks profile

Return from help

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=Web development
ArticleID=486785
TutorialTitle=Zen and the art of installing Request Tracker 2.0.X
publish-date=11052002
author1-email=jtilly@yahoo.com
author1-email-cc=

Tags

Help
Use the search field to find all types of content in My developerWorks with that tag.

Use the slider bar to see more or fewer tags.

Popular tags shows the top tags for this particular content zone (for example, Java technology, Linux, WebSphere).

My tags shows your tags for this particular content zone (for example, Java technology, Linux, WebSphere).

Use the search field to find all types of content in My developerWorks with that tag. Popular tags shows the top tags for this particular content zone (for example, Java technology, Linux, WebSphere). My tags shows your tags for this particular content zone (for example, Java technology, Linux, WebSphere).

Try IBM PureSystems. No charge.