SuSE10InstallGuide

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 'SuSE10InstallGuide' 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.



Install Guide for SLES 10, RT 3.6.3 and Apache 2

Use Yast to install these:

apache2, apache2-mod_auth-mysql, apache2-mod_perl, apache2-mod_python, apache2-prefork_MPM, perl-Apache-DBI, mysql-max,
gd-devel, gcc,  ncftp, fastcgi (if you will be using fastcgi), openssl

Install lynx from rpm:

wget ftp://rpmfind.net/linux/SuSE-Linux/i386/update/10.0/rpm/i586/lynx-2.8.5-35.3.i586.rpm

Install Apache2 from source: latest version at http://httpd.apache.org/download.cgi

Apache configure options: provides for option to use https with RT.

./configure --prefix=/usr/local/apache2 --enable-so --enable-rewrite \
--with-included-apr --enable-ssl --with-ssl=/usr/bin/openssl/

Create an RT group and user:

sudo /usr/sbin/groupadd rt
sudo /usr/sbin/useradd -g rt rt_user

Download RT from http://download.bestpractical.com/pub/rt/release/ Untar and begin configuration:

./configure --prefix=/opt/rt3 --with-web-user=rt-user --with-web-group=rt --with-db-database=rt3 --with-db-rt-pass=changethis \
--with-db-type=mysql --with-rt-group=rt --with-apachectl=/usr/local/apache2/bin/apachectl

Check which perl modules are needed: make testdeps First, configure CPAN in perl.

sudo perl -MCPAN -eshell

Answer the questions, selecting "follow" option for policy on building prereqs.

install Bundle::CPAN
reload CPAN

One option that may work for initial CPAN config:

sudo perl -e "use CPAN::FirstTime; CPAN::FirstTime::init();"

Try running script to auto-install modules:

sudo make fixdeps

If it doesn't work, scroll down to the bottom of this document for the list of the Perl modules you will need, grouped in some semblance of order and sequence to eliminate dependency errors.

After 'make testdeps' shows that everything installed successfully, return to your RT install folder and do a 'sudo make install'.


Configure /opt/rt3/etc/RT_SiteConfig.pm:

Set($rtname, 'RT-yourdept');
Set($Organization , "your.dns.name.here");
Set($WebBaseURL, "http://server.your.dns.name/rt");
Set($WebPath, "/rt");
Set($WebURL = "http://server.your.dns.name/rt/");
Set($WebImagesURL = "http://server.your.dns.name/rt/NoAuth/images/");
Set($LogoURL, $WebImagesURL . "bplogo.gif");
Set($Timezone, 'US/Eastern');
Set($CorrespondAddress, 'rt_user@server.your.dns.name');
Set($CommentAddress, 'rt_user-comment@server.your.dns.name');
Set($SendmailPath, "/usr/sbin/sendmail");
Set($MailCommand , 'sendmailpipe');
Set($SendmailArguments, "-oi -t");
Set($SenderMustExistInExternalDatabase , 0);
Set($EmailOutputEncoding , 'utf-8');
Set($LogtoSyslog, ' ');
Set($LogToFile, 'info');
Set($LogDir, '/opt/rt3/var/log');
Set($OwnerEmail, "postmaster@server.your.dns.name");
Set($MyTicketsLength, 20);
Set($MaxAttachmentSize , 10000000);
Set($MaxInlineBody, 13456);
$DatabasePassword = 'yourpassword';

1;

Mysql and Apache

Start mysql:           sudo /etc/init.d/mysql start
In the RT build dir:   sudo make initialize-database
Set mysql to start at boot: sudo chkconfig mysql on
Set the root sql password: sudo /usr/bin/mysqladmin -u root password XXXXXX

Configure the Apache server /usr/local/apache2/conf/httpd.conf:

LoadModule perl_module /usr/lib/apache2/mod_perl.so
 
 <VirtualHost 192.168.1.5>
 
 ServerName server.your.dns.name
 Alias /rt "/opt/rt3/share/html"
 AddDefaultCharset UTF-8
 SetHandler perl-script
 PerlHandler RT::Mason
 PerlModule Apache::DBI
 PerlRequire /opt/rt3/bin/webmux.pl
 
 <Directory "/opt/rt3/share/html">
 
 Options ExecCGI FollowSymLinks
 AllowOverride None
 Options deny,allow
 # set your allowed IP ranges here, on separate lines
 Allow from 192.168.1.0/24
 Deny from all
 
 </Directory>
 
 </VirtualHost>
 

Confirm that the logs folder exists: /opt/rt3/var/log and do a sudo chown -R rt_user:rt /opt/rt3 Check that your firewall port is open for http - via Yast, Network Services.

Start httpd:

sudo /usr/local/apache2/bin/apachectl start  or /etc/init.d/apache2 start

You should now be able to log in to http://hostname/rt . The root password is 'password', which you must change immediately in RT's preferences for the root user.


Create postfix mail aliases

In /etc/aliases:
 helpdesk:         rt_user
 helpdesk-comment: rt_user

Update postfix: sudo newaliases; sudo postfix reload

Create a procmail forwarding for the rt_user:

vi /home/rt_user/.forward:  Add this line:
 "|/usr/bin/procmail"
 
 vi /home/rt_user/.procmailrc
 # All RT mail queues pass through here. This file must be owned by the rt_user.
 
 SHELL=/bin/tcsh
 PATH=/usr/local/bin:/bin:/usr/bin
 MAILDIR=/home/rt_user/Mail
 VERBOSE=yes
 LOGFILE=/opt/rt3/var/log/procmail.log
 LOGABSTRACT=all
 
 # Define the mailgate settings to be called later in the file
 
 HELPDESK_CORR="/opt/rt3/bin/rt-mailgate --queue helpdesk --action correspond \
  --url http://servername.your.dns.name/rt/"
 
 HELPDESK_COMM="/opt/rt3/bin/rt-mailgate --queue helpdesk --action comment \
 --url http://servername.your.dns.name/rt/"
 
 * ^TO(helpdesk|help)
 | $HELPDESK_CORR
 
 * ^TO(helpdesk-comment|help-comment)
 | $HELPDESK_COMM
 
 # end procmailrc
 


Perl modules

Grouped in some semblance of order and sequence to eliminate dependency errors. (even better, wrap this in another perl script)

 perl -MCPAN -e'install IO::Socket::INET'
 perl -MCPAN -e'install IO::Socket::SSL'
 perl -MCPAN -e'install Module::Build'
 perl -MCPAN -e'install Params::Validate'
 perl -MCPAN -e'install DBI'
 perl -MCPAN -e'install Apache::DBI'
 perl -MCPAN -e'install Test::Inline'
 perl -MCPAN -e'install Class::ReturnValue'
 perl -MCPAN -e'install DBIx::SearchBuilder'
 perl -MCPAN -e'install Text::Template'
 perl -MCPAN -e'install HTML::Entities'
 perl -MCPAN -e'install HTML::Scrubber'
 perl -MCPAN -e'install Log::Dispatch'
 perl -MCPAN -e'install Locale::Maketext::Lexicon'
 perl -MCPAN -e'install Locale::Maketext::Fuzzy'
 perl -MCPAN -e'install MIME::Entity'
 perl -MCPAN -e'install Mail::Mailer'
 perl -MCPAN -e'install Text::Wrapper'
 perl -MCPAN -e'install Time::ParseDate'
 perl -MCPAN -e'install Text::Autoformat'
 perl -MCPAN -e'install Text::Quoted'
 perl -MCPAN -e'install Tree::Simple'
 perl -MCPAN -e'install Module::Versions::Report'
 perl -MCPAN -e'install XML::Parser'
 perl -MCPAN -e'install FCGI'

DEV dependencies:

perl -MCPAN -e'install Regexp::Common'
 perl -MCPAN -e'install Test::Inline'
 perl -MCPAN -e'install Test::Memory::Cycle'
 perl -MCPAN -e'install Test::Pod'
 perl -MCPAN -e'install Test::Pod::Coverage'
 perl -MCPAN -e'install Test::Taint'
 perl -MCPAN -e'install Test::Warn'
 perl -MCPAN -e'install Apache::Test'
 
 # enter /usr/local/apache2/bin/httpd for httpd location
 # enter /usr/local/apache2/bin/apxs for apxs location
 
 perl -MCPAN -e'install HTML::Form'
 
 # answer 'y' to libwww app installation
 
 perl -MCPAN -e'install HTML::TokeParser'
 perl --MCPAN --e'install WWW::Mechanize'
 perl -MCPAN -e'install Bundle::Apache2'   (found this on perl_mod's site recommendation)
 
 

MAILGATE dependencies

perl -MCPAN -e'install HTML::TreeBuilder'
perl -MCPAN -e'install HTML::FormatText'

MASON dependencies

perl -MCPAN -e'install Params::Validate'
 perl -MCPAN -e'install Cache::Cache'
 perl -MCPAN -e'install Exception::Class'
 perl -MCPAN -e'install HTML::Mason'  (this one gave a bit of trouble)
 
 # To install HTML::Mason manually: wget http://search.cpan.org/CPAN/authors/id/D/DR/DROLSKY/HTML-Mason-1.36.tar.gz
 (see prereqs in README file)
                        perl Build.PL
                        ./Build
                        ./Build install
 perl --MCPAN --e'install HTTP::Server::Simple::Mason'
 
 perl -MCPAN -e'install MLDBM'
 perl -MCPAN -e'install FreezeThaw'
 perl -MCPAN -e'install Apache::Session'
 perl -MCPAN -e'install XML::RSS'
 
 
 

If you made it this far, congratulations - and I hope this helped you. --Mark S.

Author: msallee AT ucar DOT edu