MacOSX SnowLeopard ClientInstallGuide
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 'MacOSX SnowLeopard ClientInstallGuide' 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 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
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/rtand have at it !
Running Apache in 32 Bit :
If you are stuck with the following errors in apache error_log , chances are that you are running apache in 64 bit .
Can't load '/Library/Perl/Updates/5.8.8/darwin-thread-multi-2level/auto/Encode/Encode.bundle' for module Encode: dlopen(/Library/Perl/Updates/5.8.8/darwin-thread-multi-2level/auto/Encode/Encode.bundle Can't load Perl file: /opt/rt3/bin/webmux.pl for server rt.example.com:0, exiting
All you have to do is run apache in 32 bit .
Open /System/Library/LaunchDaemons/org.apache.httpd.plist and find the line
<string>/usr/sbin/httpd</string>
and add the following lines above it
<string>/usr/bin/arch</string> <string>-i386</string>
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 !)