add HTML::Scrubber to rt install/upgrade docs
[freeside.git] / httemplate / docs / install-rt.html
index 0a82ff5..406b008 100644 (file)
@@ -6,6 +6,8 @@
 
 <p><i>Integrated ticketing is an new feature and these instructinos 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:
     <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=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>
   </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
@@ -37,6 +41,7 @@ make install-rt
 
 <p>Add the following to your httpd.conf:
 <pre>
+# replace /var/www/freeside with your freeside document root
 &lt;DirectoryMatch "^/var/www/freeside/rt/.*NoAuth"&gt;
 &lt;Limit GET POST&gt;
 allow from all
@@ -45,9 +50,15 @@ SetHandler perl-script
 PerlHandler HTML::Mason
 &lt;/Limit&gt;
 &lt;/DirectoryMatch&gt;
+# replace /var/www/freeside with your freeside document root
 &lt;DirectoryMatch "^/var/www/freeside/rt/.*NoAuth/images"&gt;
 SetHandler None
 &lt;/DirectoryMatch&gt;
+# replace /var/www/freeside with your freeside document root
+&lt;Directory /var/www/freeside/rt/Ticket/Attachment&gt; 
+SetHandler perl-script 
+PerlHandler HTML::Mason 
+&lt;/Directory&gt;
 </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.