Freeside:2.1:Documentation:RT Installation:Ubuntu

Introduction

Install RT on Ubuntu / Debian system - Tested with Ubuntu 10.4 Lts

1. Install Perl Modules

cpan Apache::Session HTML::TreeBuilder HTML::FormatText Test::Inline Class::ReturnValue DBIx::SearchBuilder Log::Dispatch Locale::Maketext::Lexicon 
cpan Locale::Maketext::Fuzzy Text::Wrapper Time::ParseDate Term::ReadKey Text::Autoformat Text::Quoted Regexp::Common HTML::Scrubber Tree::Simple
cpan Crypt::SSLeay GD::Graph UNIVERSAL::require XML::RSS Calendar::Simple GD::Graph GD::Text CSS::Squish 
cpan File::ShareDir HTML::RewriteAttributes MIME::Types  PerlIO::eol GnuPG::Interface Data::ICal Text::WikiFormat Net::Server
cpan HTTP::Server::Simple HTTP::Server::Simple::Mason Module::Versions::Report DateTime::Set IPC::Run::SafeHandles

Installation

• Create a new Unix group called 'rt'

addgroup rt

• Edit the top-level Makefile (within the freeside source directory - NOT rt directory), set RT_ENABLED to 1 and set the RT_DOMAIN, RT_TIMEZONE, and FREESIDE_URL variables.

cd /freesidesource/freeside-X.X/
nano Makefile

• $ make configure-rt

• If your database is not on the local machine you will need to edit /opt/rt3/etc/RT_SiteConfig.pm and set the DatabaseHost value

• # make create-rt

  • Authentication errors?
    • Edit pg_hba.conf, change "ident sameuser" auth to "trust" for the line starting with "local all all"
    • Restart Pg
    • Revert the change back and restart Pg after this installation step

• make install-rt

• Add the following to your httpd.conf:

#replace /var/www/freeside with your freeside document root
<Directory /var/www/freeside/rt/NoAuth>
<Limit GET POST>
allow from all
Satisfy any   
SetHandler perl-script
PerlHandler HTML::Mason
</Limit>
</Directory>

#replace /var/www/freeside with your freeside document root
<Directory /var/www/freeside/rt/REST/1.0/NoAuth>
<Limit GET POST>
allow from all
Satisfy any   
SetHandler perl-script
PerlHandler HTML::Mason
</Limit>
</Directory>

#replace /var/www/freeside with your freeside document root
<DirectoryMatch "^%/var/www/freeside/rt/.*NoAuth/images">
SetHandler None
</DirectoryMatch>

#replace /var/www/freeside with your freeside document root
<Directory /var/www/freeside/rt/Ticket/Attachment> 
SetHandler perl-script 
PerlHandler HTML::Mason 
</Directory>

#replace /var/www/freeside with your freeside document root
<Directory /var/www/freeside/rt/Search> 
SetHandler perl-script 
PerlHandler HTML::Mason 
</Directory>

• Restart Apache (httpd) and log into the Freeside web interface using the username and password you created during the first part of the installation.

• Set the ticket_system configuration value to RT_Internal. (You may also wish to set ticket_system-default_queueid once you have RT configured.)

Bootstrap RT's permissions

• Click on "Ticketing Main" on the Freeside main menu to auto-create an RT login for your username
• From "Billing Main", go to Configuration > Employees > View/Edit employees and add a temporary "root" user. Note: the user name must be "root" (without the quotes).
• Log into your Freeside installation as the "root" user you just created, by closing all of your browser windows, or by using https://root@yourmachone/freeside/ syntax if your browser supports it.
• Click on "Ticketing Main" on the Freeside main menu. Go to Configuration > Ticketing > Ticketing Global, and then "User Rights". Grant the "SuperUser" right to your normal RT/Freeside login.
• Go back to the freeside employee list and disable the temporary "root" user.

Futher Reading

• Follow the regular RT documentation to configure RT, setup the mailgate, etc.