From: jocuri%softhome.net <> Date: Tue, 28 Feb 2006 18:22:24 +0000 (+0000) Subject: Documentation patch for bug 213262: add instructions on how to get sendmail to work... X-Git-Tag: bugzilla-2.18.6~35 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=bb3fbf87006158bd6768aff8dd82165864b3c14a;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 b6019a12d2..81944aa876 100644 --- a/docs/xml/administration.xml +++ b/docs/xml/administration.xml @@ -294,6 +294,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 d3dbc4b42a..76953b7554 100644 --- a/docs/xml/installation.xml +++ b/docs/xml/installation.xml @@ -1,5 +1,5 @@ - + Installing Bugzilla @@ -1518,67 +1518,105 @@ $smtp->quit;
<productname>Mac OS X</productname> - Apple did not include the GD library with Mac OS X. Bugzilla - needs this for bug graphs. +
+ Sendmail - You can install it using a program called - Fink, which is similar in nature to the CPAN installer, but installs - common GNU utilities. Fink is available from - . + 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. - Follow the instructions for setting up Fink. Once it's installed, - you'll want to use it to install the gd2 package. - + 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: - It will prompt you for a number of dependencies, type 'y' and hit - enter to install all of the dependencies and then watch it work. You will - then be able to use CPAN to - install the GD Perl module. - + +[localhost:~] sudo ln -s /usr/sbin/sendmail /usr/lib/sendmail +Enter Password: ******** + + + + You must be logged in as an 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 . + - - 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 - will be at /sw/lib and - /sw/include instead of - /usr/lib and - /usr/include. When the - Perl module config script asks where your libgd - is, be sure to tell it - /sw/lib. +
+ +
+ Libraries & Perl Modules on Mac OS X + + Apple did not include the GD library with Mac OS X. Bugzilla + needs this for bug graphs. + + You can install it using a program called + Fink, which is similar in nature to the CPAN installer, but installs + common GNU utilities. Fink is available from + . + + Follow the instructions for setting up Fink. Once it's installed, + you'll want to use it to install the gd2 package. - - Also available via Fink is expat. After using - fink to install the expat package you will be able to install - XML::Parser using CPAN. There is one caveat. Unlike recent versions of - the GD module, XML::Parser doesn't prompt for the location of the - required libraries. When using CPAN, you will need to use the following - command sequence: - + It will prompt you for a number of dependencies, type 'y' and hit + enter to install all of the dependencies and then watch it work. You + wille then be able to use + CPAN to install the GD Perl + module. + - + + 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 + will be at /sw/lib and + /sw/include instead of + /usr/lib and + /usr/include. When the + Perl module config script asks where your libgd + is, be sure to tell it + /sw/lib. + + + + Also available via Fink is expat. After using + fink to install the expat package you will be able to install + XML::Parser using CPAN. There is one caveat. Unlike recent versions of + the GD module, XML::Parser doesn't prompt for the location of the + required libraries. When using CPAN, you will need to use the following + command sequence: + + + # perl -MCPAN -e'look XML::Parser' # perl Makefile.PL EXPATLIBPATH=/sw/lib EXPATINCPATH=/sw/include # make; make test; make install # exit - - - - The look command will download the module and spawn a - new shell with the extracted files as the current working directory. - The exit command will return you to your original shell. - - - - You should watch the output from these make commands, - especially make test as errors may prevent XML::Parser - from functioning correctly with Bugzilla. - - - + + + + The look command will download the module and spawn a + new shell with the extracted files as the current working directory. + The exit command will return you to your original shell. + + + + You should watch the output from these make commands, + especially make test as errors may prevent + XML::Parser from functioning correctly with Bugzilla. + + + +