Admin: 3 revisions imported

2016-04-06T20:14:20Z

3 revisions imported

New page

{{OutdatedInstallGuide}}

== 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. <code>sudo</code> has the bad habit of not picking up the correct <code>$HOME</code>.

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 (<code>/var/mysql/mysql.sock</code>). 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 <code>/etc/apache2/sites/<####_ip_port_vhostname>.conf</code> 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!'''

MacOSXServerLeopard - Revision history

Admin: 3 revisions imported