DebianJessieInstallGuide

From Request Tracker Wiki
Revision as of 05:19, 10 August 2016 by Sadume (talk | contribs)
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

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 request-tracker4 with apt to install the core features

install mysql-server then install rt4-db-mysql and run through configuring the database

install rt4-apache2

run a2enmode mod-rewrite

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-available/default

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