From Request Tracker Wiki
Jump to navigation Jump to search

Unofficial Installation Guide

This is an unofficial installation guide. It may be outdated or apply only to very specific configurations and versions. The official and maintained installation steps for RT are in the README and UPGRADING documents included in the official .tar.gz packages.


This page contains out of date and possibly misleading information or instructions such as installation methods or configuration examples that no longer apply. Please consider this warning when reading the page below.

RHEL / CentOS / EPEL installation


Install Red Hat Enterprise Linux 5 or CentOS 5 .

Install the EPEL repository : http://fedoraproject.org/wiki/EPEL/FAQ#howtouse

If you don't know what the EPEL project is, please read http://fedoraproject.org/wiki/EPEL and the FAQ at http://fedoraproject.org/wiki/EPEL/FAQ .

The benefits of drawbacks of using the EPEL packages

Using the EPEL repository is a lot faster than compiling all the required packages for RT missing in RHEL. Plus, as the EPEL project supports the packages, upgrade issues are minimized. However, the main drawback is that the current EPEL package is lagging behind the RT version currently available from BestPractical.

Request Tracker 3 installation

Once EPEL is installed, run :

yum install rt3 rt3-mailgate

This will install the rt3 and rt3-mailgate packages described at :

http://download.fedora.redhat.com/pub/epel/5/x86_64/repoview/rt3.html and http://download.fedora.redhat.com/pub/epel/5/x86_64/repoview/rt3-mailgate.html

You can now read the included installation notes and howto in the file at : /usr/share/doc/rt3-$version/README.fedora

Your /etc/rt3/RT_SiteConfig.pm should probably include the following configuration variables :

$rtname, $Organization, $Timezone, $WebBaseURL, $WebPath, $DatabaseType, $DatabaseUser, $DatabasePassword, $DatabaseName, $OwnerEmail, $MaxAttachmentSize, $DropLongAttachments, $UseFriendlyToLine, $NotifyActor, $WebDefaultStylesheet, $DefaultSummaryRows, $OldestTransactionsFirst, $CorrespondAddress, $CommentAddress, $SendmailArguments .

Optional step : Postfix instead of Sendmail

To configure Postfix instead of SendMail, run :

yum install postfix

chkconfig postfix on

chkconfig sendmail off

service sendmail stop

service postfix start

You can now configure Postfix in /etc/postfix/main.cf and then add RT queue aliases in /etc/aliases. For instance, for a support@yoursite queue, add :

support: |"/usr/sbin/rt-mailgate --queue support --action correspond --url http://localhost/rt3/"

Note, for Postfix to be able to launch rt-mailgate, you either have to disable SELinux or use setsebool on the Postfix binary.