summaryrefslogtreecommitdiff
path: root/httemplate/docs/install-rt.html
diff options
context:
space:
mode:
authorivan <ivan>2005-03-09 08:18:57 +0000
committerivan <ivan>2005-03-09 08:18:57 +0000
commit24cf1de1156932c50a8d0d7bcab5f1fd163a35c0 (patch)
tree9359bb4d2d285515f137a893b323d911eb3aea88 /httemplate/docs/install-rt.html
parenta18e0aadb62be9f96c0aa42b3a6464dc933477dc (diff)
preliminary RT docs
Diffstat (limited to 'httemplate/docs/install-rt.html')
-rw-r--r--httemplate/docs/install-rt.html66
1 files changed, 66 insertions, 0 deletions
diff --git a/httemplate/docs/install-rt.html b/httemplate/docs/install-rt.html
new file mode 100644
index 000000000..0a82ff5e6
--- /dev/null
+++ b/httemplate/docs/install-rt.html
@@ -0,0 +1,66 @@
+<head>
+ <title>Installing integrated RT ticketing</title>
+</head>
+<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>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=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=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>
+ </ul>
+
+<p>Create a new Unix group called 'rt'
+
+<p><pre>make configure-rt
+make create-rt
+make install-rt
+</pre>
+
+<p>Add the following to your httpd.conf:
+<pre>
+&lt;DirectoryMatch "^/var/www/freeside/rt/.*NoAuth"&gt;
+&lt;Limit GET POST&gt;
+allow from all
+Satisfy any
+SetHandler perl-script
+PerlHandler HTML::Mason
+&lt;/Limit&gt;
+&lt;/DirectoryMatch&gt;
+&lt;DirectoryMatch "^/var/www/freeside/rt/.*NoAuth/images"&gt;
+SetHandler None
+&lt;/DirectoryMatch&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.
+
+<p>Bootstrap RT's permissions:
+ <ul>
+ <li>Click on "Ticketing Main" on the Freeside main menu to auto-create an RT login for your username
+ <li>Run <code>freeside-adduser -h /usr/local/etc/freeside/htpasswd root</code> and set a (temporary) password
+ <li>Log into your Freeside installation as the "root" user you just created, by closing your browser or using <code>https://root@yourmachone/freeside/</code> syntax.
+ <li>Click on "Ticketing Main" on the Freeside main menu. Click on "Configuration", then "Global", and then "User Rights". Grant the "SuperUser" right to your RT login.
+ <li>Remove the temporary "root" user from /usr/local/etc/freeside/mapsecrets and /usr/local/etc/freeside/htpasswd
+ </ul>
+
+<p>Follow the <A HREF="http://wiki.bestpractical.com/">regular RT documentation</A> to configure RT, setup the mailgate, etc.
+
+</body>