MacOSX SnowLeopard ClientInstallGuide

From Request Tracker Wiki
Jump to navigation Jump to search


Unofficial Installation Guide

This is an unofficial installation guide. It may be outdated or apply only to very specific configurations and versions. The official and maintained installation steps for RT are in the README and UPGRADING documents included in the official .tar.gz packages.

Outdated

This page contains out of date and possibly misleading information or instructions such as installation methods or configuration examples that no longer apply. Please consider this warning when reading the page below.


Installation of RT-3.8.4 on Mac OS X 10.6 Client

This document is specific to installing RT under Mac OS X 10.6 client (ie: the Non-server product)

Create a system group for rt

sudo dscl . create /Groups/rt

sudo dscl . create /Groups/rt name rt

sudo dscl . create /Groups/rt passwd "*"

sudo dscl . create /Groups/rt gid 302

Optional install

Download and install GnuPG from http://sourceforge.net/projects/macgpg2/files/

MySQL install

Download and install mysql-5.1.37-osx10.5-x86_64 (If you have one of the earliest Intel Macs that is only 32-bit, get the 32-bit version)

Get mysql started, and at least setup the following:

$ mysql -u root -p <your_mysql_root_password_here>

setup access to the rt. db: > msyql GRANT ALL PRIVILEGES ON rt3.* TO 'rt_user'@'localhost' IDENTIFIED BY '<your_RT_MySQL_passwd>'

for DBD::MySQL, add access to the 'test' db:

mysql -u root -p <your_mysql_root_password_here> mysql> grant all privileges on test.* to 'test'@'localhost';

*MAKE SURE to remove the test db after DBD-MySQL is installed ! ie

> mysql drop database test;

Initial Perl Setup steps

run sudo perl -MCPAN -e shell and configure appropriately

Download RT and take some initial steps

Download and decompress rt-3.8.4.tar.gz ie, tar xzvf rt-3.8.4.tar.gz cd rt-3.8.4 ./configure make testdeps sudo make fixdeps Be sure to watch the progress, and when asked to follow all dependancies

and keep an eye on it: every once in a while it will ask about following dependencies

and just hit enter to answer "yes" (I didn't do the one or two "optional" installs)

Install libgd

Download libgd from http://www.libgd.org/Downloads extract and run ./configure, make sudo make install

Manually install the following (won't install via CPAN)

DBD::MySQL

GD

GD::Text

GD::Graph

manually install Data::ICal, via

download from http://search.cpan.org/~alexmv/Data-ICal-0.16/lib/Data/ICal.pm

tar xzvf Data-ICal-0.16.tar.gz

cd Data-ICAL-0.16

perl Makefile.PL

make (NB: it will ask you for your (admin) password at one point)

sudo make install

get GnuPG::Interface from

http://search.cpan.org/~jesse/GnuPG-Interface-0.36/lib/GnuPG/Interface.pm

  • repeat install instructions as per above

get DBD-mysql from http://search.cpan.org/dist/DBD-mysql/lib/DBD/mysql.pm

install as above

Finish up RT setup

From within your rt source folder (rt.-3.8.4) run make testdeps to ensure all is installed.

run:

./configure

sudo make install

edit /opt/rt3/etc/RT_SiteConfig.pm

i.e.: edit your rt. name ( $rtname )

Set($DatabasePassword , 'rt_pass');

sudo make initialize-database

Apache setup

edit /etc/apache2/httpd.conf

and add

LoadModule perl_module libexec/apache2/mod_perl.so

after fastcgi line

IE:

LoadModule fastcgi_module libexec/apache2/mod_fastcgi.so LoadModule perl_module libexec/apache2/mod_perl.so

edit /etc/apache2/extra/httpd-vhosts.conf

to match http://wiki.bestpractical.com/view/ManualApacheConfig

TURN on Web-Sharing and visit (just examples) http://rt.yourhostname.com OR http://www.yourfq.dn/rtand have at it !

Running Apache in 32 Bit :

If you are stuck with the following errors in apache error_log , chances are that you are running apache in 64 bit .

Can't load '/Library/Perl/Updates/5.8.8/darwin-thread-multi-2level/auto/Encode/Encode.bundle' for module Encode: dlopen(/Library/Perl/Updates/5.8.8/darwin-thread-multi-2level/auto/Encode/Encode.bundle

Can't load Perl file: /opt/rt3/bin/webmux.pl for server rt.example.com:0, exiting All you have to do is run apache in 32 bit .

Open /System/Library/LaunchDaemons/org.apache.httpd.plist and find the line

/usr/sbin/httpd

and add the following lines above it

   /usr/bin/arch
   -i386

Important note: Please, make sure to read http://wiki.bestpractical.com/view/ManualApacheConfig thoroughly. You have to pay attention to the sections on "rt.example.com/" vs. "www.example.com/rt" and configure Apache accordingly.

(The default, initial web login for RT is:

root / password

-- be sure to edit the default password here !)