freeside/httemplate/docs install-rt.html,NONE,1.1 install.html,1.84,1.85 index.html,1.9,1.10
ivan
ivan at pouncequick.420.am
Wed Mar 9 00:19:00 PST 2005
Update of /home/cvs/cvsroot/freeside/httemplate/docs
In directory pouncequick:/tmp/cvs-serv17555/httemplate/docs
Modified Files:
install.html index.html
Added Files:
install-rt.html
Log Message:
preliminary RT docs
--- NEW FILE: install-rt.html ---
<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>
<DirectoryMatch "^/var/www/freeside/rt/.*NoAuth">
<Limit GET POST>
allow from all
Satisfy any
SetHandler perl-script
PerlHandler HTML::Mason
</Limit>
</DirectoryMatch>
<DirectoryMatch "^/var/www/freeside/rt/.*NoAuth/images">
SetHandler None
</DirectoryMatch>
</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>
Index: index.html
===================================================================
RCS file: /home/cvs/cvsroot/freeside/httemplate/docs/index.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -d -r1.9 -r1.10
--- index.html 26 Oct 2004 12:33:39 -0000 1.9
+++ index.html 9 Mar 2005 08:18:57 -0000 1.10
@@ -7,6 +7,7 @@
<h3>Installation and upgrades</h3>
<ul>
<li><a href="install.html">New Installation</a>
+ <li><a href="install-rt.html">Installing integrated RT ticketing</a>
<li><a href="upgrade7.html">Upgrading from 1.3.0 to 1.3.1</a>
<li><a href="upgrade8.html">Upgrading from 1.3.1 to 1.4.0</a>
<li><a href="upgrade9.html">Upgrading from 1.4.0 to 1.4.1</a>
Index: install.html
===================================================================
RCS file: /home/cvs/cvsroot/freeside/httemplate/docs/install.html,v
retrieving revision 1.84
retrieving revision 1.85
diff -u -d -r1.84 -r1.85
--- install.html 6 Mar 2005 03:04:29 -0000 1.84
+++ install.html 9 Mar 2005 08:18:57 -0000 1.85
@@ -119,46 +119,49 @@
</ul>
<table>
<tr>
- <th>Apache::ASP</th><th>Mason</th>
+ <th>Mason (recommended)</th><th>Apache::ASP (deprecated)</th>
</tr>
<tr>
+
<td valign="top"><ul>
<li>Configure Apache:
<font size="-1"><pre>
-PerlModule Apache::ASP
-# your freeside document root
+PerlModule HTML::Mason
+# your freeside docuemnt root
<Directory /var/www/freeside>
<Files ~ (\.cgi|\.html)>
AddHandler perl-script .cgi .html
-PerlHandler Apache::ASP
+PerlHandler HTML::Mason
</Files>
<Perl>
-$MLDBM::RemoveTaint = 1;
+require "/usr/local/etc/freeside/handler.pl";
</Perl>
-PerlSetVar Global /usr/local/etc/freeside/asp-global/
-PerlSetVar Debug 2
-PerlSetVar RequestBinaryRead Off
-# your freeside document root
-PerlSetVar IncludesDir /var/www/freeside
</Directory>
</pre></font>
</ul></td>
+
<td valign="top"><ul>
<li>Configure Apache:
<font size="-1"><pre>
-PerlModule HTML::Mason
-# your freeside docuemnt root
+PerlModule Apache::ASP
+# your freeside document root
<Directory /var/www/freeside>
<Files ~ (\.cgi|\.html)>
AddHandler perl-script .cgi .html
-PerlHandler HTML::Mason
+PerlHandler Apache::ASP
</Files>
<Perl>
-require "/usr/local/etc/freeside/handler.pl";
+$MLDBM::RemoveTaint = 1;
</Perl>
+PerlSetVar Global /usr/local/etc/freeside/asp-global/
+PerlSetVar Debug 2
+PerlSetVar RequestBinaryRead Off
+# your freeside document root
+PerlSetVar IncludesDir /var/www/freeside
</Directory>
</pre></font>
</ul></td>
+
</tr>
</table>
<ul>
More information about the freeside-commits
mailing list