DebianJessieInstallGuide

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.


These are my notes from deploying RT4 in Debian using packages, I will try to make this more indepth as time goes on. Please note that I am not an expert in this and feel free to add to this / modify as needed.

Useful Links

Requirements

Packages

Here is a summary of the packages for apt that are available for use.

request-tracker4

this installs the rt4 core

rt4-db-mysql

This will configure the RT4 database, best to run after installing 'request-tracker4', it does not install mysql-server so you will need to install that first.

rt4-apache2

Note: for Debian Jessie 8.5 the information below does not apply. All necessary libraries are installed with rt4-apache2. Also no modules had to be manually enabled using a2enmod

you may need to edit /etc/apt/sources so that you can get libapache2-mod-fcgi and libapache2-mod-perl2

deb http://ftp.es.debian.org/debian stable main contrib non-free
deb-src http://ftp.es.debian.org/debian stable main contrib non-free

deb http://ftp.debian.org/debian/ wheezy-updates main contrib non-free
deb-src http://ftp.debian.org/debian/ wheezy-updates main contrib non-free

deb http://security.debian.org/ wheezy/updates main contrib non-free
deb-src http://security.debian.org/ wheezy/updates main contrib non-free

this installs apache as well as sample config files in /etc/request-tracker4 (I think, they might just be there from the start) it also installs some other stuff :) see Debian Packages: rt4-apache2

You may need to manually install libapache2-mod-fcgi / libapache2-mod-perl2 try a2enmod mod-perl2 and see what output you get

rt4-fcgi

This installs fastcgi related packages for use with nginx, it is not required for apache

Different File Locations

The Debian packages install the files to locations different than it would be if installing from source, see below:

  • /usr/bin/rt-* (contains rt-mailgate etc.)
  • /usr/share/request-tracker4/ (contains html files etc)
  • /usr/share/request-tracker4/rt-server?/ (contains rt-server, rt-server.fcgi, rt-server.pl etc.)
  • /etc/request-tracker4/ (contains rtconfig.pm and sample config files for apache)

Installation

set the hostname for the server that the clients will use to browse to it

install mysql-server first, to set up an administrative password that will be asked during the rt4-db-mysql installation

apt-get install mysql-server

install request-tracker4 with apt to install the core features and any additional packages

apt-get install request-tracker4 rt4-db-mysql rt4-apache2

this should deal with installation of all necessary apache2 packages follow the configuration for the database setup and rt root password

check the apache sample config files located in /etc/request-tracker4/

you can just add the following in the end of the virtualhost block in /etc/apache2/sites-enabled/000-default.conf

Include /etc/request-tracker4/apache2-modperl2.conf

RedirectMatch ^/$ /rt

restart apache and try to browse to http://hostname/rt and you can sign in with root && password

this will give you a very very basic setup, please only use this guide for reference as it is incomplete