Skip to content

bugzilla
bugzilla
Commit 9daaa3f9 authored by jake%bugzilla.org's avatar jake%bugzilla.org
Browse files
Options

Bug 192511 - Removing all occurances of 'processmail' from the documentation now…

Bug 192511 - Removing all occurances of 'processmail' from the documentation now that bug 124174 is FIXED.
parent cc844939
Hide whitespace changes
Inline Side-by-side
Showing with 74 additions and 32 deletions
docs/sgml/faq.sgml
View file @ 9daaa3f9
...@@ -778,14 +778,16 @@ ...@@ -778,14 +778,16 @@
</question> </question>
<answer> <answer>
<para> <para>
If you are using an alternate Mail Transport Agent (MTA other than If you are using an alternate <glossterm linkend="gloss-mta">MTA</glossterm>,
sendmail), make sure the options given in the "processmail" and other make sure the options given in <filename>Bugzilla/BugMail.pm</filename>
scripts for all and any other place where <application>sendmail</application> is called from
instances of "sendmail" are correct for your MTA. are correct for your MTA. You should also ensure that the
<option>sendmailnow</option> param is set to <literal>on</literal>.
</para> </para>
<para> <para>
If you are using Sendmail, try enabling "sendmailnow" in editparams.cgi. If you are using <application>sendmail</application>, try enabling
If you are using Postfix, you will also need to enable <quote>sendmailnow</quote>. <option>sendmailnow</option> in <filename>editparams.cgi</filename>.
<!-- TODO provide more info about this, possibly a link to admin -->
</para> </para>
</answer> </answer>
</qandaentry> </qandaentry>
......
docs/sgml/glossary.sgml
View file @ 9daaa3f9
...@@ -227,6 +227,21 @@ ...@@ -227,6 +227,21 @@
<glossdiv id="gloss-m"> <glossdiv id="gloss-m">
<title>M</title> <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> <glossentry>
<glossterm>mysqld</glossterm> <glossterm>mysqld</glossterm>
......
docs/sgml/installation.sgml
View file @ 9daaa3f9
...@@ -597,7 +597,7 @@ ...@@ -597,7 +597,7 @@
<para> <para>
<programlisting> <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> </programlisting>
Change <filename>/usr/bin/perl</filename> to match the location Change <filename>/usr/bin/perl</filename> to match the location
...@@ -1424,19 +1424,14 @@ my $webservergid = '8' ...@@ -1424,19 +1424,14 @@ my $webservergid = '8'
the <function>system</function> call. For example, you'll need to the <function>system</function> call. For example, you'll need to
change: change:
</para> </para>
<!-- We'll need a different example when there's no more processmail -->
<programlisting> <programlisting>
system("./processmail", $id, $exporter); system("$webdotbase","-Tpng","-o","$pngfilename","$filename");
</programlisting> </programlisting>
<para>with</para> <para>with</para>
<programlisting> <programlisting>
system("C:\\perl\\bin\\perl", "processmail", $id, $exporter); system("C:\\perl\\bin\\perl", "$webdotbase","-Tpng","-o","$pngfilename","$filename");
</programlisting> </programlisting>
<para>Notice that the <computeroutput>./</computeroutput> is also
removed.
</para>
<tip> <tip>
<para>The <command>grep</command> command is very helpful in finding <para>The <command>grep</command> command is very helpful in finding
these <function>system</function> calls, assuming you have the these <function>system</function> calls, assuming you have the
...@@ -1444,6 +1439,16 @@ system("C:\\perl\\bin\\perl", "processmail", $id, $exporter); ...@@ -1444,6 +1439,16 @@ system("C:\\perl\\bin\\perl", "processmail", $id, $exporter);
</para> </para>
</tip> </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>
</section> </section>
...@@ -1613,7 +1618,7 @@ AllowOverride Limit ...@@ -1613,7 +1618,7 @@ AllowOverride Limit
<para><filename>$BUGZILLA_HOME/.htaccess</filename> <para><filename>$BUGZILLA_HOME/.htaccess</filename>
<programlisting><![CDATA[ <programlisting><![CDATA[
# don't allow people to retrieve non-cgi executable files or our private data # 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 deny from all
</FilesMatch> </FilesMatch>
<FilesMatch ^(localconfig.js|localconfig.rdf)$> <FilesMatch ^(localconfig.js|localconfig.rdf)$>
...@@ -1721,7 +1726,6 @@ deny from all ...@@ -1721,7 +1726,6 @@ deny from all
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/*.pl 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/processmail filter_deny
ns_register_filter preauth GET /bugzilla/syncshadowdb filter_deny ns_register_filter preauth GET /bugzilla/syncshadowdb filter_deny
ns_register_filter preauth GET /bugzilla/runtests.sh filter_deny ns_register_filter preauth GET /bugzilla/runtests.sh filter_deny
......
docs/xml/faq.xml
View file @ 9daaa3f9
...@@ -778,14 +778,16 @@ ...@@ -778,14 +778,16 @@
</question> </question>
<answer> <answer>
<para> <para>
If you are using an alternate Mail Transport Agent (MTA other than If you are using an alternate <glossterm linkend="gloss-mta">MTA</glossterm>,
sendmail), make sure the options given in the "processmail" and other make sure the options given in <filename>Bugzilla/BugMail.pm</filename>
scripts for all and any other place where <application>sendmail</application> is called from
instances of "sendmail" are correct for your MTA. are correct for your MTA. You should also ensure that the
<option>sendmailnow</option> param is set to <literal>on</literal>.
</para> </para>
<para> <para>
If you are using Sendmail, try enabling "sendmailnow" in editparams.cgi. If you are using <application>sendmail</application>, try enabling
If you are using Postfix, you will also need to enable <quote>sendmailnow</quote>. <option>sendmailnow</option> in <filename>editparams.cgi</filename>.
<!-- TODO provide more info about this, possibly a link to admin -->
</para> </para>
</answer> </answer>
</qandaentry> </qandaentry>
......
docs/xml/glossary.xml
View file @ 9daaa3f9
...@@ -227,6 +227,21 @@ ...@@ -227,6 +227,21 @@
<glossdiv id="gloss-m"> <glossdiv id="gloss-m">
<title>M</title> <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> <glossentry>
<glossterm>mysqld</glossterm> <glossterm>mysqld</glossterm>
......
docs/xml/installation.xml
View file @ 9daaa3f9
...@@ -597,7 +597,7 @@ ...@@ -597,7 +597,7 @@
<para> <para>
<programlisting> <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> </programlisting>
Change <filename>/usr/bin/perl</filename> to match the location Change <filename>/usr/bin/perl</filename> to match the location
...@@ -1424,19 +1424,14 @@ my $webservergid = '8' ...@@ -1424,19 +1424,14 @@ my $webservergid = '8'
the <function>system</function> call. For example, you'll need to the <function>system</function> call. For example, you'll need to
change: change:
</para> </para>
<!-- We'll need a different example when there's no more processmail -->
<programlisting> <programlisting>
system("./processmail", $id, $exporter); system("$webdotbase","-Tpng","-o","$pngfilename","$filename");
</programlisting> </programlisting>
<para>with</para> <para>with</para>
<programlisting> <programlisting>
system("C:\\perl\\bin\\perl", "processmail", $id, $exporter); system("C:\\perl\\bin\\perl", "$webdotbase","-Tpng","-o","$pngfilename","$filename");
</programlisting> </programlisting>
<para>Notice that the <computeroutput>./</computeroutput> is also
removed.
</para>
<tip> <tip>
<para>The <command>grep</command> command is very helpful in finding <para>The <command>grep</command> command is very helpful in finding
these <function>system</function> calls, assuming you have the these <function>system</function> calls, assuming you have the
...@@ -1444,6 +1439,16 @@ system("C:\\perl\\bin\\perl", "processmail", $id, $exporter); ...@@ -1444,6 +1439,16 @@ system("C:\\perl\\bin\\perl", "processmail", $id, $exporter);
</para> </para>
</tip> </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>
</section> </section>
...@@ -1613,7 +1618,7 @@ AllowOverride Limit ...@@ -1613,7 +1618,7 @@ AllowOverride Limit
<para><filename>$BUGZILLA_HOME/.htaccess</filename> <para><filename>$BUGZILLA_HOME/.htaccess</filename>
<programlisting><![CDATA[ <programlisting><![CDATA[
# don't allow people to retrieve non-cgi executable files or our private data # 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 deny from all
</FilesMatch> </FilesMatch>
<FilesMatch ^(localconfig.js|localconfig.rdf)$> <FilesMatch ^(localconfig.js|localconfig.rdf)$>
...@@ -1721,7 +1726,6 @@ deny from all ...@@ -1721,7 +1726,6 @@ deny from all
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/*.pl 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/processmail filter_deny
ns_register_filter preauth GET /bugzilla/syncshadowdb filter_deny ns_register_filter preauth GET /bugzilla/syncshadowdb filter_deny
ns_register_filter preauth GET /bugzilla/runtests.sh filter_deny ns_register_filter preauth GET /bugzilla/runtests.sh filter_deny
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment