From d8caf6045d10344c431918128e3803ca497565f3 Mon Sep 17 00:00:00 2001 From: "gerv%gerv.net" <> Date: Sun, 28 Jul 2002 05:00:17 +0000 Subject: Merging new docs from 2.16 branch. --- docs/html/troubleshooting.html | 309 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 309 insertions(+) create mode 100644 docs/html/troubleshooting.html (limited to 'docs/html/troubleshooting.html') diff --git a/docs/html/troubleshooting.html b/docs/html/troubleshooting.html new file mode 100644 index 000000000..7a4a32d7d --- /dev/null +++ b/docs/html/troubleshooting.html @@ -0,0 +1,309 @@ +
This section gives solutions to common Bugzilla installation + problems. +
Try executing perl -MCPAN -e 'install CPAN' + and then continuing. +
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. +
The following error message may appear due to a bug in DBD::mysql + (over which the Bugzilla team have no control): +
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) + |
To fix this, go to + <path-to-perl>/lib/DBD/sponge.pm + in your Perl installation and replace +
my $numFields; + if ($attribs->{'NUM_OF_FIELDS'}) { + $numFields = $attribs->{'NUM_OF_FIELDS'}; + } elsif ($attribs->{'NAME'}) { + $numFields = @{$attribs->{NAME}}; + |
by +
my $numFields; + if ($attribs->{'NUM_OF_FIELDS'}) { + $numFields = $attribs->{'NUM_OF_FIELDS'}; + } elsif ($attribs->{'NAMES'}) { + $numFields = @{$attribs->{NAMES}}; + |
(note the S added to NAME.) +
If you are installing Bugzilla on SuSE Linux, or some other + distributions with + "paranoid" + security options, it is possible that the checksetup.pl script may fail + with the error: +
cannot chdir(/var/spool/mqueue): Permission denied + |
This is because your + /var/spool/mqueue + directory has a mode of + "drwx------". Type + chmod 755 + /var/spool/mqueue + + as root to fix this problem. +