FedoraInstallGuide1-1

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 'FedoraInstallGuide1-1' is tagged as OUTDATED

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.

If you have checked or updated this page and found the content to be suitable, please remove this notice by editing the page and remove the Outdated template tag.

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
 
     # 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
 
     <Location />
         SetHandler perl-script
         PerlHandler RT::Mason
     </Location>
 </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 127.0.0.1 like this:

127.0.0.1 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:

127.0.0.1 localhost.localdomain localhost