http://www.freeside.biz/mediawiki/api.php?action=feedcontributions&user=Alex&feedformat=atomFreeside - User contributions [en]2024-03-28T08:58:27ZUser contributionsMediaWiki 1.27.7http://www.freeside.biz/mediawiki/index.php?title=Freeside:3:Documentation:RT_Installation&diff=8201Freeside:3:Documentation:RT Installation2015-01-20T23:30:59Z<p>Alex: Including Debian 7's setup of the pg_hba.conf file.</p>
<hr />
<div>== Introduction ==<br />
<br />
These instructions document installation of the integrated internal RT ticketing system. <br />
<br />
There is also support for running this integration against an external RT installation, but it is not (yet) documented.<br />
<br />
Documentation contributions are welcome.<br />
<br />
== Prerequisites ==<br />
<br />
* [http://search.cpan.org/dist/Apache-Session Apache::Session]<br />
* [http://search.cpan.org/dist/HTML-Tree HTML::TreeBuilder]<br />
* [http://search.cpan.org/dist/HTML-Format HTML-Format] (CPAN: "install HTML::FormatText")<br />
* [http://search.cpan.org/dist/Test-Inline Test::Inline]<br />
* [http://search.cpan.org/dist/Class-ReturnValue Class::ReturnValue]<br />
* [http://search.cpan.org/dist/DBIx-SearchBuilder DBIx::SearchBuilder]<br />
* [http://search.cpan.org/dist/Log-Dispatch Log::Dispatch]<br />
* [http://search.cpan.org/dist/Locale-Maketext-Lexicon Locale::Maketext::Lexicon]<br />
* [http://search.cpan.org/dist/Locale-Maketext-Fuzzy Locale::Maketext::Fuzzy]<br />
* [http://search.cpan.org/dist/Text-Wrapper Text::Wrapper]<br />
* [http://search.cpan.org/dist/Time-modules Time-modules] (CPAN: "install Time::ParseDate")<br />
* [http://search.cpan.org/dist/TermReadKey Term::ReadKey]<br />
* [http://search.cpan.org/dist/Text-Autoformat Text::Autoformat]<br />
* [http://search.cpan.org/dist/Text-Quoted Text::Quoted]<br />
* [http://search.cpan.org/dist/Regexp-Common Regexp::Common]<br />
* [http://search.cpan.org/dist/HTML-Scrubber HTML::Scrubber]<br />
* [http://search.cpan.org/dist/Tree-Simple Tree::Simple]<br />
* [http://search.cpan.org/dist/Crypt-SSLeay Crypt::SSLeay]<br />
* [http://search.cpan.org/dist/GDGraph GD::Graph]<br />
* [http://search.cpan.org/dist/UNIVERSAL-Require UNIVERSAL::require]<br />
* [http://search.cpan.org/dist/XML-RSS XML::RSS]<br />
* [http://search.cpan.org/dist/Calendar-Simple Calendar::Simple]<br />
* [http://search.cpan.org/dist/GD-Graph GD::Graph]<br />
* [http://search.cpan.org/dist/GD-Text GD::Text]<br />
* [http://search.cpan.org/dist/CSS-Squish CSS::Squish]<br />
* [http://search.cpan.org/dist/HTML-Element-Extended HTML::ElementTable]<br />
<br />
Missing prerequisites? Please add them.<br />
<br />
== Installation ==<br />
<br />
* Create a new Unix group called 'rt'<br />
<pre><br />
addgroup rt<br />
</pre><br />
* 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.<br />
<pre><br />
cd freeside-X.X/<br />
nano Makefile<br />
</pre><br />
<br />
* <pre><nowiki>$ make configure-rt</nowiki></pre><br />
* 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<br />
* <pre><nowiki># make create-rt</nowiki></pre><br />
** ''Authentication errors?''<br />
*** ''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>" (Debian 7.x has a METHOD column that is set to <code>peer</code>, this needs to be set to <code>trust</code>)''<br />
*** ''Restart Pg''<br />
*** ''Revert the change back and restart Pg after this installation step''<br />
* <pre><nowiki>make install-rt</nowiki></pre><br />
* Configure Apache: make sure APACHE_CONF and FREESIDE_DOCUMENT_ROOT are set correctly in the Makefile, then run:<br />
<pre><br />
make install-apache<br />
</pre><br />
<br />
* Restart Apache (httpd) and log into the Freeside web interface using the username and password you created during the first part of the installation.<br />
<br />
* 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.)<br />
<br />
=== Bootstrap RT's permissions ===<br />
*Click on "Ticketing Main" on the Freeside main menu to auto-create an RT login for your username<br />
*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).<br />
* 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.<br />
* 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.<br />
* Go back to the freeside employee list and disable the temporary "root" user.<br />
<br />
== Futher Reading ==<br />
* Follow the [http://wiki.bestpractical.com/ regular RT documentation] to configure RT, setup the mailgate, etc.</div>Alex