Admin: 3 revisions imported

2016-04-06T20:37:48Z

3 revisions imported

New page

{{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

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

SuSE10InstallGuide - Revision history

Admin: 3 revisions imported