Difference between revisions of "Freeside:2.1:Documentation:RT Installation:Ubuntu"
From Freeside
(→Introduction) |
(→Introduction) |
||
Line 3: | Line 3: | ||
Install RT on Ubuntu system - Tested with Ubuntu 10.4 Lts | Install RT on Ubuntu system - Tested with Ubuntu 10.4 Lts | ||
− | NOTE: This is user-contributed documentation and may contain errors or omissions (in the past, this documentation caused folks to wind up with an unstyled RT). Please use in conjunction with the stock installation instructions and help us keep this documentation up-to-date and accurate by editing where appropriate. | + | ''NOTE: This is user-contributed documentation and may contain errors or omissions (in the past, this documentation caused folks to wind up with an unstyled RT). Please use in conjunction with the stock installation instructions and help us keep this documentation up-to-date and accurate by editing where appropriate. |
+ | '' | ||
==Install Dependancies== | ==Install Dependancies== |
Revision as of 12:27, 23 November 2011
Contents
Introduction
Install RT on Ubuntu system - Tested with Ubuntu 10.4 Lts
NOTE: This is user-contributed documentation and may contain errors or omissions (in the past, this documentation caused folks to wind up with an unstyled RT). Please use in conjunction with the stock installation instructions and help us keep this documentation up-to-date and accurate by editing where appropriate.
Install Dependancies
- Install dependancy for Crypt::SSLeay
apt-get install libssl-dev
- Install Perl Modules (WTF, are none of these available as packages in Ubuntu? They should all be in Debian. -Ivan)
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
- Edit
- Authentication errors?
-
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.