diff options
Diffstat (limited to 'docs/html/troubleshooting.html')
| -rw-r--r-- | docs/html/troubleshooting.html | 469 |
1 files changed, 0 insertions, 469 deletions
diff --git a/docs/html/troubleshooting.html b/docs/html/troubleshooting.html deleted file mode 100644 index 5ea13534b..000000000 --- a/docs/html/troubleshooting.html +++ /dev/null @@ -1,469 +0,0 @@ -<HTML -><HEAD -><TITLE ->Troubleshooting</TITLE -><META -NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ -"><LINK -REL="HOME" -TITLE="The Bugzilla Guide - 2.17.7 - Development Release" -HREF="index.html"><LINK -REL="UP" -TITLE="Installing Bugzilla" -HREF="installing-bugzilla.html"><LINK -REL="PREVIOUS" -TITLE="OS-Specific Installation Notes" -HREF="os-specific.html"><LINK -REL="NEXT" -TITLE="Administering Bugzilla" -HREF="administration.html"></HEAD -><BODY -CLASS="section" -BGCOLOR="#FFFFFF" -TEXT="#000000" -LINK="#0000FF" -VLINK="#840084" -ALINK="#0000FF" -><DIV -CLASS="NAVHEADER" -><TABLE -SUMMARY="Header navigation table" -WIDTH="100%" -BORDER="0" -CELLPADDING="0" -CELLSPACING="0" -><TR -><TH -COLSPAN="3" -ALIGN="center" ->The Bugzilla Guide - 2.17.7 - Development Release</TH -></TR -><TR -><TD -WIDTH="10%" -ALIGN="left" -VALIGN="bottom" -><A -HREF="os-specific.html" -ACCESSKEY="P" ->Prev</A -></TD -><TD -WIDTH="80%" -ALIGN="center" -VALIGN="bottom" ->Chapter 2. Installing Bugzilla</TD -><TD -WIDTH="10%" -ALIGN="right" -VALIGN="bottom" -><A -HREF="administration.html" -ACCESSKEY="N" ->Next</A -></TD -></TR -></TABLE -><HR -ALIGN="LEFT" -WIDTH="100%"></DIV -><DIV -CLASS="section" -><H1 -CLASS="section" -><A -NAME="troubleshooting" -></A ->2.5. Troubleshooting</H1 -><P ->This section gives solutions to common Bugzilla installation - problems. If none of the section headings seems to match your - problem, read the general advice. - </P -><DIV -CLASS="section" -><H2 -CLASS="section" -><A -NAME="general-advice" -></A ->2.5.1. General Advice</H2 -><P -> If you can't get <TT -CLASS="filename" ->checksetup.pl</TT -> to run to - 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 - <A -HREF="news://news.mozilla.org/netscape.public.mozilla.webtools" -TARGET="_top" ->netscape.public.mozilla.webtools</A -> - newsgroup. - </P -><P -> If you have made it all the way through - <A -HREF="installation.html" ->Section 2.1</A -> (Installation) and - <A -HREF="configuration.html" ->Section 2.2</A -> (Configuration) but - accessing the Bugzilla URL doesn't work, - the first thing to do is to check your webserver error log. For - Apache, this is often located at - <TT -CLASS="filename" ->/etc/logs/httpd/error_log</TT ->. The error messages - you see may be self-explanatory enough to enable you to diagnose and - fix the problem. If not, see below for some commonly-encountered - errors. If that doesn't help, post the errors to the newsgroup. - </P -></DIV -><DIV -CLASS="section" -><H2 -CLASS="section" -><A -NAME="AEN827" -></A ->2.5.2. I installed a Perl module, but - <TT -CLASS="filename" ->checksetup.pl</TT -> claims it's not installed!</H2 -><P -> You have two versions of Perl on your machine. You are installing - modules into one, and Bugzilla is using the other. Rerun the CPAN - commands (or manual compile) using the full path to Perl from the - top of <TT -CLASS="filename" ->checksetup.pl</TT ->. This will make sure you - are installing the modules in the right place. - </P -></DIV -><DIV -CLASS="section" -><H2 -CLASS="section" -><A -NAME="AEN832" -></A ->2.5.3. Bundle::Bugzilla makes me upgrade to Perl 5.6.1</H2 -><P -> Try executing <B -CLASS="command" ->perl -MCPAN -e 'install CPAN'</B -> - and then continuing. - </P -><P -> 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. - </P -></DIV -><DIV -CLASS="section" -><H2 -CLASS="section" -><A -NAME="AEN837" -></A ->2.5.4. DBD::Sponge::db prepare failed</H2 -><P -> The following error message may appear due to a bug in DBD::mysql - (over which the Bugzilla team have no control): - </P -><TABLE -BORDER="0" -BGCOLOR="#E0E0E0" -WIDTH="100%" -><TR -><TD -><FONT -COLOR="#000000" -><PRE -CLASS="programlisting" -> DBD::Sponge::db prepare failed: Cannot determine NUM_OF_FIELDS at D:/Perl/site/lib/DBD/mysql.pm line 248. - SV = NULL(0x0) at 0x20fc444 - REFCNT = 1 - FLAGS = (PADBUSY,PADMY) -</PRE -></FONT -></TD -></TR -></TABLE -><P -> To fix this, go to - <TT -CLASS="filename" -><path-to-perl>/lib/DBD/sponge.pm</TT -> - in your Perl installation and replace - </P -><TABLE -BORDER="0" -BGCOLOR="#E0E0E0" -WIDTH="100%" -><TR -><TD -><FONT -COLOR="#000000" -><PRE -CLASS="programlisting" -> my $numFields; - if ($attribs->{'NUM_OF_FIELDS'}) { - $numFields = $attribs->{'NUM_OF_FIELDS'}; - } elsif ($attribs->{'NAME'}) { - $numFields = @{$attribs->{NAME}}; -</PRE -></FONT -></TD -></TR -></TABLE -><P -> by - </P -><TABLE -BORDER="0" -BGCOLOR="#E0E0E0" -WIDTH="100%" -><TR -><TD -><FONT -COLOR="#000000" -><PRE -CLASS="programlisting" -> my $numFields; - if ($attribs->{'NUM_OF_FIELDS'}) { - $numFields = $attribs->{'NUM_OF_FIELDS'}; - } elsif ($attribs->{'NAMES'}) { - $numFields = @{$attribs->{NAMES}}; -</PRE -></FONT -></TD -></TR -></TABLE -><P -> (note the S added to NAME.) - </P -></DIV -><DIV -CLASS="section" -><H2 -CLASS="section" -><A -NAME="paranoid-security" -></A ->2.5.5. cannot chdir(/var/spool/mqueue)</H2 -><P ->If you are installing Bugzilla on SuSE Linux, or some other - distributions with - <SPAN -CLASS="QUOTE" ->"paranoid"</SPAN -> - security options, it is possible that the checksetup.pl script may fail - with the error: -<TABLE -BORDER="0" -BGCOLOR="#E0E0E0" -WIDTH="100%" -><TR -><TD -><FONT -COLOR="#000000" -><PRE -CLASS="programlisting" ->cannot chdir(/var/spool/mqueue): Permission denied -</PRE -></FONT -></TD -></TR -></TABLE -> - </P -><P -> This is because your - <TT -CLASS="filename" ->/var/spool/mqueue</TT -> - directory has a mode of - <SPAN -CLASS="QUOTE" ->"drwx------"</SPAN ->. Type - <B -CLASS="command" ->chmod 755 - <TT -CLASS="filename" ->/var/spool/mqueue</TT -> - </B -> - as root to fix this problem. - </P -></DIV -><DIV -CLASS="section" -><H2 -CLASS="section" -><A -NAME="trouble-filetemp" -></A ->2.5.6. Your vendor has not defined Fcntl macro O_NOINHERIT</H2 -><P ->This is caused by a bug in the version of - <SPAN -CLASS="productname" ->File::Temp</SPAN -> that is distributed with perl - 5.6.0. Many minor variations of this error have been reported: - </P -><TABLE -BORDER="0" -BGCOLOR="#E0E0E0" -WIDTH="100%" -><TR -><TD -><FONT -COLOR="#000000" -><PRE -CLASS="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.</PRE -></FONT -></TD -></TR -></TABLE -><P ->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 <A -HREF="../xml/filetemp.patch" -TARGET="_top" ->patch file</A ->. - </P -><TABLE -BORDER="0" -BGCOLOR="#E0E0E0" -WIDTH="100%" -><TR -><TD -><FONT -COLOR="#000000" -><PRE -CLASS="programlisting" ->--- 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; - };</PRE -></FONT -></TD -></TR -></TABLE -></DIV -></DIV -><DIV -CLASS="NAVFOOTER" -><HR -ALIGN="LEFT" -WIDTH="100%"><TABLE -SUMMARY="Footer navigation table" -WIDTH="100%" -BORDER="0" -CELLPADDING="0" -CELLSPACING="0" -><TR -><TD -WIDTH="33%" -ALIGN="left" -VALIGN="top" -><A -HREF="os-specific.html" -ACCESSKEY="P" ->Prev</A -></TD -><TD -WIDTH="34%" -ALIGN="center" -VALIGN="top" -><A -HREF="index.html" -ACCESSKEY="H" ->Home</A -></TD -><TD -WIDTH="33%" -ALIGN="right" -VALIGN="top" -><A -HREF="administration.html" -ACCESSKEY="N" ->Next</A -></TD -></TR -><TR -><TD -WIDTH="33%" -ALIGN="left" -VALIGN="top" ->OS-Specific Installation Notes</TD -><TD -WIDTH="34%" -ALIGN="center" -VALIGN="top" -><A -HREF="installing-bugzilla.html" -ACCESSKEY="U" ->Up</A -></TD -><TD -WIDTH="33%" -ALIGN="right" -VALIGN="top" ->Administering Bugzilla</TD -></TR -></TABLE -></DIV -></BODY -></HTML ->
\ No newline at end of file |