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

From Freeside
Jump to: navigation, search
(Fleshed out Bootstrap RT's permissions, based on a 3.x install)
 
(4 intermediate revisions by the same user not shown)
Line 54: Line 54:
 
* <pre><nowiki># make create-rt</nowiki></pre>
 
* <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>" (Debian 7.x has a METHOD column that is set to <code>peer</code>, this needs to be set to <code>trust</code>)''
+
*** ''Edit <code>pg_hba.conf</code>, change "<code>peer</code>" auth to "<code>trust</code>" for the line starting with "<code>local all all</code>"''
 
*** ''Restart Pg''
 
*** ''Restart Pg''
 
*** ''Revert the change back and restart Pg after this installation step''
 
*** ''Revert the change back and restart Pg after this installation step''
Line 65: Line 65:
 
* Restart Apache (httpd) and log into the Freeside web interface using the username and password you created during the first part of the installation.
 
* 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
 +
* Bootstrap your RT Login, replace ivan with your freeside employee account
 +
 
 +
<pre>
 +
sudo su freeside -c psql
  
−
=== Bootstrap RT's permissions ===
+
insert into acl ( principaltype, principalid, rightname, objecttype, objectid )
−
*Click on "Ticketing Main" on the Freeside main menu to auto-create an RT login for your username
+
        values ( 'Group',
−
*From "Billing Main", go to Configuration > Employees > Employees, click on "Add an employee" and add a temporary SuperUser "root" user.  Note: the user name must be "root" (without the quotes).
+
                ( select id from groups where instance = ( select id from users where name = 'ivan' )
−
* Log into your Freeside installation as the "root" user you just created, by closing all of your browser windows, using a different browser, or by using <code><nowiki>https://root@yourmachone/freeside/</nowiki></code> syntax if your browser supports it.
+
                                          and domain = 'ACLEquivalence' and type = 'UserEquiv'        ),
−
* Click on "Ticketing Main" on the Freeside main menu.  Go to Configuration > Ticketing > Ticketing Global, and then "User Rights".  Enter your normal RT/Freeside login in the box labeled ADD USER, click on the "Rights for Administrators" tab, check the "Do anything and everything" box (SuperUser) and then click "Save Changes"
+
                  'SuperUser', 'RT::System', 1 );
−
* As your regular user, go back to the freeside employee list, click on the "root" user and set it to disabled
+
\q
 +
 
 +
</pre>
  
 
== Futher Reading ==
 
== Futher Reading ==
 
* Follow the [http://wiki.bestpractical.com/ regular RT documentation] to configure RT, setup the mailgate, etc.
 
* Follow the [http://wiki.bestpractical.com/ regular RT documentation] to configure RT, setup the mailgate, etc.
 +
* Set '''ticket_system-default_queueid''' once you have RT configured.

Latest revision as of 11:58, 11 April 2020

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

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 "peer" 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
  • 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.

Bootstrap RT's permissions

  • Click on "Ticketing Main" on the Freeside main menu to auto-create an RT login for your username
  • Bootstrap your RT Login, replace ivan with your freeside employee account
sudo su freeside -c psql

insert into acl ( principaltype, principalid, rightname, objecttype, objectid )
         values ( 'Group',
                 ( select id from groups where instance = ( select id from users where name = 'ivan' )
                                           and domain = 'ACLEquivalence' and type = 'UserEquiv'        ),
                  'SuperUser', 'RT::System', 1 );
\q

Futher Reading

  • Follow the regular RT documentation to configure RT, setup the mailgate, etc.
  • Set ticket_system-default_queueid once you have RT configured.
Retrieved from "http://freeside.biz/mediawiki/index.php?title=Freeside:3:Documentation:RT_Installation&oldid=9803"