MacOSX_SnowLeopard_ClientInstallGuide

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::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/rt

and have at 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 !)

RT Wiki