From: jocuri%softhome.net <>
Date: Fri, 4 Apr 2008 11:47:06 +0000 (+0000)
Subject: Patch for bug 251338: Installation section should mention that you need an MTA instal... 
X-Git-Tag: bugzilla-3.1.3~168
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=450bdaf16c87131f1d34add4579aaf3b2ee7f7c7;p=thirdparty%2Fbugzilla.git

Patch for bug 251338: Installation section should mention that you need an MTA installed; patch by Colin S. Ogilvie <colin.ogilvie@gmail.com>; r=vladd, a=justdave.
---

diff --git a/docs/en/xml/installation.xml b/docs/en/xml/installation.xml
index 397dc359e7..097b21e0bf 100644
--- a/docs/en/xml/installation.xml
+++ b/docs/en/xml/installation.xml
@@ -1,5 +1,5 @@
 <!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"> -->
-<!-- $Id: installation.xml,v 1.75 2008/04/04 06:47:05 justdave%bugzilla.org Exp $ -->
+<!-- $Id: installation.xml,v 1.76 2008/04/04 06:47:06 jocuri%softhome.net Exp $ -->
 <chapter id="installing-bugzilla">
   <title>Installing Bugzilla</title>
 
@@ -75,6 +75,10 @@
         <para><link linkend="install-perlmodules">Install Perl modules</link>
         </para>
       </step>
+      <step>
+        <para><link linkend="install-MTA">Install a Mail Transfer Agent</link>
+        </para>
+      </step>
       <step>
         <para>Configure all of the above.
         </para>
@@ -478,6 +482,27 @@
         </para>
       </section>
     </section>    
+    <section id="install-MTA">
+      <title>Mail Transfer Agent (MTA)</title>
+    
+      <para>Bugzilla is dependent on the availability of an e-mail system for its user
+      authentication and for other tasks. </para>
+    
+      <para>On Linux, any Sendmail-compatible MTA (Mail Transfer Agent) will suffice.
+      Sendmail, Postfix, qmail and Exim are examples of common MTAs. Sendmail is the 
+      original Unix MTA, but the others are easier to configure, and therefore many people
+      replace Sendmail with Postfix or Exim. They are drop-in replacements, so that Bugzilla
+      will not distinguish between them.</para>
+
+      <para>Consult the manual for the specific MTA you choose for detailed installation
+      instructions. Each of these programs will have their own configuration files where you must
+      configure certain parameters to ensure that the mail is delivered properly. They
+      are implemented as services, and you should ensure that the MTA is in the
+      auto-start list of services for the machine.</para>
+
+      <para>If a simple mail sent with the command-line 'mail' program succeeds, then
+      Bugzilla should also be fine.</para>
+    </section>  
   </section>