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.

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.


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/" <ul> <li>^TO(helpdesk|help) | $HELPDESK_CORR</li> <li>^TO(helpdesk-comment|help-comment) | $HELPDESK_COMM <h1>end procmailrc</h1>



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