DebianSqueezeInstallGuide - Revision history

Admin: 21 revisions imported

2016-04-06T20:08:47Z

21 revisions imported

New page

{{UnofficialInstallGuide}}
The following guide describes the basic steps on how to install Request Tracker 4 (RT4) on Debian 6 (Squeeze).

This guide shows how to install RT4 using apt, this is done by using the squeeze-backports source in combination with the stable tree.

Or one can use the puppet-rt module to do this work. [https://forge.puppetlabs.com/darin/rt puppetforge] | [https://github.com/deadpoint/puppet-rt github_project] | [https://github.com/hesco/puppet-rt pull_request_supporting_debian]. The Debian pull request linked here was written based on the recipe below, and as of this writing provides RT 4.0.19 (while [http://www.bestpractical.com/ BestPractical.com] is currently offering version 4.2.7 in its [http://download.bestpractical.com/pub/rt/release/rt.tar.gz latest source installation]). I only a moment ago completed my first successful test of this procedure, but over the next day or so, intend to extend the day's work to provide me a working installation and home for my migrated RT 3.8.2 legacy installation. [[#puppet-rt|puppet-rt]] on the use of the puppet-rt module are included below.

== Requirements ==
To begin, make sure that you have a base system installed.

The actual installation of the Debian OS is something that I'll leave to your imagination. I have my own preferences but someone else will have their own.

So, in general you just need a Debian Squeeze installation somewhere (desktop even, doesn't matter much for this guide).

This instructions also work for Debian 7.0 Stable (Wheezy)

==Repositories==
The first thing, after having a working Debian Squeeze installation, is to setup the repositories. The stable repository only has RT 3.8, but ther'es a nifty Debian repository which will allow you to install the latest RT version.

This is the backports repository; you can find specific information about the backports repo on this page: http://backports-master.debian.org. It's officially supported by Debian, so it's a nice and clean way for installing RT 4.

And in Debian Squeeze, when you install something from the backports it will also update other packages from the backports repository.

Below are the steps of adding the repository to your sources.lst:
(login as root, or use sudo with the below commands)

# nano -w /etc/apt/sources.list
...
# Squeeze Backports (add at the bottom)
deb http://backports.debian.org/debian-backports squeeze-backports main
Now update your repositories:
# aptitude update
That's all for the repositories, the next step is using the backports to install RT 4.

==Install RT 4==
Since we already have the repositories setup you can install RT 4 with the following commands.
===First pick a database===
To begin, make sure you install one of the three database choices. The first package installs the actual database, the second installs the client dependencies for RT.

PostgreSQL
aptitude install postgresql rt4-db-postgresql
MySQL
aptitude install mysql-server rt4-db-mysql
Sqlite
aptitude install sqlite rt4-db-sqlite
This will install both the client and server modules needed for the database.

After installation make sure that your database is running:
# service postgresql [status|start|stop|restart]
# service mysql [status|start|stop|restart]
This part is important for the next steps, the DB server needs to be up and running.

===Secondly, install RT4===
And now install RT 4 itself, at the moment of this writing this means that you'll be installing RT 4.0.4.
aptitude install rt4-apache2
aptitude install request-tracker4
During the installation you'll be asked a bunch of questions, follow the steps and you'll be ok :-) This will create the RT database, configure the DB + the basics for RT.

The last step is to setup apache2 for RT, there are sample configuration files located under /etc/request-tracker4/.

Pick your config and configure it under /etc/apache2/sites-available, from there make a symlink from that file to /etc/apach2/sites-enabled.

open apache2 configuration file.

vi /etc/apache2/sites-available/default

At the end of this file :

Include /etc/request-tracker4/apache2-modperl2.conf
RedirectMatch ^/$ /rt
</VirtualHost>

Then restart apache (service apache2 restart) and see if RT is up and running.

And voila, you've now installed RT 4 on Debian Squeeze using apt :-)

* It might happen that aptitude complains about some perl dependencies being outdated. You can update those specific packets using the following command (these are the ones that were complaining on my end):
aptitude -t squeeze-backports install libdbix-searchbuilder-perl liblog-dispatch-perl libhtml-rewriteattributes-perl libplack-perl -y
This forces aptitude to update those packets using the backports repository.

Or just install the package 'request-tracker4' via synaptic and everything will be smooth sailing.

== [[#puppet-rt|puppet-rt]] ==
Today I adapted the recipe in the above article (by another author) to extend the Suse supporting puppet-rt module to provide for an RT installation on a Debian server. Its use has been tested on an Ubuntu 14.04 LTS installation. /etc/debian_version reports: 'jessie/sid'. Presumably (and I say this without having tested this), this module should work on any Debian 6 or 7 installation as well as Ubuntu 10, 12 or 14.

As I write this, I have already pushed my changes to [https://github.com/hesco/puppet-rt my fork on github]. Over the next day or so, I expect to wrap up work on this project and submit a pull request to the [https://github.com/deadpoint/puppet-rt upstream project]. If accepted, presumably a future version will get pushed to the [https://forge.puppetlabs.com/darin/rt puppet forge] where you can install the requisite module on which this recipe is dependent as follows:
puppet module install -i /etc/puppet/modules darin-rt
If you are not patient enough for that, feel free to clone my github repo for this project (linked in the preceding paragraph). A base installation has already passed trivial tests on a docker container in my environment, though I have not tried yet to use this module to install any of the external plugins, nor to configure any queues (which is outside of the requirements of my current migration; I expect those to be imported when I attach and upgrade my legacy database). I did update the rt::params module to reflect the package names available in the backports repository for external plugins. But I have not tested their use yet.

Once you have installed the puppet forge RT module, in your own puppet manifest, you want to add something like the following in a file called /etc/puppet/environments/<environment_name>/modules/my_rt/manifests/init.pp:
class my_rt { class { "rt": dbtype => "postgres", apt_backports => true } }
And then you only need to add this to the manifest which builds your target node:
include my_rt
and run this on that node:
puppet agent -t
or simply wait for the next catalog compilation (which happens at thirty minute intervals by default if the puppet agent has been daemonized).

For my purposes, I have been testing this with postgresql. The backports repository includes packages which will presumably support mysql and sqlite3 as well. The code in the original puppet forge module which I have extended suggests that oracle is also supported under suse. For my purposes I am only testing the postgresql path.

Feel free to report issues if you encounter them, or better yet to fork the code ([https://github.com/hesco/puppet-rt/fork here] if my own pull request is not accepted, or [https://github.com/deadpoint/puppet-rt/fork here] if it is) and submit a pull request of your own, preferably with tests and documentation patches.
==Configuring RT 4==
In general your installation should be done, but you probably want to know the location of your configuration files under Debian. Below a list of the locations that I know of:
*/etc/request-tracker4
*/usr/share/request-tracker4
The first contains the basic configuration files, like RT_SiteConfig.pm. The latter contains the actual application.

Also be sure to configure [[EmailInterface#RT.27s_mail_gate|Mailgate]] if you plan to be able to submit tickets via email.
[[Category:Installation]]
[[Category:UnofficialInstallGuide]]

99.71.128.147: /* Secondly, install RT4 */

2013-07-25T00:21:25Z

Secondly, install RT4

← Older revision		Revision as of 20:21, 24 July 2013
Line 67:		Line 67:
	</VirtualHost>		</VirtualHost>

	Then restart apache (service apache2 restart) and see of RT is up and running.		Then restart apache (service apache2 restart) and see if RT is up and running.

	And voila, you've now installed RT 4 on Debian Squeeze using apt :-)		And voila, you've now installed RT 4 on Debian Squeeze using apt :-)

105.163.137.254: /* Requirements */

2013-06-14T21:18:00Z

Requirements

← Older revision		Revision as of 17:18, 14 June 2013
Line 8:		Line 8:

	So, in general you just need a Debian Squeeze installation somewhere (desktop even, doesn't matter much for this guide).		So, in general you just need a Debian Squeeze installation somewhere (desktop even, doesn't matter much for this guide).

			This instructions also work for Debian 7.0 Stable (Wheezy)

	==Repositories==		==Repositories==

66.207.201.186: typo

2012-09-04T16:55:18Z

typo

← Older revision		Revision as of 12:55, 4 September 2012
Line 71:		Line 71:
	* It might happen that aptitude complains about some perl dependencies being outdated. You can update those specific packets using the following command (these are the ones that were complaining on my end):		* It might happen that aptitude complains about some perl dependencies being outdated. You can update those specific packets using the following command (these are the ones that were complaining on my end):
	aptitude -t squeeze-backports install libdbix-searchbuilder-perl liblog-dispatch-perl libhtml-rewriteattributes-perl libplack-perl -y		aptitude -t squeeze-backports install libdbix-searchbuilder-perl liblog-dispatch-perl libhtml-rewriteattributes-perl libplack-perl -y
	This forces aptitude to update those packets using the ~~backporst~~ repository.		This forces aptitude to update those packets using the backports repository.

	Or just install the package 'request-tracker4' via synaptic and everything will be smooth sailing.		Or just install the package 'request-tracker4' via synaptic and everything will be smooth sailing.

192.33.96.71: /* Requirements */

2012-07-10T05:38:02Z

Requirements

← Older revision		Revision as of 01:38, 10 July 2012
Line 5:		Line 5:
	To begin, make sure that you have a base system installed.		To begin, make sure that you have a base system installed.

	The actual installation of de Debian OS is something that I'll leave to your imagination. I have my own preferences but someone else will have their own.		The actual installation of the Debian OS is something that I'll leave to your imagination. I have my own preferences but someone else will have their own.

	So, in general you just need a Debian Squeeze installation somewhere (desktop even, ~~deosn~~'t matter much for this guide).		So, in general you just need a Debian Squeeze installation somewhere (desktop even, doesn't matter much for this guide).

	==Repositories==		==Repositories==

192.33.96.71: /* First pick a database */

2012-07-02T14:26:26Z

First pick a database

← Older revision		Revision as of 10:26, 2 July 2012
Line 30:		Line 30:
	Since we already have the repositories setup you can install RT 4 with the following commands.		Since we already have the repositories setup you can install RT 4 with the following commands.
	===First pick a database===		===First pick a database===
	To begin, make sure you install one of the three database choices. The first package installs the actual database, the second installs the client ~~dependensies~~ for RT.		To begin, make sure you install one of the three database choices. The first package installs the actual database, the second installs the client dependencies for RT.

	PostgreSQL		PostgreSQL
Line 44:		Line 44:
	# service mysql [status\|start\|stop\|restart]		# service mysql [status\|start\|stop\|restart]
	This part is important for the next steps, the DB server needs to be up and running.		This part is important for the next steps, the DB server needs to be up and running.

	===Secondly, install RT4===		===Secondly, install RT4===
	And now install RT 4 itself, at the moment of this writing this means that you'll be installing RT 4.0.4.		And now install RT 4 itself, at the moment of this writing this means that you'll be installing RT 4.0.4.

93.196.202.155: /* Secondly, install RT4 */

2012-06-19T08:43:56Z

Secondly, install RT4

← Older revision		Revision as of 04:43, 19 June 2012
Line 56:		Line 56:
	open apache2 configuration file.		open apache2 configuration file.

	~~vim~~ /etc/apache2/sites-available/default		vi /etc/apache2/sites-available/default

	At the end of this file :		At the end of this file :

24.2.99.188 at 05:45, 27 May 2012

2012-05-27T05:45:19Z

← Older revision		Revision as of 01:45, 27 May 2012
Line 63:		Line 63:
	RedirectMatch ^/$ /rt		RedirectMatch ^/$ /rt
	</VirtualHost>		</VirtualHost>



	Then restart apache (service apache2 restart) and see of RT is up and running.		Then restart apache (service apache2 restart) and see of RT is up and running.
Line 73:		Line 71:
	aptitude -t squeeze-backports install libdbix-searchbuilder-perl liblog-dispatch-perl libhtml-rewriteattributes-perl libplack-perl -y		aptitude -t squeeze-backports install libdbix-searchbuilder-perl liblog-dispatch-perl libhtml-rewriteattributes-perl libplack-perl -y
	This forces aptitude to update those packets using the backporst repository.		This forces aptitude to update those packets using the backporst repository.



	Or just install the package 'request-tracker4' via synaptic and everything will be smooth sailing.		Or just install the package 'request-tracker4' via synaptic and everything will be smooth sailing.
Line 84:		Line 80:
	The first contains the basic configuration files, like RT_SiteConfig.pm. The latter contains the actual application.		The first contains the basic configuration files, like RT_SiteConfig.pm. The latter contains the actual application.

	~~Hope this helps some of~~ you ~~:-) Enjoy~~.		Also be sure to configure [[EmailInterface#RT.27s_mail_gate\|Mailgate]] if you plan to be able to submit tickets via email.
	[[Category:Installation]]		[[Category:Installation]]

24.2.99.188: Adding categories

2012-05-27T05:15:07Z

Adding categories

← Older revision		Revision as of 01:15, 27 May 2012
Line 85:		Line 85:

	Hope this helps some of you :-) Enjoy.		Hope this helps some of you :-) Enjoy.
			[[Category:Installation]]

49.145.118.11: /* Install RT 4 */

2012-05-11T11:25:37Z

Install RT 4

← Older revision		Revision as of 07:25, 11 May 2012
Line 73:		Line 73:
	aptitude -t squeeze-backports install libdbix-searchbuilder-perl liblog-dispatch-perl libhtml-rewriteattributes-perl libplack-perl -y		aptitude -t squeeze-backports install libdbix-searchbuilder-perl liblog-dispatch-perl libhtml-rewriteattributes-perl libplack-perl -y
	This forces aptitude to update those packets using the backporst repository.		This forces aptitude to update those packets using the backporst repository.



			Or just install the package 'request-tracker4' via synaptic and everything will be smooth sailing.

	==Configuring RT 4==		==Configuring RT 4==