Installation of RT-3.8.4 on Mac OS X 10.6 Client Edit

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 Edit

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 Edit

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

MySQL install Edit

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 Edit

run sudo perl -MCPAN -e shell and configure appropriately

Download RT and take some initial steps Edit

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 Edit

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) Edit

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 Edit

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

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

<string>/usr/sbin/httpd</string>

and add the following lines above it

	<string>/usr/bin/arch</string>
	<string>-i386</string>

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 !)