summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorjocuri%softhome.net <>2008-04-04 13:47:06 +0200
committerjocuri%softhome.net <>2008-04-04 13:47:06 +0200
commit450bdaf16c87131f1d34add4579aaf3b2ee7f7c7 (patch)
treede8e59dbfdb6cded7b715a383f2afa2dba5a6d4d
parent76d740a9545c19a424f395acd5788d8da941ed68 (diff)
downloadbugzilla-450bdaf16c87131f1d34add4579aaf3b2ee7f7c7.tar.gz
bugzilla-450bdaf16c87131f1d34add4579aaf3b2ee7f7c7.tar.xz
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.
-rw-r--r--docs/en/xml/installation.xml27
1 files changed, 26 insertions, 1 deletions
diff --git a/docs/en/xml/installation.xml b/docs/en/xml/installation.xml
index 397dc359e..097b21e0b 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>
@@ -76,6 +76,10 @@
</para>
</step>
<step>
+ <para><link linkend="install-MTA">Install a Mail Transfer Agent</link>
+ </para>
+ </step>
+ <step>
<para>Configure all of the above.
</para>
</step>
@@ -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>