From e533434c36adb9531f1642815b4340e8df90cbe2 Mon Sep 17 00:00:00 2001 From: "karl%kornel.name" <> Date: Sat, 12 Nov 2005 08:12:05 +0000 Subject: Bug 313469: Various small docs bugs found doing a clean install - Patch by A. Karl Kornel + + + maildeliverymethod + + + + This is used to specify how email is sent, or if it is sent at + all. There are several options included for different MTAs, + along with two additional options that disable email sending. + "testfile" does not send mail, but instead saves it in + data/mailer.testfile for later review. + "none" disables email sending entirely. + + + + shadowdb diff --git a/docs/xml/installation.xml b/docs/xml/installation.xml index 863fbb11f..ad46cabfc 100644 --- a/docs/xml/installation.xml +++ b/docs/xml/installation.xml @@ -1,5 +1,5 @@ - + Installing Bugzilla @@ -211,9 +211,7 @@ The first thing it checks is whether you have appropriate versions of all the required Perl modules. The aim of this section is to pass this check. - When it passes, - do not run it again, - but proceed to . + When it passes, proceed to . @@ -533,29 +531,58 @@
Mail Transfer Agent (MTA) - Bugzilla is dependent on the availability of an e-mail system for its user - authentication and for other tasks. + + Bugzilla is dependent on the availability of an e-mail system for its + user authentication and for other tasks. + + + + + This is not entirely true. It is possible to completely disable + email sending, or to have Bugzilla store email messages in a + file instead of sending them. However, this is mainly intended + for testing, as disabling or diverting email on a production + machine would mean that users could miss important events (such + as bug changes or the creation of new accouts). + + + + For more information, see the "maildeliverymethod" parameter in + . + + - 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. + + 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 Bugzilla will not + distinguish between them. + If you are using Sendmail, version 8.7 or higher is required. - If you are using a Sendmail-compatible MTA, it must be congruent with at least version 8.7 of Sendmail. + If you are using a Sendmail-compatible MTA, it must be congruent with + at least version 8.7 of Sendmail. - 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. + + 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. + + + + If a simple mail sent with the command-line 'mail' program + succeeds, then Bugzilla should also be fine. + - If a simple mail sent with the command-line 'mail' program succeeds, then - Bugzilla should also be fine.
+ @@ -594,6 +621,18 @@ password (for simplicity, it should not contain single quote characters) and put it here. + + + You may need to change the value of + webservergroup if your web server does not + run in the "apache" group. On Debian, for example, Apache runs in + the "www-data" group. If you are going to run Bugzilla on a + machine where you do not have root access (such as on a shared web + hosting account), you will need to leave + webservergroup empty, ignoring the warnings + that checksetup.pl will subsequently display + every time it in run. + The other options in the localconfig file @@ -1077,69 +1116,6 @@ c:\perl\bin\perl.exe -xc:\bugzilla -wT "%s" %s -
- AOL Server - - Ben FrantzDale reported success using AOL Server with Bugzilla. He - reported his experience and what appears below is based on that. - - - AOL Server will have to be configured to run - CGI scripts, please consult - the documentation that came with your server for more information on - how to do this. - - - Because AOL Server doesn't support .htaccess - files, you'll have to create a TCL - script. You should create an aolserver/modules/tcl/filter.tcl - file (the filename shouldn't matter) with the following contents (change - /bugzilla/ to the web-based path to - your Bugzilla installation): - - - - ns_register_filter preauth GET /bugzilla/localconfig filter_deny - ns_register_filter preauth GET /bugzilla/localconfig~ filter_deny - ns_register_filter preauth GET /bugzilla/\#localconfig\# filter_deny - ns_register_filter preauth GET /bugzilla/*.pl filter_deny - ns_register_filter preauth GET /bugzilla/syncshadowdb filter_deny - ns_register_filter preauth GET /bugzilla/data/* filter_deny - ns_register_filter preauth GET /bugzilla/template/* filter_deny - - proc filter_deny { why } { - ns_log Notice "filter_deny" - return "filter_return" - } - - - - This probably doesn't account for all possible editor backup - files so you may wish to add some additional variations of - localconfig. For more information, see - - bug 186383 or Bugtraq ID 6501. - - - - - If you are using webdot from research.att.com (the default - configuration for the paramater), you - will need to allow access to data/webdot/*.dot - for the reasearch.att.com machine. - - If you are using a local installation of GraphViz, you will need to allow - everybody to access *.png, - *.gif, *.jpg, and - *.map in the - data/webdot directory. - - -
- -
@@ -1152,6 +1128,14 @@ c:\perl\bin\perl.exe -xc:\bugzilla -wT "%s" %s front page. If not, consult the Troubleshooting section, . + + + + The URL above may be incorrect if you installed Bugzilla into a + subdirectory or used a symbolic link from your web site root to + the Bugzilla directory. + + Log in with the administrator account you defined in the last -- cgit v1.2.3-24-g4f1b