Difference between revisions of "Freeside:2.1:Documentation:RT Installation"
From Freeside
(New page: == Introduction == These instructions document installation of the integrated internal RT ticketing system. There is also support for running this integration against an external RT in...) |
(→Prerequisites) |
||
| (6 intermediate revisions by 2 users not shown) | |||
| Line 34: | Line 34: | ||
* [http://search.cpan.org/dist/GD-Text GD::Text] | * [http://search.cpan.org/dist/GD-Text GD::Text] | ||
* [http://search.cpan.org/dist/CSS-Squish CSS::Squish] | * [http://search.cpan.org/dist/CSS-Squish CSS::Squish] | ||
| + | * [http://search.cpan.org/dist/HTML-Element-Extended HTML::ElementTable] | ||
| + | |||
| + | Missing prerequisites? Please add them. | ||
== Installation == | == Installation == | ||
* 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. | + | <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 freeside-X.X/ | ||
| + | nano Makefile | ||
| + | </pre> | ||
| + | |||
* <pre><nowiki>$ make configure-rt</nowiki></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 | * 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 | ||
| Line 47: | Line 58: | ||
*** ''Revert the change back and restart Pg after this installation step'' | *** ''Revert the change back and restart Pg after this installation step'' | ||
* <pre><nowiki>make install-rt</nowiki></pre> | * <pre><nowiki>make install-rt</nowiki></pre> | ||
| − | * | + | * Configure Apache: make sure APACHE_CONF and FREESIDE_DOCUMENT_ROOT are set correctly in the Makefile, then run: |
<pre> | <pre> | ||
| − | + | make install-apache | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
</pre> | </pre> | ||
Latest revision as of 13:20, 26 June 2012
Contents
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
- Apache::Session
- HTML::TreeBuilder
- HTML-Format (CPAN: "install HTML::FormatText")
- Test::Inline
- Class::ReturnValue
- DBIx::SearchBuilder
- Log::Dispatch
- Locale::Maketext::Lexicon
- Locale::Maketext::Fuzzy
- Text::Wrapper
- Time-modules (CPAN: "install Time::ParseDate")
- Term::ReadKey
- Text::Autoformat
- Text::Quoted
- Regexp::Common
- HTML::Scrubber
- Tree::Simple
- Crypt::SSLeay
- GD::Graph
- UNIVERSAL::require
- XML::RSS
- Calendar::Simple
- GD::Graph
- GD::Text
- CSS::Squish
- HTML::ElementTable
Missing prerequisites? Please add them.
Installation
- Create a new Unix group called 'rt'
addgroup rt
- 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.
cd freeside-X.X/ nano Makefile
-
$ 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
- Edit
- Authentication errors?
-
make install-rt
- Configure Apache: make sure APACHE_CONF and FREESIDE_DOCUMENT_ROOT are set correctly in the Makefile, then run:
make install-apache
- 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. 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 regular RT documentation to configure RT, setup the mailgate, etc.
