Admin: 3 revisions imported

2016-04-06T20:09:04Z

3 revisions imported

New page

{{Template:OutdatedInstallGuide}}

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

<nowiki># chkconfig httpd on
# chkconfig mysqld on
</nowiki>

4) Start the mysql daemon:

<nowiki># service mysqld start
</nowiki>

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

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

Then run CPAN once in order to configure it:

<nowiki># perl -MCPAN -e'shell'
</nowiki>

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

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

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

<nowiki># perl sbin/rt-test-dependencies --with-mysql --with-modperl2
</nowiki>

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)

<nowiki># perl -MCPAN -e'install WWW::Mechanize'
# perl -MCPAN -e'install Log::Dispatch'
</nowiki>

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:

<nowiki># make install
# make initialize-database
</nowiki>

12) cd to RT3 etc directory and copy over pertinent site info from [[RT Config|RT_Config]].pm to [[RT SiteConfig|RT_SiteConfig]].pm

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

13) Edit [[RT SiteConfig|RT_SiteConfig]].pm and change the relevant parameters.

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

<nowiki><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>
</nowiki>

15) Start Apache

<nowiki># service httpd start
</nowiki>

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

FedoraInstallGuide1-1 - Revision history

Admin: 3 revisions imported