Skip to content
Projects
Groups
Snippets
Help
This project
Loading...
Sign in / Register
Toggle navigation
bugzilla
Project
Project
Details
Activity
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Wiki
Wiki
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
etersoft
bugzilla
Commits
d09b99cd
Commit
d09b99cd
authored
Apr 23, 2003
by
jake%bugzilla.org
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Recompile the docs from the XML source in anticipation of the 2.17.4 release.
parent
25047db4
Hide whitespace changes
Inline
Side-by-side
Showing
15 changed files
with
1148 additions
and
999 deletions
+1148
-999
Bugzilla-Guide.html
docs/html/Bugzilla-Guide.html
+511
-460
administration.html
docs/html/administration.html
+4
-4
cust-templates.html
docs/html/cust-templates.html
+4
-4
dbdoc.html
docs/html/dbdoc.html
+2
-2
extraconfig.html
docs/html/extraconfig.html
+3
-3
faq.html
docs/html/faq.html
+98
-27
gfdl-howto.html
docs/html/gfdl-howto.html
+1
-1
gfdl.html
docs/html/gfdl.html
+1
-1
glossary.html
docs/html/glossary.html
+100
-16
index.html
docs/html/index.html
+22
-2
installation.html
docs/html/installation.html
+19
-9
os-specific.html
docs/html/os-specific.html
+101
-146
stepbystep.html
docs/html/stepbystep.html
+40
-229
troubleshooting.html
docs/html/troubleshooting.html
+112
-2
Bugzilla-Guide.txt
docs/txt/Bugzilla-Guide.txt
+130
-93
No files found.
docs/html/Bugzilla-Guide.html
View file @
d09b99cd
...
...
@@ -61,7 +61,7 @@ CLASS="corpauthor"
>
The Bugzilla Team
</H3
><P
CLASS=
"pubdate"
>
2003-0
2-16
<BR></P
>
2003-0
4-23
<BR></P
><DIV
><DIV
CLASS=
"abstract"
...
...
@@ -80,7 +80,7 @@ NAME="AEN14"
><P
>
This documentation is maintained in DocBook 4.1.2 XML format.
Changes are best submitted as plain text or
SG
ML diffs, attached
Changes are best submitted as plain text or
X
ML diffs, attached
to a bug filed in the
<A
HREF=
"http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla&component=Documentation"
TARGET=
"_top"
...
...
@@ -444,6 +444,26 @@ CLASS="LOT"
CLASS=
"LOT"
><DT
><B
>
List of Figures
</B
></DT
><DT
>
4-1.
<A
HREF=
"#trouble-filetemp-errors"
>
Other File::Temp error messages
</A
></DT
><DT
>
4-2.
<A
HREF=
"#trouble-filetemp-patch"
>
Patch for File::Temp in Perl 5.6.0
</A
></DT
></DL
></DIV
><DIV
CLASS=
"LOT"
><DL
CLASS=
"LOT"
><DT
><B
>
List of Examples
</B
></DT
><DT
...
...
@@ -2347,7 +2367,7 @@ TARGET="_top"
>
Date::Parse
</A
>
(
any
)
(
2.21
)
</P
></LI
><LI
...
...
@@ -2465,124 +2485,6 @@ VALIGN="TOP"
></DIV
>
<DIV
CLASS=
"note"
><P
></P
><TABLE
CLASS=
"note"
WIDTH=
"100%"
BORDER=
"0"
><TR
><TD
WIDTH=
"25"
ALIGN=
"CENTER"
VALIGN=
"TOP"
><IMG
SRC=
"../images/note.gif"
HSPACE=
"5"
ALT=
"Note"
></TD
><TD
ALIGN=
"LEFT"
VALIGN=
"TOP"
><P
>
Linux-Mandrake 8.0 includes every
required and optional library for Bugzilla. The easiest way to
install them is by using the
<TT
CLASS=
"filename"
>
urpmi
</TT
>
utility. If you follow these commands, you should have everything you
need for Bugzilla, and
<TT
CLASS=
"filename"
>
checksetup.pl
</TT
>
should not complain about any missing libraries. You may already have
some of these installed.
</P
><P
></P
><TABLE
BORDER=
"0"
><TBODY
><TR
><TD
>
<TT
CLASS=
"prompt"
>
bash#
</TT
>
<B
CLASS=
"command"
>
urpmi perl-mysql
</B
>
</TD
></TR
><TR
><TD
>
<TT
CLASS=
"prompt"
>
bash#
</TT
>
<B
CLASS=
"command"
>
urpmi perl-chart
</B
>
</TD
></TR
><TR
><TD
>
<TT
CLASS=
"prompt"
>
bash#
</TT
>
<B
CLASS=
"command"
>
urpmi perl-gd
</B
>
</TD
></TR
><TR
><TD
>
<TT
CLASS=
"prompt"
>
bash#
</TT
>
<B
CLASS=
"command"
>
urpmi perl-MailTools
</B
>
(for Bugzilla email integration)
</TD
></TR
><TR
><TD
>
<TT
CLASS=
"prompt"
>
bash#
</TT
>
<B
CLASS=
"command"
>
urpmi apache-modules
</B
>
</TD
></TR
></TBODY
></TABLE
><P
></P
></TD
></TR
></TABLE
></DIV
>
</P
></DIV
><DIV
...
...
@@ -2945,7 +2847,7 @@ CLASS="section"
><HR><H3
CLASS=
"section"
><A
NAME=
"AEN5
8
6"
NAME=
"AEN5
6
6"
></A
>
4.1.5.1. DBI
</H3
><P
...
...
@@ -2960,7 +2862,7 @@ CLASS="section"
><HR><H3
CLASS=
"section"
><A
NAME=
"AEN5
8
9"
NAME=
"AEN5
6
9"
></A
>
4.1.5.2. Data::Dumper
</H3
><P
...
...
@@ -2974,7 +2876,7 @@ CLASS="section"
><HR><H3
CLASS=
"section"
><A
NAME=
"AEN5
9
2"
NAME=
"AEN5
7
2"
></A
>
4.1.5.3. MySQL-related modules
</H3
><P
...
...
@@ -3000,7 +2902,7 @@ CLASS="section"
><HR><H3
CLASS=
"section"
><A
NAME=
"AEN5
9
7"
NAME=
"AEN5
7
7"
></A
>
4.1.5.4. TimeDate modules
</H3
><P
...
...
@@ -3016,7 +2918,7 @@ CLASS="section"
><HR><H3
CLASS=
"section"
><A
NAME=
"AEN
60
0"
NAME=
"AEN
58
0"
></A
>
4.1.5.5. GD (optional)
</H3
><P
...
...
@@ -3071,7 +2973,7 @@ CLASS="section"
><HR><H3
CLASS=
"section"
><A
NAME=
"AEN
60
7"
NAME=
"AEN
58
7"
></A
>
4.1.5.6. Chart::Base (optional)
</H3
><P
...
...
@@ -3086,7 +2988,7 @@ CLASS="section"
><HR><H3
CLASS=
"section"
><A
NAME=
"AEN
61
0"
NAME=
"AEN
59
0"
></A
>
4.1.5.7. Template Toolkit
</H3
><P
...
...
@@ -3155,7 +3057,7 @@ CLASS="section"
><HR><H2
CLASS=
"section"
><A
NAME=
"AEN6
2
0"
NAME=
"AEN6
0
0"
></A
>
4.1.7. Bugzilla
</H2
><P
...
...
@@ -3220,112 +3122,13 @@ CLASS="filename"
>
checksetup.pl
</TT
>
script, which locks down your installation.
</P
><P
>
Lastly, you'll need to set up a symbolic link to
<TT
CLASS=
"filename"
>
/usr/bonsaitools/bin/perl
</TT
>
for the correct location of your Perl executable (probably
<TT
CLASS=
"filename"
>
/usr/bin/perl
</TT
>
).
Otherwise you must hack all the .cgi files to change where they look
for Perl. This can be done using the following Perl one-liner, but
I suggest using the symlink approach to avoid upgrade hassles.
</P
><DIV
CLASS=
"note"
><P
></P
><TABLE
CLASS=
"note"
WIDTH=
"100%"
BORDER=
"0"
><TR
><TD
WIDTH=
"25"
ALIGN=
"CENTER"
VALIGN=
"TOP"
><IMG
SRC=
"../images/note.gif"
HSPACE=
"5"
ALT=
"Note"
></TD
><TD
ALIGN=
"LEFT"
VALIGN=
"TOP"
><P
><SPAN
CLASS=
"QUOTE"
>
"Bonsaitools"
</SPAN
>
is the name Terry Weissman, the
original author of Bugzilla, created
for his suite of webtools at the time he created Bugzilla and several
other tools in use at mozilla.org. He created a directory,
<TT
CLASS=
"filename"
>
/usr/bonsaitools
</TT
>
to house his specific versions
of perl and other utilities. This usage is still current at
<A
HREF=
"http://bugzilla.mozilla.org/"
TARGET=
"_top"
>
bugzilla.mozilla.org
</A
>
,
but in general most other places do not use it. You can either edit
the paths at the start of each perl file to the correct location of
perl on your system, or simply bow to history and create a
<TT
CLASS=
"filename"
>
/usr/bonsaitools
</TT
>
and
<TT
CLASS=
"filename"
>
/usr/bonsaitools/bin
</TT
>
directory, placing a symlink to perl on your system
inside
<TT
CLASS=
"filename"
>
/usr/bonsaitools/bin
</TT
>
</P
></TD
></TR
></TABLE
></DIV
><P
>
<TABLE
BORDER=
"0"
BGCOLOR=
"#E0E0E0"
WIDTH=
"100%"
><TR
><TD
><FONT
COLOR=
"#000000"
><PRE
CLASS=
"programlisting"
>
perl -pi -e 's@#\!/usr/bonsaitools/bin/perl@#\!/usr/bin/perl@' *cgi *pl Bug.pm syncshadowdb
</PRE
></FONT
></TD
></TR
></TABLE
>
Change
<TT
CLASS=
"filename"
>
/usr/bin/perl
</TT
>
to match the location
of Perl on your machine.
</P
></DIV
><DIV
CLASS=
"section"
><HR><H2
CLASS=
"section"
><A
NAME=
"AEN6
45
"
NAME=
"AEN6
11
"
></A
>
4.1.8. Setting Up the MySQL Database
</H2
><P
...
...
@@ -3492,13 +3295,41 @@ CLASS="command"
></P
>
</P
><DIV
CLASS=
"note"
><P
></P
><TABLE
CLASS=
"note"
WIDTH=
"100%"
BORDER=
"0"
><TR
><TD
WIDTH=
"25"
ALIGN=
"CENTER"
VALIGN=
"TOP"
><IMG
SRC=
"../images/note.gif"
HSPACE=
"5"
ALT=
"Note"
></TD
><TD
ALIGN=
"LEFT"
VALIGN=
"TOP"
><P
>
If you are using MySQL 4, the bugs user also needs to be granted
the LOCK TABLES and CREATE TEMPORARY TABLES permissions.
</P
></TD
></TR
></TABLE
></DIV
></DIV
><DIV
CLASS=
"section"
><HR><H2
CLASS=
"section"
><A
NAME=
"AEN6
81
"
NAME=
"AEN6
49
"
></A
>
4.1.9.
<TT
CLASS=
"filename"
...
...
@@ -3651,7 +3482,7 @@ CLASS="section"
><HR><H2
CLASS=
"section"
><A
NAME=
"AEN
713
"
NAME=
"AEN
681
"
></A
>
4.1.10. Configuring Bugzilla
</H2
><P
...
...
@@ -3677,7 +3508,7 @@ CLASS="section"
><H2
CLASS=
"section"
><A
NAME=
"AEN
719
"
NAME=
"AEN
687
"
></A
>
4.2.1. Dependency Charts
</H2
><P
...
...
@@ -3741,7 +3572,7 @@ CLASS="section"
><HR><H2
CLASS=
"section"
><A
NAME=
"AEN7
34
"
NAME=
"AEN7
02
"
></A
>
4.2.2. Bug Graphs
</H2
><P
...
...
@@ -3800,7 +3631,7 @@ CLASS="section"
><HR><H2
CLASS=
"section"
><A
NAME=
"AEN7
47
"
NAME=
"AEN7
15
"
></A
>
4.2.3. The Whining Cron
</H2
><P
...
...
@@ -4513,150 +4344,6 @@ CLASS="programlisting"
></TR
></TABLE
></DIV
><DIV
CLASS=
"section"
><HR><H4
CLASS=
"section"
><A
NAME=
"AEN863"
></A
>
4.3.1.3.2. System Calls
</H4
><P
>
In order to get system calls to work on win32's perl, you need
to tell the windows shell what interpreter to use. This is done by
changing the
<TT
CLASS=
"function"
>
system
</TT
>
calls. You will need to
search all of Bugzilla's code for
<TT
CLASS=
"function"
>
system
</TT
>
calls.
To tell perl your interpreter, it needs to be the first argument to
the
<TT
CLASS=
"function"
>
system
</TT
>
call. For example, you'll need to
change:
</P
><TABLE
BORDER=
"0"
BGCOLOR=
"#E0E0E0"
WIDTH=
"100%"
><TR
><TD
><FONT
COLOR=
"#000000"
><PRE
CLASS=
"programlisting"
>
system("$webdotbase","-Tpng","-o","$pngfilename","$filename");
</PRE
></FONT
></TD
></TR
></TABLE
><P
>
with
</P
><TABLE
BORDER=
"0"
BGCOLOR=
"#E0E0E0"
WIDTH=
"100%"
><TR
><TD
><FONT
COLOR=
"#000000"
><PRE
CLASS=
"programlisting"
>
system("C:\\perl\\bin\\perl", "$webdotbase","-Tpng","-o","$pngfilename","$filename");
</PRE
></FONT
></TD
></TR
></TABLE
><DIV
CLASS=
"tip"
><P
></P
><TABLE
CLASS=
"tip"
WIDTH=
"100%"
BORDER=
"0"
><TR
><TD
WIDTH=
"25"
ALIGN=
"CENTER"
VALIGN=
"TOP"
><IMG
SRC=
"../images/tip.gif"
HSPACE=
"5"
ALT=
"Tip"
></TD
><TD
ALIGN=
"LEFT"
VALIGN=
"TOP"
><P
>
The
<B
CLASS=
"command"
>
grep
</B
>
command is very helpful in finding
these
<TT
CLASS=
"function"
>
system
</TT
>
calls, assuming you have the
<SPAN
CLASS=
"productname"
>
cygwin
</SPAN
>
utilities.
</P
></TD
></TR
></TABLE
></DIV
><DIV
CLASS=
"note"
><P
></P
><TABLE
CLASS=
"note"
WIDTH=
"100%"
BORDER=
"0"
><TR
><TD
WIDTH=
"25"
ALIGN=
"CENTER"
VALIGN=
"TOP"
><IMG
SRC=
"../images/note.gif"
HSPACE=
"5"
ALT=
"Note"
></TD
><TD
ALIGN=
"LEFT"
VALIGN=
"TOP"
><P
>
It appears that the only
<TT
CLASS=
"function"
>
system
</TT
>
call
remaining in the Bugzilla codebase is in
<TT
CLASS=
"filename"
>
showdependencygraph.cgi
</TT
>
. Not changing this
file will only cause dependency graphs to not function if the
<TT
CLASS=
"option"
>
webdotbase
</TT
>
paramater points to a local
installation of
<A
HREF=
"http://www.graphviz.org"
TARGET=
"_top"
>
GraphViz
</A
>
.
</P
></TD
></TR
></TABLE
></DIV
></DIV
></DIV
><DIV
CLASS=
"section"
...
...
@@ -4710,7 +4397,7 @@ TARGET="_top"
to modify the first line of every script to contain your path to
perl instead of
<TT
CLASS=
"filename"
>
/usr/b
onsaitools/b
in/perl
</TT
>
/usr/bin/perl
</TT
>
.
</P
></TD
...
...
@@ -4783,7 +4470,7 @@ CLASS="command"
This should go through the motions of downloading the latest version of
the GD module, then it will open a shell and drop you into the build
directory. Apply
<A
HREF=
"../
sg
ml/gd-makefile.patch"
HREF=
"../
x
ml/gd-makefile.patch"
TARGET=
"_top"
>
this patch
</A
>
...
...
@@ -4814,42 +4501,141 @@ CLASS="command"
><TD
>
<B
CLASS=
"command"
>
make
</B
>
make
</B
>
</TD
></TR
><TR
><TD
>
<B
CLASS=
"command"
>
make test
</B
>
</TD
></TR
><TR
><TD
>
<B
CLASS=
"command"
>
make install
</B
>
</TD
></TR
><TR
><TD
>
And don't forget to run
<B
CLASS=
"command"
>
exit
</B
>
to get back to CPAN.
</TD
></TR
></TBODY
></TABLE
><P
></P
>
</P
></DIV
><DIV
CLASS=
"section"
><HR><H2
CLASS=
"section"
><A
NAME=
"os-mandrake"
></A
>
4.3.3. Linux-Mandrake 8.0
</H2
><P
>
Linux-Mandrake 8.0 includes every required and optional library
for Bugzilla. The easiest way to install them is by using the
<B
CLASS=
"command"
>
urpmi
</B
>
utility. If you follow these commands, you
should have everything you need for Bugzilla, and
<B
CLASS=
"command"
>
./checksetup.pl
</B
>
should not complain about any
missing libraries. You may already have some of these installed.
</P
><TABLE
BORDER=
"0"
BGCOLOR=
"#E0E0E0"
WIDTH=
"100%"
><TR
><TD
><FONT
COLOR=
"#000000"
><PRE
CLASS=
"screen"
>
<TT
CLASS=
"prompt"
>
bash#
</TT
>
<B
CLASS=
"command"
>
urpmi perl-mysql
</B
>
<TT
CLASS=
"prompt"
>
bash#
</TT
>
<B
CLASS=
"command"
>
urpmi perl-chart
</B
>
</TD
></TR
><TR
><TD
>
<B
<TT
CLASS=
"prompt"
>
bash#
</TT
>
<B
CLASS=
"command"
>
make test
</B
>
urpmi perl-gd
</B
>
</TD
></TR
><TR
><TD
>
<B
<TT
CLASS=
"prompt"
>
bash#
</TT
>
<B
CLASS=
"command"
>
make install
</B
>
urpmi perl-MailTools
</B
>
<A
NAME=
"test-mailtools"
><IMG
SRC=
"../images/callouts/1.gif"
HSPACE=
"0"
VSPACE=
"0"
BORDER=
"0"
ALT=
"(1)"
></A
>
</TD
></TR
><TR
><TD
>
And don't forget to run
<B
<TT
CLASS=
"prompt"
>
bash#
</TT
>
<B
CLASS=
"command"
>
exit
</B
>
urpmi apache-modules
</B
>
to get back to CPAN.
</TD
</PRE
></FONT
></TD
></TR
></TBODY
></TABLE
><P
></P
>
</P
><DIV
CLASS=
"calloutlist"
><DL
COMPACT=
"COMPACT"
><DT
><A
HREF=
"#test-mailtools"
><IMG
SRC=
"../images/callouts/1.gif"
HSPACE=
"0"
VSPACE=
"0"
BORDER=
"0"
ALT=
"(1)"
></A
></DT
><DD
>
for Bugzilla e-mail integration
</DD
></DL
></DIV
></DIV
></DIV
><DIV
...
...
@@ -5433,7 +5219,7 @@ CLASS="section"
><HR><H2
CLASS=
"section"
><A
NAME=
"AEN
1009
"
NAME=
"AEN
977
"
></A
>
4.5.1. Bundle::Bugzilla makes me upgrade to Perl 5.6.1
</H2
><P
...
...
@@ -5458,7 +5244,7 @@ CLASS="section"
><HR><H2
CLASS=
"section"
><A
NAME=
"AEN
1014
"
NAME=
"AEN
982
"
></A
>
4.5.2. DBD::Sponge::db prepare failed
</H2
><P
...
...
@@ -5597,6 +5383,116 @@ CLASS="filename"
as root to fix this problem.
</P
></DIV
><DIV
CLASS=
"section"
><HR><H2
CLASS=
"section"
><A
NAME=
"trouble-filetemp"
></A
>
4.5.4. 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. Examples
can be found in
<A
HREF=
"#trouble-filetemp-errors"
>
Figure 4-1
</A
>
.
</P
><DIV
CLASS=
"figure"
><A
NAME=
"trouble-filetemp-errors"
></A
><P
><B
>
Figure 4-1. Other File::Temp error messages
</B
></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
></DIV
><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 patch in
<A
HREF=
"#trouble-filetemp-patch"
>
Figure 4-2
</A
>
. The patch is also
available as a
<A
HREF=
"../xml/filetemp.patch"
TARGET=
"_top"
>
patch file
</A
>
.
</P
><DIV
CLASS=
"figure"
><A
NAME=
"trouble-filetemp-patch"
></A
><P
><B
>
Figure 4-2. Patch for File::Temp in Perl 5.6.0
</B
></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
></DIV
><DIV
...
...
@@ -7435,7 +7331,7 @@ CLASS="section"
><HR><H2
CLASS=
"section"
><A
NAME=
"AEN14
43
"
NAME=
"AEN14
25
"
></A
>
5.7.1. What to Edit
</H2
><P
...
...
@@ -7550,7 +7446,7 @@ CLASS="section"
><HR><H2
CLASS=
"section"
><A
NAME=
"AEN14
62
"
NAME=
"AEN14
44
"
></A
>
5.7.2. How To Edit Templates
</H2
><P
...
...
@@ -7632,7 +7528,7 @@ CLASS="section"
><HR><H2
CLASS=
"section"
><A
NAME=
"AEN14
72
"
NAME=
"AEN14
54
"
></A
>
5.7.3. Template Formats
</H2
><P
...
...
@@ -7694,7 +7590,7 @@ CLASS="section"
><HR><H2
CLASS=
"section"
><A
NAME=
"AEN14
85
"
NAME=
"AEN14
67
"
></A
>
5.7.4. Particular Templates
</H2
><P
...
...
@@ -8747,12 +8643,24 @@ HREF="#faq-general-mysql"
><DT
>
A.1.9.
<A
HREF=
"#faq-general-bonsaitools"
>
Why do the scripts say "/usr/bonsaitools/bin/perl" instead of
"/usr/bin/perl" or something else?
>
What is
<TT
CLASS=
"filename"
>
/usr/bonsaitools/bin/perl
</TT
>
?
</A
></DT
><DT
>
A.1.10.
<A
HREF=
"#faq-general-perlpath"
>
My perl is not located at
<TT
CLASS=
"filename"
>
/usr/bin/perl
</TT
>
, is
there an easy way to change it everywhere it needs to be changed?
</A
></DT
><DT
>
A.1.11.
<A
HREF=
"#faq-general-cookie"
>
Is there an easy way to change the Bugzilla cookie name?
</A
...
...
@@ -9534,8 +9442,10 @@ NAME="faq-general-bonsaitools"
><B
>
A.1.9.
</B
>
Why do the scripts say "/usr/bonsaitools/bin/perl" instead of
"/usr/bin/perl" or something else?
What is
<TT
CLASS=
"filename"
>
/usr/bonsaitools/bin/perl
</TT
>
?
</P
></DIV
><DIV
...
...
@@ -9544,16 +9454,72 @@ CLASS="answer"
><B
>
</B
>
Mozilla.org uses /usr/bonsaitools/bin/perl, because originally
Terry wanted a place to put a version of Perl and other tools
that was strictly under his control.
</P
Bugzilla used to have the path to perl on the shebang line set to
<TT
CLASS=
"filename"
>
/usr/bonsaitools/bin/perl
</TT
>
because when
Terry first started writing the code for mozilla.org he needed a
version of Perl and other tools that were completely under his
control. This location was abandoned for the 2.18 release in favor
of the more sensible
<TT
CLASS=
"filename"
>
/usr/bin/perl
</TT
>
. If you
installed an older verion of Bugzilla and created the symlink we
suggested, you can remove it now (provided that you don't have
anything else, such as Bonsai, using it and you don't intend to
reinstall an older version of Bugzilla).
</P
></DIV
></DIV
><DIV
CLASS=
"qandaentry"
><DIV
CLASS=
"question"
><P
>
We always recommend that, if possible, you keep the path
as /usr/bonsaitools/bin/perl, and simply add symlink.
This will make upgrading
your Bugzilla much easier in the future.
</P
><A
NAME=
"faq-general-perlpath"
></A
><B
>
A.1.10.
</B
>
My perl is not located at
<TT
CLASS=
"filename"
>
/usr/bin/perl
</TT
>
, is
there an easy way to change it everywhere it needs to be changed?
</P
></DIV
><DIV
CLASS=
"answer"
><P
><B
>
</B
>
Yes, the following bit of perl magic will change all the shebang
lines. Be sure to change
<TT
CLASS=
"filename"
>
/usr/local/bin/perl
</TT
>
to your path to the perl binary.
</P
><TABLE
BORDER=
"0"
BGCOLOR=
"#E0E0E0"
WIDTH=
"100%"
><TR
><TD
><FONT
COLOR=
"#000000"
><PRE
CLASS=
"programlisting"
>
perl -pi -e 's@#\!/usr/bin/perl@#\!/usr/local/bin/perl@' *cgi *pl
</PRE
></FONT
></TD
></TR
></TABLE
></DIV
></DIV
><DIV
...
...
@@ -9565,7 +9531,7 @@ CLASS="question"
NAME=
"faq-general-cookie"
></A
><B
>
A.1.1
0
.
</B
>
A.1.1
1
.
</B
>
Is there an easy way to change the Bugzilla cookie name?
</P
...
...
@@ -9979,12 +9945,12 @@ CLASS="computeroutput"
CLASS=
"filename"
>
importxml.pl
</TT
>
which is intended to be
used for importing the data generated by
<TT
used for importing the data generated by the XML ctype of
<TT
CLASS=
"filename"
>
xml.cgi
</TT
>
in association with bug moving. Any other use is left as an
exercise for the user.
>
show_bug.cgi
</TT
>
in association with bug moving.
Any other use is left as an exercise for the user.
</P
><P
>
There are also scripts included in the
<TT
...
...
@@ -10020,9 +9986,9 @@ CLASS="answer"
>
Yes. For more information including available translated templates,
see
<A
HREF=
"http://www.bugzilla.org/download.html"
HREF=
"http://www.bugzilla.org/download.html
#localizations
"
TARGET=
"_top"
>
http://www.bugzilla.org/download.html
</A
>
http://www.bugzilla.org/download.html
#localizations
</A
>
.
The admin interfaces are still not included in these translated
templates and is therefore still English only. Also, there may be
...
...
@@ -10442,13 +10408,14 @@ CLASS="answer"
>
</B
>
Try Klaas Freitag's excellent patch for "whineatassigned" functionality.
You can find it at
<A
HREF=
"
http://bugzilla.mozilla.org/show_bug.cgi?id=6679"
You can find it at
<A
HREF=
"http://bugzilla.mozilla.org/show_bug.cgi?id=6679"
TARGET=
"_top"
>
http://bugzilla.mozilla.org/show_bug.cgi?id=6679
</A
>
http://bugzilla.mozilla.org/show_bug.cgi?id=6679
</A
>
. This
patch is against an older version of Bugzilla, so you must apply
the diffs manually.
</P
></DIV
></DIV
...
...
@@ -10476,7 +10443,7 @@ CLASS="answer"
You can call bug_email.pl directly from your aliases file, with
an entry like this:
<A
NAME=
"AEN18
94
"
NAME=
"AEN18
86
"
></A
><BLOCKQUOTE
CLASS=
"BLOCKQUOTE"
...
...
@@ -10920,7 +10887,7 @@ CLASS="answer"
><P
>
Microsoft has some advice on this matter, as well:
<A
NAME=
"AEN19
77
"
NAME=
"AEN19
69
"
></A
><BLOCKQUOTE
CLASS=
"BLOCKQUOTE"
...
...
@@ -11279,7 +11246,7 @@ TARGET="_top"
This list includes bugs for the 2.18 release that have already
been fixed and checked into CVS. Please consult the
<A
HREF=
"http://www.
mozilla.org/projects/bugzilla
/"
HREF=
"http://www.
bugzilla.org
/"
TARGET=
"_top"
>
Bugzilla Project Page
</A
>
for details on how to
...
...
@@ -11550,7 +11517,7 @@ CLASS="section"
><HR><H2
CLASS=
"section"
><A
NAME=
"AEN209
9
"
NAME=
"AEN209
1
"
></A
>
B.2.1. Bugzilla Database Basics
</H2
><P
...
...
@@ -11666,7 +11633,7 @@ CLASS="section"
><HR><H3
CLASS=
"section"
><A
NAME=
"AEN21
26
"
NAME=
"AEN21
18
"
></A
>
B.2.1.1. Bugzilla Database Tables
</H3
><P
...
...
@@ -12234,7 +12201,7 @@ NAME="gfdl"
><P
>
Version 1.1, March 2000
</P
><A
NAME=
"AEN22
14
"
NAME=
"AEN22
06
"
></A
><BLOCKQUOTE
CLASS=
"BLOCKQUOTE"
...
...
@@ -12699,7 +12666,7 @@ NAME="gfdl-howto"
of the License in the document and put the following copyright and
license notices just after the title page:
</P
><A
NAME=
"AEN2
304
"
NAME=
"AEN2
296
"
></A
><BLOCKQUOTE
CLASS=
"BLOCKQUOTE"
...
...
@@ -12736,7 +12703,7 @@ CLASS="glossdiv"
><H1
CLASS=
"glossdiv"
><A
NAME=
"AEN230
9
"
NAME=
"AEN230
1
"
></A
>
0-9, high ascii
</H1
><DL
...
...
@@ -12978,7 +12945,7 @@ CLASS="glossdiv"
><A
NAME=
"gloss-c"
></A
></H1
>
C
</H1
><DL
><DT
><A
...
...
@@ -13207,22 +13174,52 @@ TARGET="_top"
</P
><P
></P
><UL
><LI
><DIV
CLASS=
"variablelist"
><DL
><DT
><A
HREF=
"http://www.mysql.com/doc/en/Backup.html"
TARGET=
"_top"
>
Backup
</A
></DT
><DD
><P
>
Methods for backing up your Bugzilla database.
</P
></DD
><DT
><A
HREF=
"http://www.mysql.com/doc/en/Option_files.html"
TARGET=
"_top"
>
Option Files
</A
></DT
><DD
><P
>
Information about how to configure MySQL using
<TT
CLASS=
"filename"
>
my.cnf
</TT
>
.
</P
></DD
><DT
><A
HREF=
"http://www.mysql.com/doc/
P/r
/Privilege_system.html"
HREF=
"http://www.mysql.com/doc/
en
/Privilege_system.html"
TARGET=
"_top"
>
MySQL
Privilege System
</A
>
- Much more detailed information about
the suggestions in
<A
>
Privilege System
</A
></DT
><DD
><P
>
Much more detailed information about the suggestions in
<A
HREF=
"#security-mysql"
>
Section 5.6.2
</A
>
.
</P
></LI
></UL
</P
></DD
></DL
></DIV
></DD
></DL
></DIV
...
...
@@ -13473,16 +13470,70 @@ NAME="gloss-z"
><DL
><DT
><A
NAME=
"
zarro-boogs-found
"
NAME=
"
gloss-zarro
"
></A
><B
>
Zarro Boogs Found
</B
></DT
><DD
><P
>
This is the cryptic response sent by Bugzilla when a query
returned no results. It is just a goofy way of saying "Zero Bugs
Found".
</P
>
This is just a goofy way of saying that there were no bugs
found matching your query. When asked to explain this message,
Terry had the following to say:
</P
><A
NAME=
"AEN2515"
></A
><TABLE
BORDER=
"0"
WIDTH=
"100%"
CELLSPACING=
"0"
CELLPADDING=
"0"
CLASS=
"BLOCKQUOTE"
><TR
><TD
WIDTH=
"10%"
VALIGN=
"TOP"
>
</TD
><TD
WIDTH=
"80%"
VALIGN=
"TOP"
><P
>
I've been asked to explain this ... way back when, when
Netscape released version 4.0 of its browser, we had a release
party. Naturally, there had been a big push to try and fix every
known bug before the release. Naturally, that hadn't actually
happened. (This is not unique to Netscape or to 4.0; the same thing
has happened with every software project I've ever seen.) Anyway,
at the release party, T-shirts were handed out that said something
like "Netscape 4.0: Zarro Boogs". Just like the software, the
T-shirt had no known bugs. Uh-huh.
</P
><P
>
So, when you query for a list of bugs, and it gets no results,
you can think of this as a friendly reminder. Of *course* there are
bugs matching your query, they just aren't in the bugsystem yet...
</P
></TD
><TD
WIDTH=
"10%"
VALIGN=
"TOP"
>
</TD
></TR
><TR
><TD
COLSPAN=
"2"
ALIGN=
"RIGHT"
VALIGN=
"TOP"
>
--
<SPAN
CLASS=
"attribution"
>
Terry Weissman
</SPAN
></TD
><TD
WIDTH=
"10%"
>
</TD
></TR
></TABLE
></DD
></DL
></DIV
...
...
docs/html/administration.html
View file @
d09b99cd
...
...
@@ -180,22 +180,22 @@ HREF="cust-templates.html"
><DL
><DT
>
5.7.1.
<A
HREF=
"cust-templates.html#AEN14
43
"
HREF=
"cust-templates.html#AEN14
25
"
>
What to Edit
</A
></DT
><DT
>
5.7.2.
<A
HREF=
"cust-templates.html#AEN14
62
"
HREF=
"cust-templates.html#AEN14
44
"
>
How To Edit Templates
</A
></DT
><DT
>
5.7.3.
<A
HREF=
"cust-templates.html#AEN14
72
"
HREF=
"cust-templates.html#AEN14
54
"
>
Template Formats
</A
></DT
><DT
>
5.7.4.
<A
HREF=
"cust-templates.html#AEN14
85
"
HREF=
"cust-templates.html#AEN14
67
"
>
Particular Templates
</A
></DT
></DL
...
...
docs/html/cust-templates.html
View file @
d09b99cd
...
...
@@ -99,7 +99,7 @@ CLASS="section"
><H2
CLASS=
"section"
><A
NAME=
"AEN14
43
"
NAME=
"AEN14
25
"
></A
>
5.7.1. What to Edit
</H2
><P
...
...
@@ -214,7 +214,7 @@ CLASS="section"
><H2
CLASS=
"section"
><A
NAME=
"AEN14
62
"
NAME=
"AEN14
44
"
></A
>
5.7.2. How To Edit Templates
</H2
><P
...
...
@@ -296,7 +296,7 @@ CLASS="section"
><H2
CLASS=
"section"
><A
NAME=
"AEN14
72
"
NAME=
"AEN14
54
"
></A
>
5.7.3. Template Formats
</H2
><P
...
...
@@ -358,7 +358,7 @@ CLASS="section"
><H2
CLASS=
"section"
><A
NAME=
"AEN14
85
"
NAME=
"AEN14
67
"
></A
>
5.7.4. Particular Templates
</H2
><P
...
...
docs/html/dbdoc.html
View file @
d09b99cd
...
...
@@ -135,7 +135,7 @@ CLASS="section"
><H2
CLASS=
"section"
><A
NAME=
"AEN209
9
"
NAME=
"AEN209
1
"
></A
>
B.2.1. Bugzilla Database Basics
</H2
><P
...
...
@@ -251,7 +251,7 @@ CLASS="section"
><H3
CLASS=
"section"
><A
NAME=
"AEN21
26
"
NAME=
"AEN21
18
"
></A
>
B.2.1.1. Bugzilla Database Tables
</H3
><P
...
...
docs/html/extraconfig.html
View file @
d09b99cd
...
...
@@ -81,7 +81,7 @@ CLASS="section"
><H2
CLASS=
"section"
><A
NAME=
"AEN
719
"
NAME=
"AEN
687
"
></A
>
4.2.1. Dependency Charts
</H2
><P
...
...
@@ -145,7 +145,7 @@ CLASS="section"
><H2
CLASS=
"section"
><A
NAME=
"AEN7
34
"
NAME=
"AEN7
02
"
></A
>
4.2.2. Bug Graphs
</H2
><P
...
...
@@ -204,7 +204,7 @@ CLASS="section"
><H2
CLASS=
"section"
><A
NAME=
"AEN7
47
"
NAME=
"AEN7
15
"
></A
>
4.2.3. The Whining Cron
</H2
><P
...
...
docs/html/faq.html
View file @
d09b99cd
...
...
@@ -138,12 +138,24 @@ HREF="faq.html#faq-general-mysql"
><DT
>
A.1.9.
<A
HREF=
"faq.html#faq-general-bonsaitools"
>
Why do the scripts say "/usr/bonsaitools/bin/perl" instead of
"/usr/bin/perl" or something else?
>
What is
<TT
CLASS=
"filename"
>
/usr/bonsaitools/bin/perl
</TT
>
?
</A
></DT
><DT
>
A.1.10.
<A
HREF=
"faq.html#faq-general-perlpath"
>
My perl is not located at
<TT
CLASS=
"filename"
>
/usr/bin/perl
</TT
>
, is
there an easy way to change it everywhere it needs to be changed?
</A
></DT
><DT
>
A.1.11.
<A
HREF=
"faq.html#faq-general-cookie"
>
Is there an easy way to change the Bugzilla cookie name?
</A
...
...
@@ -925,8 +937,10 @@ NAME="faq-general-bonsaitools"
><B
>
A.1.9.
</B
>
Why do the scripts say "/usr/bonsaitools/bin/perl" instead of
"/usr/bin/perl" or something else?
What is
<TT
CLASS=
"filename"
>
/usr/bonsaitools/bin/perl
</TT
>
?
</P
></DIV
><DIV
...
...
@@ -935,16 +949,72 @@ CLASS="answer"
><B
>
</B
>
Mozilla.org uses /usr/bonsaitools/bin/perl, because originally
Terry wanted a place to put a version of Perl and other tools
that was strictly under his control.
</P
Bugzilla used to have the path to perl on the shebang line set to
<TT
CLASS=
"filename"
>
/usr/bonsaitools/bin/perl
</TT
>
because when
Terry first started writing the code for mozilla.org he needed a
version of Perl and other tools that were completely under his
control. This location was abandoned for the 2.18 release in favor
of the more sensible
<TT
CLASS=
"filename"
>
/usr/bin/perl
</TT
>
. If you
installed an older verion of Bugzilla and created the symlink we
suggested, you can remove it now (provided that you don't have
anything else, such as Bonsai, using it and you don't intend to
reinstall an older version of Bugzilla).
</P
></DIV
></DIV
><DIV
CLASS=
"qandaentry"
><DIV
CLASS=
"question"
><P
>
We always recommend that, if possible, you keep the path
as /usr/bonsaitools/bin/perl, and simply add symlink.
This will make upgrading
your Bugzilla much easier in the future.
</P
><A
NAME=
"faq-general-perlpath"
></A
><B
>
A.1.10.
</B
>
My perl is not located at
<TT
CLASS=
"filename"
>
/usr/bin/perl
</TT
>
, is
there an easy way to change it everywhere it needs to be changed?
</P
></DIV
><DIV
CLASS=
"answer"
><P
><B
>
</B
>
Yes, the following bit of perl magic will change all the shebang
lines. Be sure to change
<TT
CLASS=
"filename"
>
/usr/local/bin/perl
</TT
>
to your path to the perl binary.
</P
><TABLE
BORDER=
"0"
BGCOLOR=
"#E0E0E0"
WIDTH=
"100%"
><TR
><TD
><FONT
COLOR=
"#000000"
><PRE
CLASS=
"programlisting"
>
perl -pi -e 's@#\!/usr/bin/perl@#\!/usr/local/bin/perl@' *cgi *pl
</PRE
></FONT
></TD
></TR
></TABLE
></DIV
></DIV
><DIV
...
...
@@ -956,7 +1026,7 @@ CLASS="question"
NAME=
"faq-general-cookie"
></A
><B
>
A.1.1
0
.
</B
>
A.1.1
1
.
</B
>
Is there an easy way to change the Bugzilla cookie name?
</P
...
...
@@ -1370,12 +1440,12 @@ CLASS="computeroutput"
CLASS=
"filename"
>
importxml.pl
</TT
>
which is intended to be
used for importing the data generated by
<TT
used for importing the data generated by the XML ctype of
<TT
CLASS=
"filename"
>
xml.cgi
</TT
>
in association with bug moving. Any other use is left as an
exercise for the user.
>
show_bug.cgi
</TT
>
in association with bug moving.
Any other use is left as an exercise for the user.
</P
><P
>
There are also scripts included in the
<TT
...
...
@@ -1411,9 +1481,9 @@ CLASS="answer"
>
Yes. For more information including available translated templates,
see
<A
HREF=
"http://www.bugzilla.org/download.html"
HREF=
"http://www.bugzilla.org/download.html
#localizations
"
TARGET=
"_top"
>
http://www.bugzilla.org/download.html
</A
>
http://www.bugzilla.org/download.html
#localizations
</A
>
.
The admin interfaces are still not included in these translated
templates and is therefore still English only. Also, there may be
...
...
@@ -1833,13 +1903,14 @@ CLASS="answer"
>
</B
>
Try Klaas Freitag's excellent patch for "whineatassigned" functionality.
You can find it at
<A
HREF=
"
http://bugzilla.mozilla.org/show_bug.cgi?id=6679"
You can find it at
<A
HREF=
"http://bugzilla.mozilla.org/show_bug.cgi?id=6679"
TARGET=
"_top"
>
http://bugzilla.mozilla.org/show_bug.cgi?id=6679
</A
>
http://bugzilla.mozilla.org/show_bug.cgi?id=6679
</A
>
. This
patch is against an older version of Bugzilla, so you must apply
the diffs manually.
</P
></DIV
></DIV
...
...
@@ -1867,7 +1938,7 @@ CLASS="answer"
You can call bug_email.pl directly from your aliases file, with
an entry like this:
<A
NAME=
"AEN18
94
"
NAME=
"AEN18
86
"
></A
><BLOCKQUOTE
CLASS=
"BLOCKQUOTE"
...
...
@@ -2311,7 +2382,7 @@ CLASS="answer"
><P
>
Microsoft has some advice on this matter, as well:
<A
NAME=
"AEN19
77
"
NAME=
"AEN19
69
"
></A
><BLOCKQUOTE
CLASS=
"BLOCKQUOTE"
...
...
@@ -2670,7 +2741,7 @@ TARGET="_top"
This list includes bugs for the 2.18 release that have already
been fixed and checked into CVS. Please consult the
<A
HREF=
"http://www.
mozilla.org/projects/bugzilla
/"
HREF=
"http://www.
bugzilla.org
/"
TARGET=
"_top"
>
Bugzilla Project Page
</A
>
for details on how to
...
...
docs/html/gfdl-howto.html
View file @
d09b99cd
...
...
@@ -81,7 +81,7 @@ NAME="gfdl-howto"
of the License in the document and put the following copyright and
license notices just after the title page:
</P
><A
NAME=
"AEN2
304
"
NAME=
"AEN2
296
"
></A
><BLOCKQUOTE
CLASS=
"BLOCKQUOTE"
...
...
docs/html/gfdl.html
View file @
d09b99cd
...
...
@@ -144,7 +144,7 @@ HREF="gfdl-howto.html"
><P
>
Version 1.1, March 2000
</P
><A
NAME=
"AEN22
14
"
NAME=
"AEN22
06
"
></A
><BLOCKQUOTE
CLASS=
"BLOCKQUOTE"
...
...
docs/html/glossary.html
View file @
d09b99cd
...
...
@@ -70,7 +70,7 @@ CLASS="glossdiv"
><H1
CLASS=
"glossdiv"
><A
NAME=
"AEN230
9
"
NAME=
"AEN230
1
"
></A
>
0-9, high ascii
</H1
><DL
...
...
@@ -312,7 +312,7 @@ CLASS="glossdiv"
><A
NAME=
"gloss-c"
></A
></H1
>
C
</H1
><DL
><DT
><A
...
...
@@ -541,22 +541,52 @@ TARGET="_top"
</P
><P
></P
><UL
><LI
><DIV
CLASS=
"variablelist"
><DL
><DT
><A
HREF=
"http://www.mysql.com/doc/en/Backup.html"
TARGET=
"_top"
>
Backup
</A
></DT
><DD
><P
>
Methods for backing up your Bugzilla database.
</P
></DD
><DT
><A
HREF=
"http://www.mysql.com/doc/
P/r/Privilege_system
.html"
HREF=
"http://www.mysql.com/doc/
en/Option_files
.html"
TARGET=
"_top"
>
MySQL
Privilege System
</A
>
- Much more detailed information about
the suggestions in
<A
>
Option Files
</A
></DT
><DD
><P
>
Information about how to configure MySQL using
<TT
CLASS=
"filename"
>
my.cnf
</TT
>
.
</P
></DD
><DT
><A
HREF=
"http://www.mysql.com/doc/en/Privilege_system.html"
TARGET=
"_top"
>
Privilege System
</A
></DT
><DD
><P
>
Much more detailed information about the suggestions in
<A
HREF=
"security.html#security-mysql"
>
Section 5.6.2
</A
>
.
</P
></LI
></UL
</P
></DD
></DL
></DIV
></DD
></DL
></DIV
...
...
@@ -807,16 +837,70 @@ NAME="gloss-z"
><DL
><DT
><A
NAME=
"
zarro-boogs-found
"
NAME=
"
gloss-zarro
"
></A
><B
>
Zarro Boogs Found
</B
></DT
><DD
><P
>
This is the cryptic response sent by Bugzilla when a query
returned no results. It is just a goofy way of saying "Zero Bugs
Found".
</P
>
This is just a goofy way of saying that there were no bugs
found matching your query. When asked to explain this message,
Terry had the following to say:
</P
><A
NAME=
"AEN2515"
></A
><TABLE
BORDER=
"0"
WIDTH=
"100%"
CELLSPACING=
"0"
CELLPADDING=
"0"
CLASS=
"BLOCKQUOTE"
><TR
><TD
WIDTH=
"10%"
VALIGN=
"TOP"
>
</TD
><TD
WIDTH=
"80%"
VALIGN=
"TOP"
><P
>
I've been asked to explain this ... way back when, when
Netscape released version 4.0 of its browser, we had a release
party. Naturally, there had been a big push to try and fix every
known bug before the release. Naturally, that hadn't actually
happened. (This is not unique to Netscape or to 4.0; the same thing
has happened with every software project I've ever seen.) Anyway,
at the release party, T-shirts were handed out that said something
like "Netscape 4.0: Zarro Boogs". Just like the software, the
T-shirt had no known bugs. Uh-huh.
</P
><P
>
So, when you query for a list of bugs, and it gets no results,
you can think of this as a friendly reminder. Of *course* there are
bugs matching your query, they just aren't in the bugsystem yet...
</P
></TD
><TD
WIDTH=
"10%"
VALIGN=
"TOP"
>
</TD
></TR
><TR
><TD
COLSPAN=
"2"
ALIGN=
"RIGHT"
VALIGN=
"TOP"
>
--
<SPAN
CLASS=
"attribution"
>
Terry Weissman
</SPAN
></TD
><TD
WIDTH=
"10%"
>
</TD
></TR
></TABLE
></DD
></DL
></DIV
...
...
docs/html/index.html
View file @
d09b99cd
...
...
@@ -64,7 +64,7 @@ CLASS="corpauthor"
>
The Bugzilla Team
</H3
><P
CLASS=
"pubdate"
>
2003-0
2-16
<BR></P
>
2003-0
4-23
<BR></P
><DIV
><DIV
CLASS=
"abstract"
...
...
@@ -83,7 +83,7 @@ NAME="AEN14"
><P
>
This documentation is maintained in DocBook 4.1.2 XML format.
Changes are best submitted as plain text or
SG
ML diffs, attached
Changes are best submitted as plain text or
X
ML diffs, attached
to a bug filed in the
<A
HREF=
"http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla&component=Documentation"
TARGET=
"_top"
...
...
@@ -447,6 +447,26 @@ CLASS="LOT"
CLASS=
"LOT"
><DT
><B
>
List of Figures
</B
></DT
><DT
>
4-1.
<A
HREF=
"troubleshooting.html#trouble-filetemp-errors"
>
Other File::Temp error messages
</A
></DT
><DT
>
4-2.
<A
HREF=
"troubleshooting.html#trouble-filetemp-patch"
>
Patch for File::Temp in Perl 5.6.0
</A
></DT
></DL
></DIV
><DIV
CLASS=
"LOT"
><DL
CLASS=
"LOT"
><DT
><B
>
List of Examples
</B
></DT
><DT
...
...
docs/html/installation.html
View file @
d09b99cd
...
...
@@ -118,17 +118,17 @@ HREF="stepbystep.html#sbs-http"
></DT
><DT
>
4.1.7.
<A
HREF=
"stepbystep.html#AEN6
2
0"
HREF=
"stepbystep.html#AEN6
0
0"
>
Bugzilla
</A
></DT
><DT
>
4.1.8.
<A
HREF=
"stepbystep.html#AEN6
45
"
HREF=
"stepbystep.html#AEN6
11
"
>
Setting Up the MySQL Database
</A
></DT
><DT
>
4.1.9.
<A
HREF=
"stepbystep.html#AEN6
81
"
HREF=
"stepbystep.html#AEN6
49
"
><TT
CLASS=
"filename"
>
checksetup.pl
</TT
...
...
@@ -136,7 +136,7 @@ CLASS="filename"
></DT
><DT
>
4.1.10.
<A
HREF=
"stepbystep.html#AEN
713
"
HREF=
"stepbystep.html#AEN
681
"
>
Configuring Bugzilla
</A
></DT
></DL
...
...
@@ -150,17 +150,17 @@ HREF="extraconfig.html"
><DL
><DT
>
4.2.1.
<A
HREF=
"extraconfig.html#AEN
719
"
HREF=
"extraconfig.html#AEN
687
"
>
Dependency Charts
</A
></DT
><DT
>
4.2.2.
<A
HREF=
"extraconfig.html#AEN7
34
"
HREF=
"extraconfig.html#AEN7
02
"
>
Bug Graphs
</A
></DT
><DT
>
4.2.3.
<A
HREF=
"extraconfig.html#AEN7
47
"
HREF=
"extraconfig.html#AEN7
15
"
>
The Whining Cron
</A
></DT
><DT
...
...
@@ -222,6 +222,11 @@ CLASS="productname"
>
Mac OS X
</SPAN
></A
></DT
><DT
>
4.3.3.
<A
HREF=
"os-specific.html#os-mandrake"
>
Linux-Mandrake 8.0
</A
></DT
></DL
></DD
><DT
...
...
@@ -263,12 +268,12 @@ HREF="troubleshooting.html"
><DL
><DT
>
4.5.1.
<A
HREF=
"troubleshooting.html#AEN
1009
"
HREF=
"troubleshooting.html#AEN
977
"
>
Bundle::Bugzilla makes me upgrade to Perl 5.6.1
</A
></DT
><DT
>
4.5.2.
<A
HREF=
"troubleshooting.html#AEN
1014
"
HREF=
"troubleshooting.html#AEN
982
"
>
DBD::Sponge::db prepare failed
</A
></DT
><DT
...
...
@@ -276,6 +281,11 @@ HREF="troubleshooting.html#AEN1014"
HREF=
"troubleshooting.html#paranoid-security"
>
cannot chdir(/var/spool/mqueue)
</A
></DT
><DT
>
4.5.4.
<A
HREF=
"troubleshooting.html#trouble-filetemp"
>
Your vendor has not defined Fcntl macro O_NOINHERIT
</A
></DT
></DL
></DD
></DL
...
...
docs/html/os-specific.html
View file @
d09b99cd
...
...
@@ -353,150 +353,6 @@ CLASS="programlisting"
></TR
></TABLE
></DIV
><DIV
CLASS=
"section"
><H4
CLASS=
"section"
><A
NAME=
"AEN863"
></A
>
4.3.1.3.2. System Calls
</H4
><P
>
In order to get system calls to work on win32's perl, you need
to tell the windows shell what interpreter to use. This is done by
changing the
<TT
CLASS=
"function"
>
system
</TT
>
calls. You will need to
search all of Bugzilla's code for
<TT
CLASS=
"function"
>
system
</TT
>
calls.
To tell perl your interpreter, it needs to be the first argument to
the
<TT
CLASS=
"function"
>
system
</TT
>
call. For example, you'll need to
change:
</P
><TABLE
BORDER=
"0"
BGCOLOR=
"#E0E0E0"
WIDTH=
"100%"
><TR
><TD
><FONT
COLOR=
"#000000"
><PRE
CLASS=
"programlisting"
>
system("$webdotbase","-Tpng","-o","$pngfilename","$filename");
</PRE
></FONT
></TD
></TR
></TABLE
><P
>
with
</P
><TABLE
BORDER=
"0"
BGCOLOR=
"#E0E0E0"
WIDTH=
"100%"
><TR
><TD
><FONT
COLOR=
"#000000"
><PRE
CLASS=
"programlisting"
>
system("C:\\perl\\bin\\perl", "$webdotbase","-Tpng","-o","$pngfilename","$filename");
</PRE
></FONT
></TD
></TR
></TABLE
><DIV
CLASS=
"tip"
><P
></P
><TABLE
CLASS=
"tip"
WIDTH=
"100%"
BORDER=
"0"
><TR
><TD
WIDTH=
"25"
ALIGN=
"CENTER"
VALIGN=
"TOP"
><IMG
SRC=
"../images/tip.gif"
HSPACE=
"5"
ALT=
"Tip"
></TD
><TD
ALIGN=
"LEFT"
VALIGN=
"TOP"
><P
>
The
<B
CLASS=
"command"
>
grep
</B
>
command is very helpful in finding
these
<TT
CLASS=
"function"
>
system
</TT
>
calls, assuming you have the
<SPAN
CLASS=
"productname"
>
cygwin
</SPAN
>
utilities.
</P
></TD
></TR
></TABLE
></DIV
><DIV
CLASS=
"note"
><P
></P
><TABLE
CLASS=
"note"
WIDTH=
"100%"
BORDER=
"0"
><TR
><TD
WIDTH=
"25"
ALIGN=
"CENTER"
VALIGN=
"TOP"
><IMG
SRC=
"../images/note.gif"
HSPACE=
"5"
ALT=
"Note"
></TD
><TD
ALIGN=
"LEFT"
VALIGN=
"TOP"
><P
>
It appears that the only
<TT
CLASS=
"function"
>
system
</TT
>
call
remaining in the Bugzilla codebase is in
<TT
CLASS=
"filename"
>
showdependencygraph.cgi
</TT
>
. Not changing this
file will only cause dependency graphs to not function if the
<TT
CLASS=
"option"
>
webdotbase
</TT
>
paramater points to a local
installation of
<A
HREF=
"http://www.graphviz.org"
TARGET=
"_top"
>
GraphViz
</A
>
.
</P
></TD
></TR
></TABLE
></DIV
></DIV
></DIV
><DIV
CLASS=
"section"
...
...
@@ -550,7 +406,7 @@ TARGET="_top"
to modify the first line of every script to contain your path to
perl instead of
<TT
CLASS=
"filename"
>
/usr/b
onsaitools/b
in/perl
</TT
>
/usr/bin/perl
</TT
>
.
</P
></TD
...
...
@@ -623,7 +479,7 @@ CLASS="command"
This should go through the motions of downloading the latest version of
the GD module, then it will open a shell and drop you into the build
directory. Apply
<A
HREF=
"../
sg
ml/gd-makefile.patch"
HREF=
"../
x
ml/gd-makefile.patch"
TARGET=
"_top"
>
this patch
</A
>
...
...
@@ -691,6 +547,105 @@ CLASS="command"
>
</P
></DIV
><DIV
CLASS=
"section"
><H2
CLASS=
"section"
><A
NAME=
"os-mandrake"
></A
>
4.3.3. Linux-Mandrake 8.0
</H2
><P
>
Linux-Mandrake 8.0 includes every required and optional library
for Bugzilla. The easiest way to install them is by using the
<B
CLASS=
"command"
>
urpmi
</B
>
utility. If you follow these commands, you
should have everything you need for Bugzilla, and
<B
CLASS=
"command"
>
./checksetup.pl
</B
>
should not complain about any
missing libraries. You may already have some of these installed.
</P
><TABLE
BORDER=
"0"
BGCOLOR=
"#E0E0E0"
WIDTH=
"100%"
><TR
><TD
><FONT
COLOR=
"#000000"
><PRE
CLASS=
"screen"
>
<TT
CLASS=
"prompt"
>
bash#
</TT
>
<B
CLASS=
"command"
>
urpmi perl-mysql
</B
>
<TT
CLASS=
"prompt"
>
bash#
</TT
>
<B
CLASS=
"command"
>
urpmi perl-chart
</B
>
<TT
CLASS=
"prompt"
>
bash#
</TT
>
<B
CLASS=
"command"
>
urpmi perl-gd
</B
>
<TT
CLASS=
"prompt"
>
bash#
</TT
>
<B
CLASS=
"command"
>
urpmi perl-MailTools
</B
>
<A
NAME=
"test-mailtools"
><IMG
SRC=
"../images/callouts/1.gif"
HSPACE=
"0"
VSPACE=
"0"
BORDER=
"0"
ALT=
"(1)"
></A
>
<TT
CLASS=
"prompt"
>
bash#
</TT
>
<B
CLASS=
"command"
>
urpmi apache-modules
</B
>
</PRE
></FONT
></TD
></TR
></TABLE
><DIV
CLASS=
"calloutlist"
><DL
COMPACT=
"COMPACT"
><DT
><A
HREF=
"os-specific.html#test-mailtools"
><IMG
SRC=
"../images/callouts/1.gif"
HSPACE=
"0"
VSPACE=
"0"
BORDER=
"0"
ALT=
"(1)"
></A
></DT
><DD
>
for Bugzilla e-mail integration
</DD
></DL
></DIV
></DIV
></DIV
><DIV
CLASS=
"NAVFOOTER"
...
...
docs/html/stepbystep.html
View file @
d09b99cd
...
...
@@ -265,7 +265,7 @@ TARGET="_top"
>
Date::Parse
</A
>
(
any
)
(
2.21
)
</P
></LI
><LI
...
...
@@ -383,124 +383,6 @@ VALIGN="TOP"
></DIV
>
<DIV
CLASS=
"note"
><P
></P
><TABLE
CLASS=
"note"
WIDTH=
"100%"
BORDER=
"0"
><TR
><TD
WIDTH=
"25"
ALIGN=
"CENTER"
VALIGN=
"TOP"
><IMG
SRC=
"../images/note.gif"
HSPACE=
"5"
ALT=
"Note"
></TD
><TD
ALIGN=
"LEFT"
VALIGN=
"TOP"
><P
>
Linux-Mandrake 8.0 includes every
required and optional library for Bugzilla. The easiest way to
install them is by using the
<TT
CLASS=
"filename"
>
urpmi
</TT
>
utility. If you follow these commands, you should have everything you
need for Bugzilla, and
<TT
CLASS=
"filename"
>
checksetup.pl
</TT
>
should not complain about any missing libraries. You may already have
some of these installed.
</P
><P
></P
><TABLE
BORDER=
"0"
><TBODY
><TR
><TD
>
<TT
CLASS=
"prompt"
>
bash#
</TT
>
<B
CLASS=
"command"
>
urpmi perl-mysql
</B
>
</TD
></TR
><TR
><TD
>
<TT
CLASS=
"prompt"
>
bash#
</TT
>
<B
CLASS=
"command"
>
urpmi perl-chart
</B
>
</TD
></TR
><TR
><TD
>
<TT
CLASS=
"prompt"
>
bash#
</TT
>
<B
CLASS=
"command"
>
urpmi perl-gd
</B
>
</TD
></TR
><TR
><TD
>
<TT
CLASS=
"prompt"
>
bash#
</TT
>
<B
CLASS=
"command"
>
urpmi perl-MailTools
</B
>
(for Bugzilla email integration)
</TD
></TR
><TR
><TD
>
<TT
CLASS=
"prompt"
>
bash#
</TT
>
<B
CLASS=
"command"
>
urpmi apache-modules
</B
>
</TD
></TR
></TBODY
></TABLE
><P
></P
></TD
></TR
></TABLE
></DIV
>
</P
></DIV
><DIV
...
...
@@ -863,7 +745,7 @@ CLASS="section"
><H3
CLASS=
"section"
><A
NAME=
"AEN5
8
6"
NAME=
"AEN5
6
6"
></A
>
4.1.5.1. DBI
</H3
><P
...
...
@@ -878,7 +760,7 @@ CLASS="section"
><H3
CLASS=
"section"
><A
NAME=
"AEN5
8
9"
NAME=
"AEN5
6
9"
></A
>
4.1.5.2. Data::Dumper
</H3
><P
...
...
@@ -892,7 +774,7 @@ CLASS="section"
><H3
CLASS=
"section"
><A
NAME=
"AEN5
9
2"
NAME=
"AEN5
7
2"
></A
>
4.1.5.3. MySQL-related modules
</H3
><P
...
...
@@ -918,7 +800,7 @@ CLASS="section"
><H3
CLASS=
"section"
><A
NAME=
"AEN5
9
7"
NAME=
"AEN5
7
7"
></A
>
4.1.5.4. TimeDate modules
</H3
><P
...
...
@@ -934,7 +816,7 @@ CLASS="section"
><H3
CLASS=
"section"
><A
NAME=
"AEN
60
0"
NAME=
"AEN
58
0"
></A
>
4.1.5.5. GD (optional)
</H3
><P
...
...
@@ -989,7 +871,7 @@ CLASS="section"
><H3
CLASS=
"section"
><A
NAME=
"AEN
60
7"
NAME=
"AEN
58
7"
></A
>
4.1.5.6. Chart::Base (optional)
</H3
><P
...
...
@@ -1004,7 +886,7 @@ CLASS="section"
><H3
CLASS=
"section"
><A
NAME=
"AEN
61
0"
NAME=
"AEN
59
0"
></A
>
4.1.5.7. Template Toolkit
</H3
><P
...
...
@@ -1073,7 +955,7 @@ CLASS="section"
><H2
CLASS=
"section"
><A
NAME=
"AEN6
2
0"
NAME=
"AEN6
0
0"
></A
>
4.1.7. Bugzilla
</H2
><P
...
...
@@ -1138,112 +1020,13 @@ CLASS="filename"
>
checksetup.pl
</TT
>
script, which locks down your installation.
</P
><P
>
Lastly, you'll need to set up a symbolic link to
<TT
CLASS=
"filename"
>
/usr/bonsaitools/bin/perl
</TT
>
for the correct location of your Perl executable (probably
<TT
CLASS=
"filename"
>
/usr/bin/perl
</TT
>
).
Otherwise you must hack all the .cgi files to change where they look
for Perl. This can be done using the following Perl one-liner, but
I suggest using the symlink approach to avoid upgrade hassles.
</P
><DIV
CLASS=
"note"
><P
></P
><TABLE
CLASS=
"note"
WIDTH=
"100%"
BORDER=
"0"
><TR
><TD
WIDTH=
"25"
ALIGN=
"CENTER"
VALIGN=
"TOP"
><IMG
SRC=
"../images/note.gif"
HSPACE=
"5"
ALT=
"Note"
></TD
><TD
ALIGN=
"LEFT"
VALIGN=
"TOP"
><P
><SPAN
CLASS=
"QUOTE"
>
"Bonsaitools"
</SPAN
>
is the name Terry Weissman, the
original author of Bugzilla, created
for his suite of webtools at the time he created Bugzilla and several
other tools in use at mozilla.org. He created a directory,
<TT
CLASS=
"filename"
>
/usr/bonsaitools
</TT
>
to house his specific versions
of perl and other utilities. This usage is still current at
<A
HREF=
"http://bugzilla.mozilla.org/"
TARGET=
"_top"
>
bugzilla.mozilla.org
</A
>
,
but in general most other places do not use it. You can either edit
the paths at the start of each perl file to the correct location of
perl on your system, or simply bow to history and create a
<TT
CLASS=
"filename"
>
/usr/bonsaitools
</TT
>
and
<TT
CLASS=
"filename"
>
/usr/bonsaitools/bin
</TT
>
directory, placing a symlink to perl on your system
inside
<TT
CLASS=
"filename"
>
/usr/bonsaitools/bin
</TT
>
</P
></TD
></TR
></TABLE
></DIV
><P
>
<TABLE
BORDER=
"0"
BGCOLOR=
"#E0E0E0"
WIDTH=
"100%"
><TR
><TD
><FONT
COLOR=
"#000000"
><PRE
CLASS=
"programlisting"
>
perl -pi -e 's@#\!/usr/bonsaitools/bin/perl@#\!/usr/bin/perl@' *cgi *pl Bug.pm syncshadowdb
</PRE
></FONT
></TD
></TR
></TABLE
>
Change
<TT
CLASS=
"filename"
>
/usr/bin/perl
</TT
>
to match the location
of Perl on your machine.
</P
></DIV
><DIV
CLASS=
"section"
><H2
CLASS=
"section"
><A
NAME=
"AEN6
45
"
NAME=
"AEN6
11
"
></A
>
4.1.8. Setting Up the MySQL Database
</H2
><P
...
...
@@ -1410,13 +1193,41 @@ CLASS="command"
></P
>
</P
><DIV
CLASS=
"note"
><P
></P
><TABLE
CLASS=
"note"
WIDTH=
"100%"
BORDER=
"0"
><TR
><TD
WIDTH=
"25"
ALIGN=
"CENTER"
VALIGN=
"TOP"
><IMG
SRC=
"../images/note.gif"
HSPACE=
"5"
ALT=
"Note"
></TD
><TD
ALIGN=
"LEFT"
VALIGN=
"TOP"
><P
>
If you are using MySQL 4, the bugs user also needs to be granted
the LOCK TABLES and CREATE TEMPORARY TABLES permissions.
</P
></TD
></TR
></TABLE
></DIV
></DIV
><DIV
CLASS=
"section"
><H2
CLASS=
"section"
><A
NAME=
"AEN6
81
"
NAME=
"AEN6
49
"
></A
>
4.1.9.
<TT
CLASS=
"filename"
...
...
@@ -1569,7 +1380,7 @@ CLASS="section"
><H2
CLASS=
"section"
><A
NAME=
"AEN
713
"
NAME=
"AEN
681
"
></A
>
4.1.10. Configuring Bugzilla
</H2
><P
...
...
docs/html/troubleshooting.html
View file @
d09b99cd
...
...
@@ -85,7 +85,7 @@ CLASS="section"
><H2
CLASS=
"section"
><A
NAME=
"AEN
1009
"
NAME=
"AEN
977
"
></A
>
4.5.1. Bundle::Bugzilla makes me upgrade to Perl 5.6.1
</H2
><P
...
...
@@ -110,7 +110,7 @@ CLASS="section"
><H2
CLASS=
"section"
><A
NAME=
"AEN
1014
"
NAME=
"AEN
982
"
></A
>
4.5.2. DBD::Sponge::db prepare failed
</H2
><P
...
...
@@ -249,6 +249,116 @@ CLASS="filename"
as root to fix this problem.
</P
></DIV
><DIV
CLASS=
"section"
><H2
CLASS=
"section"
><A
NAME=
"trouble-filetemp"
></A
>
4.5.4. 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. Examples
can be found in
<A
HREF=
"troubleshooting.html#trouble-filetemp-errors"
>
Figure 4-1
</A
>
.
</P
><DIV
CLASS=
"figure"
><A
NAME=
"trouble-filetemp-errors"
></A
><P
><B
>
Figure 4-1. Other File::Temp error messages
</B
></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
></DIV
><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 patch in
<A
HREF=
"troubleshooting.html#trouble-filetemp-patch"
>
Figure 4-2
</A
>
. The patch is also
available as a
<A
HREF=
"../xml/filetemp.patch"
TARGET=
"_top"
>
patch file
</A
>
.
</P
><DIV
CLASS=
"figure"
><A
NAME=
"trouble-filetemp-patch"
></A
><P
><B
>
Figure 4-2. Patch for File::Temp in Perl 5.6.0
</B
></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
><DIV
CLASS=
"NAVFOOTER"
...
...
docs/txt/Bugzilla-Guide.txt
View file @
d09b99cd
...
...
@@ -7,7 +7,7 @@ Jacob Steenhagen
The Bugzilla Team
2003-0
2-16
2003-0
4-23
This is the documentation for Bugzilla, the mozilla.org bug-tracking
system. Bugzilla is an enterprise-class piece of software that powers
...
...
@@ -15,8 +15,8 @@ The Bugzilla Team
tracking millions of bugs.
This documentation is maintained in DocBook 4.1.2 XML format. Changes
are best submitted as plain text or
SGML diffs, attached to a bug
filed
in the Bugzilla Documentation compontent.
are best submitted as plain text or
XML diffs, attached to a bug filed
in the Bugzilla Documentation compontent.
This is a development version of this guide. Information in it is
subject to change before the 2.18 release of this guide (which will
...
...
@@ -101,6 +101,10 @@ The Bugzilla Team
Glossary
List of Figures
4-1. Other File::Temp error messages
4-2. Patch for File::Temp in Perl 5.6.0
List of Examples
4-1. .htaccess files for Apache
5-1. Upgrading using CVS
...
...
@@ -702,7 +706,7 @@ Chapter 4. Installation
f. Data::Dumper (any)
g. DBD::mysql (2.1010)
h. DBI (1.32)
i. Date::Parse (
any
)
i. Date::Parse (
2.21
)
j. CGI (2.88)
and, optionally:
a. GD (1.20) for bug charting
...
...
@@ -721,20 +725,6 @@ Chapter 4. Installation
Many installation steps require an active Internet connection to
complete, but you must take care to ensure that at no point is your
machine vulnerable to an attack.
Note
Linux-Mandrake 8.0 includes every required and optional library for
Bugzilla. The easiest way to install them is by using the urpmi
utility. If you follow these commands, you should have everything you
need for Bugzilla, and checksetup.pl should not complain about any
missing libraries. You may already have some of these installed.
bash# urpmi perl-mysql
bash# urpmi perl-chart
bash# urpmi perl-gd
bash# urpmi perl-MailTools (for Bugzilla email integration)
bash# urpmi apache-modules
_________________________________________________________________
4.1.3. MySQL
...
...
@@ -938,31 +928,6 @@ Chapter 4. Installation
directory writable by your webserver's user. This is a temporary step
until you run the post-install checksetup.pl script, which locks down
your installation.
Lastly, you'll need to set up a symbolic link to
/usr/bonsaitools/bin/perl for the correct location of your Perl
executable (probably /usr/bin/perl). Otherwise you must hack all the
.cgi files to change where they look for Perl. This can be done using
the following Perl one-liner, but I suggest using the symlink approach
to avoid upgrade hassles.
Note
"Bonsaitools" is the name Terry Weissman, the original author of
Bugzilla, created for his suite of webtools at the time he created
Bugzilla and several other tools in use at mozilla.org. He created a
directory, /usr/bonsaitools to house his specific versions of perl and
other utilities. This usage is still current at bugzilla.mozilla.org,
but in general most other places do not use it. You can either edit
the paths at the start of each perl file to the correct location of
perl on your system, or simply bow to history and create a
/usr/bonsaitools and /usr/bonsaitools/bin directory, placing a symlink
to perl on your system inside /usr/bonsaitools/bin
perl -pi -e 's@#\!/usr/bonsaitools/bin/perl@#\!/usr/bin/perl@' *cgi *pl Bug.pm
syncshadowdb
Change /usr/bin/perl to match the location of Perl on your machine.
_________________________________________________________________
4.1.8. Setting Up the MySQL Database
...
...
@@ -1001,6 +966,11 @@ syncshadowdb
ALTER,CREATE,DROP,REFERENCES ON bugs.* TO bugs@localhost IDENTIFIED BY
'<bugs_password>';
mysql> FLUSH PRIVILEGES;
Note
If you are using MySQL 4, the bugs user also needs to be granted the
LOCK TABLES and CREATE TEMPORARY TABLES permissions.
_________________________________________________________________
4.1.9. checksetup.pl
...
...
@@ -1307,32 +1277,6 @@ my $webservergid = getgrnam($my_webservergroup)
my $webservergid = '8'
_________________________________________________________________
4.3.1.3.2. System Calls
In order to get system calls to work on win32's perl, you need to tell
the windows shell what interpreter to use. This is done by changing
the system calls. You will need to search all of Bugzilla's code for
system calls. To tell perl your interpreter, it needs to be the first
argument to the system call. For example, you'll need to change:
system("$webdotbase","-Tpng","-o","$pngfilename","$filename");
with
system("C:\\perl\\bin\\perl", "$webdotbase","-Tpng","-o","$pngfilename","$filen
ame");
Tip
The grep command is very helpful in finding these system calls,
assuming you have the cygwin utilities.
Note
It appears that the only system call remaining in the Bugzilla
codebase is in showdependencygraph.cgi. Not changing this file will
only cause dependency graphs to not function if the webdotbase
paramater points to a local installation of GraphViz.
_________________________________________________________________
4.3.1.4. Serving the web pages
As is the case on Unix based systems, any web server should be able to
...
...
@@ -1346,7 +1290,7 @@ ame");
If using Apache on windows, you can set the ScriptInterpreterSource
directive in your Apache config, if you don't do this, you'll have to
modify the first line of every script to contain your path to perl
instead of /usr/b
onsaitools/b
in/perl.
instead of /usr/bin/perl.
_________________________________________________________________
4.3.2. Mac OS X
...
...
@@ -1390,6 +1334,23 @@ ame");
And don't forget to run exit to get back to CPAN.
_________________________________________________________________
4.3.3. Linux-Mandrake 8.0
Linux-Mandrake 8.0 includes every required and optional library for
Bugzilla. The easiest way to install them is by using the urpmi
utility. If you follow these commands, you should have everything you
need for Bugzilla, and ./checksetup.pl should not complain about any
missing libraries. You may already have some of these installed.
bash# urpmi perl-mysql
bash# urpmi perl-chart
bash# urpmi perl-gd
bash# urpmi perl-MailTools (1)
bash# urpmi apache-modules
(1)
for Bugzilla e-mail integration
_________________________________________________________________
4.4. HTTP Server Configuration
The Bugzilla Team recommends Apache when using Bugzilla, however, any
...
...
@@ -1602,6 +1563,47 @@ proc filter_deny { why } {
problem.
_________________________________________________________________
4.5.4. 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. Examples can be found in Figure 4-1.
Figure 4-1. Other File::Temp error messages
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 patch in Figure 4-2. The patch is also available as a patch file.
Figure 4-2. Patch for File::Temp in Perl 5.6.0
--- 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;
};
_________________________________________________________________
Chapter 5. Administering Bugzilla
5.1. Bugzilla Configuration
...
...
@@ -2662,10 +2664,11 @@ Appendix A. The Bugzilla FAQ
A.1.8. Why MySQL? I'm interested in seeing Bugzilla run on
Oracle/Sybase/Msql/PostgreSQL/MSSQL.
A.1.9. Why do the scripts say "/usr/bonsaitools/bin/perl" instead
of "/usr/bin/perl" or something else?
A.1.9. What is /usr/bonsaitools/bin/perl?
A.1.10. My perl is not located at /usr/bin/perl, is there an easy
way to change it everywhere it needs to be changed?
A.1.1
0
. Is there an easy way to change the Bugzilla cookie name?
A.1.1
1
. Is there an easy way to change the Bugzilla cookie name?
2. Managerial Questions
...
...
@@ -2926,18 +2929,27 @@ Appendix A. The Bugzilla FAQ
Once both of these are done, adding support for additional database
servers should be trivial.
A.1.9. Why do the scripts say "/usr/bonsaitools/bin/perl" instead of
"/usr/bin/perl" or something else?
A.1.9. What is /usr/bonsaitools/bin/perl?
Bugzilla used to have the path to perl on the shebang line set to
/usr/bonsaitools/bin/perl because when Terry first started writing the
code for mozilla.org he needed a version of Perl and other tools that
were completely under his control. This location was abandoned for the
2.18 release in favor of the more sensible /usr/bin/perl. If you
installed an older verion of Bugzilla and created the symlink we
suggested, you can remove it now (provided that you don't have
anything else, such as Bonsai, using it and you don't intend to
reinstall an older version of Bugzilla).
Mozilla.org uses /usr/bonsaitools/bin/perl, because originally Terry
wanted a place to put a version of Perl and other tools that was
strictly under his control.
A.1.10. My perl is not located at /usr/bin/perl, is there an easy way
to change it everywhere it needs to be changed?
We always recommend that, if possible, you keep the path as
/usr/bonsaitools/bin/perl, and simply add symlink. This will make
upgrading your Bugzilla much easier in the future.
Yes, the following bit of perl magic will change all the shebang
lines. Be sure to change /usr/local/bin/perl to your path to the perl
binary.
perl -pi -e 's@#\!/usr/bin/perl@#\!/usr/local/bin/perl@' *cgi *pl
A.1.1
0
. Is there an easy way to change the Bugzilla cookie name?
A.1.1
1
. Is there an easy way to change the Bugzilla cookie name?
At present, no.
...
...
@@ -3048,8 +3060,8 @@ Appendix A. The Bugzilla FAQ
Currently the only script included with Bugzilla that can import data
is importxml.pl which is intended to be used for importing the data
generated by
xml.cgi in association with bug moving. Any other use is
left as an exercise for the user.
generated by
the XML ctype of show_bug.cgi in association with bug
moving. Any other use is
left as an exercise for the user.
There are also scripts included in the contrib/ directory for using
e-mail to import information into Bugzilla, but these scripts are not
...
...
@@ -3059,10 +3071,10 @@ Appendix A. The Bugzilla FAQ
in other countries? Is it localizable?
Yes. For more information including available translated templates,
see http://www.bugzilla.org/download.html
. The admin interfaces are
still not included in these translated templates and is therefore
still English only. Also, there may be issues with the charset not
being declared. See bug 126226 for more information.
see http://www.bugzilla.org/download.html
#localizations. The admin
interfaces are still not included in these translated templates and is
therefore still English only. Also, there may be issues with the
charset not
being declared. See bug 126226 for more information.
A.2.13. Can a user create and save reports? Can they do this in Word
format? Excel format?
...
...
@@ -4337,6 +4349,8 @@ B
Bugzilla is the world-leading free software bug tracking
system.
C
Common Gateway Interface (CGI)
CGI is an acronym for Common Gateway Interface. This is a
standard for interfacing an external application with a web
...
...
@@ -4391,8 +4405,15 @@ M
familiarize yourself with all of the documentation, some high
points are:
+ MySQL Privilege System - Much more detailed information about
the suggestions in Section 5.6.2.
Backup
Methods for backing up your Bugzilla database.
Option Files
Information about how to configure MySQL using my.cnf.
Privilege System
Much more detailed information about the suggestions in
Section 5.6.2.
P
...
...
@@ -4459,6 +4480,22 @@ T
Z
Zarro Boogs Found
This is the cryptic response sent by Bugzilla when a query
returned no results. It is just a goofy way of saying "Zero
Bugs Found".
This is just a goofy way of saying that there were no bugs
found matching your query. When asked to explain this message,
Terry had the following to say:
I've been asked to explain this ... way back when, when Netscape
released version 4.0 of its browser, we had a release party.
Naturally, there had been a big push to try and fix every known bug
before the release. Naturally, that hadn't actually happened. (This is
not unique to Netscape or to 4.0; the same thing has happened with
every software project I've ever seen.) Anyway, at the release party,
T-shirts were handed out that said something like "Netscape 4.0: Zarro
Boogs". Just like the software, the T-shirt had no known bugs. Uh-huh.
So, when you query for a list of bugs, and it gets no results, you can
think of this as a friendly reminder. Of *course* there are bugs
matching your query, they just aren't in the bugsystem yet...
--Terry Weissman
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment
