Installing integrated RT ticketing

From 24cf1de1156932c50a8d0d7bcab5f1fd163a35c0 Mon Sep 17 00:00:00 2001 From: ivan Date: Wed, 9 Mar 2005 08:18:57 +0000 Subject: [PATCH] preliminary RT docs --- ANNOUNCE.1.5 | 3 +- httemplate/docs/index.html | 1 + httemplate/docs/install-rt.html | 66 +++++++++++++++++++++++++++++++++++++++++ httemplate/docs/install.html | 31 ++++++++++--------- 4 files changed, 86 insertions(+), 15 deletions(-) create mode 100644 httemplate/docs/install-rt.html diff --git a/ANNOUNCE.1.5 b/ANNOUNCE.1.5 index c8143a80c..0be1a930a 100644 --- a/ANNOUNCE.1.5 +++ b/ANNOUNCE.1.5 @@ -25,7 +25,8 @@ - historical late notice viewing in web interface - VoIP billing for CDRs from RADIUS - promotional codes for signup -- lots of RT integration, integrated RT upgraded to 3.2.2 +- lots of RT integration, integrated RT upgraded to 3.2.2, preliminary RT + add-on docs - one-time referral credits - invoices now use history records (don't lose details) - option to credit for remaining service upon package cancel/change diff --git a/httemplate/docs/index.html b/httemplate/docs/index.html index d0151edeb..4a58441f7 100644 --- a/httemplate/docs/index.html +++ b/httemplate/docs/index.html @@ -7,6 +7,7 @@

Installation and upgrades

New Installation +
Installing integrated RT ticketing
Upgrading from 1.3.0 to 1.3.1
Upgrading from 1.3.1 to 1.4.0
Upgrading from 1.4.0 to 1.4.1 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 @@ + + Installing integrated RT ticketing + + +
Installing integrated RT ticketing
+ +
Integrated ticketing is an new feature and these instructinos are preliminary. Documentation contributions are welcome. + +
Perl minimum version 5.8.3 is required. HTML::Mason is required. + +
Install the following perl modules: +
- Apache::Session +
- HTML::TreeBuilder +
- HTML::FormatText +
- Test::Inline +
- Class::ReturnValue +
- DBIx::SearchBuilder +
- Log::Dispatch +
- Locale::Maketext::Lexicon +
- Locale::Maketext::Fuzzy +
- MIME::Entity +
- Text::Wrapper +
- Time::ParseDate +
- Term::ReadKey +
- Text::Autoformat +
- Text::Quoted +
- Regexp::Common +
+ +
Create a new Unix group called 'rt' + +
```
make configure-rt
+make create-rt
+make install-rt
+
```
+ +
Add the following to your httpd.conf: +
```
+<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>
+
```
+ +
Set the ticket_system configuration value to RT_Internal. You may also wish to set ticket_system-default_queueid once you have RT configured. + +
Bootstrap RT's permissions: +
- Click on "Ticketing Main" on the Freeside main menu to auto-create an RT login for your username +
- Run freeside-adduser -h /usr/local/etc/freeside/htpasswd root and set a (temporary) password +
- Log into your Freeside installation as the "root" user you just created, by closing your browser or using https://root@yourmachone/freeside/ syntax. +
- 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. +
- Remove the temporary "root" user from /usr/local/etc/freeside/mapsecrets and /usr/local/etc/freeside/htpasswd +
+ +
Follow the regular RT documentation to configure RT, setup the mailgate, etc. + + diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 4a89ab3ba..b7802b90f 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -119,46 +119,49 @@ $ su

- + + + +

Apache::ASP	Mason	Mason (recommended)	Apache::ASP (deprecated)
Configure Apache: -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>	Configure Apache: -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>

Apache::ASP

Mason

Mason (recommended)

Apache::ASP (deprecated)

Configure Apache:

-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>

Configure Apache:

-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>

-- 2.11.0