View source for SuSE10InstallGuide

{{OutdatedInstallGuide}}

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

 <nowiki>LoadModule perl_module /usr/lib/apache2/mod_perl.so
 
 &lt;VirtualHost 192.168.1.5&gt;
 
 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
 
 &lt;Directory "/opt/rt3/share/html"&gt;
 
 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
 
 &lt;/Directory&gt;
 
 &lt;/VirtualHost&gt;
 </nowiki>

----

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:

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

----

----

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

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

MAILGATE dependencies

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

MASON dependencies

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

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

Author: msallee AT ucar DOT edu