==Request-Tracker 3.8.1 on Debian Lenny==
copied from http://rtvm.tehcorner.com/rt38/ and edited for my company Installation
1. setup base system with very minimalistic install
2. update sources then upgrade
aptitude update
aptitude full-upgrade
3. install ssh
aptitude install openssh-server
4. install the following packages
aptitude install apache2 openssl mysql-server-5.0 postfix fetchmail libc6-dev libc-dev libmudflap0-dev make gcc gawk libapache2-mod-perl2 libxml-handler-composer-perl libxml-generator-perl unzip mlocate
5. choose "Internet Site with smart host" in postfix configuration and use yourmailserver as smart host.
6. setup your mysql root password NOTE: This is different from your system root password
mysqladmin -u root password <yourpassword>
7. download and unpack download:
wget http://download.bestpractical.com/pub/rt/release/rt.tar.gz unpack:
tar -xzvf rt.tar.gz change working directory
cd ./rt-3.8.1
8. configure CPAN
perl -MCPAN -e shell Choose auto config
Would you like me to configure as much as possible automatically? noyes when asked about building prerequisites choose "follow"
Policy on building prerequisites (follow, ask or ignore)? ask follow Once your done and get the cpan> prompt run o conf init
cpan>o conf init this time choose choose enter no for auto config
Would you like me to configure as much as possible automatically? yesno once your done go ahead and install Bundle::CPAN as per http://search.cpan.org/~andk/Bundle-CPAN-1.857/CPAN.pm "Bundle::CPAN - Bundle to optimize the behaviour of CPAN.pm"
cpan> install Bundle::CPAN .. ... install everything, including optional packages exit cpan once its complete cpan> exit
9. lets start the rt install
./configure
10. run make testdeps
make testdeps Expect to see errors a fews time due to the missing dependencies you should get something similar at the end. We will be running make testdeps a few times to make sure all dependencies are satisfied. make: * testdeps Error 1
11. now run make fixdeps
make fixdeps
keep hitting yes when asked about prepending.
Shall I follow them and prepend them to the queue of modules we are processing right now? yes
run make testdeps to see if
we are still missing dependencies
make testdeps you might get the folling message
SOME DEPENDENCIES WERE MISSING. ICAL missing dependencies: Data::ICal...MISSING make: * fixdeps Error 1
simply re-run for any missing dependencies
make fixdeps .. All dependencies have been found.
to make sure everything is satisfied
make testdeps and you should get the following
All dependencies have been found
12. now run make install
make install Configuration
13. once completed you will need to edit RT_SiteConfig.pm backup:
cp /opt/rt3/etc/RT_SiteConfig.pm /opt/rt3/etc/RT_SiteConfig.pm.orig edit:
vim /opt/rt3/etc/RT_SiteConfig.pm edit your RT_SiteConfig.pm to reflect your specific settings
Set($rtname , "rt.yourdomain.com"); Set($Organization , "yourdomain.com"); Set($CorrespondAddress , 'rt@rt.yourdomain.com'); Set($CommentAddress , 'rt-comment@rt.yourdomain.com'); Set($OwnerEmail , 'root'); Set($MaxAttachmentSize , 10000000);
# THE DATABASE:
Set($DatabaseType, 'mysql'); # e.g. Pg or mysql
# These are the settings that will be used when # 'make initialize-database' is run, you MUST set # these to what you want.
Set($DatabaseUser , 'rt_user'); Set($DatabasePassword , '<db password>'); Set($DatabaseName , 'rt3');
# THE WEBSERVER:
Set($WebPath , ""); #Set($WebPath , "/rt"); Set($WebBaseURL , "http://rt.yourdomain.com"); 1;
14. now run make initialize-database
make initialize-database enter the password you created in step 6 you should get the following
Working with: Type: mysql Host: localhost Name: rtdb User: rtuser DBA: root Now creating a mysql database rtdb for RT. Done. Now populating database schema. Done. Now inserting database ACLs Granting access to rtuser@'localhost' on rtdb. Done. Now inserting RT core system objects Done. Now inserting data Done inserting data Done.
15. backup and modify your default apache config backup:
mv /etc/apache2/sites-available/default /etc/apache2/sites-available/default.orig edit:
vim /etc/apache2/sites-available/default now edit to reflect your sites specification
<VirtualHost *:80>
ServerName rt.yourdomain.com
DocumentRoot /opt/rt3/share/html
PerlRequire "/opt/rt3/bin/webmux.pl"
<Location />
AddDefaultCharset UTF-8
SetHandler perl-script
PerlResponseHandler RT::Mason
</Location>
</VirtualHost>
16. enable apache modules you might be using, this will depend on how you've configured your site
a2enmod perl a2enmod rewrite Test RT 17.stop start apache as needed
/etc/init.d/apache2 stop /etc/init.d/apache2 start
18. now open up your favorite browser and login
http://your.ip.address.or.hostname
the default login is user: root password: password
Install RTFM 19. Download and extract RTFM
wget http://download.bestpractical.com/pub/rt/release/rtfm.tar.gz
tar -xzvf rtfm.tar.gz
20. Install and patch the database
cd RTFM-2.4.0 perl Makefile.PL make install make initdb
21. add follwing line to /opt/rt3/etc/RT_SiteConfig.pm
Set(@Plugins,qw(RT::FM));
22. clear mason cache
rm -rf /opt/rt3/var/mason_data/*
23. Stop and restart Apache
/etc/init.d/apache2 stop /etc/init.d/apache2 start
24. log in again and retest
Configure Postfix
25. add follwing line to /etc/aliases rt: "|/opt/rt3/bin/rt-mailgate --queue 'General' --action correspond --url http://rt.yourdomain.com" rt-comment: "|/opt/rt3/bin/rt-mailgate --queue 'General' --action comment --url http://rt.yourdomain.com"
26. run newaliases command
newaliases
27. Give everyone rights to CreateTicket, ReplyToTicket, CommentOnTicket (configuration, global, group rights)