====== Sitemap ====== This is a sitemap over all available pages ordered by [[doku>namespaces|namespaces]].
Page Actions
Wiki Actions
User Actions
====== Differences ====== This shows you the differences between two versions of the page.
|
guides:rt3.8 [2009/03/16 15:40] fishy |
guides:rt3.8 [2009/03/16 16:02] (current) fishy |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | http://wiki.bestpractical.com/view/DebianLennyInstallGuide | + | ====== How I installed Request Tracker 3.8.2 on Debian Lenny ====== |
| + | |||
| + | My first hints and pointers were from the poorly formatted guide at: | ||
| + | |||
| + | * http://wiki.bestpractical.com/view/DebianLennyInstallGuide | ||
| + | |||
| + | ===== Basic prerequisites ===== | ||
| Install "providing" software. By this, I mean software that is needed to compile software, serve data to the web, test the data served, and communicate with the world. | Install "providing" software. By this, I mean software that is needed to compile software, serve data to the web, test the data served, and communicate with the world. | ||
| + | |||
| <code> | <code> | ||
| apt-get install build-essential bzip2 \ | apt-get install build-essential bzip2 \ | ||
| Line 24: | Line 31: | ||
| sudo apt-get install postfix | sudo apt-get install postfix | ||
| </code> | </code> | ||
| + | |||
| + | |||
| + | ===== Perl prerequisites... ===== | ||
| Next up is a shockingly long list of development- and perl-dependencies. The commands below are split into chunks that the BASH shell will accept, but the order, and eventual dependency satification is not taken into consideration. I.e. the list is for completeness. | Next up is a shockingly long list of development- and perl-dependencies. The commands below are split into chunks that the BASH shell will accept, but the order, and eventual dependency satification is not taken into consideration. I.e. the list is for completeness. | ||
| + | |||
| Your mileage may vary on what you actually need to install. | Your mileage may vary on what you actually need to install. | ||
| + | |||
| + | ==== OS packaged perl-dependencies ==== | ||
| <code> | <code> | ||
| Line 59: | Line 72: | ||
| libxml-namespacesupport-perl | libxml-namespacesupport-perl | ||
| </code> | </code> | ||
| + | |||
| + | ==== CPAN setup ==== | ||
| Now, prepare your Perl CPAN setup, as Request Tracker installation __will__ use CPAN to pull in even more dependencies! | Now, prepare your Perl CPAN setup, as Request Tracker installation __will__ use CPAN to pull in even more dependencies! | ||
| Line 64: | Line 79: | ||
| [[guides:rt3.8:CPAN]] | [[guides:rt3.8:CPAN]] | ||
| + | ===== Download & unpack Request Tracker ===== | ||
| Line 73: | Line 89: | ||
| cd rt-3.* | cd rt-3.* | ||
| </code> | </code> | ||
| + | |||
| + | ===== Setting up the source tree ===== | ||
| + | |||
| + | The following code sets up my RT install to dump the instance files into the dir /opt/rt/defcon, and | ||
| + | use MySQL for storage | ||
| <code> | <code> | ||
| Line 116: | Line 137: | ||
| All dependencies have been found. | All dependencies have been found. | ||
| </code> | </code> | ||
| + | |||
| + | ===== Installation ===== | ||
| Time to do the actual installation: | Time to do the actual installation: | ||
| Line 122: | Line 145: | ||
| ... | ... | ||
| + | </code> | ||
| - | You must now configure RT by editing /opt/rt/defcon/etc/RT_SiteConfig.pm. | + | ===== Configuration of RT ===== |
| + | |||
| + | You must now configure RT by editing /opt/rt/defcon/etc/RT_SiteConfig.pm. | ||
| + | |||
| + | WARNING: Never, EVER, change RT_Config.pm. All your changes need to be put in | ||
| + | RT_SiteConfig.pm. | ||
| (You will definitely need to set RT's database password in | (You will definitely need to set RT's database password in | ||
| Line 130: | Line 159: | ||
| database user or set up a database for RT. These actions will be | database user or set up a database for RT. These actions will be | ||
| taken care of in the next step.) | taken care of in the next step.) | ||
| - | |||
| - | After that, you need to initialize RT's database by running | ||
| - | 'make initialize-database' | ||
| - | </code> | ||
| So, the natural next step is to open $PREFIX/etc/RT_SiteConfig.pm in your favourite text-editor, and decide on the basic setting of this instance... | So, the natural next step is to open $PREFIX/etc/RT_SiteConfig.pm in your favourite text-editor, and decide on the basic setting of this instance... | ||
| Line 140: | Line 165: | ||
| # What RT instance? | # What RT instance? | ||
| - | Set( $rtname, 'rt.example.com'); | + | Set($rtname, 'Ticket'); |
| - | Set($Organization , "example.com"); | + | Set($Organization , "defcon.no"); |
| + | |||
| + | # Default email adresses | ||
| + | Set($CorrespondAddress , 'rt@defcon.no'); | ||
| + | Set($CommentAddress , 'rt-comment@defcon.no'); | ||
| # How to handle time (timezone setting) | # How to handle time (timezone setting) | ||
| Line 156: | Line 185: | ||
| # Who is owner/admin of this instance? | # Who is owner/admin of this instance? | ||
| - | Set($OwnerEmail , 'rtowner@example.com'); | + | Set($OwnerEmail , 'rtowner@defcon.no'); |
| Set($LoopsToRTOwner , 1); | Set($LoopsToRTOwner , 1); | ||
| - | # Max allowed attachments, up from 10MB ti 20MB | + | # Max allowed attachments, up from 10MB to 20MB |
| Set($MaxAttachmentSize , 20000000); | Set($MaxAttachmentSize , 20000000); | ||
| Line 169: | Line 198: | ||
| </code> | </code> | ||
| + | |||
| + | ===== Initialize the RT database ===== | ||
| <code> | <code> | ||
| sudo make initialize-database | sudo make initialize-database | ||
| </code> | </code> | ||
| + | |||
| + | ===== Configure HTTPd ===== | ||
| + | |||
| + | I am using Apache2, and running RT through mod_perl. Note the PerlRequire, SetHandler and PerlResponseHandler. Without these, your RT will __not__ work. | ||
| <code> | <code> | ||
| Line 192: | Line 227: | ||
| </code> | </code> | ||
| + | |||
| + | As this is a Debian Lenny system, I used the Debian helper tools to enable all needed apache2 related configurations: | ||
| <code> | <code> | ||
| Line 199: | Line 236: | ||
| sudo /etc/init.d/apache2 reload | sudo /etc/init.d/apache2 reload | ||
| </code> | </code> | ||
| + | |||
| + | ===== First look at the installed RT ===== | ||
| Go to the address you have configured in Apache, DNS and RT_SiteConfig.pm, and you should be greeted with the login-box of RT3.8! | Go to the address you have configured in Apache, DNS and RT_SiteConfig.pm, and you should be greeted with the login-box of RT3.8! | ||
| Line 208: | Line 247: | ||
| * New passord | * New passord | ||
| * Retype passord | * Retype passord | ||
| + | |||
| + | ===== Post install setup ===== | ||
| That's not all, but it is all for now... | That's not all, but it is all for now... | ||
| + | ==== Overriding the footer ==== | ||
| <code> | <code> | ||
| Line 217: | Line 259: | ||
| web:/opt/rt/defcon# vim local/html/Elements/Footer | web:/opt/rt/defcon# vim local/html/Elements/Footer | ||
| </code> | </code> | ||
| + | |||
| + | ==== Setting up default permissions ==== | ||
| + | |||
| + | ==== Adding a few queues ==== | ||
| + | |||
| + | |||