|
|
| (3 intermediate revisions by the same user not shown) |
| Line 1: |
Line 1: |
| | ==Introduction== | | ==Introduction== |
| | | | |
| − | Install RT on Ubuntu / Debian system - Tested with Ubuntu 10.4 Lts | + | Install RT on Ubuntu system - Tested with Ubuntu 10.4 Lts |
| | | | |
| | ==Install Dependancies== | | ==Install Dependancies== |
| Line 19: |
Line 19: |
| | == Installation == | | == Installation == |
| | | | |
| − | * Create a new Unix group called 'rt'
| + | Follow the [[Freeside:2.1:Documentation:RT_Installation#Installation|regular installation instructions]]. |
| − | <pre>
| |
| − | addgroup rt
| |
| − | </pre>
| |
| − | * Edit the top-level Makefile (within the freeside source directory - NOT rt directory), set RT_ENABLED to 1 and set the RT_DOMAIN, RT_TIMEZONE, and FREESIDE_URL variables.
| |
| − | <pre>
| |
| − | cd /freesidesource/freeside-X.X/
| |
| − | nano Makefile
| |
| − | </pre>
| |
| − | | |
| − | * <pre><nowiki>$ make configure-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?''
| |
| − | *** ''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>"''
| |
| − | *** ''Restart Pg''
| |
| − | *** ''Revert the change back and restart Pg after this installation step''
| |
| − | * <pre><nowiki>make install-rt</nowiki></pre>
| |
| − | * Add the following to your httpd.conf:
| |
| − | <pre>
| |
| − | #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>
| |
| − | </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.)
| |
| − | | |
| − | === 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 <code><nowiki>https://root@yourmachone/freeside/</nowiki></code> syntax if your browser supports it.
| |
| − | * Click on "Ticketing Main" on the Freeside main menu. Go to Configuration > Ticketing > Ticketing Global, and then "User Rights". Grant the "SuperUser" right to your normal RT/Freeside login.
| |
| − | * Go back to the freeside employee list and disable the temporary "root" user.
| |
| − | | |
| − | == Futher Reading ==
| |
| − | * Follow the [http://wiki.bestpractical.com/ regular RT documentation] to configure RT, setup the mailgate, etc.
| |
