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
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.
Howto Install Request-Tracker 3.6 (mysql) on Ubuntu Hardy Server 8.04
This Howto will explain how to install request-tracker on a clean Ubuntu Dapper Server install. It is tested on Ubuntu Hardy 8.04 and might work with slight modifications on other versions or Debian based distros.
It also installs the additional services required for Request-Tracker, such as
- Apache2 - Web Server
- Postfix - Email Server (for sending emails)
- Mysqld - Database to Store the RT information.
Install the Request Tracker Packages
Open a Root Login Shell
as member of the admin group to get a root-login shell.
Update your apt package list
Update your apt package list
Install the Packages
apt-get install rt3.6-apache2 (this will also take care of some prerequisites)
apt-get install request-tracker3.6 rt3.6-clients apache2-doc postfix mysql-server lynx libdbd-pg-perl
- In the "Postfix Configuration" - I choose "Internet Site", just because I prefer to have the system send emails without being dependent on a different mail server. The logic behind that is because if the email server goes down, the ticket server should NOT follow.
- You should see this message after the install is done... Postfix is now set up with a default configuration. If you need to make changes, edit /etc/postfix/main.cf (and others) as needed. To view Postfix configuration values, see postconf(1). After modifying main.cf, be sure to run '/etc/init.d/postfix reload'.
- Backup the RT config file. I like to do this for every conf file I modify cp -vpr /etc/request-tracker3.6/RT_SiteConfig.pm /etc/request-tracker3.6/RT_SiteConfig.pm.orig vim /etc/request-tracker3.6/RT_SiteConfig.pm
- Customize using the directions in the file.
Create the Database
I used the ConfigureMysqlOnGentoo guide as reference and had issues with the script my workaround was to create the database, create the user, drop the database and recreate the database and it worked fine.
- Use script to create database (don’t worry about user error message we will fix this later) /usr/sbin/rt-setup-database-3.6 --action init --dba root --prompt-for-dba-password
- As root, login to MySQL mysql -p
- Create user
CREATE USER rtuser IDENTIFIED BY 'p4ssw0rd';
- Grant access rights to rtuser GRANT ALL PRIVILEGES ON rtdb.* TO 'rtuser'@'localhost' IDENTIFIED BY 'p4ssw0rd'; FLUSH PRIVILEGES; QUIT
- Drop the database mysqladmin drop rtdb -p
- Recreate the database using the script (it should work this time) /usr/sbin/rt-setup-database-3.6 --action init --dba root --prompt-for-dba-password
Add the Virtual Host Config
cp -vpr /etc/apache2/sites-available/default /etc/apache2/sites-available/default.orig
Add the following line to the VirtualHost section of Apache from which you wish to serve RT
If you didn't move the RT web tree also add:
Alias /rt /usr/share/request-tracker3.6/html
Enable Apache2 RewriteEngine
ln -s ../mods-available/rewrite.load
- You can also add the module the 'apache2' way by typing
Below i am still working on
Make sure that you update the 'make', 'tar', 'unzip', and 'gzip' libraries in your distribution prior to installing ''Apache::Session'':
aptitude install make tar gzip unzip
Check that Apache::Session is installed. If necessary, install (as root) with
cpan install Apache::Session
(hit no for manual configuration and yes for prepending modules, you will be asked about prepending a few times)
You can now login to:
using user root and password "password" (without quotation marks of course). Change this passwd ASAP via the Configuration menu. You can know tweak and use RT
Install RTFM FAQ Manager for Request Tracker 3.6
aptitude install rt3.6-rtfm