diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/sgml/faq.sgml | 14 | ||||
| -rw-r--r-- | docs/sgml/glossary.sgml | 15 | ||||
| -rw-r--r-- | docs/sgml/installation.sgml | 24 | ||||
| -rw-r--r-- | docs/xml/faq.xml | 14 | ||||
| -rw-r--r-- | docs/xml/glossary.xml | 15 | ||||
| -rw-r--r-- | docs/xml/installation.xml | 24 |
6 files changed, 74 insertions, 32 deletions
diff --git a/docs/sgml/faq.sgml b/docs/sgml/faq.sgml index 27e714e1b..df80794cd 100644 --- a/docs/sgml/faq.sgml +++ b/docs/sgml/faq.sgml @@ -778,14 +778,16 @@ </question> <answer> <para> - If you are using an alternate Mail Transport Agent (MTA other than - sendmail), make sure the options given in the "processmail" and other - scripts for all - instances of "sendmail" are correct for your MTA. + If you are using an alternate <glossterm linkend="gloss-mta">MTA</glossterm>, + make sure the options given in <filename>Bugzilla/BugMail.pm</filename> + and any other place where <application>sendmail</application> is called from + are correct for your MTA. You should also ensure that the + <option>sendmailnow</option> param is set to <literal>on</literal>. </para> <para> - If you are using Sendmail, try enabling "sendmailnow" in editparams.cgi. - If you are using Postfix, you will also need to enable <quote>sendmailnow</quote>. + If you are using <application>sendmail</application>, try enabling + <option>sendmailnow</option> in <filename>editparams.cgi</filename>. + <!-- TODO provide more info about this, possibly a link to admin --> </para> </answer> </qandaentry> diff --git a/docs/sgml/glossary.sgml b/docs/sgml/glossary.sgml index f3be34466..191b3fb39 100644 --- a/docs/sgml/glossary.sgml +++ b/docs/sgml/glossary.sgml @@ -227,6 +227,21 @@ <glossdiv id="gloss-m"> <title>M</title> + <glossentry id="gloss-mta"> + <glossterm>Message Transport Agent</glossterm> + <acronym>MTA</acronym> + + <glossdef> + <para>A Message Transport Agent is used to control the flow of email + on a system. Many unix based systems use + <ulink url="http://www.sendmail.org">sendmail</ulink> which is what + Bugzilla expects to find by default at <filename>/usr/sbin/sendmail</filename>. + Many other MTA's will work, but they all require that the + <option>sendmailnow</option> param be set to <literal>on</literal>. + </para> + </glossdef> + </glossentry> + <glossentry> <glossterm>mysqld</glossterm> diff --git a/docs/sgml/installation.sgml b/docs/sgml/installation.sgml index b25a2bcab..f7607d2e3 100644 --- a/docs/sgml/installation.sgml +++ b/docs/sgml/installation.sgml @@ -597,7 +597,7 @@ <para> <programlisting> -perl -pi -e 's@#\!/usr/bonsaitools/bin/perl@#\!/usr/bin/perl@' *cgi *pl Bug.pm processmail syncshadowdb +perl -pi -e 's@#\!/usr/bonsaitools/bin/perl@#\!/usr/bin/perl@' *cgi *pl Bug.pm syncshadowdb </programlisting> Change <filename>/usr/bin/perl</filename> to match the location @@ -1424,19 +1424,14 @@ my $webservergid = '8' the <function>system</function> call. For example, you'll need to change: </para> -<!-- We'll need a different example when there's no more processmail --> <programlisting> -system("./processmail", $id, $exporter); +system("$webdotbase","-Tpng","-o","$pngfilename","$filename"); </programlisting> <para>with</para> <programlisting> -system("C:\\perl\\bin\\perl", "processmail", $id, $exporter); +system("C:\\perl\\bin\\perl", "$webdotbase","-Tpng","-o","$pngfilename","$filename"); </programlisting> - <para>Notice that the <computeroutput>./</computeroutput> is also - removed. - </para> - <tip> <para>The <command>grep</command> command is very helpful in finding these <function>system</function> calls, assuming you have the @@ -1444,6 +1439,16 @@ system("C:\\perl\\bin\\perl", "processmail", $id, $exporter); </para> </tip> + <note> + <para>It appears that the only <function>system</function> call + remaining in the Bugzilla codebase is in + <filename>showdependencygraph.cgi</filename>. Not changing this + file will only cause dependency graphs to not function if the + <option>webdotbase</option> paramater points to a local + installation of <ulink url="http://www.graphviz.org">GraphViz</ulink>. + </para> + </note> + </section> </section> @@ -1613,7 +1618,7 @@ AllowOverride Limit <para><filename>$BUGZILLA_HOME/.htaccess</filename> <programlisting><![CDATA[ # don't allow people to retrieve non-cgi executable files or our private data -<FilesMatch ^(.*\.pl|.*localconfig.*|processmail|runtests.sh)$> +<FilesMatch ^(.*\.pl|.*localconfig.*|runtests.sh)$> deny from all </FilesMatch> <FilesMatch ^(localconfig.js|localconfig.rdf)$> @@ -1721,7 +1726,6 @@ deny from all ns_register_filter preauth GET /bugzilla/localconfig filter_deny ns_register_filter preauth GET /bugzilla/*.pl filter_deny ns_register_filter preauth GET /bugzilla/localconfig filter_deny -ns_register_filter preauth GET /bugzilla/processmail filter_deny ns_register_filter preauth GET /bugzilla/syncshadowdb filter_deny ns_register_filter preauth GET /bugzilla/runtests.sh filter_deny diff --git a/docs/xml/faq.xml b/docs/xml/faq.xml index 27e714e1b..df80794cd 100644 --- a/docs/xml/faq.xml +++ b/docs/xml/faq.xml @@ -778,14 +778,16 @@ </question> <answer> <para> - If you are using an alternate Mail Transport Agent (MTA other than - sendmail), make sure the options given in the "processmail" and other - scripts for all - instances of "sendmail" are correct for your MTA. + If you are using an alternate <glossterm linkend="gloss-mta">MTA</glossterm>, + make sure the options given in <filename>Bugzilla/BugMail.pm</filename> + and any other place where <application>sendmail</application> is called from + are correct for your MTA. You should also ensure that the + <option>sendmailnow</option> param is set to <literal>on</literal>. </para> <para> - If you are using Sendmail, try enabling "sendmailnow" in editparams.cgi. - If you are using Postfix, you will also need to enable <quote>sendmailnow</quote>. + If you are using <application>sendmail</application>, try enabling + <option>sendmailnow</option> in <filename>editparams.cgi</filename>. + <!-- TODO provide more info about this, possibly a link to admin --> </para> </answer> </qandaentry> diff --git a/docs/xml/glossary.xml b/docs/xml/glossary.xml index f3be34466..191b3fb39 100644 --- a/docs/xml/glossary.xml +++ b/docs/xml/glossary.xml @@ -227,6 +227,21 @@ <glossdiv id="gloss-m"> <title>M</title> + <glossentry id="gloss-mta"> + <glossterm>Message Transport Agent</glossterm> + <acronym>MTA</acronym> + + <glossdef> + <para>A Message Transport Agent is used to control the flow of email + on a system. Many unix based systems use + <ulink url="http://www.sendmail.org">sendmail</ulink> which is what + Bugzilla expects to find by default at <filename>/usr/sbin/sendmail</filename>. + Many other MTA's will work, but they all require that the + <option>sendmailnow</option> param be set to <literal>on</literal>. + </para> + </glossdef> + </glossentry> + <glossentry> <glossterm>mysqld</glossterm> diff --git a/docs/xml/installation.xml b/docs/xml/installation.xml index b25a2bcab..f7607d2e3 100644 --- a/docs/xml/installation.xml +++ b/docs/xml/installation.xml @@ -597,7 +597,7 @@ <para> <programlisting> -perl -pi -e 's@#\!/usr/bonsaitools/bin/perl@#\!/usr/bin/perl@' *cgi *pl Bug.pm processmail syncshadowdb +perl -pi -e 's@#\!/usr/bonsaitools/bin/perl@#\!/usr/bin/perl@' *cgi *pl Bug.pm syncshadowdb </programlisting> Change <filename>/usr/bin/perl</filename> to match the location @@ -1424,19 +1424,14 @@ my $webservergid = '8' the <function>system</function> call. For example, you'll need to change: </para> -<!-- We'll need a different example when there's no more processmail --> <programlisting> -system("./processmail", $id, $exporter); +system("$webdotbase","-Tpng","-o","$pngfilename","$filename"); </programlisting> <para>with</para> <programlisting> -system("C:\\perl\\bin\\perl", "processmail", $id, $exporter); +system("C:\\perl\\bin\\perl", "$webdotbase","-Tpng","-o","$pngfilename","$filename"); </programlisting> - <para>Notice that the <computeroutput>./</computeroutput> is also - removed. - </para> - <tip> <para>The <command>grep</command> command is very helpful in finding these <function>system</function> calls, assuming you have the @@ -1444,6 +1439,16 @@ system("C:\\perl\\bin\\perl", "processmail", $id, $exporter); </para> </tip> + <note> + <para>It appears that the only <function>system</function> call + remaining in the Bugzilla codebase is in + <filename>showdependencygraph.cgi</filename>. Not changing this + file will only cause dependency graphs to not function if the + <option>webdotbase</option> paramater points to a local + installation of <ulink url="http://www.graphviz.org">GraphViz</ulink>. + </para> + </note> + </section> </section> @@ -1613,7 +1618,7 @@ AllowOverride Limit <para><filename>$BUGZILLA_HOME/.htaccess</filename> <programlisting><![CDATA[ # don't allow people to retrieve non-cgi executable files or our private data -<FilesMatch ^(.*\.pl|.*localconfig.*|processmail|runtests.sh)$> +<FilesMatch ^(.*\.pl|.*localconfig.*|runtests.sh)$> deny from all </FilesMatch> <FilesMatch ^(localconfig.js|localconfig.rdf)$> @@ -1721,7 +1726,6 @@ deny from all ns_register_filter preauth GET /bugzilla/localconfig filter_deny ns_register_filter preauth GET /bugzilla/*.pl filter_deny ns_register_filter preauth GET /bugzilla/localconfig filter_deny -ns_register_filter preauth GET /bugzilla/processmail filter_deny ns_register_filter preauth GET /bugzilla/syncshadowdb filter_deny ns_register_filter preauth GET /bugzilla/runtests.sh filter_deny |