Difference between revisions of "Freeside:2.1:Documentation:RT Installation:Ubuntu"

From Freeside
Jump to: navigation, search
 
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
==Introduction==
 
==Introduction==
  
−
Install RT on Ubuntu / Debian system - Tested with Ubuntu 10.4 Lts
+
Install RT on Ubuntu system - Tested with Ubuntu 10.4 Lts
−
 
 
−
==1. Install Perl Modules==
 
  
 +
==Install Dependancies==
 +
* Install dependancy for Crypt::SSLeay
 +
<pre>
 +
apt-get install libssl-dev
 +
</pre>
 +
* Install Perl Modules ''(WTF, are none of these available as packages in Ubuntu?  They should all be in Debian.  -Ivan)''
 
<pre>
 
<pre>
 
cpan Apache::Session HTML::TreeBuilder HTML::FormatText Test::Inline Class::ReturnValue DBIx::SearchBuilder Log::Dispatch Locale::Maketext::Lexicon  
 
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 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 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 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
+
cpan HTTP::Server::Simple HTTP::Server::Simple::Mason Module::Versions::Report DateTime::Set IPC::Run::SafeHandles
 
</pre>
 
</pre>
  
 
== Installation ==
 
== Installation ==
  
−
* Create a new Unix group called 'rt'
+
Follow the [[Freeside:2.1:Documentation:RT_Installation#Installation|regular installation instructions]].
−
<pre>
 
−
addgroup rt
 
−
</pre>
 
−
* 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.
 
−
<pre>
 
−
cd /freesidesource/freeside-X.X/
 
−
nano Makefile
 
−
</pre>
 
−
 
 
−
* <pre><nowiki>$ make configure-rt</nowiki></pre>
 
−
* 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
 
−
* <pre><nowiki># make create-rt</nowiki></pre>
 
−
** ''Authentication errors?''
 
−
*** ''Edit <code>pg_hba.conf</code>, change "<code>ident sameuser</code>" auth to "<code>trust</code>" for the line starting with "<code>local all all</code>"''
 
−
*** ''Restart Pg''
 
−
*** ''Revert the change back and restart Pg after this installation step''
 
−
* <pre><nowiki>make install-rt</nowiki></pre>
 
−
* Add the following to your httpd.conf:
 
−
<pre>
 
−
#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>
 
−
</pre>
 
−
 
 
−
* 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 <code>RT_Internal</code>.  (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 <code><nowiki>https://root@yourmachone/freeside/</nowiki></code> 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 [http://wiki.bestpractical.com/ regular RT documentation] to configure RT, setup the mailgate, etc.
 

Latest revision as of 12:30, 23 November 2011

Introduction

Install RT on Ubuntu system - Tested with Ubuntu 10.4 Lts

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

Follow the regular installation instructions.

Retrieved from "http://secure.freeside.biz/mediawiki/index.php?title=Freeside:2.1:Documentation:RT_Installation:Ubuntu&oldid=6693"