diff options
Diffstat (limited to 'docs/en/xml/troubleshooting.xml')
-rw-r--r-- | docs/en/xml/troubleshooting.xml | 89 |
1 files changed, 77 insertions, 12 deletions
diff --git a/docs/en/xml/troubleshooting.xml b/docs/en/xml/troubleshooting.xml index 13a756a3b..10ad59f1c 100644 --- a/docs/en/xml/troubleshooting.xml +++ b/docs/en/xml/troubleshooting.xml @@ -1,5 +1,9 @@ -<!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"> --> -<!-- $Id: troubleshooting.xml,v 1.1 2008/04/03 19:05:43 lpsolit%gmail.com Exp $ --> +<?xml version="1.0"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" + "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [ + <!ENTITY % myents SYSTEM "bugzilla.ent"> + %myents; +]> <appendix id="troubleshooting"> <title>Troubleshooting</title> @@ -15,14 +19,14 @@ 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/mozilla.support.bugzilla">mozilla.support.bugzilla</ulink> + <ulink url="news://news.mozilla.org/netscape.public.mozilla.webtools">netscape.public.mozilla.webtools</ulink> newsgroup. </para> <para>If you have made it all the way through <xref linkend="installation"/> (Installation) and <xref linkend="configuration"/> (Configuration) but accessing the Bugzilla - URL doesn't work, the first thing to do is to check your web server error + URL doesn't work, the first thing to do is to check your webserver error log. For Apache, this is often located at <filename>/etc/logs/httpd/error_log</filename>. The error messages you see may be self-explanatory enough to enable you to diagnose and @@ -32,7 +36,7 @@ <para> Bugzilla can also log all user-based errors (and many code-based errors) - that occur, without polluting the web server's error log. To enable + 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 @@ -45,10 +49,10 @@ </section> <section id="trbl-testserver"> - <title>The Apache web server is not serving Bugzilla pages</title> + <title>The Apache webserver is not serving Bugzilla pages</title> <para>After you have run <command>checksetup.pl</command> twice, run <command>testserver.pl http://yoursite.yourdomain/yoururl</command> - to confirm that your web server is configured properly for + to confirm that your webserver is configured properly for Bugzilla. </para> <programlisting> @@ -75,13 +79,31 @@ TEST-OK Webserver is preventing fetch of http://landfill.bugzilla.org/bugzilla-t </para> </listitem> <listitem> - <para>The permissions on your library directories are set incorrectly. - They must, at the very least, be readable by the web server user or - group. It is recommended that they be world readable. + <para>The permissions on your library directories are set incorrectly. + They must, at the very least, be readable by the webserver user or + group. It is recommended that they be world readable. </para> </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> @@ -139,12 +161,55 @@ 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> <para>The most-likely cause is that the <quote>cookiepath</quote> parameter is not set correctly in the Bugzilla configuration. You can change this (if - you're a Bugzilla administrator) from the editparams.cgi page via the web interface. + you're a Bugzilla administrator) from the editparams.cgi page via the web. </para> <para>The value of the cookiepath parameter should be the actual directory @@ -213,7 +278,7 @@ TEST-OK Webserver is preventing fetch of http://landfill.bugzilla.org/bugzilla-t </para> </section> - <section id="trbl-relogin-some"> + <section> <title>Some users are constantly being forced to relogin</title> <para>First, make sure cookies are enabled in the user's browser. |