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 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
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.
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.
/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
to the list of modules.