summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/en/xml/installation.xml26
-rw-r--r--docs/en/xml/modules.xml18
-rw-r--r--docs/en/xml/requiredsoftware.xml35
-rw-r--r--docs/en/xml/troubleshooting.xml105
4 files changed, 54 insertions, 130 deletions
diff --git a/docs/en/xml/installation.xml b/docs/en/xml/installation.xml
index 8de7be914..71d9fb8e3 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.125 2008/04/04 06:47:55 mkanat%bugzilla.org Exp $ -->
+<!-- $Id: installation.xml,v 1.126 2008/04/04 06:47:56 mkanat%bugzilla.org Exp $ -->
<chapter id="installing-bugzilla">
<title>Installing Bugzilla</title>
@@ -293,12 +293,6 @@
<listitem>
<para>
- Data::Dumper (&min-data-dumper-ver;)
- </para>
- </listitem>
-
- <listitem>
- <para>
Date::Format (&min-date-format-ver;)
</para>
</listitem>
@@ -330,12 +324,6 @@
<listitem>
<para>
- File::Temp (&min-file-temp-ver;)
- </para>
- </listitem>
-
- <listitem>
- <para>
<link linkend="install-modules-template">Template</link>
(&min-template-ver;)
</para>
@@ -343,12 +331,6 @@
<listitem>
<para>
- Text::Wrap (&min-text-wrap-ver;)
- </para>
- </listitem>
-
- <listitem>
- <para>
Mail::Mailer (&min-mail-mailer-ver;)
</para>
</listitem>
@@ -364,12 +346,6 @@
MIME::Parser (&min-mime-parser-ver;)
</para>
</listitem>
-
- <listitem>
- <para>
- Storable (&min-storable-ver;)
- </para>
- </listitem>
</orderedlist>
Optional Perl modules:
diff --git a/docs/en/xml/modules.xml b/docs/en/xml/modules.xml
index e2912d6a8..2e20bdc56 100644
--- a/docs/en/xml/modules.xml
+++ b/docs/en/xml/modules.xml
@@ -104,15 +104,6 @@
</para>
<para>
- File::Temp:
- <literallayout>
- CPAN Download Page: <ulink url="http://search.cpan.org/dist/File-Temp/"/>
- PPM Download Page: Part of core distribution.
- Documentation: <ulink url="http://www.perldoc.com/perl5.8.0/lib/File/Temp.html"/>
- </literallayout>
- </para>
-
- <para>
Template-Toolkit:
<literallayout>
CPAN Download Page: <ulink url="http://search.cpan.org/dist/Template-Toolkit/"/>
@@ -122,15 +113,6 @@
</para>
<para>
- Text::Wrap:
- <literallayout>
- CPAN Download Page: <ulink url="http://search.cpan.org/dist/Text-Tabs+Wrap/"/>
- PPM Download Link: Part of core distribution.
- Documentation: <ulink url="http://www.perldoc.com/perl5.8.0/lib/Text/Wrap.html"/>
- </literallayout>
- </para>
-
- <para>
GD:
<literallayout>
CPAN Download Page: <ulink url="http://search.cpan.org/dist/GD/"/>
diff --git a/docs/en/xml/requiredsoftware.xml b/docs/en/xml/requiredsoftware.xml
index f32f0dc2f..4a751c0c7 100644
--- a/docs/en/xml/requiredsoftware.xml
+++ b/docs/en/xml/requiredsoftware.xml
@@ -6,59 +6,48 @@
stay current for a while.</para>
<para>Apache Web Server:
- <ulink url="http://www.apache.org/">http://www.apache.org</ulink>
+ <ulink url="http://www.apache.org/"/>
Optional web server for Bugzilla, but recommended because of broad user
base and support.</para>
<para>Bugzilla:
- <ulink url="http://www.bugzilla.org/">
- http://www.bugzilla.org/</ulink>
+ <ulink url="http://www.bugzilla.org/"/>
</para>
<para>MySQL:
- <ulink url="http://www.mysql.com/">http://www.mysql.com/</ulink>
+ <ulink url="http://www.mysql.com/"/>
</para>
<para>Perl:
- <ulink url="http://www.perl.org">http://www.perl.org/</ulink>
+ <ulink url="http://www.perl.org/"/>
</para>
<para>CPAN:
- <ulink url="http://www.cpan.org/">http://www.cpan.org/</ulink>
+ <ulink url="http://www.cpan.org/"/>
</para>
<para>DBI Perl module:
- <ulink url="http://www.cpan.org/modules/by-module/DBI/">
- http://www.cpan.org/modules/by-module/DBI/</ulink>
- </para>
-
- <para>Data::Dumper module:
- <ulink url="http://www.cpan.org/modules/by-module/Data/">
- http://www.cpan.org/modules/by-module/Data/</ulink>
+ <ulink url="http://www.cpan.org/modules/by-module/DBI/"/>
</para>
<para>MySQL related Perl modules:
- <ulink url="http://www.cpan.org/modules/by-module/Mysql/">
- http://www.cpan.org/modules/by-module/Mysql/</ulink>
+ <ulink url="http://www.cpan.org/modules/by-module/Mysql/"/>
</para>
<para>TimeDate Perl module collection:
- <ulink url="http://www.cpan.org/modules/by-module/Date/">
- http://www.cpan.org/modules/by-module/Date/</ulink>
+ <ulink url="http://www.cpan.org/modules/by-module/Date/"/>
</para>
<para>GD Perl module:
- <ulink url="http://www.cpan.org/modules/by-module/GD/">
- http://www.cpan.org/modules/by-module/GD/</ulink>
+ <ulink url="http://www.cpan.org/modules/by-module/GD/"/>
Alternately, you should be able to find the latest version of GD at
- <ulink url="http://www.boutell.com/gd/">http://www.boutell.com/gd/</ulink>
+ <ulink url="http://www.boutell.com/gd/"/>
</para>
<para>Chart::Base module:
- <ulink url="http://www.cpan.org/modules/by-module/Chart/">
- http://www.cpan.org/modules/by-module/Chart/</ulink>
+ <ulink url="http://www.cpan.org/modules/by-module/Chart/"/>
</para>
<para>(But remember, Bundle::Bugzilla will install all the modules for you.)
@@ -80,7 +69,7 @@ sgml-local-ecat-files:nil
sgml-minimize-attributes:nil
sgml-namecase-general:t
sgml-omittag:t
-sgml-parent-document:("Bugzilla-Guide.sgml" "book" "chapter")
+sgml-parent-document:("Bugzilla-Guide.xml" "book" "chapter")
sgml-shorttag:t
sgml-tag-region-if-active:t
End:
diff --git a/docs/en/xml/troubleshooting.xml b/docs/en/xml/troubleshooting.xml
index 3500f5251..5905f964c 100644
--- a/docs/en/xml/troubleshooting.xml
+++ b/docs/en/xml/troubleshooting.xml
@@ -1,5 +1,5 @@
<!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"> -->
-<!-- $Id: troubleshooting.xml,v 1.4 2008/04/04 06:48:16 jake%bugzilla.org Exp $ -->
+<!-- $Id: troubleshooting.xml,v 1.12 2008/04/04 06:48:24 mkanat%bugzilla.org Exp $ -->
<appendix id="troubleshooting">
<title>Troubleshooting</title>
@@ -15,7 +15,7 @@
completion, it normally explains what's wrong and how to fix it.
If you can't work it out, or if it's being uncommunicative, post
the errors in the
- <ulink url="news://news.mozilla.org/netscape.public.mozilla.webtools">netscape.public.mozilla.webtools</ulink>
+ <ulink url="news://news.mozilla.org/mozilla.support.bugzilla">mozilla.support.bugzilla</ulink>
newsgroup.
</para>
@@ -29,6 +29,19 @@
fix the problem. If not, see below for some commonly-encountered
errors. If that doesn't help, post the errors to the newsgroup.
</para>
+
+ <para>
+ Bugzilla can also log all user-based errors (and many code-based errors)
+ that occur, without polluting the web server error log. To enable
+ Bugzilla error logging, create a file that Bugzilla can write to, named
+ <filename>errorlog</filename>, in the Bugzilla <filename>data</filename>
+ directory. Errors will be logged as they occur, and will include the type
+ of the error, the IP address and username (if available) of the user who
+ triggered the error, and the values of all environment variables; if a
+ form was being submitted, the data in the form will also be included.
+ To disable error logging, delete or rename the
+ <filename>errorlog</filename> file.
+ </para>
</section>
<section id="trbl-testserver">
@@ -69,24 +82,6 @@ TEST-OK Webserver is preventing fetch of http://landfill.bugzilla.org/bugzilla-t
</listitem>
</orderedlist>
</section>
-
- <section id="trbl-bundleBugzilla">
- <title>Bundle::Bugzilla makes me upgrade to Perl 5.6.1</title>
-
- <para>Try executing <command>perl -MCPAN -e 'install CPAN'</command>
- and then continuing.
- </para>
-
- <para>Certain older versions of the CPAN toolset were somewhat naive about
- how to upgrade Perl modules. When a couple of modules got rolled into the
- core Perl distribution for 5.6.1, CPAN thought that the best way to get
- those modules up to date was to haul down the Perl distribution itself and
- build it. Needless to say, this has caused headaches for just about
- everybody. Upgrading to a newer version of CPAN with the
- commandline above should fix things.
- </para>
- </section>
-
<section id="trbl-dbdSponge">
<title>DBD::Sponge::db prepare failed</title>
@@ -144,49 +139,6 @@ TEST-OK Webserver is preventing fetch of http://landfill.bugzilla.org/bugzilla-t
</para>
</section>
- <section id="trouble-filetemp">
- <title>Your vendor has not defined Fcntl macro O_NOINHERIT</title>
-
- <para>This is caused by a bug in the version of
- <productname>File::Temp</productname> that is distributed with perl
- 5.6.0. Many minor variations of this error have been reported:
- </para>
-
- <programlisting>Your vendor has not defined Fcntl macro O_NOINHERIT, used
-at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 208.
-
-Your vendor has not defined Fcntl macro O_EXLOCK, used
-at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 210.
-
-Your vendor has not defined Fcntl macro O_TEMPORARY, used
-at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 233.</programlisting>
-
- <para>Numerous people have reported that upgrading to version 5.6.1
- or higher solved the problem for them. A less involved fix is to apply
- the following patch, which is also
- available as a <ulink url="../xml/filetemp.patch">patch file</ulink>.
- </para>
-
- <programlisting><![CDATA[--- File/Temp.pm.orig Thu Feb 6 16:26:00 2003
-+++ File/Temp.pm Thu Feb 6 16:26:23 2003
-@@ -205,6 +205,7 @@
- # eg CGI::Carp
- local $SIG{__DIE__} = sub {};
- local $SIG{__WARN__} = sub {};
-+ local *CORE::GLOBAL::die = sub {};
- $bit = &$func();
- 1;
- };
-@@ -226,6 +227,7 @@
- # eg CGI::Carp
- local $SIG{__DIE__} = sub {};
- local $SIG{__WARN__} = sub {};
-+ local *CORE::GLOBAL::die = sub {};
- $bit = &$func();
- 1;
- };]]></programlisting>
- </section>
-
<section id="trbl-relogin-everyone">
<title>Everybody is constantly being forced to relogin</title>
@@ -261,7 +213,7 @@ at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 233.</programlisting>
</para>
</section>
- <section>
+ <section id="trbl-relogin-some">
<title>Some users are constantly being forced to relogin</title>
<para>First, make sure cookies are enabled in the user's browser.
@@ -305,6 +257,31 @@ at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 233.</programlisting>
</section>
+ <section id="trbl-passwd-encryption">
+ <title>
+ checksetup.pl reports "Client does not support authentication protocol
+ requested by server..."
+ </title>
+
+ <para>
+ This error is occurring because you are using the new password
+ encryption that comes with MySQL 4.1, while your
+ <filename>DBD::mysql</filename> module was compiled against an
+ older version of MySQL. If you recompile <filename>DBD::mysql</filename>
+ against the current MySQL libraries (or just obtain a newer version
+ of this module) then the error may go away.
+ </para>
+
+ <para>
+ If that does not fix the problem, or if you cannot recompile the
+ existing module (e.g. you're running Windows) and/or don't want to
+ replace it (e.g. you want to keep using a packaged version), then a
+ workaround is available from the MySQL docs:
+ <ulink url="http://dev.mysql.com/doc/mysql/en/Old_client.html"/>
+ </para>
+
+ </section>
+
</appendix>
<!-- Keep this comment at the end of the file