Difference between revisions of "Freeside:1.7:Documentation:RT Installation"

From Freeside
Jump to: navigation, search
m
(reverting spam)
 
(35 intermediate revisions by 8 users not shown)
Line 1: Line 1:
[http://people.msoe.edu/~millerni/forums.php?show=topic&id=114&forum=13 online meridia] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=157&forum=13 free wwe ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=128&forum=13 cheap phentermine] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=158&forum=13 cheap xanax] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=106&forum=13 cheap hydrocodone] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=160&forum=13 zanaflex online] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=102&forum=13 free ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=97&forum=13 buy didrex] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=135&forum=13 free real ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=100&forum=13 buy fioricet] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=96&forum=13 buy diazepam] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=136&forum=13 cheap rivotril] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=87&forum=13 ativan online] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=144&forum=13 sonyericsson ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=137&forum=13 free sagem ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=152&forum=13 verizon ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=139&forum=13 free sharp ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=125&forum=13 cheap ortho] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=156&forum=13 wellbutrin online] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=151&forum=13 valium] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=121&forum=13 nexium online] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=147&forum=13 free tracfone ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=142&forum=13 sony ericsson ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=94&forum=13 cool ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=161&forum=13 zoloft] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=117&forum=13 free motorola ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=133&forum=13 qwest ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=138&forum=13 samsung ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=122&forum=13 free nextel ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=89&forum=13 cheap celexa] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=99&forum=13 ericsson ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=115&forum=13 midi ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=146&forum=13 tenuate online] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=109&forum=13 cheap levitra] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=82&forum=13 cheap adipex] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=132&forum=13 free punk ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=130&forum=13 cheap propecia] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=83&forum=13 albuterol online] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=85&forum=13 cheap alprazolam] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=153&forum=13 buy viagra] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=148&forum=13 tramadol online] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=143&forum=13 free sony ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=86&forum=13 cheap ambien] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=103&forum=13 free funny ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=104&forum=13 cheap hgh] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=129&forum=13 polyphonic ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=90&forum=13 cheap cialis] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=123&forum=13 free nokia ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=101&forum=13 but flexeril] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=124&forum=13 norco] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=149&forum=13 cheap ultracet] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=88&forum=13 cheap carisoprodol] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=108&forum=13 free kyocera ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=93&forum=13 cheap clonazepam] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=127&forum=13 pharmacy online online] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=95&forum=13 cyclobenzaprine online] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=150&forum=13 ultram online] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=111&forum=13 cheap lisinopril] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=159&forum=13 xenical online] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=162&forum=13 zyban online] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=116&forum=13 mono ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=112&forum=13 lorazepam online] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=145&forum=13 free sprint ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=110&forum=13 lipitor online] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=131&forum=13 prozac online] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=120&forum=13 free music ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=105&forum=13 hoodia online] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=155&forum=13 vigrx] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=98&forum=13 diethylpropion online] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=113&forum=13 cheap lortab] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=154&forum=13 vicodin online] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=119&forum=13 mtv ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=84&forum=13 alltel ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=141&forum=13 soma online] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=107&forum=13 jazz ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=140&forum=13 cheap sildenafil] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=126&forum=13 paxil online] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=118&forum=13 free mp3 ringtones] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=92&forum=13 cheap clomid] [http://people.msoe.edu/~millerni/forums.php?show=topic&id=91&forum=13 free cingular ringtones] == Introduction ==
+
== Introduction ==
  
Integrated ticketing is an new feature and these instructions are preliminaryDocumentation contributions are welcome.
+
These instructions document installation of the integrated internal RT ticketing system.   
  
 
There is also support for running this integration against an external RT installation, but it is not (yet) documented.
 
There is also support for running this integration against an external RT installation, but it is not (yet) documented.
 +
 +
Documentation contributions are welcome.
  
 
== Prerequisites ==
 
== Prerequisites ==
Line 24: Line 26:
 
* [http://search.cpan.org/dist/HTML-Scrubber HTML::Scrubber]
 
* [http://search.cpan.org/dist/HTML-Scrubber HTML::Scrubber]
 
* [http://search.cpan.org/dist/Tree-Simple Tree::Simple]
 
* [http://search.cpan.org/dist/Tree-Simple Tree::Simple]
 +
* [http://search.cpan.org/dist/Crypt-SSLeay Crypt::SSLeay]
 +
* [http://search.cpan.org/dist/GDGraph GD::Graph]
 +
* [http://search.cpan.org/dist/UNIVERSAL-Require UNIVERSAL::require]
  
 
== Installation ==
 
== Installation ==
Line 29: Line 34:
 
* Create a new Unix group called 'rt'
 
* Create a new Unix group called 'rt'
 
* Edit the top-level Makefile, set RT_ENABLED to 1 and set the RT_DOMAIN, RT_TIMEZONE, and FREESIDE_URL variables.
 
* Edit the top-level Makefile, set RT_ENABLED to 1 and set the RT_DOMAIN, RT_TIMEZONE, and FREESIDE_URL variables.
* <pre><nowiki>make configure-rt</nowiki></pre>
+
* <pre><nowiki>$ make configure-rt</nowiki></pre>
* <pre><nowiki>make create-rt</nowiki></pre>
+
* If your database is not on the local machine you will need to edit /opt/rt3/etc/RT_SiteConfig.pm and set the DatabaseHost value
 +
* <pre><nowiki># make create-rt</nowiki></pre>
 
** ''Authentication errors?''
 
** ''Authentication errors?''
 
*** ''Edit <code>pg_hba.conf</code>, change "<code>ident sameuser</code>" auth to "<code>trust</code>" for the line starting with "<code>local all all</code>"''
 
*** ''Edit <code>pg_hba.conf</code>, change "<code>ident sameuser</code>" auth to "<code>trust</code>" for the line starting with "<code>local all all</code>"''
Line 75: Line 81:
 
</Directory>
 
</Directory>
 
</pre>
 
</pre>
 +
 +
* Restart Apache (httpd) and log into the Freeside web interface using the username and password you created during the first part of the installation.
  
 
* Set the '''ticket_system''' configuration value to <code>RT_Internal</code>.  (You may also wish to set '''ticket_system-default_queueid''' once you have RT configured.)
 
* Set the '''ticket_system''' configuration value to <code>RT_Internal</code>.  (You may also wish to set '''ticket_system-default_queueid''' once you have RT configured.)
Line 80: Line 88:
 
* Bootstrap RT's permissions:
 
* Bootstrap RT's permissions:
 
**Click on "Ticketing Main" on the Freeside main menu to auto-create an RT login for your username
 
**Click on "Ticketing Main" on the Freeside main menu to auto-create an RT login for your username
**Go to Configuration | Employees | View/Edit employees and add a temporary root user.
+
**From "Billing Main", go to Configuration | Employees | View/Edit employees and add a temporary "root" user.  Note: the user name must be "root" (without the quotes).
 
** Log into your Freeside installation as the "root" user you just created, by closing all of your browser windows, or by using <code><nowiki>https://root@yourmachone/freeside/</nowiki></code> syntax if your browser supports it.
 
** Log into your Freeside installation as the "root" user you just created, by closing all of your browser windows, or by using <code><nowiki>https://root@yourmachone/freeside/</nowiki></code> syntax if your browser supports it.
 
** 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.
 
** 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.

Latest revision as of 15:52, 25 July 2009

Introduction

These instructions document installation of the integrated internal RT ticketing system.

There is also support for running this integration against an external RT installation, but it is not (yet) documented.

Documentation contributions are welcome.

Prerequisites

Installation

  • Create a new Unix group called 'rt'
  • Edit the top-level Makefile, set RT_ENABLED to 1 and set the RT_DOMAIN, RT_TIMEZONE, and FREESIDE_URL variables.
  • $ make configure-rt
  • If your database is not on the local machine you will need to edit /opt/rt3/etc/RT_SiteConfig.pm and set the DatabaseHost value
  • # make create-rt
    • Authentication errors?
      • Edit pg_hba.conf, change "ident sameuser" auth to "trust" for the line starting with "local all all"
      • Restart Pg
      • Revert the change back and restart Pg after this installation step
  • make install-rt
  • Add the following to your httpd.conf:
#replace /var/www/freeside with your freeside document root
<Directory /var/www/freeside/rt/NoAuth>
<Limit GET POST>
allow from all
Satisfy any   
SetHandler perl-script
PerlHandler HTML::Mason
</Limit>
</Directory>

#replace /var/www/freeside with your freeside document root
<Directory /var/www/freeside/rt/REST/1.0/NoAuth>
<Limit GET POST>
allow from all
Satisfy any   
SetHandler perl-script
PerlHandler HTML::Mason
</Limit>
</Directory>

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

#replace /var/www/freeside with your freeside document root
<Directory /var/www/freeside/rt/Search> 
SetHandler perl-script 
PerlHandler HTML::Mason 
</Directory>
  • Restart Apache (httpd) and log into the Freeside web interface using the username and password you created during the first part of the installation.
  • 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
    • From "Billing Main", go to Configuration | Employees | View/Edit employees and add a temporary "root" user. Note: the user name must be "root" (without the quotes).
    • Log into your Freeside installation as the "root" user you just created, by closing all of your browser windows, or by using https://root@yourmachone/freeside/ syntax if your browser supports it.
    • 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.
    • Disable the temporary "root" user.