MacOSXServerLeopard
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 .tar.gz packages.
| This page 'MacOSXServerLeopard' is tagged as OUTDATED |
| 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. |
| If you have checked or updated this page and found the content to be suitable, please remove this notice by editing the page and remove the Outdated template tag. |
Installation on Mac OS X 10.5 Server
These instructions might not be accurate, as I'm writing from memory.
Please update if you find any errors.
Install Developer Tools
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
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
sudo cpan ... exit
Update CPAN to the latest version
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
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
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
sudo make install
Edit /opt/rt3/etc/RT_SiteConfig.pm to suit your needs
sudo make initialize-database
Configure MySQL
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
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!