4.4. Mac OS X Installation Notes

4.4.1. Sendmail

In Mac OS X 10.3 and later, Postfix is used as the built-in email server. Postfix provides an executable that mimics sendmail enough to fool Bugzilla, as long as Bugzilla can find it.

The substitute Sendmail executable is located at /usr/sbin/sendmail, while Bugzilla expects the executable to be located at /usr/lib/sendmail. Rather than copying the sendmail executable, a symbolic link can be used. To create the symbolic link, launch the Terminal application and execute the following command:

[localhost:~] sudo ln -s /usr/sbin/sendmail
/usr/lib/sendmail (1)
Enter Password: ********
You must be logged in as administrator to run this command. Enter your password if prompted.

The other change to be made involves turning on the sendmailnow Bugzilla parameter, which is described in Section 5.1.

4.4.2. Libraries & Perl Modules on Mac OS X

There are a lot of common libraries and utilities out there that Apple did not include with Mac OS X, but which run perfectly well on it. The GD library, which Bugzilla needs to do bug graphs, is one of these.

The easiest way to get a lot of these is with a program called Fink, which is similar in nature to the CPAN installer, but installs common GNU utilities. Fink is available from <https://sourceforge.net/projects/fink/>.

Follow the instructions for setting up Fink. Once it's installed, you'll want to run the following as root: fink install gd

It will prompt you for a number of dependencies, type 'y' and hit enter to install all of the dependencies. Then watch it work.

To prevent creating conflicts with the software that Apple installs by default, Fink creates its own directory tree at /sw where it installs most of the software that it installs. This means your libraries and headers for libgd will be at /sw/lib and /sw/include instead of /usr/lib and /usr/local/include. Because of these changed locations for the libraries, the Perl GD module will not install directly via CPAN, because it looks for the specific paths instead of getting them from your environment. But there's a way around that :-)

Instead of typing "install GD" at the cpan> prompt, type look GD. This should go through the motions of downloading the latest version of the GD module, then it will open a shell and drop you into the build directory. Apply this patch to the Makefile.PL file (save the patch into a file and use the command patch < patchfile.)

Then, run these commands to finish the installation of the GD module:

perl Makefile.PL
make test
make install
And don't forget to run exit to get back to CPAN.