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.

Fedora Install Guide

This is based on the mailing list, and was provided by Raymond Norton.

1) On a new Fedora install, at the "Package Group Selection" stage, inside the "Web Server" package Group, verify that mod_perl is selected (selected by default).

2) Go into the "SQL Database Server" group and select the "mysql-server" package (not selected by default)

3) Once server install is done go into services and select httpd and mysqld to start on boot up. or at the command line as root:

# chkconfig httpd on # chkconfig mysqld on

4) Start the mysql daemon:

# service mysqld start

5) At a shell set the mysql root password via

mysqladmin -uroot password "new password" (without quotes)

6) Download RT3 and untar it.

7) Follow the RT docs and run ./configure with the flags you want, something like the following should do (be sure to change the db-rt-pass):

# ./configure --with-web-user=apache --with-web-group=apache --prefix=/usr/share/rt3 --with-db-rt-pass=password

Then run CPAN once in order to configure it:

# perl -MCPAN -e'shell'

When done with CPAN configuration (at the cpan> prompt) type exit. Then run:

# perl sbin/rt-test-dependencies --with-mysql --with-modperl2 --install

This will install everything except WWW::Mechanize and Log::Dispatch. Run :

# perl sbin/rt-test-dependencies --with-mysql --with-modperl2

and make sure that all dependencies are satisfied.

8) Once done you can cd into root.cpan and install WWW::Mechanize and Log::Dispatch. (or maybe just do it through CPAN)

# perl -MCPAN -e'install WWW::Mechanize' # perl -MCPAN -e'install Log::Dispatch'

9) Verify that the RT Makefile web user and group are set to "apache", also verify the rt_user password

10) At a shell add the rt group via "groupadd rt"

11) Install RT3 and initialize the database:

# make install # make initialize-database

12) cd to RT3 etc directory and copy over pertinent site info from RT_Config.pm to RT_SiteConfig.pm

# cd /full-path-to-rt3-directory/etc # cp RT_Config.pm RT_SiteConfig.pm

13) Edit RT_SiteConfig.pm and change the relevant parameters.

14) Add the following virtualhost info into /etc/httpd/conf.d/rt3.conf:

<VirtualHost your.ip.address> ServerName your.rt.server.hostname DocumentRoot /full-path-to-rt3-directoy/share/html AddDefaultCharset UTF-8 <code><pre> # these four lines apply to Apache2+mod_perl2 only: {{{ PerlSetVar MasonArgsMethod CGI PerlModule Apache2 Apache::compat RewriteEngine On RewriteRule ^(.*)/$ $1/index.html # }}} PerlModule Apache::DBI PerlRequire /full-path-to-rt3-directoy/bin/webmux.pl &lt;Location /&gt; SetHandler perl-script PerlHandler RT::Mason &lt;/Location&gt; </pre></code> </VirtualHost>

15) Start Apache

# service httpd start

16) This will satisfy all dependencies and configure apache 2.0.47 to give you a working RT3 box. Continue configuring RT mail gateway as per RT's README file.

Note: some distros add, at instalation time, the hostname you specified to /etc/hosts as like this: yourhostname.domain.com yourhostname localhost.localdomain localhost

this could affect a lot on your system, at least rt-mailgate will be affected. Be sure that it is just: localhost.localdomain localhost