From: jocuri%softhome.net <> Date: Tue, 28 Feb 2006 18:22:55 +0000 (+0000) Subject: Documentation patch for bug 213262: add instructions on how to get sendmail to work... X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=008b6331d0644e6337033844e91f6ea50886da18;p=thirdparty%2Fbugzilla.git Documentation patch for bug 213262: add instructions on how to get sendmail to work with Bugzilla on Mac OS X; patch by A. Karl Kornel , r=colin.ogilvie, r=justdave. --- diff --git a/docs/xml/administration.xml b/docs/xml/administration.xml index ea5ef0c7d5..1095e307c2 100644 --- a/docs/xml/administration.xml +++ b/docs/xml/administration.xml @@ -300,6 +300,23 @@ + + + + sendmailnow + + + + When Bugzilla is using Sendmail older than 8.12, turning this option + off will improve performance by not waiting for Sendmail to actually + send mail. If Sendmail 8.12 or later is being used, there is + nothing to gain by turning this off. If another MTA is being used, + such as Postfix, then this option *must* be turned on (even if you + are using the fake sendmail executable that Postfix provides). + + + + diff --git a/docs/xml/installation.xml b/docs/xml/installation.xml index e17f4105b0..7d97f90e14 100644 --- a/docs/xml/installation.xml +++ b/docs/xml/installation.xml @@ -1906,74 +1906,111 @@ binmode(STDOUT);
Mac OS X Installation Notes + +
+ 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: - 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. + +[localhost:~] sudo ln -s /usr/sbin/sendmail +/usr/lib/sendmail +Enter Password: ******** + + + + You must be logged in as administrator to run this + command. Enter your password if prompted. + + - 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 - <http://sourceforge.net/projects/fink/>. + The other change to be made involves turning on the sendmailnow + Bugzilla parameter, which is described in . + + +
+ +
+ 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 + <http://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 + - Follow the instructions for setting up Fink. Once it's installed, - you'll want to run the following as root: - fink install gd - + + make + - 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 - - - - make test - - - - make install - - - And don't forget to run - exit - - to get back to CPAN. - - + + make test + + + make install + + + And don't forget to run + exit + + to get back to CPAN. + + +