<body>
<h1>Installing integrated RT ticketing</h1>
-<p><i>Integrated ticketing is an new feature and these instructinos are preliminary. Documentation contributions are welcome.</i>
+<p><i>Integrated ticketing is an new feature and these instructions are preliminary. Documentation contributions are welcome.</i>
+
+<p><i>There is also support for running this integration against an external RT installation, but it is not (yet) documented.</i>
<p>Perl minimum version 5.8.3 is required. HTML::Mason is required.
<p>Install the following perl modules:
<ul>
<li><a href="http://search.cpan.org/search?dist=Apache-Session">Apache::Session</a>
- <li><a href="http://search.cpan.org/search?dist=HTML-TreeBuilder">HTML::TreeBuilder</a>
- <li><a href="http://search.cpan.org/search?dist=HTML-FormatText">HTML::FormatText</a>
+ <li><a href="http://search.cpan.org/search?dist=HTML-Tree">HTML::TreeBuilder (HTML-Tree)</a>
+ <li><a href="http://search.cpan.org/search?dist=HTML-Format">HTML::FormatText (HTML-Format)</a>
<li><a href="http://search.cpan.org/search?dist=Test-Inline">Test::Inline</a>
<li><a href="http://search.cpan.org/search?dist=Class-ReturnValue">Class::ReturnValue</a>
<li><a href="http://search.cpan.org/search?dist=DBIx-SearchBuilder">DBIx::SearchBuilder</a>
<li><a href="http://search.cpan.org/search?dist=Log-Dispatch">Log::Dispatch</a>
<li><a href="http://search.cpan.org/search?dist=Locale-Maketext-Lexicon">Locale::Maketext::Lexicon</a>
<li><a href="http://search.cpan.org/search?dist=Locale-Maketext-Fuzzy">Locale::Maketext::Fuzzy</a>
- <li><a href="http://search.cpan.org/search?dist=MIME-Entity">MIME::Entity</a>
<li><a href="http://search.cpan.org/search?dist=Text-Wrapper">Text::Wrapper</a>
- <li><a href="http://search.cpan.org/search?dist=Time-ParseDate">Time::ParseDate</a>
- <li><a href="http://search.cpan.org/search?dist=Term-ReadKey">Term::ReadKey</a>
+ <li><a href="http://search.cpan.org/search?dist=Time-modules">Time::ParseDate (Time-modules)</a>
+ <li><a href="http://search.cpan.org/search?dist=TermReadKey">Term::ReadKey (TermReadKey)</a>
<li><a href="http://search.cpan.org/search?dist=Text-Autoformat">Text::Autoformat</a>
<li><a href="http://search.cpan.org/search?dist=Text-Quoted">Text::Quoted</a>
<li><a href="http://search.cpan.org/search?dist=Regexp-Common">Regexp::Common</a>
+ <li><a href="http://search.cpan.org/search?dist=HTML-Scrubber">HTML::Scrubber</a>
+ <li><a href="http://search.cpan.org/search?dist=Tree-Simple">Tree::Simple</a>
</ul>
<p>Create a new Unix group called 'rt'
+<p>Edit the top-level Makefile, set RT_ENABLED to 1 and set the RT_DOMAIN, RT_TIMEZONE, and FREESIDE_URL variables.
+
<p><pre>make configure-rt
make create-rt
make install-rt
<p>Add the following to your httpd.conf:
<pre>
+# replace /var/www/freeside with your freeside document root
<DirectoryMatch "^/var/www/freeside/rt/.*NoAuth">
<Limit GET POST>
allow from all
PerlHandler HTML::Mason
</Limit>
</DirectoryMatch>
+# 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>
</pre>
<p>Set the <b>ticket_system</b> configuration value to <b>RT_Internal</b>. You may also wish to set <b>ticket_system-default_queueid</b> once you have RT configured.