MacOSX SnowLeopard ClientInstallGuide
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
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
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)
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)
manually install Data::ICal, via
tar xzvf Data-ICal-0.16.tar.gz
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 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.
sudo make install
i.e.: edit your rt. name ( $rtname )
Set($DatabasePassword , 'rt_pass');
sudo make initialize-database
LoadModule perl_module libexec/apache2/mod_perl.so
after fastcgi line
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
and add the following lines above it
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 !)