Installation on Mac OS X 10.5 Server Edit

These instructions might not be accurate, as I'm writing from memory.

Please update if you find any errors.

Install Developer Tools Edit

Server doesn't have developer tools installed by default. You'll need that to update CPAN in the steps below; this requires `make`.

Get MySQL client libraries and headers Edit

Either build them yourself or copy them over from another system. You can also install the MySQL package from http://www.mysql.com, but make sure to use only the client libraries from it. Leopard Server comes with a sufficiently recent MySQL for RT.

Start and configure CPAN Edit

sudo cpan
...
exit

Update CPAN to the latest version Edit

sudo -s
export HOME=/private/var/root

This is done to avoid breaking some tests that check the user's home directory. sudo has the bad habit of not picking up the correct $HOME.

cpan
install Bundle::CPAN
...
reload cpan

Manually install required packages that break on OS X Edit

look DBD::mysql
perl Makefile.PL --mysql_config=/usr/local/mysql/bin/mysql_config
make
exit
force test DBD::mysql
install DBD::mysql
look HTML::Mason

edit Build.PL and comment the require Apache::Request line out

perl Build.PL
make
exit
force test HTML::Mason
install HTML::Mason

Get RT Edit

Download the latest tgz from bestpractical.com, unpack and switch to the rt-... directory.

./configure
make testdeps
make fixdeps

Wait a while, accept all dependencies.

make testdeps

If everything went fine, there should be no missing packages now. If there are, fix them with the cpan look method above and describe here what you did.

Install RT Edit

sudo make install

Edit /opt/rt3/etc/RT_SiteConfig.pm to suit your needs

sudo make initialize-database

Configure MySQL Edit

It's possible that RT will refuse to connect to MySQL via its socket (/var/mysql/mysql.sock). Enable TCP access to MySQL from Server Admin in that case, and make sure to disallow connections from outside or set up secure passwords for all MySQL grants.

Configure Apache Edit

Using the Apache configurator of Server Admin, create a new VHost for your RT.

Edit /etc/apache2/sites/<####_ip_port_vhostname>.conf and add the following:

 	PerlRequire "/opt/rt3/bin/webmux.pl"
 	<Location "/NoAuth/images">
 		SetHandler default
 	</Location>
 	<Location "/">
 		SetHandler perl-script
 		PerlResponseHandler RT::Mason
 	</Location>

Using Server Admin, enable mod_perl by adding

perl_module libexec/apache2/mod_perl.so

to the list of modules.

Restart Apache.

Done!