From c88af85fd2d0627287386f8ed21ad3baa7e93fdc Mon Sep 17 00:00:00 2001 From: "jake%bugzilla.org" <> Date: Tue, 7 Dec 2004 19:41:59 +0000 Subject: Bug 271360 - Moving the Troubleshooting section into an appendix instead. Also, moved a few items out of the FAQ and into this new appendix. --- docs/xml/installation.xml | 194 +--------------------------------------------- 1 file changed, 1 insertion(+), 193 deletions(-) (limited to 'docs/xml/installation.xml') diff --git a/docs/xml/installation.xml b/docs/xml/installation.xml index 0f06b4735..4cd5cfc0b 100644 --- a/docs/xml/installation.xml +++ b/docs/xml/installation.xml @@ -1,5 +1,5 @@ - + Installing Bugzilla @@ -1738,198 +1738,6 @@ pid-file=/home/foo/mymysql/the.pid -
- Troubleshooting - - This section gives solutions to common Bugzilla installation - problems. If none of the section headings seems to match your - problem, read the general advice. - - -
- General Advice - - If you can't get checksetup.pl 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 - netscape.public.mozilla.webtools - newsgroup. - - - - If you have made it all the way through - (Installation) and - (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 - /etc/logs/httpd/error_log. 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. - -
- -
- The Apache webserver is not serving Bugzilla pages - - After you have run checksetup.pl twice, - run testserver.pl http://yoursite.yourdomain/yoururl - to confirm that your webserver is configured properly for - Bugzilla. - - -
- -
- I installed a Perl module, but - <filename>checksetup.pl</filename> claims it's not installed! - - - 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 checksetup.pl. This will make sure you - are installing the modules in the right place. - -
- -
- Bundle::Bugzilla makes me upgrade to Perl 5.6.1 - - - 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. - -
- - -
- DBD::Sponge::db prepare failed - - - The following error message may appear due to a bug in DBD::mysql - (over which the Bugzilla team have no control): - - - - - - To fix this, go to - <path-to-perl>/lib/DBD/sponge.pm - in your Perl installation and replace - - -{'NUM_OF_FIELDS'}) { - $numFields = $attribs->{'NUM_OF_FIELDS'}; - } elsif ($attribs->{'NAME'}) { - $numFields = @{$attribs->{NAME}}; -]]> - - - by - - -{'NUM_OF_FIELDS'}) { - $numFields = $attribs->{'NUM_OF_FIELDS'}; - } elsif ($attribs->{'NAMES'}) { - $numFields = @{$attribs->{NAMES}}; -]]> - - - (note the S added to NAME.) - -
- -
- cannot chdir(/var/spool/mqueue) - - 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: - - - - - 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. - -
- -
- Your vendor has not defined Fcntl macro O_NOINHERIT - - This is caused by a bug in the version of - File::Temp that is distributed with perl - 5.6.0. Many minor variations of this error have been reported: - - - 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. - - 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 patch file. - - - -
-