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.


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

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 extract and run ./configure, make sudo make install

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





manually install Data::ICal, via

download from

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

  • repeat install instructions as per above

get DBD-mysql from

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.



sudo make install

edit /opt/rt3/etc/

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/

after fastcgi line


LoadModule fastcgi_module libexec/apache2/ LoadModule perl_module libexec/apache2/

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

to match

TURN on Web-Sharing and visit (just examples) 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/ for server, exiting All you have to do is run apache in 32 bit .

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


and add the following lines above it


Important note: Please, make sure to read thoroughly. You have to pay attention to the sections on "" vs. "" and configure Apache accordingly.

(The default, initial web login for RT is:

root / password

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