summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/html/Bugzilla-Guide.html756
-rw-r--r--docs/html/faq.html457
-rw-r--r--docs/html/gfdl.html2
-rw-r--r--docs/html/gfdl_howto.html2
-rw-r--r--docs/html/glossary.html2
-rw-r--r--docs/html/how.html8
-rw-r--r--docs/html/index.html48
-rw-r--r--docs/html/installation.html22
-rw-r--r--docs/html/programadmin.html24
-rw-r--r--docs/html/readme.unix.html105
-rw-r--r--docs/html/readme.windows.html65
-rw-r--r--docs/html/rhbugzilla.html2
-rw-r--r--docs/html/security.html39
-rw-r--r--docs/html/setperl.html2
-rw-r--r--docs/sgml/Bugzilla-Guide.sgml2
-rw-r--r--docs/sgml/administration.sgml28
-rw-r--r--docs/sgml/faq.sgml48
-rw-r--r--docs/sgml/installation.sgml95
-rw-r--r--docs/txt/Bugzilla-Guide.txt282
-rw-r--r--docs/xml/Bugzilla-Guide.xml2
-rw-r--r--docs/xml/administration.xml28
-rw-r--r--docs/xml/faq.xml48
-rw-r--r--docs/xml/installation.xml95
23 files changed, 1544 insertions, 618 deletions
diff --git a/docs/html/Bugzilla-Guide.html b/docs/html/Bugzilla-Guide.html
index 0712a5146..809fd745e 100644
--- a/docs/html/Bugzilla-Guide.html
+++ b/docs/html/Bugzilla-Guide.html
@@ -306,37 +306,37 @@ HREF="#AEN334"
></DT
><DT
>2.1.2.14. <A
-HREF="#AEN343"
+HREF="#AEN347"
>Setting Up the MySQL Database</A
></DT
><DT
>2.1.2.15. <A
-HREF="#AEN379"
+HREF="#AEN383"
>Tweaking "localconfig"</A
></DT
><DT
>2.1.2.16. <A
-HREF="#AEN401"
->Setting Up Maintainers Manuall (Optional)</A
+HREF="#AEN410"
+>Setting Up Maintainers Manually (Optional)</A
></DT
><DT
>2.1.2.17. <A
-HREF="#AEN410"
+HREF="#AEN419"
>The Whining Cron (Optional)</A
></DT
><DT
>2.1.2.18. <A
-HREF="#AEN417"
+HREF="#AEN426"
>Bug Graphs (Optional)</A
></DT
><DT
>2.1.2.19. <A
-HREF="#AEN429"
+HREF="#AEN438"
>Securing MySQL</A
></DT
><DT
>2.1.2.20. <A
-HREF="#AEN495"
+HREF="#AEN504"
>Installation General Notes</A
></DT
></DL
@@ -806,57 +806,67 @@ CLASS="LOT"
></DT
><DT
>2-1. <A
-HREF="#AEN646"
+HREF="#AEN341"
+>Setting up bonsaitools symlink</A
+></DT
+><DT
+>2-2. <A
+HREF="#AEN403"
+>Running checksetup.pl as the web user</A
+></DT
+><DT
+>2-3. <A
+HREF="#AEN655"
>Removing encrypt() for Windows NT installations</A
></DT
><DT
>3-1. <A
-HREF="#AEN838"
+HREF="#AEN850"
>Creating some Components</A
></DT
><DT
>3-2. <A
-HREF="#AEN867"
+HREF="#AEN879"
>Common Use of Versions</A
></DT
><DT
>3-3. <A
-HREF="#AEN871"
+HREF="#AEN883"
>A Different Use of Versions</A
></DT
><DT
>3-4. <A
-HREF="#AEN899"
+HREF="#AEN911"
>Using SortKey with Target Milestone</A
></DT
><DT
>3-5. <A
-HREF="#AEN937"
+HREF="#AEN949"
>When to Use Group Security</A
></DT
><DT
>3-6. <A
-HREF="#AEN954"
+HREF="#AEN966"
>Creating a New Group</A
></DT
><DT
>4-1. <A
-HREF="#AEN1095"
+HREF="#AEN1112"
>Some Famous Software Versions</A
></DT
><DT
>4-2. <A
-HREF="#AEN1105"
+HREF="#AEN1122"
>Mozilla Webtools Components</A
></DT
><DT
>D-1. <A
-HREF="#AEN1963"
+HREF="#AEN1986"
>Using Setperl to set your perl path</A
></DT
><DT
>1. <A
-HREF="#AEN2145"
+HREF="#AEN2168"
>A Sample Product</A
></DT
></DL
@@ -2314,7 +2324,7 @@ CLASS="TIP"
><P
><B
>Tip: </B
-> HINT: If you symlink the bugzilla directory into your Apache's
+> If you symlink the bugzilla directory into your Apache's
HTML heirarchy, you may receive "Forbidden" errors unless you
add the "FollowSymLinks" directive to the &#60;Directory&#62; entry
for the HTML root.
@@ -2329,12 +2339,45 @@ CLASS="TIP"
installation.
</P
><P
-> Lastly, you'll need to set up a symbolic link from /usr/bonsaitools/bin
- to the correct location of your perl executable (probably /usr/bin/perl).
+> 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. To make future upgrades easier, you should use the symlink
approach.
<DIV
+CLASS="EXAMPLE"
+><A
+NAME="AEN341"
+></A
+><P
+><B
+>Example 2-1. Setting up bonsaitools symlink</B
+></P
+><P
+> Here's how you set up the Perl symlink on Linux to make Bugzilla work.
+ Your mileage may vary; if you are running on Solaris, you probably need to subsitute
+ "/usr/local/bin/perl" for "/usr/bin/perl" below; if on certain other UNIX systems,
+ Perl may live in weird places like "/opt/perl". As root, run these commands:
+ <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>bash# mkdir /usr/bonsaitools
+bash# mkdir /usr/bonsaitools/bin
+bash# ln -s /usr/bin/perl /usr/bosaitools/bin/perl
+ </PRE
+></TD
+></TR
+></TABLE
+>
+ </P
+></DIV
+>
+ <DIV
CLASS="TIP"
><BLOCKQUOTE
CLASS="TIP"
@@ -2356,7 +2399,7 @@ CLASS="SECTION"
><HR><H3
CLASS="SECTION"
><A
-NAME="AEN343"
+NAME="AEN347"
>2.1.2.14. Setting Up the MySQL Database</A
></H3
><P
@@ -2542,7 +2585,7 @@ CLASS="SECTION"
><HR><H3
CLASS="SECTION"
><A
-NAME="AEN379"
+NAME="AEN383"
>2.1.2.15. Tweaking "localconfig"</A
></H3
><P
@@ -2609,11 +2652,47 @@ CLASS="NOTE"
><P
><B
>Note: </B
-> The second time you run checksetup.pl, it is recommended you be the same
- user as your web server runs under, and that you be sure you have set the
+> The second time you run checksetup.pl, you should become the
+ user your web server runs as, and that you ensure you have set the
"webservergroup" parameter in localconfig to match the web server's group
- name, if any. Under some systems, otherwise, checksetup.pl will goof up
- your file permissions and make them unreadable to your web server.
+ name, if any. I believe, for the next release of Bugzilla, this will
+ be fixed so that Bugzilla supports a "webserveruser" parameter in localconfig
+ as well.
+ <DIV
+CLASS="EXAMPLE"
+><A
+NAME="AEN403"
+></A
+><P
+><B
+>Example 2-2. Running checksetup.pl as the web user</B
+></P
+><P
+> Assuming your web server runs as user "apache", and Bugzilla is installed in
+ "/usr/local/bugzilla", here's one way to run checksetup.pl as the web server user.
+ As root, for the <EM
+>second run</EM
+> of checksetup.pl, do this:
+ <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>bash# chown -R apache:apache /usr/local/bugzilla
+bash# su - apache
+bash# cd /usr/local/bugzilla
+bash# ./checksetup.pl
+ </PRE
+></TD
+></TR
+></TABLE
+>
+ </P
+></DIV
+>
</P
></BLOCKQUOTE
></DIV
@@ -2637,8 +2716,8 @@ CLASS="SECTION"
><HR><H3
CLASS="SECTION"
><A
-NAME="AEN401"
->2.1.2.16. Setting Up Maintainers Manuall (Optional)</A
+NAME="AEN410"
+>2.1.2.16. Setting Up Maintainers Manually (Optional)</A
></H3
><P
> If you want to add someone else to every group by hand, you can do it
@@ -2683,7 +2762,7 @@ CLASS="SECTION"
><HR><H3
CLASS="SECTION"
><A
-NAME="AEN410"
+NAME="AEN419"
>2.1.2.17. The Whining Cron (Optional)</A
></H3
><P
@@ -2721,7 +2800,7 @@ CLASS="SECTION"
><HR><H3
CLASS="SECTION"
><A
-NAME="AEN417"
+NAME="AEN426"
>2.1.2.18. Bug Graphs (Optional)</A
></H3
><P
@@ -2776,7 +2855,7 @@ CLASS="SECTION"
><HR><H3
CLASS="SECTION"
><A
-NAME="AEN429"
+NAME="AEN438"
>2.1.2.19. Securing MySQL</A
></H3
><P
@@ -3054,7 +3133,7 @@ CLASS="SECTION"
><HR><H3
CLASS="SECTION"
><A
-NAME="AEN495"
+NAME="AEN504"
>2.1.2.20. Installation General Notes</A
></H3
><DIV
@@ -3062,7 +3141,7 @@ CLASS="SECTION"
><H4
CLASS="SECTION"
><A
-NAME="AEN497"
+NAME="AEN506"
>2.1.2.20.1. Modifying Your Running System</A
></H4
><P
@@ -3089,7 +3168,7 @@ CLASS="SECTION"
><HR><H4
CLASS="SECTION"
><A
-NAME="AEN502"
+NAME="AEN511"
>2.1.2.20.2. Upgrading From Previous Versions</A
></H4
><P
@@ -3105,7 +3184,7 @@ CLASS="SECTION"
><HR><H4
CLASS="SECTION"
><A
-NAME="AEN505"
+NAME="AEN514"
>2.1.2.20.3. UNIX Installation Instructions History</A
></H4
><P
@@ -3581,7 +3660,7 @@ CLASS="TIP"
>Tip: </B
> From Andrew Pearson:
<A
-NAME="AEN624"
+NAME="AEN633"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -3628,7 +3707,7 @@ CLASS="TIP"
>Tip: </B
>"Brian" had this to add, about upgrading to Bugzilla 2.12 from previous versions:</P
><A
-NAME="AEN634"
+NAME="AEN643"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -3684,11 +3763,11 @@ CLASS="PROGRAMLISTING"
<DIV
CLASS="EXAMPLE"
><A
-NAME="AEN646"
+NAME="AEN655"
></A
><P
><B
->Example 2-1. Removing encrypt() for Windows NT installations</B
+>Example 2-3. Removing encrypt() for Windows NT installations</B
></P
><P
> Replace this:
@@ -3762,6 +3841,63 @@ open SENDMAIL, "|\"C:/General/Web/tools/Windmail 4.0 Beta/windmail\" -t &#62; ma
></BLOCKQUOTE
></BLOCKQUOTE
></DIV
+><DIV
+CLASS="TIP"
+><BLOCKQUOTE
+CLASS="TIP"
+><P
+><B
+>Tip: </B
+> This was some late breaking information from Jan Evert. Sorry for the lack of formatting.
+ </P
+><P
+CLASS="LITERALLAYOUT"
+>I'm&nbsp;busy&nbsp;installing&nbsp;bugzilla&nbsp;on&nbsp;a&nbsp;WinNT&nbsp;machine&nbsp;and&nbsp;I&nbsp;thought&nbsp;I'd&nbsp;notify&nbsp;you<br>
+at&nbsp;this&nbsp;moment&nbsp;of&nbsp;the&nbsp;commments&nbsp;I&nbsp;have&nbsp;to&nbsp;section&nbsp;2.2.1&nbsp;of&nbsp;the&nbsp;bugzilla<br>
+guide&nbsp;(at&nbsp;http://www.trilobyte.net/barnsons/html/).<br>
+<br>
+Step&nbsp;1:<br>
+I've&nbsp;used&nbsp;apache,&nbsp;installation&nbsp;is&nbsp;really&nbsp;straightforward.<br>
+After&nbsp;reading&nbsp;the&nbsp;Unix&nbsp;installation&nbsp;instructions,&nbsp;I&nbsp;found&nbsp;that&nbsp;it&nbsp;is<br>
+necessary&nbsp;to&nbsp;add&nbsp;the&nbsp;ExecCGI&nbsp;option&nbsp;to&nbsp;the&nbsp;bugzilla&nbsp;directory.&nbsp;Also&nbsp;the<br>
+'AddHandler'&nbsp;line&nbsp;for&nbsp;.cgi&nbsp;is&nbsp;by&nbsp;default&nbsp;commented&nbsp;out.<br>
+<br>
+Step&nbsp;3:&nbsp;although&nbsp;just&nbsp;a&nbsp;detail,&nbsp;'ppm&nbsp;install&nbsp;&#60;module%gt;'&nbsp;will&nbsp;also&nbsp;work<br>
+(wihtout&nbsp;.ppd).&nbsp;And,&nbsp;it&nbsp;can&nbsp;also&nbsp;download&nbsp;these&nbsp;automatically&nbsp;from<br>
+ActiveState.<br>
+<br>
+Step&nbsp;4:&nbsp;although&nbsp;I&nbsp;have&nbsp;cygwin&nbsp;installed,&nbsp;it&nbsp;seems&nbsp;that&nbsp;it&nbsp;is&nbsp;not&nbsp;necessary.<br>
+On&nbsp;my&nbsp;machine&nbsp;cygwin&nbsp;is&nbsp;not&nbsp;in&nbsp;the&nbsp;PATH&nbsp;and&nbsp;everything&nbsp;seems&nbsp;to&nbsp;work&nbsp;as<br>
+expected.<br>
+However,&nbsp;I've&nbsp;not&nbsp;used&nbsp;everything&nbsp;yet.<br>
+<br>
+Step&nbsp;6:&nbsp;the&nbsp;'bugs_password'&nbsp;given&nbsp;in&nbsp;SQL&nbsp;command&nbsp;d&nbsp;needs&nbsp;to&nbsp;be&nbsp;edited&nbsp;into<br>
+localconfig&nbsp;later&nbsp;on&nbsp;(Step&nbsp;7)&nbsp;if&nbsp;the&nbsp;password&nbsp;is&nbsp;not&nbsp;empty.&nbsp;I've&nbsp;also&nbsp;edited<br>
+it&nbsp;into&nbsp;globals.pl,&nbsp;but&nbsp;I'm&nbsp;not&nbsp;sure&nbsp;that&nbsp;is&nbsp;needed.&nbsp;In&nbsp;both&nbsp;places,&nbsp;the<br>
+variable&nbsp;is&nbsp;named&nbsp;db_pass.<br>
+<br>
+Step&nbsp;8:&nbsp;all&nbsp;the&nbsp;sendmail&nbsp;replacements&nbsp;mentioned&nbsp;are&nbsp;not&nbsp;as&nbsp;simple&nbsp;as<br>
+described&nbsp;there.&nbsp;Since&nbsp;I&nbsp;am&nbsp;not&nbsp;familiar&nbsp;(yet)&nbsp;with&nbsp;perl,&nbsp;I&nbsp;don't&nbsp;have&nbsp;any<br>
+mail&nbsp;working&nbsp;yet.<br>
+<br>
+Step&nbsp;9:&nbsp;in&nbsp;globals.pl&nbsp;the&nbsp;encrypt()&nbsp;call&nbsp;can&nbsp;be&nbsp;replaced&nbsp;by&nbsp;just&nbsp;the<br>
+unencrypted&nbsp;password.&nbsp;In&nbsp;CGI.pl,&nbsp;the&nbsp;complete&nbsp;SQL&nbsp;command&nbsp;can&nbsp;be&nbsp;removed.<br>
+<br>
+Step&nbsp;11:&nbsp;I've&nbsp;only&nbsp;changed&nbsp;the&nbsp;#!&nbsp;lines&nbsp;in&nbsp;*.cgi.&nbsp;I&nbsp;haven't&nbsp;noticed&nbsp;problems<br>
+with&nbsp;the&nbsp;system()&nbsp;call&nbsp;yet.<br>
+There&nbsp;seem&nbsp;to&nbsp;be&nbsp;only&nbsp;four&nbsp;system()&nbsp;called&nbsp;programs:&nbsp;processmail.pl&nbsp;(handled<br>
+by&nbsp;step&nbsp;10),&nbsp;syncshadowdb&nbsp;(which&nbsp;should&nbsp;probably&nbsp;get&nbsp;the&nbsp;same&nbsp;treatment&nbsp;as<br>
+processmail.pl),&nbsp;diff&nbsp;and&nbsp;mysqldump.&nbsp;The&nbsp;last&nbsp;one&nbsp;is&nbsp;only&nbsp;needed&nbsp;with&nbsp;the<br>
+shadowdb&nbsp;feature&nbsp;(which&nbsp;I&nbsp;don't&nbsp;use).<br>
+<br>
+There&nbsp;seems&nbsp;to&nbsp;be&nbsp;one&nbsp;step&nbsp;missing:&nbsp;copying&nbsp;the&nbsp;bugzilla&nbsp;files&nbsp;somehwere<br>
+that&nbsp;apache&nbsp;can&nbsp;serve&nbsp;them.<br>
+<br>
+Just&nbsp;noticed&nbsp;the&nbsp;updated&nbsp;guide...&nbsp;Brian's&nbsp;comment&nbsp;is&nbsp;new.&nbsp;His&nbsp;first&nbsp;comment<br>
+will&nbsp;work,&nbsp;but&nbsp;opens&nbsp;up&nbsp;a&nbsp;huge&nbsp;security&nbsp;hole.<br>
+ </P
+></BLOCKQUOTE
+></DIV
></DIV
></DIV
></DIV
@@ -4562,7 +4698,7 @@ NAME="COMPONENTS"
<DIV
CLASS="EXAMPLE"
><A
-NAME="AEN838"
+NAME="AEN850"
></A
><P
><B
@@ -4571,7 +4707,7 @@ NAME="AEN838"
><DIV
CLASS="INFORMALEXAMPLE"
><A
-NAME="AEN840"
+NAME="AEN852"
></A
><P
></P
@@ -4692,7 +4828,7 @@ NAME="VERSIONS"
<DIV
CLASS="EXAMPLE"
><A
-NAME="AEN867"
+NAME="AEN879"
></A
><P
><B
@@ -4701,7 +4837,7 @@ NAME="AEN867"
><DIV
CLASS="INFORMALEXAMPLE"
><A
-NAME="AEN869"
+NAME="AEN881"
></A
><P
></P
@@ -4722,7 +4858,7 @@ NAME="AEN869"
<DIV
CLASS="EXAMPLE"
><A
-NAME="AEN871"
+NAME="AEN883"
></A
><P
><B
@@ -4731,7 +4867,7 @@ NAME="AEN871"
><DIV
CLASS="INFORMALEXAMPLE"
><A
-NAME="AEN873"
+NAME="AEN885"
></A
><P
></P
@@ -4840,7 +4976,7 @@ TYPE="1"
><DIV
CLASS="EXAMPLE"
><A
-NAME="AEN899"
+NAME="AEN911"
></A
><P
><B
@@ -4849,7 +4985,7 @@ NAME="AEN899"
><DIV
CLASS="INFORMALEXAMPLE"
><A
-NAME="AEN901"
+NAME="AEN913"
></A
><P
></P
@@ -5013,7 +5149,7 @@ NAME="GROUPS"
<DIV
CLASS="EXAMPLE"
><A
-NAME="AEN937"
+NAME="AEN949"
></A
><P
><B
@@ -5022,7 +5158,7 @@ NAME="AEN937"
><DIV
CLASS="INFORMALEXAMPLE"
><A
-NAME="AEN939"
+NAME="AEN951"
></A
><P
></P
@@ -5115,7 +5251,7 @@ TYPE="1"
<DIV
CLASS="EXAMPLE"
><A
-NAME="AEN954"
+NAME="AEN966"
></A
><P
><B
@@ -5124,7 +5260,7 @@ NAME="AEN954"
><DIV
CLASS="INFORMALEXAMPLE"
><A
-NAME="AEN956"
+NAME="AEN968"
></A
><P
></P
@@ -5337,14 +5473,49 @@ TARGET="_top"
><LI
><P
> Ensure you have adequate access controls for the $BUGZILLA_HOME/data/ and
- $BUGZILLA_HOME/shadow/ directories, as well as the $BUGZILLA_HOME/localconfig file.
+ $BUGZILLA_HOME/shadow/ directories, as well as the $BUGZILLA_HOME/localconfig and
+ $BUGZILLA_HOME/globals.pl files.
The localconfig file stores your "bugs" user password,
which would be terrible to have in the hands
- of a criminal. Also some files under $BUGZILLA_HOME/data/ store sensitive information, and
+ of a criminal, while the "globals.pl" stores some default information regarding your
+ installation which could aid a system cracker.
+ In addition, some files under $BUGZILLA_HOME/data/ store sensitive information, and
$BUGZILLA_HOME/shadow/ stores bug information for faster retrieval. If you fail to secure
these directories and this file, you will expose bug information to those who may not
be allowed to see it.
</P
+><DIV
+CLASS="NOTE"
+><BLOCKQUOTE
+CLASS="NOTE"
+><P
+><B
+>Note: </B
+> Bugzilla provides default .htaccess files to protect the most common Apache
+ installations. However, you should verify these are adequate according to the site-wide
+ security policy of your web server, and ensure that the .htaccess files are
+ allowed to "override" default permissions set in your Apache configuration files.
+ Covering Apache security is beyond the scope of this Guide; please consult the Apache
+ documentation for details.
+ </P
+><P
+> If you are using a web server that does not support the .htaccess control method,
+ <EM
+>you are at risk!</EM
+> After installing, check to see if you can
+ view the file "localconfig" in your web browser (ergo:
+ <A
+HREF="http://bugzilla.mozilla.org/localconfig"
+TARGET="_top"
+> http://bugzilla.mozilla.org/localconfig</A
+>. If you can read the contents of this
+ file, your web server has not secured your bugzilla directory properly and you
+ must fix this problem before deploying Bugzilla. If, however, it gives you a
+ "Forbidden" error, then it probably respects the .htaccess conventions and you
+ are good to go.
+ </P
+></BLOCKQUOTE
+></DIV
><P
> On Apache, you can use .htaccess files to protect access to these directories, as outlined
in <A
@@ -5890,7 +6061,7 @@ TYPE="1"
<DIV
CLASS="EXAMPLE"
><A
-NAME="AEN1095"
+NAME="AEN1112"
></A
><P
><B
@@ -5899,7 +6070,7 @@ NAME="AEN1095"
><DIV
CLASS="INFORMALEXAMPLE"
><A
-NAME="AEN1097"
+NAME="AEN1114"
></A
><P
></P
@@ -5951,7 +6122,7 @@ NAME="AEN1097"
<DIV
CLASS="EXAMPLE"
><A
-NAME="AEN1105"
+NAME="AEN1122"
></A
><P
><B
@@ -5960,7 +6131,7 @@ NAME="AEN1105"
><DIV
CLASS="INFORMALEXAMPLE"
><A
-NAME="AEN1107"
+NAME="AEN1124"
></A
><P
></P
@@ -7175,63 +7346,63 @@ HREF="#FAQ_GENERAL"
><DL
><DT
>A.1.1. <A
-HREF="#AEN1302"
+HREF="#AEN1319"
> Where can I find information about Bugzilla?</A
></DT
><DT
>A.1.2. <A
-HREF="#AEN1308"
+HREF="#AEN1325"
> What license is Bugzilla distributed under?
</A
></DT
><DT
>A.1.3. <A
-HREF="#AEN1314"
+HREF="#AEN1331"
> How do I get commercial support for Bugzilla?
</A
></DT
><DT
>A.1.4. <A
-HREF="#AEN1321"
+HREF="#AEN1338"
> What major companies or projects are currently using Bugzilla
for bug-tracking?
</A
></DT
><DT
>A.1.5. <A
-HREF="#AEN1346"
+HREF="#AEN1363"
> Who maintains Bugzilla?
</A
></DT
><DT
>A.1.6. <A
-HREF="#AEN1351"
+HREF="#AEN1368"
> How does Bugzilla stack up against other bug-tracking databases?
</A
></DT
><DT
>A.1.7. <A
-HREF="#AEN1358"
+HREF="#AEN1375"
> How do I change my user name in Bugzilla?
</A
></DT
><DT
>A.1.8. <A
-HREF="#AEN1363"
+HREF="#AEN1380"
> Why doesn't Bugzilla offer this or that feature or compatability
with this other tracking software?
</A
></DT
><DT
>A.1.9. <A
-HREF="#AEN1370"
+HREF="#AEN1387"
> Why MySQL? I'm interested in seeing Bugzilla run on
Oracle/Sybase/Msql/PostgreSQL/MSSQL?
</A
></DT
><DT
>A.1.10. <A
-HREF="#AEN1388"
+HREF="#AEN1405"
> Why do the scripts say "/usr/bonsaitools/bin/perl" instead of
"/usr/bin/perl" or something else?
</A
@@ -7247,19 +7418,19 @@ HREF="#FAQ_REDHAT"
><DL
><DT
>A.2.1. <A
-HREF="#AEN1405"
+HREF="#AEN1422"
> What about Red Hat Bugzilla?
</A
></DT
><DT
>A.2.2. <A
-HREF="#AEN1413"
+HREF="#AEN1430"
> What are the primary benefits of Red Hat Bugzilla?
</A
></DT
><DT
>A.2.3. <A
-HREF="#AEN1441"
+HREF="#AEN1458"
> What's the current status of Red Hat Bugzilla?
</A
></DT
@@ -7274,19 +7445,19 @@ HREF="#FAQ_LOKI"
><DL
><DT
>A.3.1. <A
-HREF="#AEN1457"
+HREF="#AEN1474"
> What about Loki Bugzilla?
</A
></DT
><DT
>A.3.2. <A
-HREF="#AEN1464"
+HREF="#AEN1481"
> Who maintains Fenris (Loki Bugzilla) now?
</A
></DT
><DT
>A.3.3. <A
-HREF="#AEN1469"
+HREF="#AEN1486"
>
</A
></DT
@@ -7301,41 +7472,41 @@ HREF="#FAQ_PHB"
><DL
><DT
>A.4.1. <A
-HREF="#AEN1477"
+HREF="#AEN1494"
> Is Bugzilla web-based or do you have to have specific software or
specific operating system on your machine?
</A
></DT
><DT
>A.4.2. <A
-HREF="#AEN1482"
+HREF="#AEN1499"
> Has anyone you know of already done any Bugzilla integration with
Perforce (SCM software)?
</A
></DT
><DT
>A.4.3. <A
-HREF="#AEN1487"
+HREF="#AEN1504"
> Does Bugzilla allow the user to track multiple projects?
</A
></DT
><DT
>A.4.4. <A
-HREF="#AEN1492"
+HREF="#AEN1509"
> If I am on many projects, and search for all bugs assigned to me, will
Bugzilla list them for me and allow me to sort by project, severity etc?
</A
></DT
><DT
>A.4.5. <A
-HREF="#AEN1497"
+HREF="#AEN1514"
> Does Bugzilla allow attachments (text, screenshots, urls etc)? If yes,
are there any that are NOT allowed?
</A
></DT
><DT
>A.4.6. <A
-HREF="#AEN1502"
+HREF="#AEN1519"
> Does Bugzilla allow us to define our own priorities and levels? Do we
have complete freedom to change the labels of fields and format of them, and
the choice of acceptable values?
@@ -7343,43 +7514,51 @@ HREF="#AEN1502"
></DT
><DT
>A.4.7. <A
-HREF="#AEN1507"
+HREF="#AEN1524"
+> The index.html page doesn't show the footer. It's really annoying to have
+ to go to the querypage just to check my "my bugs" link. How do I get a footer
+ on static HTML pages?
+ </A
+></DT
+><DT
+>A.4.8. <A
+HREF="#AEN1530"
> Does Bugzilla provide any reporting features, metrics, graphs, etc? You
know, the type of stuff that management likes to see. :)
</A
></DT
><DT
->A.4.8. <A
-HREF="#AEN1515"
+>A.4.9. <A
+HREF="#AEN1538"
> Is there email notification and if so, what do you see when you get an
email? Do you see bug number and title or is it only the number?
</A
></DT
><DT
->A.4.9. <A
-HREF="#AEN1520"
+>A.4.10. <A
+HREF="#AEN1543"
> Can email notification be set up to send to multiple
people, some on the To List, CC List, BCC List etc?
</A
></DT
><DT
->A.4.10. <A
-HREF="#AEN1525"
+>A.4.11. <A
+HREF="#AEN1548"
> If there is email notification, do users have to have any particular
type of email application?
</A
></DT
><DT
->A.4.11. <A
-HREF="#AEN1532"
+>A.4.12. <A
+HREF="#AEN1555"
> If I just wanted to track certain bugs, as they go through life, can I
set it up to alert me via email whenever that bug changes, whether it be
owner, status or description etc.?
</A
></DT
><DT
->A.4.12. <A
-HREF="#AEN1537"
+>A.4.13. <A
+HREF="#AEN1560"
> Does Bugzilla allow data to be imported and exported? If I had outsiders
write up a bug report using a MS Word bug template, could that template be
imported into "matching" fields? If I wanted to take the results of a query
@@ -7387,76 +7566,76 @@ HREF="#AEN1537"
</A
></DT
><DT
->A.4.13. <A
-HREF="#AEN1545"
+>A.4.14. <A
+HREF="#AEN1568"
> Does Bugzilla allow fields to be added, changed or deleted? If I want to
customize the bug submission form to meet our needs, can I do that using our
terminology?
</A
></DT
><DT
->A.4.14. <A
-HREF="#AEN1550"
+>A.4.15. <A
+HREF="#AEN1573"
> Has anyone converted Bugzilla to another language to be used in other
countries? Is it localizable?
</A
></DT
><DT
->A.4.15. <A
-HREF="#AEN1555"
+>A.4.16. <A
+HREF="#AEN1578"
> Can a user create and save reports? Can they do this in Word format?
Excel format?
</A
></DT
><DT
->A.4.16. <A
-HREF="#AEN1560"
+>A.4.17. <A
+HREF="#AEN1583"
> Can a user re-run a report with a new project, same query?
</A
></DT
><DT
->A.4.17. <A
-HREF="#AEN1565"
+>A.4.18. <A
+HREF="#AEN1588"
> Can a user modify an existing report and then save it into another name?
</A
></DT
><DT
->A.4.18. <A
-HREF="#AEN1570"
+>A.4.19. <A
+HREF="#AEN1593"
> Does Bugzilla have the ability to search by word, phrase, compound
search?
</A
></DT
><DT
->A.4.19. <A
-HREF="#AEN1575"
+>A.4.20. <A
+HREF="#AEN1598"
> Can the admin person establish separate group and individual user
privileges?
</A
></DT
><DT
->A.4.20. <A
-HREF="#AEN1580"
+>A.4.21. <A
+HREF="#AEN1603"
> Does Bugzilla provide record locking when there is simultaneous access
to the same bug? Does the second person get a notice that the bug is in use
or how are they notified?
</A
></DT
><DT
->A.4.21. <A
-HREF="#AEN1585"
+>A.4.22. <A
+HREF="#AEN1608"
> Are there any backup features provided?
</A
></DT
><DT
->A.4.22. <A
-HREF="#AEN1591"
+>A.4.23. <A
+HREF="#AEN1614"
> Can users be on the system while a backup is in progress?
</A
></DT
><DT
->A.4.23. <A
-HREF="#AEN1596"
+>A.4.24. <A
+HREF="#AEN1619"
> What type of human resources are needed to be on staff to install and
maintain Bugzilla? Specifically, what type of skills does the person need to
have? I need to find out if we were to go with Bugzilla, what types of
@@ -7465,8 +7644,8 @@ HREF="#AEN1596"
</A
></DT
><DT
->A.4.24. <A
-HREF="#AEN1603"
+>A.4.25. <A
+HREF="#AEN1626"
> What time frame are we looking at if we decide to hire people to install
and maintain the Bugzilla? Is this something that takes hours or weeks to
install and a couple of hours per week to maintain and customize or is this
@@ -7475,8 +7654,8 @@ HREF="#AEN1603"
</A
></DT
><DT
->A.4.25. <A
-HREF="#AEN1608"
+>A.4.26. <A
+HREF="#AEN1631"
> Is there any licensing fee or other fees for using Bugzilla? Any
out-of-pocket cost other than the bodies needed as identified above?
</A
@@ -7492,19 +7671,19 @@ HREF="#FAQ_INSTALL"
><DL
><DT
>A.5.1. <A
-HREF="#AEN1615"
+HREF="#AEN1638"
> How do I download and install Bugzilla?
</A
></DT
><DT
>A.5.2. <A
-HREF="#AEN1621"
+HREF="#AEN1644"
> How do I install Bugzilla on Windows NT?
</A
></DT
><DT
>A.5.3. <A
-HREF="#AEN1626"
+HREF="#AEN1649"
> Is there an easy way to change the Bugzilla cookie name?
</A
></DT
@@ -7519,20 +7698,20 @@ HREF="#FAQ_SECURITY"
><DL
><DT
>A.6.1. <A
-HREF="#AEN1633"
+HREF="#AEN1656"
> How do I completely disable MySQL security if it's giving me problems
(I've followed the instructions in the README!)?
</A
></DT
><DT
>A.6.2. <A
-HREF="#AEN1639"
+HREF="#AEN1662"
> Are there any security problems with Bugzilla?
</A
></DT
><DT
>A.6.3. <A
-HREF="#AEN1644"
+HREF="#AEN1667"
> I've implemented the security fixes mentioned in Chris Yeh's security
advisory of 5/10/2000 advising not to run MySQL as root, and am running into
problems with MySQL no longer working correctly.
@@ -7549,48 +7728,48 @@ HREF="#FAQ_EMAIL"
><DL
><DT
>A.7.1. <A
-HREF="#AEN1651"
+HREF="#AEN1674"
> I have a user who doesn't want to receive any more email from Bugzilla.
How do I stop it entirely for this user?
</A
></DT
><DT
>A.7.2. <A
-HREF="#AEN1656"
+HREF="#AEN1679"
> I'm evaluating/testing Bugzilla, and don't want it to send email to
anyone but me. How do I do it?
</A
></DT
><DT
>A.7.3. <A
-HREF="#AEN1661"
+HREF="#AEN1684"
> I want whineatnews.pl to whine at something more, or other than, only new
bugs. How do I do it?
</A
></DT
><DT
>A.7.4. <A
-HREF="#AEN1667"
+HREF="#AEN1690"
> I don't like/want to use Procmail to hand mail off to bug_email.pl.
What alternatives do I have?
</A
></DT
><DT
>A.7.5. <A
-HREF="#AEN1674"
+HREF="#AEN1697"
> How do I set up the email interface to submit/change bugs via email?
</A
></DT
><DT
>A.7.6. <A
-HREF="#AEN1679"
+HREF="#AEN1702"
> Email takes FOREVER to reach me from bugzilla -- it's extremely slow.
What gives?
</A
></DT
><DT
>A.7.7. <A
-HREF="#AEN1686"
+HREF="#AEN1709"
> How come email never reaches me from bugzilla changes?
</A
></DT
@@ -7605,60 +7784,60 @@ HREF="#FAQ_DB"
><DL
><DT
>A.8.1. <A
-HREF="#AEN1694"
+HREF="#AEN1717"
> I've heard Bugzilla can be used with Oracle?
</A
></DT
><DT
>A.8.2. <A
-HREF="#AEN1699"
+HREF="#AEN1722"
> Bugs are missing from queries, but exist in the database (and I can pull
them up by specifying the bug ID). What's wrong?
</A
></DT
><DT
>A.8.3. <A
-HREF="#AEN1704"
+HREF="#AEN1727"
> I think my database might be corrupted, or contain invalid entries. What
do I do?
</A
></DT
><DT
>A.8.4. <A
-HREF="#AEN1709"
+HREF="#AEN1732"
> I want to manually edit some entries in my database. How?
</A
></DT
><DT
>A.8.5. <A
-HREF="#AEN1714"
+HREF="#AEN1737"
> I try to add myself as a user, but Bugzilla always tells me my password is wrong.
</A
></DT
><DT
>A.8.6. <A
-HREF="#AEN1719"
+HREF="#AEN1742"
> I think I've set up MySQL permissions correctly, but bugzilla still can't
connect.
</A
></DT
><DT
>A.8.7. <A
-HREF="#AEN1724"
+HREF="#AEN1747"
> How do I synchronize bug information among multiple different Bugzilla
databases?
</A
></DT
><DT
>A.8.8. <A
-HREF="#AEN1731"
+HREF="#AEN1754"
> Why do I get bizarre errors when trying to submit data, particularly problems
with "groupset"?
</A
></DT
><DT
>A.8.9. <A
-HREF="#AEN1736"
+HREF="#AEN1759"
> How come even after I delete bugs, the long descriptions show up?
</A
></DT
@@ -7673,32 +7852,32 @@ HREF="#FAQ_NT"
><DL
><DT
>A.9.1. <A
-HREF="#AEN1743"
+HREF="#AEN1766"
> What is the easiest way to run Bugzilla on Win32 (Win98+/NT/2K)?
</A
></DT
><DT
>A.9.2. <A
-HREF="#AEN1748"
+HREF="#AEN1771"
> Is there a "Bundle::Bugzilla" equivalent for Win32?
</A
></DT
><DT
>A.9.3. <A
-HREF="#AEN1753"
+HREF="#AEN1776"
> CGI's are failing with a "something.cgi is not a valid Windows NT
application" error. Why?
</A
></DT
><DT
>A.9.4. <A
-HREF="#AEN1761"
+HREF="#AEN1784"
> Can I have some general instructions on how to make Bugzilla on Win32 work?
</A
></DT
><DT
>A.9.5. <A
-HREF="#AEN1767"
+HREF="#AEN1790"
> I'm having trouble with the perl modules for NT not being able to talk to
to the database.
</A
@@ -7714,34 +7893,34 @@ HREF="#FAQ_USE"
><DL
><DT
>A.10.1. <A
-HREF="#AEN1788"
+HREF="#AEN1811"
> The query page is very confusing. Isn't there a simpler way to query?
</A
></DT
><DT
>A.10.2. <A
-HREF="#AEN1794"
+HREF="#AEN1817"
> I'm confused by the behavior of the "accept" button in the Show Bug form.
Why doesn't it assign the bug to me when I accept it?
</A
></DT
><DT
>A.10.3. <A
-HREF="#AEN1804"
+HREF="#AEN1827"
> I can't upload anything into the database via the "Create Attachment"
link. What am I doing wrong?
</A
></DT
><DT
>A.10.4. <A
-HREF="#AEN1809"
+HREF="#AEN1832"
> Email submissions to Bugzilla that have attachments end up asking me to
save it as a "cgi" file.
</A
></DT
><DT
>A.10.5. <A
-HREF="#AEN1814"
+HREF="#AEN1837"
> How do I change a keyword in Bugzilla, once some bugs are using it?
</A
></DT
@@ -7756,20 +7935,20 @@ HREF="#FAQ_HACKING"
><DL
><DT
>A.11.1. <A
-HREF="#AEN1821"
+HREF="#AEN1844"
> What bugs are in Bugzilla right now?
</A
></DT
><DT
>A.11.2. <A
-HREF="#AEN1830"
+HREF="#AEN1853"
> How can I change the default priority to a null value? For instance, have the default
priority be "---" instead of "P2"?
</A
></DT
><DT
>A.11.3. <A
-HREF="#AEN1836"
+HREF="#AEN1859"
> What's the best way to submit patches? What guidelines should I follow?
</A
></DT
@@ -7789,7 +7968,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1302"
+NAME="AEN1319"
></A
><B
>A.1.1. </B
@@ -7815,7 +7994,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1308"
+NAME="AEN1325"
></A
><B
>A.1.2. </B
@@ -7842,7 +8021,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1314"
+NAME="AEN1331"
></A
><B
>A.1.3. </B
@@ -7877,7 +8056,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1321"
+NAME="AEN1338"
></A
><B
>A.1.4. </B
@@ -7985,7 +8164,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1346"
+NAME="AEN1363"
></A
><B
>A.1.5. </B
@@ -8013,7 +8192,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1351"
+NAME="AEN1368"
></A
><B
>A.1.6. </B
@@ -8048,7 +8227,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1358"
+NAME="AEN1375"
></A
><B
>A.1.7. </B
@@ -8071,7 +8250,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1363"
+NAME="AEN1380"
></A
><B
>A.1.8. </B
@@ -8109,7 +8288,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1370"
+NAME="AEN1387"
></A
><B
>A.1.9. </B
@@ -8124,7 +8303,7 @@ CLASS="ANSWER"
> </B
>Terry Weissman answers,
<A
-NAME="AEN1374"
+NAME="AEN1391"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -8200,7 +8379,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1388"
+NAME="AEN1405"
></A
><B
>A.1.10. </B
@@ -8220,7 +8399,7 @@ CLASS="ANSWER"
><P
> Here's Terry Weissman's comment, for some historical context:
<A
-NAME="AEN1393"
+NAME="AEN1410"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -8285,7 +8464,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1405"
+NAME="AEN1422"
></A
><B
>A.2.1. </B
@@ -8309,7 +8488,7 @@ CLASS="ANSWER"
><P
> Dave Lawrence, the original Red Hat Bugzilla maintainer, mentions:
<A
-NAME="AEN1410"
+NAME="AEN1427"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -8332,7 +8511,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1413"
+NAME="AEN1430"
></A
><B
>A.2.2. </B
@@ -8348,7 +8527,7 @@ CLASS="ANSWER"
>Dave Lawrence</EM
>:
<A
-NAME="AEN1418"
+NAME="AEN1435"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -8464,7 +8643,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1441"
+NAME="AEN1458"
></A
><B
>A.2.3. </B
@@ -8494,7 +8673,7 @@ CLASS="NOTE"
>Dave Lawrence</EM
>:
<A
-NAME="AEN1448"
+NAME="AEN1465"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -8585,7 +8764,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1457"
+NAME="AEN1474"
></A
><B
>A.3.1. </B
@@ -8600,7 +8779,7 @@ CLASS="ANSWER"
> Loki Games has a customized version of Bugzilla available at
http://fenris.lokigames.com. From that page,
<A
-NAME="AEN1461"
+NAME="AEN1478"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -8630,7 +8809,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1464"
+NAME="AEN1481"
></A
><B
>A.3.2. </B
@@ -8654,7 +8833,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1469"
+NAME="AEN1486"
></A
><B
>A.3.3. </B
@@ -8691,7 +8870,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1477"
+NAME="AEN1494"
></A
><B
>A.4.1. </B
@@ -8715,7 +8894,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1482"
+NAME="AEN1499"
></A
><B
>A.4.2. </B
@@ -8742,7 +8921,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1487"
+NAME="AEN1504"
></A
><B
>A.4.3. </B
@@ -8768,7 +8947,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1492"
+NAME="AEN1509"
></A
><B
>A.4.4. </B
@@ -8791,7 +8970,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1497"
+NAME="AEN1514"
></A
><B
>A.4.5. </B
@@ -8819,7 +8998,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1502"
+NAME="AEN1519"
></A
><B
>A.4.6. </B
@@ -8845,10 +9024,67 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1507"
+NAME="AEN1524"
></A
><B
>A.4.7. </B
+> The index.html page doesn't show the footer. It's really annoying to have
+ to go to the querypage just to check my "my bugs" link. How do I get a footer
+ on static HTML pages?
+ </P
+></DIV
+><DIV
+CLASS="ANSWER"
+><P
+><B
+> </B
+> This was a late-breaking question for the Guide, so I just have to
+ quote the relevant newsgroup thread on it.
+ </P
+><P
+CLASS="LITERALLAYOUT"
+>&#62;&nbsp;AFAIK,&nbsp;most&nbsp;sites&nbsp;(even&nbsp;if&nbsp;they&nbsp;have&nbsp;SSI&nbsp;enabled)&nbsp;won't&nbsp;have&nbsp;#exec&nbsp;cmd<br>
+&#62;&nbsp;enabled.&nbsp;&nbsp;Perhaps&nbsp;what&nbsp;would&nbsp;be&nbsp;better&nbsp;is&nbsp;a&nbsp;#include&nbsp;virtual&nbsp;and&nbsp;a<br>
+&#62;&nbsp;footer.cgi&nbsp;the&nbsp;basically&nbsp;has&nbsp;the&nbsp;"require&nbsp;'CGI.pl'&nbsp;and&nbsp;PutFooter&nbsp;command.<br>
+&#62;<br>
+&#62;&nbsp;Please&nbsp;note&nbsp;that&nbsp;under&nbsp;most&nbsp;configurations,&nbsp;this&nbsp;also&nbsp;requires&nbsp;naming<br>
+&#62;&nbsp;the&nbsp;file&nbsp;from&nbsp;index.html&nbsp;to&nbsp;index.shtml&nbsp;(and&nbsp;making&nbsp;sure&nbsp;that&nbsp;it&nbsp;will<br>
+&#62;&nbsp;still&nbsp;be&nbsp;reconized&nbsp;as&nbsp;an&nbsp;index).&nbsp;&nbsp;Personally,&nbsp;I&nbsp;think&nbsp;this&nbsp;is&nbsp;better&nbsp;on<br>
+&#62;&nbsp;a&nbsp;per-installation&nbsp;basis&nbsp;(perhaps&nbsp;add&nbsp;something&nbsp;to&nbsp;the&nbsp;FAQ&nbsp;that&nbsp;says&nbsp;how<br>
+&#62;&nbsp;to&nbsp;do&nbsp;this).<br>
+<br>
+Good&nbsp;point.&nbsp;&nbsp;Yeah,&nbsp;easy&nbsp;enough&nbsp;to&nbsp;do,&nbsp;that&nbsp;it&nbsp;shouldn't&nbsp;be&nbsp;a&nbsp;big&nbsp;deal&nbsp;for<br>
+someone&nbsp;to&nbsp;take&nbsp;it&nbsp;on&nbsp;if&nbsp;they&nbsp;want&nbsp;it.&nbsp;&nbsp;FAQ&nbsp;is&nbsp;a&nbsp;good&nbsp;place&nbsp;for&nbsp;it.<br>
+<br>
+&#62;&nbsp;Dave&nbsp;Miller&nbsp;wrote:<br>
+&#62;<br>
+&#62;&#62;&nbsp;I&nbsp;did&nbsp;a&nbsp;little&nbsp;experimenting&nbsp;with&nbsp;getting&nbsp;the&nbsp;command&nbsp;menu&nbsp;and&nbsp;footer&nbsp;on<br>
+&#62;&#62;&nbsp;the&nbsp;end&nbsp;of&nbsp;the&nbsp;index&nbsp;page&nbsp;while&nbsp;leaving&nbsp;it&nbsp;as&nbsp;an&nbsp;HTML&nbsp;file...<br>
+&#62;&#62;<br>
+&#62;&#62;&nbsp;I&nbsp;was&nbsp;successful.&nbsp;:)<br>
+&#62;&#62;<br>
+&#62;&#62;&nbsp;I&nbsp;added&nbsp;this&nbsp;line:<br>
+&#62;&#62;<br>
+&#62;&#62;&nbsp;<br>
+&#62;&#62;<br>
+&#62;&#62;&nbsp;Just&nbsp;before&nbsp;the&nbsp;&#60;/BODY&#62;&nbsp;&#60;/HTML&#62;&nbsp;at&nbsp;the&nbsp;end&nbsp;of&nbsp;the&nbsp;file.&nbsp;&nbsp;And&nbsp;it&nbsp;worked.<br>
+&#62;&#62;<br>
+&#62;&#62;&nbsp;Thought&nbsp;I'd&nbsp;toss&nbsp;that&nbsp;out&nbsp;there.&nbsp;&nbsp;Should&nbsp;I&nbsp;check&nbsp;this&nbsp;in?&nbsp;&nbsp;For&nbsp;those&nbsp;that<br>
+&#62;&#62;&nbsp;have&nbsp;SSI&nbsp;disabled,&nbsp;it'll&nbsp;act&nbsp;like&nbsp;a&nbsp;comment,&nbsp;so&nbsp;I&nbsp;wouldn't&nbsp;think&nbsp;it&nbsp;would<br>
+&#62;&#62;&nbsp;break&nbsp;anything.<br>
+ &nbsp;&nbsp;</P
+></DIV
+></DIV
+><DIV
+CLASS="QANDAENTRY"
+><DIV
+CLASS="QUESTION"
+><P
+><A
+NAME="AEN1530"
+></A
+><B
+>A.4.8. </B
> Does Bugzilla provide any reporting features, metrics, graphs, etc? You
know, the type of stuff that management likes to see. :)
</P
@@ -8884,10 +9120,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1515"
+NAME="AEN1538"
></A
><B
->A.4.8. </B
+>A.4.9. </B
> Is there email notification and if so, what do you see when you get an
email? Do you see bug number and title or is it only the number?
</P
@@ -8909,10 +9145,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1520"
+NAME="AEN1543"
></A
><B
->A.4.9. </B
+>A.4.10. </B
> Can email notification be set up to send to multiple
people, some on the To List, CC List, BCC List etc?
</P
@@ -8932,10 +9168,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1525"
+NAME="AEN1548"
></A
><B
->A.4.10. </B
+>A.4.11. </B
> If there is email notification, do users have to have any particular
type of email application?
</P
@@ -8973,10 +9209,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1532"
+NAME="AEN1555"
></A
><B
->A.4.11. </B
+>A.4.12. </B
> If I just wanted to track certain bugs, as they go through life, can I
set it up to alert me via email whenever that bug changes, whether it be
owner, status or description etc.?
@@ -9000,10 +9236,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1537"
+NAME="AEN1560"
></A
><B
->A.4.12. </B
+>A.4.13. </B
> Does Bugzilla allow data to be imported and exported? If I had outsiders
write up a bug report using a MS Word bug template, could that template be
imported into "matching" fields? If I wanted to take the results of a query
@@ -9045,10 +9281,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1545"
+NAME="AEN1568"
></A
><B
->A.4.13. </B
+>A.4.14. </B
> Does Bugzilla allow fields to be added, changed or deleted? If I want to
customize the bug submission form to meet our needs, can I do that using our
terminology?
@@ -9069,10 +9305,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1550"
+NAME="AEN1573"
></A
><B
->A.4.14. </B
+>A.4.15. </B
> Has anyone converted Bugzilla to another language to be used in other
countries? Is it localizable?
</P
@@ -9095,10 +9331,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1555"
+NAME="AEN1578"
></A
><B
->A.4.15. </B
+>A.4.16. </B
> Can a user create and save reports? Can they do this in Word format?
Excel format?
</P
@@ -9118,10 +9354,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1560"
+NAME="AEN1583"
></A
><B
->A.4.16. </B
+>A.4.17. </B
> Can a user re-run a report with a new project, same query?
</P
></DIV
@@ -9140,10 +9376,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1565"
+NAME="AEN1588"
></A
><B
->A.4.17. </B
+>A.4.18. </B
> Can a user modify an existing report and then save it into another name?
</P
></DIV
@@ -9163,10 +9399,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1570"
+NAME="AEN1593"
></A
><B
->A.4.18. </B
+>A.4.19. </B
> Does Bugzilla have the ability to search by word, phrase, compound
search?
</P
@@ -9187,10 +9423,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1575"
+NAME="AEN1598"
></A
><B
->A.4.19. </B
+>A.4.20. </B
> Can the admin person establish separate group and individual user
privileges?
</P
@@ -9210,10 +9446,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1580"
+NAME="AEN1603"
></A
><B
->A.4.20. </B
+>A.4.21. </B
> Does Bugzilla provide record locking when there is simultaneous access
to the same bug? Does the second person get a notice that the bug is in use
or how are they notified?
@@ -9235,10 +9471,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1585"
+NAME="AEN1608"
></A
><B
->A.4.21. </B
+>A.4.22. </B
> Are there any backup features provided?
</P
></DIV
@@ -9263,10 +9499,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1591"
+NAME="AEN1614"
></A
><B
->A.4.22. </B
+>A.4.23. </B
> Can users be on the system while a backup is in progress?
</P
></DIV
@@ -9287,10 +9523,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1596"
+NAME="AEN1619"
></A
><B
->A.4.23. </B
+>A.4.24. </B
> What type of human resources are needed to be on staff to install and
maintain Bugzilla? Specifically, what type of skills does the person need to
have? I need to find out if we were to go with Bugzilla, what types of
@@ -9326,10 +9562,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1603"
+NAME="AEN1626"
></A
><B
->A.4.24. </B
+>A.4.25. </B
> What time frame are we looking at if we decide to hire people to install
and maintain the Bugzilla? Is this something that takes hours or weeks to
install and a couple of hours per week to maintain and customize or is this
@@ -9357,10 +9593,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1608"
+NAME="AEN1631"
></A
><B
->A.4.25. </B
+>A.4.26. </B
> Is there any licensing fee or other fees for using Bugzilla? Any
out-of-pocket cost other than the bodies needed as identified above?
</P
@@ -9389,7 +9625,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1615"
+NAME="AEN1638"
></A
><B
>A.5.1. </B
@@ -9417,7 +9653,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1621"
+NAME="AEN1644"
></A
><B
>A.5.2. </B
@@ -9440,7 +9676,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1626"
+NAME="AEN1649"
></A
><B
>A.5.3. </B
@@ -9470,7 +9706,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1633"
+NAME="AEN1656"
></A
><B
>A.6.1. </B
@@ -9498,7 +9734,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1639"
+NAME="AEN1662"
></A
><B
>A.6.2. </B
@@ -9523,7 +9759,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1644"
+NAME="AEN1667"
></A
><B
>A.6.3. </B
@@ -9557,7 +9793,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1651"
+NAME="AEN1674"
></A
><B
>A.7.1. </B
@@ -9581,7 +9817,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1656"
+NAME="AEN1679"
></A
><B
>A.7.2. </B
@@ -9605,7 +9841,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1661"
+NAME="AEN1684"
></A
><B
>A.7.3. </B
@@ -9635,7 +9871,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1667"
+NAME="AEN1690"
></A
><B
>A.7.4. </B
@@ -9651,7 +9887,7 @@ CLASS="ANSWER"
> You can call bug_email.pl directly from your aliases file, with
an entry like this:
<A
-NAME="AEN1671"
+NAME="AEN1694"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -9672,7 +9908,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1674"
+NAME="AEN1697"
></A
><B
>A.7.5. </B
@@ -9695,7 +9931,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1679"
+NAME="AEN1702"
></A
><B
>A.7.6. </B
@@ -9733,7 +9969,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1686"
+NAME="AEN1709"
></A
><B
>A.7.7. </B
@@ -9771,7 +10007,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1694"
+NAME="AEN1717"
></A
><B
>A.8.1. </B
@@ -9796,7 +10032,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1699"
+NAME="AEN1722"
></A
><B
>A.8.2. </B
@@ -9831,7 +10067,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1704"
+NAME="AEN1727"
></A
><B
>A.8.3. </B
@@ -9859,7 +10095,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1709"
+NAME="AEN1732"
></A
><B
>A.8.4. </B
@@ -9886,7 +10122,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1714"
+NAME="AEN1737"
></A
><B
>A.8.5. </B
@@ -9910,7 +10146,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1719"
+NAME="AEN1742"
></A
><B
>A.8.6. </B
@@ -9937,7 +10173,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1724"
+NAME="AEN1747"
></A
><B
>A.8.7. </B
@@ -9973,7 +10209,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1731"
+NAME="AEN1754"
></A
><B
>A.8.8. </B
@@ -9999,7 +10235,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1736"
+NAME="AEN1759"
></A
><B
>A.8.9. </B
@@ -10032,7 +10268,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1743"
+NAME="AEN1766"
></A
><B
>A.9.1. </B
@@ -10055,7 +10291,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1748"
+NAME="AEN1771"
></A
><B
>A.9.2. </B
@@ -10079,7 +10315,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1753"
+NAME="AEN1776"
></A
><B
>A.9.3. </B
@@ -10100,7 +10336,7 @@ CLASS="ANSWER"
><P
> Microsoft has some advice on this matter, as well:
<A
-NAME="AEN1758"
+NAME="AEN1781"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -10125,7 +10361,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1761"
+NAME="AEN1784"
></A
><B
>A.9.4. </B
@@ -10236,7 +10472,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1767"
+NAME="AEN1790"
></A
><B
>A.9.5. </B
@@ -10311,7 +10547,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1788"
+NAME="AEN1811"
></A
><B
>A.10.1. </B
@@ -10339,7 +10575,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1794"
+NAME="AEN1817"
></A
><B
>A.10.2. </B
@@ -10392,7 +10628,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1804"
+NAME="AEN1827"
></A
><B
>A.10.3. </B
@@ -10417,7 +10653,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1809"
+NAME="AEN1832"
></A
><B
>A.10.4. </B
@@ -10442,7 +10678,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1814"
+NAME="AEN1837"
></A
><B
>A.10.5. </B
@@ -10474,7 +10710,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1821"
+NAME="AEN1844"
></A
><B
>A.11.1. </B
@@ -10518,7 +10754,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1830"
+NAME="AEN1853"
></A
><B
>A.11.2. </B
@@ -10550,7 +10786,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1836"
+NAME="AEN1859"
></A
><B
>A.11.3. </B
@@ -11420,7 +11656,7 @@ NAME="RHBUGZILLA"
database, as well as MySQL.
Here's what Dave Lawrence had to say about the status of Red Hat Bugzilla,
<A
-NAME="AEN1913"
+NAME="AEN1936"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -11636,7 +11872,7 @@ CLASS="COMMAND"
<DIV
CLASS="EXAMPLE"
><A
-NAME="AEN1963"
+NAME="AEN1986"
></A
><P
><B
@@ -11868,7 +12104,7 @@ NAME="GFDL"
><P
>Version 1.1, March 2000</P
><A
-NAME="AEN2019"
+NAME="AEN2042"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -12367,7 +12603,7 @@ NAME="GFDL_HOWTO"
a copy of the License in the document and put the following
copyright and license notices just after the title page:</P
><A
-NAME="AEN2109"
+NAME="AEN2132"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -12501,7 +12737,7 @@ NAME="GLOSS_P"
><DIV
CLASS="EXAMPLE"
><A
-NAME="AEN2145"
+NAME="AEN2168"
></A
><P
><B
diff --git a/docs/html/faq.html b/docs/html/faq.html
index 4a2bb7505..5c91bbad4 100644
--- a/docs/html/faq.html
+++ b/docs/html/faq.html
@@ -81,63 +81,63 @@ HREF="faq.html#FAQ_GENERAL"
><DL
><DT
>A.1.1. <A
-HREF="faq.html#AEN1302"
+HREF="faq.html#AEN1319"
> Where can I find information about Bugzilla?</A
></DT
><DT
>A.1.2. <A
-HREF="faq.html#AEN1308"
+HREF="faq.html#AEN1325"
> What license is Bugzilla distributed under?
</A
></DT
><DT
>A.1.3. <A
-HREF="faq.html#AEN1314"
+HREF="faq.html#AEN1331"
> How do I get commercial support for Bugzilla?
</A
></DT
><DT
>A.1.4. <A
-HREF="faq.html#AEN1321"
+HREF="faq.html#AEN1338"
> What major companies or projects are currently using Bugzilla
for bug-tracking?
</A
></DT
><DT
>A.1.5. <A
-HREF="faq.html#AEN1346"
+HREF="faq.html#AEN1363"
> Who maintains Bugzilla?
</A
></DT
><DT
>A.1.6. <A
-HREF="faq.html#AEN1351"
+HREF="faq.html#AEN1368"
> How does Bugzilla stack up against other bug-tracking databases?
</A
></DT
><DT
>A.1.7. <A
-HREF="faq.html#AEN1358"
+HREF="faq.html#AEN1375"
> How do I change my user name in Bugzilla?
</A
></DT
><DT
>A.1.8. <A
-HREF="faq.html#AEN1363"
+HREF="faq.html#AEN1380"
> Why doesn't Bugzilla offer this or that feature or compatability
with this other tracking software?
</A
></DT
><DT
>A.1.9. <A
-HREF="faq.html#AEN1370"
+HREF="faq.html#AEN1387"
> Why MySQL? I'm interested in seeing Bugzilla run on
Oracle/Sybase/Msql/PostgreSQL/MSSQL?
</A
></DT
><DT
>A.1.10. <A
-HREF="faq.html#AEN1388"
+HREF="faq.html#AEN1405"
> Why do the scripts say "/usr/bonsaitools/bin/perl" instead of
"/usr/bin/perl" or something else?
</A
@@ -153,19 +153,19 @@ HREF="faq.html#FAQ_REDHAT"
><DL
><DT
>A.2.1. <A
-HREF="faq.html#AEN1405"
+HREF="faq.html#AEN1422"
> What about Red Hat Bugzilla?
</A
></DT
><DT
>A.2.2. <A
-HREF="faq.html#AEN1413"
+HREF="faq.html#AEN1430"
> What are the primary benefits of Red Hat Bugzilla?
</A
></DT
><DT
>A.2.3. <A
-HREF="faq.html#AEN1441"
+HREF="faq.html#AEN1458"
> What's the current status of Red Hat Bugzilla?
</A
></DT
@@ -180,19 +180,19 @@ HREF="faq.html#FAQ_LOKI"
><DL
><DT
>A.3.1. <A
-HREF="faq.html#AEN1457"
+HREF="faq.html#AEN1474"
> What about Loki Bugzilla?
</A
></DT
><DT
>A.3.2. <A
-HREF="faq.html#AEN1464"
+HREF="faq.html#AEN1481"
> Who maintains Fenris (Loki Bugzilla) now?
</A
></DT
><DT
>A.3.3. <A
-HREF="faq.html#AEN1469"
+HREF="faq.html#AEN1486"
>
</A
></DT
@@ -207,41 +207,41 @@ HREF="faq.html#FAQ_PHB"
><DL
><DT
>A.4.1. <A
-HREF="faq.html#AEN1477"
+HREF="faq.html#AEN1494"
> Is Bugzilla web-based or do you have to have specific software or
specific operating system on your machine?
</A
></DT
><DT
>A.4.2. <A
-HREF="faq.html#AEN1482"
+HREF="faq.html#AEN1499"
> Has anyone you know of already done any Bugzilla integration with
Perforce (SCM software)?
</A
></DT
><DT
>A.4.3. <A
-HREF="faq.html#AEN1487"
+HREF="faq.html#AEN1504"
> Does Bugzilla allow the user to track multiple projects?
</A
></DT
><DT
>A.4.4. <A
-HREF="faq.html#AEN1492"
+HREF="faq.html#AEN1509"
> If I am on many projects, and search for all bugs assigned to me, will
Bugzilla list them for me and allow me to sort by project, severity etc?
</A
></DT
><DT
>A.4.5. <A
-HREF="faq.html#AEN1497"
+HREF="faq.html#AEN1514"
> Does Bugzilla allow attachments (text, screenshots, urls etc)? If yes,
are there any that are NOT allowed?
</A
></DT
><DT
>A.4.6. <A
-HREF="faq.html#AEN1502"
+HREF="faq.html#AEN1519"
> Does Bugzilla allow us to define our own priorities and levels? Do we
have complete freedom to change the labels of fields and format of them, and
the choice of acceptable values?
@@ -249,43 +249,51 @@ HREF="faq.html#AEN1502"
></DT
><DT
>A.4.7. <A
-HREF="faq.html#AEN1507"
+HREF="faq.html#AEN1524"
+> The index.html page doesn't show the footer. It's really annoying to have
+ to go to the querypage just to check my "my bugs" link. How do I get a footer
+ on static HTML pages?
+ </A
+></DT
+><DT
+>A.4.8. <A
+HREF="faq.html#AEN1530"
> Does Bugzilla provide any reporting features, metrics, graphs, etc? You
know, the type of stuff that management likes to see. :)
</A
></DT
><DT
->A.4.8. <A
-HREF="faq.html#AEN1515"
+>A.4.9. <A
+HREF="faq.html#AEN1538"
> Is there email notification and if so, what do you see when you get an
email? Do you see bug number and title or is it only the number?
</A
></DT
><DT
->A.4.9. <A
-HREF="faq.html#AEN1520"
+>A.4.10. <A
+HREF="faq.html#AEN1543"
> Can email notification be set up to send to multiple
people, some on the To List, CC List, BCC List etc?
</A
></DT
><DT
->A.4.10. <A
-HREF="faq.html#AEN1525"
+>A.4.11. <A
+HREF="faq.html#AEN1548"
> If there is email notification, do users have to have any particular
type of email application?
</A
></DT
><DT
->A.4.11. <A
-HREF="faq.html#AEN1532"
+>A.4.12. <A
+HREF="faq.html#AEN1555"
> If I just wanted to track certain bugs, as they go through life, can I
set it up to alert me via email whenever that bug changes, whether it be
owner, status or description etc.?
</A
></DT
><DT
->A.4.12. <A
-HREF="faq.html#AEN1537"
+>A.4.13. <A
+HREF="faq.html#AEN1560"
> Does Bugzilla allow data to be imported and exported? If I had outsiders
write up a bug report using a MS Word bug template, could that template be
imported into "matching" fields? If I wanted to take the results of a query
@@ -293,76 +301,76 @@ HREF="faq.html#AEN1537"
</A
></DT
><DT
->A.4.13. <A
-HREF="faq.html#AEN1545"
+>A.4.14. <A
+HREF="faq.html#AEN1568"
> Does Bugzilla allow fields to be added, changed or deleted? If I want to
customize the bug submission form to meet our needs, can I do that using our
terminology?
</A
></DT
><DT
->A.4.14. <A
-HREF="faq.html#AEN1550"
+>A.4.15. <A
+HREF="faq.html#AEN1573"
> Has anyone converted Bugzilla to another language to be used in other
countries? Is it localizable?
</A
></DT
><DT
->A.4.15. <A
-HREF="faq.html#AEN1555"
+>A.4.16. <A
+HREF="faq.html#AEN1578"
> Can a user create and save reports? Can they do this in Word format?
Excel format?
</A
></DT
><DT
->A.4.16. <A
-HREF="faq.html#AEN1560"
+>A.4.17. <A
+HREF="faq.html#AEN1583"
> Can a user re-run a report with a new project, same query?
</A
></DT
><DT
->A.4.17. <A
-HREF="faq.html#AEN1565"
+>A.4.18. <A
+HREF="faq.html#AEN1588"
> Can a user modify an existing report and then save it into another name?
</A
></DT
><DT
->A.4.18. <A
-HREF="faq.html#AEN1570"
+>A.4.19. <A
+HREF="faq.html#AEN1593"
> Does Bugzilla have the ability to search by word, phrase, compound
search?
</A
></DT
><DT
->A.4.19. <A
-HREF="faq.html#AEN1575"
+>A.4.20. <A
+HREF="faq.html#AEN1598"
> Can the admin person establish separate group and individual user
privileges?
</A
></DT
><DT
->A.4.20. <A
-HREF="faq.html#AEN1580"
+>A.4.21. <A
+HREF="faq.html#AEN1603"
> Does Bugzilla provide record locking when there is simultaneous access
to the same bug? Does the second person get a notice that the bug is in use
or how are they notified?
</A
></DT
><DT
->A.4.21. <A
-HREF="faq.html#AEN1585"
+>A.4.22. <A
+HREF="faq.html#AEN1608"
> Are there any backup features provided?
</A
></DT
><DT
->A.4.22. <A
-HREF="faq.html#AEN1591"
+>A.4.23. <A
+HREF="faq.html#AEN1614"
> Can users be on the system while a backup is in progress?
</A
></DT
><DT
->A.4.23. <A
-HREF="faq.html#AEN1596"
+>A.4.24. <A
+HREF="faq.html#AEN1619"
> What type of human resources are needed to be on staff to install and
maintain Bugzilla? Specifically, what type of skills does the person need to
have? I need to find out if we were to go with Bugzilla, what types of
@@ -371,8 +379,8 @@ HREF="faq.html#AEN1596"
</A
></DT
><DT
->A.4.24. <A
-HREF="faq.html#AEN1603"
+>A.4.25. <A
+HREF="faq.html#AEN1626"
> What time frame are we looking at if we decide to hire people to install
and maintain the Bugzilla? Is this something that takes hours or weeks to
install and a couple of hours per week to maintain and customize or is this
@@ -381,8 +389,8 @@ HREF="faq.html#AEN1603"
</A
></DT
><DT
->A.4.25. <A
-HREF="faq.html#AEN1608"
+>A.4.26. <A
+HREF="faq.html#AEN1631"
> Is there any licensing fee or other fees for using Bugzilla? Any
out-of-pocket cost other than the bodies needed as identified above?
</A
@@ -398,19 +406,19 @@ HREF="faq.html#FAQ_INSTALL"
><DL
><DT
>A.5.1. <A
-HREF="faq.html#AEN1615"
+HREF="faq.html#AEN1638"
> How do I download and install Bugzilla?
</A
></DT
><DT
>A.5.2. <A
-HREF="faq.html#AEN1621"
+HREF="faq.html#AEN1644"
> How do I install Bugzilla on Windows NT?
</A
></DT
><DT
>A.5.3. <A
-HREF="faq.html#AEN1626"
+HREF="faq.html#AEN1649"
> Is there an easy way to change the Bugzilla cookie name?
</A
></DT
@@ -425,20 +433,20 @@ HREF="faq.html#FAQ_SECURITY"
><DL
><DT
>A.6.1. <A
-HREF="faq.html#AEN1633"
+HREF="faq.html#AEN1656"
> How do I completely disable MySQL security if it's giving me problems
(I've followed the instructions in the README!)?
</A
></DT
><DT
>A.6.2. <A
-HREF="faq.html#AEN1639"
+HREF="faq.html#AEN1662"
> Are there any security problems with Bugzilla?
</A
></DT
><DT
>A.6.3. <A
-HREF="faq.html#AEN1644"
+HREF="faq.html#AEN1667"
> I've implemented the security fixes mentioned in Chris Yeh's security
advisory of 5/10/2000 advising not to run MySQL as root, and am running into
problems with MySQL no longer working correctly.
@@ -455,48 +463,48 @@ HREF="faq.html#FAQ_EMAIL"
><DL
><DT
>A.7.1. <A
-HREF="faq.html#AEN1651"
+HREF="faq.html#AEN1674"
> I have a user who doesn't want to receive any more email from Bugzilla.
How do I stop it entirely for this user?
</A
></DT
><DT
>A.7.2. <A
-HREF="faq.html#AEN1656"
+HREF="faq.html#AEN1679"
> I'm evaluating/testing Bugzilla, and don't want it to send email to
anyone but me. How do I do it?
</A
></DT
><DT
>A.7.3. <A
-HREF="faq.html#AEN1661"
+HREF="faq.html#AEN1684"
> I want whineatnews.pl to whine at something more, or other than, only new
bugs. How do I do it?
</A
></DT
><DT
>A.7.4. <A
-HREF="faq.html#AEN1667"
+HREF="faq.html#AEN1690"
> I don't like/want to use Procmail to hand mail off to bug_email.pl.
What alternatives do I have?
</A
></DT
><DT
>A.7.5. <A
-HREF="faq.html#AEN1674"
+HREF="faq.html#AEN1697"
> How do I set up the email interface to submit/change bugs via email?
</A
></DT
><DT
>A.7.6. <A
-HREF="faq.html#AEN1679"
+HREF="faq.html#AEN1702"
> Email takes FOREVER to reach me from bugzilla -- it's extremely slow.
What gives?
</A
></DT
><DT
>A.7.7. <A
-HREF="faq.html#AEN1686"
+HREF="faq.html#AEN1709"
> How come email never reaches me from bugzilla changes?
</A
></DT
@@ -511,60 +519,60 @@ HREF="faq.html#FAQ_DB"
><DL
><DT
>A.8.1. <A
-HREF="faq.html#AEN1694"
+HREF="faq.html#AEN1717"
> I've heard Bugzilla can be used with Oracle?
</A
></DT
><DT
>A.8.2. <A
-HREF="faq.html#AEN1699"
+HREF="faq.html#AEN1722"
> Bugs are missing from queries, but exist in the database (and I can pull
them up by specifying the bug ID). What's wrong?
</A
></DT
><DT
>A.8.3. <A
-HREF="faq.html#AEN1704"
+HREF="faq.html#AEN1727"
> I think my database might be corrupted, or contain invalid entries. What
do I do?
</A
></DT
><DT
>A.8.4. <A
-HREF="faq.html#AEN1709"
+HREF="faq.html#AEN1732"
> I want to manually edit some entries in my database. How?
</A
></DT
><DT
>A.8.5. <A
-HREF="faq.html#AEN1714"
+HREF="faq.html#AEN1737"
> I try to add myself as a user, but Bugzilla always tells me my password is wrong.
</A
></DT
><DT
>A.8.6. <A
-HREF="faq.html#AEN1719"
+HREF="faq.html#AEN1742"
> I think I've set up MySQL permissions correctly, but bugzilla still can't
connect.
</A
></DT
><DT
>A.8.7. <A
-HREF="faq.html#AEN1724"
+HREF="faq.html#AEN1747"
> How do I synchronize bug information among multiple different Bugzilla
databases?
</A
></DT
><DT
>A.8.8. <A
-HREF="faq.html#AEN1731"
+HREF="faq.html#AEN1754"
> Why do I get bizarre errors when trying to submit data, particularly problems
with "groupset"?
</A
></DT
><DT
>A.8.9. <A
-HREF="faq.html#AEN1736"
+HREF="faq.html#AEN1759"
> How come even after I delete bugs, the long descriptions show up?
</A
></DT
@@ -579,32 +587,32 @@ HREF="faq.html#FAQ_NT"
><DL
><DT
>A.9.1. <A
-HREF="faq.html#AEN1743"
+HREF="faq.html#AEN1766"
> What is the easiest way to run Bugzilla on Win32 (Win98+/NT/2K)?
</A
></DT
><DT
>A.9.2. <A
-HREF="faq.html#AEN1748"
+HREF="faq.html#AEN1771"
> Is there a "Bundle::Bugzilla" equivalent for Win32?
</A
></DT
><DT
>A.9.3. <A
-HREF="faq.html#AEN1753"
+HREF="faq.html#AEN1776"
> CGI's are failing with a "something.cgi is not a valid Windows NT
application" error. Why?
</A
></DT
><DT
>A.9.4. <A
-HREF="faq.html#AEN1761"
+HREF="faq.html#AEN1784"
> Can I have some general instructions on how to make Bugzilla on Win32 work?
</A
></DT
><DT
>A.9.5. <A
-HREF="faq.html#AEN1767"
+HREF="faq.html#AEN1790"
> I'm having trouble with the perl modules for NT not being able to talk to
to the database.
</A
@@ -620,34 +628,34 @@ HREF="faq.html#FAQ_USE"
><DL
><DT
>A.10.1. <A
-HREF="faq.html#AEN1788"
+HREF="faq.html#AEN1811"
> The query page is very confusing. Isn't there a simpler way to query?
</A
></DT
><DT
>A.10.2. <A
-HREF="faq.html#AEN1794"
+HREF="faq.html#AEN1817"
> I'm confused by the behavior of the "accept" button in the Show Bug form.
Why doesn't it assign the bug to me when I accept it?
</A
></DT
><DT
>A.10.3. <A
-HREF="faq.html#AEN1804"
+HREF="faq.html#AEN1827"
> I can't upload anything into the database via the "Create Attachment"
link. What am I doing wrong?
</A
></DT
><DT
>A.10.4. <A
-HREF="faq.html#AEN1809"
+HREF="faq.html#AEN1832"
> Email submissions to Bugzilla that have attachments end up asking me to
save it as a "cgi" file.
</A
></DT
><DT
>A.10.5. <A
-HREF="faq.html#AEN1814"
+HREF="faq.html#AEN1837"
> How do I change a keyword in Bugzilla, once some bugs are using it?
</A
></DT
@@ -662,20 +670,20 @@ HREF="faq.html#FAQ_HACKING"
><DL
><DT
>A.11.1. <A
-HREF="faq.html#AEN1821"
+HREF="faq.html#AEN1844"
> What bugs are in Bugzilla right now?
</A
></DT
><DT
>A.11.2. <A
-HREF="faq.html#AEN1830"
+HREF="faq.html#AEN1853"
> How can I change the default priority to a null value? For instance, have the default
priority be "---" instead of "P2"?
</A
></DT
><DT
>A.11.3. <A
-HREF="faq.html#AEN1836"
+HREF="faq.html#AEN1859"
> What's the best way to submit patches? What guidelines should I follow?
</A
></DT
@@ -695,7 +703,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1302"
+NAME="AEN1319"
></A
><B
>A.1.1. </B
@@ -721,7 +729,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1308"
+NAME="AEN1325"
></A
><B
>A.1.2. </B
@@ -748,7 +756,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1314"
+NAME="AEN1331"
></A
><B
>A.1.3. </B
@@ -783,7 +791,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1321"
+NAME="AEN1338"
></A
><B
>A.1.4. </B
@@ -891,7 +899,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1346"
+NAME="AEN1363"
></A
><B
>A.1.5. </B
@@ -919,7 +927,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1351"
+NAME="AEN1368"
></A
><B
>A.1.6. </B
@@ -954,7 +962,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1358"
+NAME="AEN1375"
></A
><B
>A.1.7. </B
@@ -977,7 +985,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1363"
+NAME="AEN1380"
></A
><B
>A.1.8. </B
@@ -1015,7 +1023,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1370"
+NAME="AEN1387"
></A
><B
>A.1.9. </B
@@ -1030,7 +1038,7 @@ CLASS="ANSWER"
> </B
>Terry Weissman answers,
<A
-NAME="AEN1374"
+NAME="AEN1391"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -1106,7 +1114,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1388"
+NAME="AEN1405"
></A
><B
>A.1.10. </B
@@ -1126,7 +1134,7 @@ CLASS="ANSWER"
><P
> Here's Terry Weissman's comment, for some historical context:
<A
-NAME="AEN1393"
+NAME="AEN1410"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -1191,7 +1199,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1405"
+NAME="AEN1422"
></A
><B
>A.2.1. </B
@@ -1215,7 +1223,7 @@ CLASS="ANSWER"
><P
> Dave Lawrence, the original Red Hat Bugzilla maintainer, mentions:
<A
-NAME="AEN1410"
+NAME="AEN1427"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -1238,7 +1246,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1413"
+NAME="AEN1430"
></A
><B
>A.2.2. </B
@@ -1254,7 +1262,7 @@ CLASS="ANSWER"
>Dave Lawrence</EM
>:
<A
-NAME="AEN1418"
+NAME="AEN1435"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -1370,7 +1378,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1441"
+NAME="AEN1458"
></A
><B
>A.2.3. </B
@@ -1400,7 +1408,7 @@ CLASS="NOTE"
>Dave Lawrence</EM
>:
<A
-NAME="AEN1448"
+NAME="AEN1465"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -1491,7 +1499,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1457"
+NAME="AEN1474"
></A
><B
>A.3.1. </B
@@ -1506,7 +1514,7 @@ CLASS="ANSWER"
> Loki Games has a customized version of Bugzilla available at
http://fenris.lokigames.com. From that page,
<A
-NAME="AEN1461"
+NAME="AEN1478"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -1536,7 +1544,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1464"
+NAME="AEN1481"
></A
><B
>A.3.2. </B
@@ -1560,7 +1568,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1469"
+NAME="AEN1486"
></A
><B
>A.3.3. </B
@@ -1597,7 +1605,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1477"
+NAME="AEN1494"
></A
><B
>A.4.1. </B
@@ -1621,7 +1629,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1482"
+NAME="AEN1499"
></A
><B
>A.4.2. </B
@@ -1648,7 +1656,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1487"
+NAME="AEN1504"
></A
><B
>A.4.3. </B
@@ -1674,7 +1682,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1492"
+NAME="AEN1509"
></A
><B
>A.4.4. </B
@@ -1697,7 +1705,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1497"
+NAME="AEN1514"
></A
><B
>A.4.5. </B
@@ -1725,7 +1733,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1502"
+NAME="AEN1519"
></A
><B
>A.4.6. </B
@@ -1751,10 +1759,67 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1507"
+NAME="AEN1524"
></A
><B
>A.4.7. </B
+> The index.html page doesn't show the footer. It's really annoying to have
+ to go to the querypage just to check my "my bugs" link. How do I get a footer
+ on static HTML pages?
+ </P
+></DIV
+><DIV
+CLASS="ANSWER"
+><P
+><B
+> </B
+> This was a late-breaking question for the Guide, so I just have to
+ quote the relevant newsgroup thread on it.
+ </P
+><P
+CLASS="LITERALLAYOUT"
+>&#62;&nbsp;AFAIK,&nbsp;most&nbsp;sites&nbsp;(even&nbsp;if&nbsp;they&nbsp;have&nbsp;SSI&nbsp;enabled)&nbsp;won't&nbsp;have&nbsp;#exec&nbsp;cmd<br>
+&#62;&nbsp;enabled.&nbsp;&nbsp;Perhaps&nbsp;what&nbsp;would&nbsp;be&nbsp;better&nbsp;is&nbsp;a&nbsp;#include&nbsp;virtual&nbsp;and&nbsp;a<br>
+&#62;&nbsp;footer.cgi&nbsp;the&nbsp;basically&nbsp;has&nbsp;the&nbsp;"require&nbsp;'CGI.pl'&nbsp;and&nbsp;PutFooter&nbsp;command.<br>
+&#62;<br>
+&#62;&nbsp;Please&nbsp;note&nbsp;that&nbsp;under&nbsp;most&nbsp;configurations,&nbsp;this&nbsp;also&nbsp;requires&nbsp;naming<br>
+&#62;&nbsp;the&nbsp;file&nbsp;from&nbsp;index.html&nbsp;to&nbsp;index.shtml&nbsp;(and&nbsp;making&nbsp;sure&nbsp;that&nbsp;it&nbsp;will<br>
+&#62;&nbsp;still&nbsp;be&nbsp;reconized&nbsp;as&nbsp;an&nbsp;index).&nbsp;&nbsp;Personally,&nbsp;I&nbsp;think&nbsp;this&nbsp;is&nbsp;better&nbsp;on<br>
+&#62;&nbsp;a&nbsp;per-installation&nbsp;basis&nbsp;(perhaps&nbsp;add&nbsp;something&nbsp;to&nbsp;the&nbsp;FAQ&nbsp;that&nbsp;says&nbsp;how<br>
+&#62;&nbsp;to&nbsp;do&nbsp;this).<br>
+<br>
+Good&nbsp;point.&nbsp;&nbsp;Yeah,&nbsp;easy&nbsp;enough&nbsp;to&nbsp;do,&nbsp;that&nbsp;it&nbsp;shouldn't&nbsp;be&nbsp;a&nbsp;big&nbsp;deal&nbsp;for<br>
+someone&nbsp;to&nbsp;take&nbsp;it&nbsp;on&nbsp;if&nbsp;they&nbsp;want&nbsp;it.&nbsp;&nbsp;FAQ&nbsp;is&nbsp;a&nbsp;good&nbsp;place&nbsp;for&nbsp;it.<br>
+<br>
+&#62;&nbsp;Dave&nbsp;Miller&nbsp;wrote:<br>
+&#62;<br>
+&#62;&#62;&nbsp;I&nbsp;did&nbsp;a&nbsp;little&nbsp;experimenting&nbsp;with&nbsp;getting&nbsp;the&nbsp;command&nbsp;menu&nbsp;and&nbsp;footer&nbsp;on<br>
+&#62;&#62;&nbsp;the&nbsp;end&nbsp;of&nbsp;the&nbsp;index&nbsp;page&nbsp;while&nbsp;leaving&nbsp;it&nbsp;as&nbsp;an&nbsp;HTML&nbsp;file...<br>
+&#62;&#62;<br>
+&#62;&#62;&nbsp;I&nbsp;was&nbsp;successful.&nbsp;:)<br>
+&#62;&#62;<br>
+&#62;&#62;&nbsp;I&nbsp;added&nbsp;this&nbsp;line:<br>
+&#62;&#62;<br>
+&#62;&#62;&nbsp;<br>
+&#62;&#62;<br>
+&#62;&#62;&nbsp;Just&nbsp;before&nbsp;the&nbsp;&#60;/BODY&#62;&nbsp;&#60;/HTML&#62;&nbsp;at&nbsp;the&nbsp;end&nbsp;of&nbsp;the&nbsp;file.&nbsp;&nbsp;And&nbsp;it&nbsp;worked.<br>
+&#62;&#62;<br>
+&#62;&#62;&nbsp;Thought&nbsp;I'd&nbsp;toss&nbsp;that&nbsp;out&nbsp;there.&nbsp;&nbsp;Should&nbsp;I&nbsp;check&nbsp;this&nbsp;in?&nbsp;&nbsp;For&nbsp;those&nbsp;that<br>
+&#62;&#62;&nbsp;have&nbsp;SSI&nbsp;disabled,&nbsp;it'll&nbsp;act&nbsp;like&nbsp;a&nbsp;comment,&nbsp;so&nbsp;I&nbsp;wouldn't&nbsp;think&nbsp;it&nbsp;would<br>
+&#62;&#62;&nbsp;break&nbsp;anything.<br>
+ &nbsp;&nbsp;</P
+></DIV
+></DIV
+><DIV
+CLASS="QANDAENTRY"
+><DIV
+CLASS="QUESTION"
+><P
+><A
+NAME="AEN1530"
+></A
+><B
+>A.4.8. </B
> Does Bugzilla provide any reporting features, metrics, graphs, etc? You
know, the type of stuff that management likes to see. :)
</P
@@ -1790,10 +1855,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1515"
+NAME="AEN1538"
></A
><B
->A.4.8. </B
+>A.4.9. </B
> Is there email notification and if so, what do you see when you get an
email? Do you see bug number and title or is it only the number?
</P
@@ -1815,10 +1880,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1520"
+NAME="AEN1543"
></A
><B
->A.4.9. </B
+>A.4.10. </B
> Can email notification be set up to send to multiple
people, some on the To List, CC List, BCC List etc?
</P
@@ -1838,10 +1903,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1525"
+NAME="AEN1548"
></A
><B
->A.4.10. </B
+>A.4.11. </B
> If there is email notification, do users have to have any particular
type of email application?
</P
@@ -1879,10 +1944,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1532"
+NAME="AEN1555"
></A
><B
->A.4.11. </B
+>A.4.12. </B
> If I just wanted to track certain bugs, as they go through life, can I
set it up to alert me via email whenever that bug changes, whether it be
owner, status or description etc.?
@@ -1906,10 +1971,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1537"
+NAME="AEN1560"
></A
><B
->A.4.12. </B
+>A.4.13. </B
> Does Bugzilla allow data to be imported and exported? If I had outsiders
write up a bug report using a MS Word bug template, could that template be
imported into "matching" fields? If I wanted to take the results of a query
@@ -1951,10 +2016,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1545"
+NAME="AEN1568"
></A
><B
->A.4.13. </B
+>A.4.14. </B
> Does Bugzilla allow fields to be added, changed or deleted? If I want to
customize the bug submission form to meet our needs, can I do that using our
terminology?
@@ -1975,10 +2040,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1550"
+NAME="AEN1573"
></A
><B
->A.4.14. </B
+>A.4.15. </B
> Has anyone converted Bugzilla to another language to be used in other
countries? Is it localizable?
</P
@@ -2001,10 +2066,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1555"
+NAME="AEN1578"
></A
><B
->A.4.15. </B
+>A.4.16. </B
> Can a user create and save reports? Can they do this in Word format?
Excel format?
</P
@@ -2024,10 +2089,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1560"
+NAME="AEN1583"
></A
><B
->A.4.16. </B
+>A.4.17. </B
> Can a user re-run a report with a new project, same query?
</P
></DIV
@@ -2046,10 +2111,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1565"
+NAME="AEN1588"
></A
><B
->A.4.17. </B
+>A.4.18. </B
> Can a user modify an existing report and then save it into another name?
</P
></DIV
@@ -2069,10 +2134,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1570"
+NAME="AEN1593"
></A
><B
->A.4.18. </B
+>A.4.19. </B
> Does Bugzilla have the ability to search by word, phrase, compound
search?
</P
@@ -2093,10 +2158,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1575"
+NAME="AEN1598"
></A
><B
->A.4.19. </B
+>A.4.20. </B
> Can the admin person establish separate group and individual user
privileges?
</P
@@ -2116,10 +2181,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1580"
+NAME="AEN1603"
></A
><B
->A.4.20. </B
+>A.4.21. </B
> Does Bugzilla provide record locking when there is simultaneous access
to the same bug? Does the second person get a notice that the bug is in use
or how are they notified?
@@ -2141,10 +2206,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1585"
+NAME="AEN1608"
></A
><B
->A.4.21. </B
+>A.4.22. </B
> Are there any backup features provided?
</P
></DIV
@@ -2169,10 +2234,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1591"
+NAME="AEN1614"
></A
><B
->A.4.22. </B
+>A.4.23. </B
> Can users be on the system while a backup is in progress?
</P
></DIV
@@ -2193,10 +2258,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1596"
+NAME="AEN1619"
></A
><B
->A.4.23. </B
+>A.4.24. </B
> What type of human resources are needed to be on staff to install and
maintain Bugzilla? Specifically, what type of skills does the person need to
have? I need to find out if we were to go with Bugzilla, what types of
@@ -2232,10 +2297,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1603"
+NAME="AEN1626"
></A
><B
->A.4.24. </B
+>A.4.25. </B
> What time frame are we looking at if we decide to hire people to install
and maintain the Bugzilla? Is this something that takes hours or weeks to
install and a couple of hours per week to maintain and customize or is this
@@ -2263,10 +2328,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1608"
+NAME="AEN1631"
></A
><B
->A.4.25. </B
+>A.4.26. </B
> Is there any licensing fee or other fees for using Bugzilla? Any
out-of-pocket cost other than the bodies needed as identified above?
</P
@@ -2295,7 +2360,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1615"
+NAME="AEN1638"
></A
><B
>A.5.1. </B
@@ -2323,7 +2388,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1621"
+NAME="AEN1644"
></A
><B
>A.5.2. </B
@@ -2346,7 +2411,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1626"
+NAME="AEN1649"
></A
><B
>A.5.3. </B
@@ -2376,7 +2441,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1633"
+NAME="AEN1656"
></A
><B
>A.6.1. </B
@@ -2404,7 +2469,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1639"
+NAME="AEN1662"
></A
><B
>A.6.2. </B
@@ -2429,7 +2494,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1644"
+NAME="AEN1667"
></A
><B
>A.6.3. </B
@@ -2463,7 +2528,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1651"
+NAME="AEN1674"
></A
><B
>A.7.1. </B
@@ -2487,7 +2552,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1656"
+NAME="AEN1679"
></A
><B
>A.7.2. </B
@@ -2511,7 +2576,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1661"
+NAME="AEN1684"
></A
><B
>A.7.3. </B
@@ -2541,7 +2606,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1667"
+NAME="AEN1690"
></A
><B
>A.7.4. </B
@@ -2557,7 +2622,7 @@ CLASS="ANSWER"
> You can call bug_email.pl directly from your aliases file, with
an entry like this:
<A
-NAME="AEN1671"
+NAME="AEN1694"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -2578,7 +2643,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1674"
+NAME="AEN1697"
></A
><B
>A.7.5. </B
@@ -2601,7 +2666,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1679"
+NAME="AEN1702"
></A
><B
>A.7.6. </B
@@ -2639,7 +2704,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1686"
+NAME="AEN1709"
></A
><B
>A.7.7. </B
@@ -2677,7 +2742,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1694"
+NAME="AEN1717"
></A
><B
>A.8.1. </B
@@ -2702,7 +2767,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1699"
+NAME="AEN1722"
></A
><B
>A.8.2. </B
@@ -2737,7 +2802,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1704"
+NAME="AEN1727"
></A
><B
>A.8.3. </B
@@ -2765,7 +2830,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1709"
+NAME="AEN1732"
></A
><B
>A.8.4. </B
@@ -2792,7 +2857,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1714"
+NAME="AEN1737"
></A
><B
>A.8.5. </B
@@ -2816,7 +2881,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1719"
+NAME="AEN1742"
></A
><B
>A.8.6. </B
@@ -2843,7 +2908,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1724"
+NAME="AEN1747"
></A
><B
>A.8.7. </B
@@ -2879,7 +2944,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1731"
+NAME="AEN1754"
></A
><B
>A.8.8. </B
@@ -2905,7 +2970,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1736"
+NAME="AEN1759"
></A
><B
>A.8.9. </B
@@ -2938,7 +3003,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1743"
+NAME="AEN1766"
></A
><B
>A.9.1. </B
@@ -2961,7 +3026,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1748"
+NAME="AEN1771"
></A
><B
>A.9.2. </B
@@ -2985,7 +3050,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1753"
+NAME="AEN1776"
></A
><B
>A.9.3. </B
@@ -3006,7 +3071,7 @@ CLASS="ANSWER"
><P
> Microsoft has some advice on this matter, as well:
<A
-NAME="AEN1758"
+NAME="AEN1781"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -3031,7 +3096,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1761"
+NAME="AEN1784"
></A
><B
>A.9.4. </B
@@ -3142,7 +3207,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1767"
+NAME="AEN1790"
></A
><B
>A.9.5. </B
@@ -3217,7 +3282,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1788"
+NAME="AEN1811"
></A
><B
>A.10.1. </B
@@ -3245,7 +3310,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1794"
+NAME="AEN1817"
></A
><B
>A.10.2. </B
@@ -3298,7 +3363,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1804"
+NAME="AEN1827"
></A
><B
>A.10.3. </B
@@ -3323,7 +3388,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1809"
+NAME="AEN1832"
></A
><B
>A.10.4. </B
@@ -3348,7 +3413,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1814"
+NAME="AEN1837"
></A
><B
>A.10.5. </B
@@ -3380,7 +3445,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1821"
+NAME="AEN1844"
></A
><B
>A.11.1. </B
@@ -3424,7 +3489,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1830"
+NAME="AEN1853"
></A
><B
>A.11.2. </B
@@ -3456,7 +3521,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION"
><P
><A
-NAME="AEN1836"
+NAME="AEN1859"
></A
><B
>A.11.3. </B
diff --git a/docs/html/gfdl.html b/docs/html/gfdl.html
index 5cd6b47cc..5be5aa5aa 100644
--- a/docs/html/gfdl.html
+++ b/docs/html/gfdl.html
@@ -141,7 +141,7 @@ HREF="gfdl_howto.html"
><P
>Version 1.1, March 2000</P
><A
-NAME="AEN2019"
+NAME="AEN2042"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
diff --git a/docs/html/gfdl_howto.html b/docs/html/gfdl_howto.html
index 8a7f15f58..2705130ad 100644
--- a/docs/html/gfdl_howto.html
+++ b/docs/html/gfdl_howto.html
@@ -78,7 +78,7 @@ NAME="GFDL_HOWTO"
a copy of the License in the document and put the following
copyright and license notices just after the title page:</P
><A
-NAME="AEN2109"
+NAME="AEN2132"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
diff --git a/docs/html/glossary.html b/docs/html/glossary.html
index 35c6df076..409fd8a6d 100644
--- a/docs/html/glossary.html
+++ b/docs/html/glossary.html
@@ -163,7 +163,7 @@ NAME="GLOSS_P"
><DIV
CLASS="EXAMPLE"
><A
-NAME="AEN2145"
+NAME="AEN2168"
></A
><P
><B
diff --git a/docs/html/how.html b/docs/html/how.html
index 60ad56e55..66cd6e5d3 100644
--- a/docs/html/how.html
+++ b/docs/html/how.html
@@ -344,7 +344,7 @@ TYPE="1"
<DIV
CLASS="EXAMPLE"
><A
-NAME="AEN1095"
+NAME="AEN1112"
></A
><P
><B
@@ -353,7 +353,7 @@ NAME="AEN1095"
><DIV
CLASS="INFORMALEXAMPLE"
><A
-NAME="AEN1097"
+NAME="AEN1114"
></A
><P
></P
@@ -405,7 +405,7 @@ NAME="AEN1097"
<DIV
CLASS="EXAMPLE"
><A
-NAME="AEN1105"
+NAME="AEN1122"
></A
><P
><B
@@ -414,7 +414,7 @@ NAME="AEN1105"
><DIV
CLASS="INFORMALEXAMPLE"
><A
-NAME="AEN1107"
+NAME="AEN1124"
></A
><P
></P
diff --git a/docs/html/index.html b/docs/html/index.html
index 815c0e1c2..ab0c52131 100644
--- a/docs/html/index.html
+++ b/docs/html/index.html
@@ -309,37 +309,37 @@ HREF="readme.unix.html#AEN334"
></DT
><DT
>2.1.2.14. <A
-HREF="readme.unix.html#AEN343"
+HREF="readme.unix.html#AEN347"
>Setting Up the MySQL Database</A
></DT
><DT
>2.1.2.15. <A
-HREF="readme.unix.html#AEN379"
+HREF="readme.unix.html#AEN383"
>Tweaking "localconfig"</A
></DT
><DT
>2.1.2.16. <A
-HREF="readme.unix.html#AEN401"
->Setting Up Maintainers Manuall (Optional)</A
+HREF="readme.unix.html#AEN410"
+>Setting Up Maintainers Manually (Optional)</A
></DT
><DT
>2.1.2.17. <A
-HREF="readme.unix.html#AEN410"
+HREF="readme.unix.html#AEN419"
>The Whining Cron (Optional)</A
></DT
><DT
>2.1.2.18. <A
-HREF="readme.unix.html#AEN417"
+HREF="readme.unix.html#AEN426"
>Bug Graphs (Optional)</A
></DT
><DT
>2.1.2.19. <A
-HREF="readme.unix.html#AEN429"
+HREF="readme.unix.html#AEN438"
>Securing MySQL</A
></DT
><DT
>2.1.2.20. <A
-HREF="readme.unix.html#AEN495"
+HREF="readme.unix.html#AEN504"
>Installation General Notes</A
></DT
></DL
@@ -809,57 +809,67 @@ CLASS="LOT"
></DT
><DT
>2-1. <A
-HREF="readme.windows.html#AEN646"
+HREF="readme.unix.html#AEN341"
+>Setting up bonsaitools symlink</A
+></DT
+><DT
+>2-2. <A
+HREF="readme.unix.html#AEN403"
+>Running checksetup.pl as the web user</A
+></DT
+><DT
+>2-3. <A
+HREF="readme.windows.html#AEN655"
>Removing encrypt() for Windows NT installations</A
></DT
><DT
>3-1. <A
-HREF="programadmin.html#AEN838"
+HREF="programadmin.html#AEN850"
>Creating some Components</A
></DT
><DT
>3-2. <A
-HREF="programadmin.html#AEN867"
+HREF="programadmin.html#AEN879"
>Common Use of Versions</A
></DT
><DT
>3-3. <A
-HREF="programadmin.html#AEN871"
+HREF="programadmin.html#AEN883"
>A Different Use of Versions</A
></DT
><DT
>3-4. <A
-HREF="programadmin.html#AEN899"
+HREF="programadmin.html#AEN911"
>Using SortKey with Target Milestone</A
></DT
><DT
>3-5. <A
-HREF="programadmin.html#AEN937"
+HREF="programadmin.html#AEN949"
>When to Use Group Security</A
></DT
><DT
>3-6. <A
-HREF="programadmin.html#AEN954"
+HREF="programadmin.html#AEN966"
>Creating a New Group</A
></DT
><DT
>4-1. <A
-HREF="how.html#AEN1095"
+HREF="how.html#AEN1112"
>Some Famous Software Versions</A
></DT
><DT
>4-2. <A
-HREF="how.html#AEN1105"
+HREF="how.html#AEN1122"
>Mozilla Webtools Components</A
></DT
><DT
>D-1. <A
-HREF="setperl.html#AEN1963"
+HREF="setperl.html#AEN1986"
>Using Setperl to set your perl path</A
></DT
><DT
>1. <A
-HREF="glossary.html#AEN2145"
+HREF="glossary.html#AEN2168"
>A Sample Product</A
></DT
></DL
diff --git a/docs/html/installation.html b/docs/html/installation.html
index f46abd61b..171ebd430 100644
--- a/docs/html/installation.html
+++ b/docs/html/installation.html
@@ -162,54 +162,54 @@ HREF="readme.unix.html#AEN334"
></DT
><DT
>2.1.2.14. <A
-HREF="readme.unix.html#AEN343"
+HREF="readme.unix.html#AEN347"
>Setting Up the MySQL Database</A
></DT
><DT
>2.1.2.15. <A
-HREF="readme.unix.html#AEN379"
+HREF="readme.unix.html#AEN383"
>Tweaking "localconfig"</A
></DT
><DT
>2.1.2.16. <A
-HREF="readme.unix.html#AEN401"
->Setting Up Maintainers Manuall (Optional)</A
+HREF="readme.unix.html#AEN410"
+>Setting Up Maintainers Manually (Optional)</A
></DT
><DT
>2.1.2.17. <A
-HREF="readme.unix.html#AEN410"
+HREF="readme.unix.html#AEN419"
>The Whining Cron (Optional)</A
></DT
><DT
>2.1.2.18. <A
-HREF="readme.unix.html#AEN417"
+HREF="readme.unix.html#AEN426"
>Bug Graphs (Optional)</A
></DT
><DT
>2.1.2.19. <A
-HREF="readme.unix.html#AEN429"
+HREF="readme.unix.html#AEN438"
>Securing MySQL</A
></DT
><DT
>2.1.2.20. <A
-HREF="readme.unix.html#AEN495"
+HREF="readme.unix.html#AEN504"
>Installation General Notes</A
></DT
><DD
><DL
><DT
>2.1.2.20.1. <A
-HREF="readme.unix.html#AEN497"
+HREF="readme.unix.html#AEN506"
>Modifying Your Running System</A
></DT
><DT
>2.1.2.20.2. <A
-HREF="readme.unix.html#AEN502"
+HREF="readme.unix.html#AEN511"
>Upgrading From Previous Versions</A
></DT
><DT
>2.1.2.20.3. <A
-HREF="readme.unix.html#AEN505"
+HREF="readme.unix.html#AEN514"
>UNIX Installation Instructions History</A
></DT
></DL
diff --git a/docs/html/programadmin.html b/docs/html/programadmin.html
index 0098bf805..6db026c82 100644
--- a/docs/html/programadmin.html
+++ b/docs/html/programadmin.html
@@ -194,7 +194,7 @@ NAME="COMPONENTS"
<DIV
CLASS="EXAMPLE"
><A
-NAME="AEN838"
+NAME="AEN850"
></A
><P
><B
@@ -203,7 +203,7 @@ NAME="AEN838"
><DIV
CLASS="INFORMALEXAMPLE"
><A
-NAME="AEN840"
+NAME="AEN852"
></A
><P
></P
@@ -324,7 +324,7 @@ NAME="VERSIONS"
<DIV
CLASS="EXAMPLE"
><A
-NAME="AEN867"
+NAME="AEN879"
></A
><P
><B
@@ -333,7 +333,7 @@ NAME="AEN867"
><DIV
CLASS="INFORMALEXAMPLE"
><A
-NAME="AEN869"
+NAME="AEN881"
></A
><P
></P
@@ -354,7 +354,7 @@ NAME="AEN869"
<DIV
CLASS="EXAMPLE"
><A
-NAME="AEN871"
+NAME="AEN883"
></A
><P
><B
@@ -363,7 +363,7 @@ NAME="AEN871"
><DIV
CLASS="INFORMALEXAMPLE"
><A
-NAME="AEN873"
+NAME="AEN885"
></A
><P
></P
@@ -472,7 +472,7 @@ TYPE="1"
><DIV
CLASS="EXAMPLE"
><A
-NAME="AEN899"
+NAME="AEN911"
></A
><P
><B
@@ -481,7 +481,7 @@ NAME="AEN899"
><DIV
CLASS="INFORMALEXAMPLE"
><A
-NAME="AEN901"
+NAME="AEN913"
></A
><P
></P
@@ -645,7 +645,7 @@ NAME="GROUPS"
<DIV
CLASS="EXAMPLE"
><A
-NAME="AEN937"
+NAME="AEN949"
></A
><P
><B
@@ -654,7 +654,7 @@ NAME="AEN937"
><DIV
CLASS="INFORMALEXAMPLE"
><A
-NAME="AEN939"
+NAME="AEN951"
></A
><P
></P
@@ -747,7 +747,7 @@ TYPE="1"
<DIV
CLASS="EXAMPLE"
><A
-NAME="AEN954"
+NAME="AEN966"
></A
><P
><B
@@ -756,7 +756,7 @@ NAME="AEN954"
><DIV
CLASS="INFORMALEXAMPLE"
><A
-NAME="AEN956"
+NAME="AEN968"
></A
><P
></P
diff --git a/docs/html/readme.unix.html b/docs/html/readme.unix.html
index faca430af..23f51096e 100644
--- a/docs/html/readme.unix.html
+++ b/docs/html/readme.unix.html
@@ -851,7 +851,7 @@ CLASS="TIP"
><P
><B
>Tip: </B
-> HINT: If you symlink the bugzilla directory into your Apache's
+> If you symlink the bugzilla directory into your Apache's
HTML heirarchy, you may receive "Forbidden" errors unless you
add the "FollowSymLinks" directive to the &#60;Directory&#62; entry
for the HTML root.
@@ -866,12 +866,45 @@ CLASS="TIP"
installation.
</P
><P
-> Lastly, you'll need to set up a symbolic link from /usr/bonsaitools/bin
- to the correct location of your perl executable (probably /usr/bin/perl).
+> 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. To make future upgrades easier, you should use the symlink
approach.
<DIV
+CLASS="EXAMPLE"
+><A
+NAME="AEN341"
+></A
+><P
+><B
+>Example 2-1. Setting up bonsaitools symlink</B
+></P
+><P
+> Here's how you set up the Perl symlink on Linux to make Bugzilla work.
+ Your mileage may vary; if you are running on Solaris, you probably need to subsitute
+ "/usr/local/bin/perl" for "/usr/bin/perl" below; if on certain other UNIX systems,
+ Perl may live in weird places like "/opt/perl". As root, run these commands:
+ <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>bash# mkdir /usr/bonsaitools
+bash# mkdir /usr/bonsaitools/bin
+bash# ln -s /usr/bin/perl /usr/bosaitools/bin/perl
+ </PRE
+></TD
+></TR
+></TABLE
+>
+ </P
+></DIV
+>
+ <DIV
CLASS="TIP"
><BLOCKQUOTE
CLASS="TIP"
@@ -893,7 +926,7 @@ CLASS="SECTION"
><H3
CLASS="SECTION"
><A
-NAME="AEN343"
+NAME="AEN347"
>2.1.2.14. Setting Up the MySQL Database</A
></H3
><P
@@ -1079,7 +1112,7 @@ CLASS="SECTION"
><H3
CLASS="SECTION"
><A
-NAME="AEN379"
+NAME="AEN383"
>2.1.2.15. Tweaking "localconfig"</A
></H3
><P
@@ -1146,11 +1179,47 @@ CLASS="NOTE"
><P
><B
>Note: </B
-> The second time you run checksetup.pl, it is recommended you be the same
- user as your web server runs under, and that you be sure you have set the
+> The second time you run checksetup.pl, you should become the
+ user your web server runs as, and that you ensure you have set the
"webservergroup" parameter in localconfig to match the web server's group
- name, if any. Under some systems, otherwise, checksetup.pl will goof up
- your file permissions and make them unreadable to your web server.
+ name, if any. I believe, for the next release of Bugzilla, this will
+ be fixed so that Bugzilla supports a "webserveruser" parameter in localconfig
+ as well.
+ <DIV
+CLASS="EXAMPLE"
+><A
+NAME="AEN403"
+></A
+><P
+><B
+>Example 2-2. Running checksetup.pl as the web user</B
+></P
+><P
+> Assuming your web server runs as user "apache", and Bugzilla is installed in
+ "/usr/local/bugzilla", here's one way to run checksetup.pl as the web server user.
+ As root, for the <EM
+>second run</EM
+> of checksetup.pl, do this:
+ <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>bash# chown -R apache:apache /usr/local/bugzilla
+bash# su - apache
+bash# cd /usr/local/bugzilla
+bash# ./checksetup.pl
+ </PRE
+></TD
+></TR
+></TABLE
+>
+ </P
+></DIV
+>
</P
></BLOCKQUOTE
></DIV
@@ -1174,8 +1243,8 @@ CLASS="SECTION"
><H3
CLASS="SECTION"
><A
-NAME="AEN401"
->2.1.2.16. Setting Up Maintainers Manuall (Optional)</A
+NAME="AEN410"
+>2.1.2.16. Setting Up Maintainers Manually (Optional)</A
></H3
><P
> If you want to add someone else to every group by hand, you can do it
@@ -1220,7 +1289,7 @@ CLASS="SECTION"
><H3
CLASS="SECTION"
><A
-NAME="AEN410"
+NAME="AEN419"
>2.1.2.17. The Whining Cron (Optional)</A
></H3
><P
@@ -1258,7 +1327,7 @@ CLASS="SECTION"
><H3
CLASS="SECTION"
><A
-NAME="AEN417"
+NAME="AEN426"
>2.1.2.18. Bug Graphs (Optional)</A
></H3
><P
@@ -1313,7 +1382,7 @@ CLASS="SECTION"
><H3
CLASS="SECTION"
><A
-NAME="AEN429"
+NAME="AEN438"
>2.1.2.19. Securing MySQL</A
></H3
><P
@@ -1591,7 +1660,7 @@ CLASS="SECTION"
><H3
CLASS="SECTION"
><A
-NAME="AEN495"
+NAME="AEN504"
>2.1.2.20. Installation General Notes</A
></H3
><DIV
@@ -1599,7 +1668,7 @@ CLASS="SECTION"
><H4
CLASS="SECTION"
><A
-NAME="AEN497"
+NAME="AEN506"
>2.1.2.20.1. Modifying Your Running System</A
></H4
><P
@@ -1626,7 +1695,7 @@ CLASS="SECTION"
><H4
CLASS="SECTION"
><A
-NAME="AEN502"
+NAME="AEN511"
>2.1.2.20.2. Upgrading From Previous Versions</A
></H4
><P
@@ -1642,7 +1711,7 @@ CLASS="SECTION"
><H4
CLASS="SECTION"
><A
-NAME="AEN505"
+NAME="AEN514"
>2.1.2.20.3. UNIX Installation Instructions History</A
></H4
><P
diff --git a/docs/html/readme.windows.html b/docs/html/readme.windows.html
index dc29a39ef..d1f46ca61 100644
--- a/docs/html/readme.windows.html
+++ b/docs/html/readme.windows.html
@@ -510,7 +510,7 @@ CLASS="TIP"
>Tip: </B
> From Andrew Pearson:
<A
-NAME="AEN624"
+NAME="AEN633"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -557,7 +557,7 @@ CLASS="TIP"
>Tip: </B
>"Brian" had this to add, about upgrading to Bugzilla 2.12 from previous versions:</P
><A
-NAME="AEN634"
+NAME="AEN643"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -613,11 +613,11 @@ CLASS="PROGRAMLISTING"
<DIV
CLASS="EXAMPLE"
><A
-NAME="AEN646"
+NAME="AEN655"
></A
><P
><B
->Example 2-1. Removing encrypt() for Windows NT installations</B
+>Example 2-3. Removing encrypt() for Windows NT installations</B
></P
><P
> Replace this:
@@ -691,6 +691,63 @@ open SENDMAIL, "|\"C:/General/Web/tools/Windmail 4.0 Beta/windmail\" -t &#62; ma
></BLOCKQUOTE
></BLOCKQUOTE
></DIV
+><DIV
+CLASS="TIP"
+><BLOCKQUOTE
+CLASS="TIP"
+><P
+><B
+>Tip: </B
+> This was some late breaking information from Jan Evert. Sorry for the lack of formatting.
+ </P
+><P
+CLASS="LITERALLAYOUT"
+>I'm&nbsp;busy&nbsp;installing&nbsp;bugzilla&nbsp;on&nbsp;a&nbsp;WinNT&nbsp;machine&nbsp;and&nbsp;I&nbsp;thought&nbsp;I'd&nbsp;notify&nbsp;you<br>
+at&nbsp;this&nbsp;moment&nbsp;of&nbsp;the&nbsp;commments&nbsp;I&nbsp;have&nbsp;to&nbsp;section&nbsp;2.2.1&nbsp;of&nbsp;the&nbsp;bugzilla<br>
+guide&nbsp;(at&nbsp;http://www.trilobyte.net/barnsons/html/).<br>
+<br>
+Step&nbsp;1:<br>
+I've&nbsp;used&nbsp;apache,&nbsp;installation&nbsp;is&nbsp;really&nbsp;straightforward.<br>
+After&nbsp;reading&nbsp;the&nbsp;Unix&nbsp;installation&nbsp;instructions,&nbsp;I&nbsp;found&nbsp;that&nbsp;it&nbsp;is<br>
+necessary&nbsp;to&nbsp;add&nbsp;the&nbsp;ExecCGI&nbsp;option&nbsp;to&nbsp;the&nbsp;bugzilla&nbsp;directory.&nbsp;Also&nbsp;the<br>
+'AddHandler'&nbsp;line&nbsp;for&nbsp;.cgi&nbsp;is&nbsp;by&nbsp;default&nbsp;commented&nbsp;out.<br>
+<br>
+Step&nbsp;3:&nbsp;although&nbsp;just&nbsp;a&nbsp;detail,&nbsp;'ppm&nbsp;install&nbsp;&#60;module%gt;'&nbsp;will&nbsp;also&nbsp;work<br>
+(wihtout&nbsp;.ppd).&nbsp;And,&nbsp;it&nbsp;can&nbsp;also&nbsp;download&nbsp;these&nbsp;automatically&nbsp;from<br>
+ActiveState.<br>
+<br>
+Step&nbsp;4:&nbsp;although&nbsp;I&nbsp;have&nbsp;cygwin&nbsp;installed,&nbsp;it&nbsp;seems&nbsp;that&nbsp;it&nbsp;is&nbsp;not&nbsp;necessary.<br>
+On&nbsp;my&nbsp;machine&nbsp;cygwin&nbsp;is&nbsp;not&nbsp;in&nbsp;the&nbsp;PATH&nbsp;and&nbsp;everything&nbsp;seems&nbsp;to&nbsp;work&nbsp;as<br>
+expected.<br>
+However,&nbsp;I've&nbsp;not&nbsp;used&nbsp;everything&nbsp;yet.<br>
+<br>
+Step&nbsp;6:&nbsp;the&nbsp;'bugs_password'&nbsp;given&nbsp;in&nbsp;SQL&nbsp;command&nbsp;d&nbsp;needs&nbsp;to&nbsp;be&nbsp;edited&nbsp;into<br>
+localconfig&nbsp;later&nbsp;on&nbsp;(Step&nbsp;7)&nbsp;if&nbsp;the&nbsp;password&nbsp;is&nbsp;not&nbsp;empty.&nbsp;I've&nbsp;also&nbsp;edited<br>
+it&nbsp;into&nbsp;globals.pl,&nbsp;but&nbsp;I'm&nbsp;not&nbsp;sure&nbsp;that&nbsp;is&nbsp;needed.&nbsp;In&nbsp;both&nbsp;places,&nbsp;the<br>
+variable&nbsp;is&nbsp;named&nbsp;db_pass.<br>
+<br>
+Step&nbsp;8:&nbsp;all&nbsp;the&nbsp;sendmail&nbsp;replacements&nbsp;mentioned&nbsp;are&nbsp;not&nbsp;as&nbsp;simple&nbsp;as<br>
+described&nbsp;there.&nbsp;Since&nbsp;I&nbsp;am&nbsp;not&nbsp;familiar&nbsp;(yet)&nbsp;with&nbsp;perl,&nbsp;I&nbsp;don't&nbsp;have&nbsp;any<br>
+mail&nbsp;working&nbsp;yet.<br>
+<br>
+Step&nbsp;9:&nbsp;in&nbsp;globals.pl&nbsp;the&nbsp;encrypt()&nbsp;call&nbsp;can&nbsp;be&nbsp;replaced&nbsp;by&nbsp;just&nbsp;the<br>
+unencrypted&nbsp;password.&nbsp;In&nbsp;CGI.pl,&nbsp;the&nbsp;complete&nbsp;SQL&nbsp;command&nbsp;can&nbsp;be&nbsp;removed.<br>
+<br>
+Step&nbsp;11:&nbsp;I've&nbsp;only&nbsp;changed&nbsp;the&nbsp;#!&nbsp;lines&nbsp;in&nbsp;*.cgi.&nbsp;I&nbsp;haven't&nbsp;noticed&nbsp;problems<br>
+with&nbsp;the&nbsp;system()&nbsp;call&nbsp;yet.<br>
+There&nbsp;seem&nbsp;to&nbsp;be&nbsp;only&nbsp;four&nbsp;system()&nbsp;called&nbsp;programs:&nbsp;processmail.pl&nbsp;(handled<br>
+by&nbsp;step&nbsp;10),&nbsp;syncshadowdb&nbsp;(which&nbsp;should&nbsp;probably&nbsp;get&nbsp;the&nbsp;same&nbsp;treatment&nbsp;as<br>
+processmail.pl),&nbsp;diff&nbsp;and&nbsp;mysqldump.&nbsp;The&nbsp;last&nbsp;one&nbsp;is&nbsp;only&nbsp;needed&nbsp;with&nbsp;the<br>
+shadowdb&nbsp;feature&nbsp;(which&nbsp;I&nbsp;don't&nbsp;use).<br>
+<br>
+There&nbsp;seems&nbsp;to&nbsp;be&nbsp;one&nbsp;step&nbsp;missing:&nbsp;copying&nbsp;the&nbsp;bugzilla&nbsp;files&nbsp;somehwere<br>
+that&nbsp;apache&nbsp;can&nbsp;serve&nbsp;them.<br>
+<br>
+Just&nbsp;noticed&nbsp;the&nbsp;updated&nbsp;guide...&nbsp;Brian's&nbsp;comment&nbsp;is&nbsp;new.&nbsp;His&nbsp;first&nbsp;comment<br>
+will&nbsp;work,&nbsp;but&nbsp;opens&nbsp;up&nbsp;a&nbsp;huge&nbsp;security&nbsp;hole.<br>
+ </P
+></BLOCKQUOTE
+></DIV
></DIV
></DIV
><DIV
diff --git a/docs/html/rhbugzilla.html b/docs/html/rhbugzilla.html
index 1d78c6473..c24de981b 100644
--- a/docs/html/rhbugzilla.html
+++ b/docs/html/rhbugzilla.html
@@ -80,7 +80,7 @@ NAME="RHBUGZILLA"
database, as well as MySQL.
Here's what Dave Lawrence had to say about the status of Red Hat Bugzilla,
<A
-NAME="AEN1913"
+NAME="AEN1936"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
diff --git a/docs/html/security.html b/docs/html/security.html
index 220559a72..e1ca3631d 100644
--- a/docs/html/security.html
+++ b/docs/html/security.html
@@ -173,14 +173,49 @@ TARGET="_top"
><LI
><P
> Ensure you have adequate access controls for the $BUGZILLA_HOME/data/ and
- $BUGZILLA_HOME/shadow/ directories, as well as the $BUGZILLA_HOME/localconfig file.
+ $BUGZILLA_HOME/shadow/ directories, as well as the $BUGZILLA_HOME/localconfig and
+ $BUGZILLA_HOME/globals.pl files.
The localconfig file stores your "bugs" user password,
which would be terrible to have in the hands
- of a criminal. Also some files under $BUGZILLA_HOME/data/ store sensitive information, and
+ of a criminal, while the "globals.pl" stores some default information regarding your
+ installation which could aid a system cracker.
+ In addition, some files under $BUGZILLA_HOME/data/ store sensitive information, and
$BUGZILLA_HOME/shadow/ stores bug information for faster retrieval. If you fail to secure
these directories and this file, you will expose bug information to those who may not
be allowed to see it.
</P
+><DIV
+CLASS="NOTE"
+><BLOCKQUOTE
+CLASS="NOTE"
+><P
+><B
+>Note: </B
+> Bugzilla provides default .htaccess files to protect the most common Apache
+ installations. However, you should verify these are adequate according to the site-wide
+ security policy of your web server, and ensure that the .htaccess files are
+ allowed to "override" default permissions set in your Apache configuration files.
+ Covering Apache security is beyond the scope of this Guide; please consult the Apache
+ documentation for details.
+ </P
+><P
+> If you are using a web server that does not support the .htaccess control method,
+ <EM
+>you are at risk!</EM
+> After installing, check to see if you can
+ view the file "localconfig" in your web browser (ergo:
+ <A
+HREF="http://bugzilla.mozilla.org/localconfig"
+TARGET="_top"
+> http://bugzilla.mozilla.org/localconfig</A
+>. If you can read the contents of this
+ file, your web server has not secured your bugzilla directory properly and you
+ must fix this problem before deploying Bugzilla. If, however, it gives you a
+ "Forbidden" error, then it probably respects the .htaccess conventions and you
+ are good to go.
+ </P
+></BLOCKQUOTE
+></DIV
><P
> On Apache, you can use .htaccess files to protect access to these directories, as outlined
in <A
diff --git a/docs/html/setperl.html b/docs/html/setperl.html
index 376d87a1a..57540d8d8 100644
--- a/docs/html/setperl.html
+++ b/docs/html/setperl.html
@@ -219,7 +219,7 @@ CLASS="COMMAND"
<DIV
CLASS="EXAMPLE"
><A
-NAME="AEN1963"
+NAME="AEN1986"
></A
><P
><B
diff --git a/docs/sgml/Bugzilla-Guide.sgml b/docs/sgml/Bugzilla-Guide.sgml
index 9334472af..88daac2bb 100644
--- a/docs/sgml/Bugzilla-Guide.sgml
+++ b/docs/sgml/Bugzilla-Guide.sgml
@@ -59,7 +59,7 @@ http://www.linuxdoc.org/LDP/LDP-Author-Guide/tools-hints.html
<BOOKINFO>
<TITLE>The Bugzilla Guide</TITLE>
- <PUBDATE>v2.12.0, 24 April 2001</PUBDATE>
+ <PUBDATE>2001-04-25</PUBDATE>
<AUTHOR>
<FIRSTNAME>Matthew</FIRSTNAME>
<OTHERNAME>P.</OTHERNAME>
diff --git a/docs/sgml/administration.sgml b/docs/sgml/administration.sgml
index a35ba047d..8ca600c54 100644
--- a/docs/sgml/administration.sgml
+++ b/docs/sgml/administration.sgml
@@ -1049,14 +1049,38 @@ operating parameters for bugzilla.</PARA>
<LISTITEM>
<PARA>
Ensure you have adequate access controls for the $BUGZILLA_HOME/data/ and
- $BUGZILLA_HOME/shadow/ directories, as well as the $BUGZILLA_HOME/localconfig file.
+ $BUGZILLA_HOME/shadow/ directories, as well as the $BUGZILLA_HOME/localconfig and
+ $BUGZILLA_HOME/globals.pl files.
The localconfig file stores your "bugs" user password,
which would be terrible to have in the hands
- of a criminal. Also some files under $BUGZILLA_HOME/data/ store sensitive information, and
+ of a criminal, while the "globals.pl" stores some default information regarding your
+ installation which could aid a system cracker.
+ In addition, some files under $BUGZILLA_HOME/data/ store sensitive information, and
$BUGZILLA_HOME/shadow/ stores bug information for faster retrieval. If you fail to secure
these directories and this file, you will expose bug information to those who may not
be allowed to see it.
</PARA>
+ <NOTE>
+ <PARA>
+ Bugzilla provides default .htaccess files to protect the most common Apache
+ installations. However, you should verify these are adequate according to the site-wide
+ security policy of your web server, and ensure that the .htaccess files are
+ allowed to "override" default permissions set in your Apache configuration files.
+ Covering Apache security is beyond the scope of this Guide; please consult the Apache
+ documentation for details.
+ </PARA>
+ <PARA>
+ If you are using a web server that does not support the .htaccess control method,
+ <EMPHASIS>you are at risk!</EMPHASIS> After installing, check to see if you can
+ view the file "localconfig" in your web browser (ergo:
+ <ULINK URL="http://bugzilla.mozilla.org/localconfig">
+ http://bugzilla.mozilla.org/localconfig</ULINK>. If you can read the contents of this
+ file, your web server has not secured your bugzilla directory properly and you
+ must fix this problem before deploying Bugzilla. If, however, it gives you a
+ "Forbidden" error, then it probably respects the .htaccess conventions and you
+ are good to go.
+ </PARA>
+ </NOTE>
<PARA>
On Apache, you can use .htaccess files to protect access to these directories, as outlined
in <ULINK URL="http://bugzilla.mozilla.org/show_bug.cgi?id=57161">Bug 57161</ULINK> for the
diff --git a/docs/sgml/faq.sgml b/docs/sgml/faq.sgml
index b7ca03201..2b67890a9 100644
--- a/docs/sgml/faq.sgml
+++ b/docs/sgml/faq.sgml
@@ -680,6 +680,54 @@
</answer>
</qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
+ The index.html page doesn't show the footer. It's really annoying to have
+ to go to the querypage just to check my "my bugs" link. How do I get a footer
+ on static HTML pages?
+ </para>
+ </question>
+ <answer>
+ <para>
+ This was a late-breaking question for the Guide, so I just have to
+ quote the relevant newsgroup thread on it.
+ </para>
+ <literallayout>
+> AFAIK, most sites (even if they have SSI enabled) won't have #exec cmd
+> enabled. Perhaps what would be better is a #include virtual and a
+> footer.cgi the basically has the "require 'CGI.pl' and PutFooter command.
+>
+> Please note that under most configurations, this also requires naming
+> the file from index.html to index.shtml (and making sure that it will
+> still be reconized as an index). Personally, I think this is better on
+> a per-installation basis (perhaps add something to the FAQ that says how
+> to do this).
+
+Good point. Yeah, easy enough to do, that it shouldn't be a big deal for
+someone to take it on if they want it. FAQ is a good place for it.
+
+> Dave Miller wrote:
+>
+>> I did a little experimenting with getting the command menu and footer on
+>> the end of the index page while leaving it as an HTML file...
+>>
+>> I was successful. :)
+>>
+>> I added this line:
+>>
+>> <!--#exec cmd="/usr/bin/perl -e &quot;require 'CGI.pl';
+>>PutFooter();&quot;" -->
+>>
+>> Just before the &lt;/BODY&gt; &lt;/HTML&gt; at the end of the file. And it worked.
+>>
+>> Thought I'd toss that out there. Should I check this in? For those that
+>> have SSI disabled, it'll act like a comment, so I wouldn't think it would
+>> break anything.
+ </literallayout>
+ </answer>
+ </qandaentry>
<qandaentry>
<question>
<para>
diff --git a/docs/sgml/installation.sgml b/docs/sgml/installation.sgml
index 03ff0bd8d..8165afd6d 100644
--- a/docs/sgml/installation.sgml
+++ b/docs/sgml/installation.sgml
@@ -479,7 +479,7 @@
</PARA>
<TIP>
<PARA>
- HINT: If you symlink the bugzilla directory into your Apache's
+ If you symlink the bugzilla directory into your Apache's
HTML heirarchy, you may receive "Forbidden" errors unless you
add the "FollowSymLinks" directive to the &lt;Directory&gt; entry
for the HTML root.
@@ -493,11 +493,25 @@
installation.
</PARA>
<PARA>
- Lastly, you'll need to set up a symbolic link from /usr/bonsaitools/bin
- to the correct location of your perl executable (probably /usr/bin/perl).
+ 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. To make future upgrades easier, you should use the symlink
approach.
+ <EXAMPLE>
+ <TITLE>Setting up bonsaitools symlink</TITLE>
+ <PARA>
+ Here's how you set up the Perl symlink on Linux to make Bugzilla work.
+ Your mileage may vary; if you are running on Solaris, you probably need to subsitute
+ "/usr/local/bin/perl" for "/usr/bin/perl" below; if on certain other UNIX systems,
+ Perl may live in weird places like "/opt/perl". As root, run these commands:
+ <PROGRAMLISTING>
+bash# mkdir /usr/bonsaitools
+bash# mkdir /usr/bonsaitools/bin
+bash# ln -s /usr/bin/perl /usr/bosaitools/bin/perl
+ </PROGRAMLISTING>
+ </PARA>
+ </EXAMPLE>
<TIP>
<PARA>
If you don't have root access to set this symlink up, check out the
@@ -663,11 +677,26 @@
<ERRORCODE>Now regenerating the shadow database for all bugs.</ERRORCODE>
<NOTE>
<PARA>
- The second time you run checksetup.pl, it is recommended you be the same
- user as your web server runs under, and that you be sure you have set the
+ The second time you run checksetup.pl, you should become the
+ user your web server runs as, and that you ensure you have set the
"webservergroup" parameter in localconfig to match the web server's group
- name, if any. Under some systems, otherwise, checksetup.pl will goof up
- your file permissions and make them unreadable to your web server.
+ name, if any. I believe, for the next release of Bugzilla, this will
+ be fixed so that Bugzilla supports a "webserveruser" parameter in localconfig
+ as well.
+ <EXAMPLE>
+ <TITLE>Running checksetup.pl as the web user</TITLE>
+ <PARA>
+ Assuming your web server runs as user "apache", and Bugzilla is installed in
+ "/usr/local/bugzilla", here's one way to run checksetup.pl as the web server user.
+ As root, for the <EMPHASIS>second run</EMPHASIS> of checksetup.pl, do this:
+ <PROGRAMLISTING>
+bash# chown -R apache:apache /usr/local/bugzilla
+bash# su - apache
+bash# cd /usr/local/bugzilla
+bash# ./checksetup.pl
+ </PROGRAMLISTING>
+ </PARA>
+ </EXAMPLE>
</PARA>
</NOTE>
</PARA>
@@ -680,7 +709,7 @@
</SECTION>
<SECTION>
- <TITLE>Setting Up Maintainers Manuall (Optional)</TITLE>
+ <TITLE>Setting Up Maintainers Manually (Optional)</TITLE>
<PARA>
If you want to add someone else to every group by hand, you can do it
by typing the appropriate MySQL commands. Run '<COMPUTEROUTPUT>
@@ -1295,6 +1324,56 @@ open SENDMAIL, "|\"C:/General/Web/tools/Windmail 4.0 Beta/windmail\" -t > mail.l
</PROCEDURE>
</BLOCKQUOTE>
</TIP>
+ <TIP>
+ <PARA>
+ This was some late breaking information from Jan Evert. Sorry for the lack of formatting.
+ </PARA>
+ <LITERALLAYOUT>
+I'm busy installing bugzilla on a WinNT machine and I thought I'd notify you
+at this moment of the commments I have to section 2.2.1 of the bugzilla
+guide (at http://www.trilobyte.net/barnsons/html/).
+
+Step 1:
+I've used apache, installation is really straightforward.
+After reading the Unix installation instructions, I found that it is
+necessary to add the ExecCGI option to the bugzilla directory. Also the
+'AddHandler' line for .cgi is by default commented out.
+
+Step 3: although just a detail, 'ppm install &lt;module%gt;' will also work
+(wihtout .ppd). And, it can also download these automatically from
+ActiveState.
+
+Step 4: although I have cygwin installed, it seems that it is not necessary.
+On my machine cygwin is not in the PATH and everything seems to work as
+expected.
+However, I've not used everything yet.
+
+Step 6: the 'bugs_password' given in SQL command d needs to be edited into
+localconfig later on (Step 7) if the password is not empty. I've also edited
+it into globals.pl, but I'm not sure that is needed. In both places, the
+variable is named db_pass.
+
+Step 8: all the sendmail replacements mentioned are not as simple as
+described there. Since I am not familiar (yet) with perl, I don't have any
+mail working yet.
+
+Step 9: in globals.pl the encrypt() call can be replaced by just the
+unencrypted password. In CGI.pl, the complete SQL command can be removed.
+
+Step 11: I've only changed the #! lines in *.cgi. I haven't noticed problems
+with the system() call yet.
+There seem to be only four system() called programs: processmail.pl (handled
+by step 10), syncshadowdb (which should probably get the same treatment as
+processmail.pl), diff and mysqldump. The last one is only needed with the
+shadowdb feature (which I don't use).
+
+There seems to be one step missing: copying the bugzilla files somehwere
+that apache can serve them.
+
+Just noticed the updated guide... Brian's comment is new. His first comment
+will work, but opens up a huge security hole.
+ </LITERALLAYOUT>
+ </TIP>
</SECTION>
</SECTION>
</CHAPTER>
diff --git a/docs/txt/Bugzilla-Guide.txt b/docs/txt/Bugzilla-Guide.txt
index b31a112e6..2c2ed648e 100644
--- a/docs/txt/Bugzilla-Guide.txt
+++ b/docs/txt/Bugzilla-Guide.txt
@@ -64,7 +64,7 @@ Matthew P. Barnson
2.1.2.13. Installing the Bugzilla Files
2.1.2.14. Setting Up the MySQL Database
2.1.2.15. Tweaking "localconfig"
- 2.1.2.16. Setting Up Maintainers Manuall (Optional)
+ 2.1.2.16. Setting Up Maintainers Manually (Optional)
2.1.2.17. The Whining Cron (Optional)
2.1.2.18. Bug Graphs (Optional)
2.1.2.19. Securing MySQL
@@ -179,7 +179,9 @@ Matthew P. Barnson
Glossary
List of Examples
- 2-1. Removing encrypt() for Windows NT installations
+ 2-1. Setting up bonsaitools symlink
+ 2-2. Running checksetup.pl as the web user
+ 2-3. Removing encrypt() for Windows NT installations
3-1. Creating some Components
3-2. Common Use of Versions
3-3. A Different Use of Versions
@@ -709,10 +711,10 @@ Chapter 2. Installing Bugzilla
Bugzilla) and make sure you can access the files in that directory
through your web server.
- Tip: HINT: If you symlink the bugzilla directory into your Apache's
- HTML heirarchy, you may receive "Forbidden" errors unless you add
- the "FollowSymLinks" directive to the <Directory> entry for the
- HTML root.
+ Tip: If you symlink the bugzilla directory into your Apache's HTML
+ heirarchy, you may receive "Forbidden" errors unless you add the
+ "FollowSymLinks" directive to the <Directory> entry for the HTML
+ root.
Once all the files are in a web accessible directory, make that
directory writable by your webserver's user (which may require just
@@ -720,11 +722,22 @@ Chapter 2. Installing Bugzilla
post-install "checksetup.pl" script, which locks down your
installation.
- Lastly, you'll need to set up a symbolic link from
- /usr/bonsaitools/bin to 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. To make future upgrades easier,
- you should use the symlink approach.
+ 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. To make future upgrades
+ easier, you should use the symlink approach.
+
+ Example 2-1. Setting up bonsaitools symlink
+
+ Here's how you set up the Perl symlink on Linux to make Bugzilla work.
+ Your mileage may vary; if you are running on Solaris, you probably
+ need to subsitute "/usr/local/bin/perl" for "/usr/bin/perl" below; if
+ on certain other UNIX systems, Perl may live in weird places like
+ "/opt/perl". As root, run these commands:
+bash# mkdir /usr/bonsaitools
+bash# mkdir /usr/bonsaitools/bin
+bash# ln -s /usr/bin/perl /usr/bosaitools/bin/perl
Tip: If you don't have root access to set this symlink up, check
out the "setperl.csh" utility, listed in the Patches section of
@@ -813,19 +826,30 @@ Chapter 2. Installing Bugzilla
with multiple instances. If flock() is not fully supported, it will
stall at: Now regenerating the shadow database for all bugs.
- Note: The second time you run checksetup.pl, it is recommended you
- be the same user as your web server runs under, and that you be
- sure you have set the "webservergroup" parameter in localconfig to
- match the web server's group name, if any. Under some systems,
- otherwise, checksetup.pl will goof up your file permissions and
- make them unreadable to your web server.
+ Note: The second time you run checksetup.pl, you should become the
+ user your web server runs as, and that you ensure you have set the
+ "webservergroup" parameter in localconfig to match the web server's
+ group name, if any. I believe, for the next release of Bugzilla,
+ this will be fixed so that Bugzilla supports a "webserveruser"
+ parameter in localconfig as well.
+
+ Example 2-2. Running checksetup.pl as the web user
+
+ Assuming your web server runs as user "apache", and Bugzilla is
+ installed in "/usr/local/bugzilla", here's one way to run
+ checksetup.pl as the web server user. As root, for the second run of
+ checksetup.pl, do this:
+bash# chown -R apache:apache /usr/local/bugzilla
+bash# su - apache
+bash# cd /usr/local/bugzilla
+bash# ./checksetup.pl
Note: The checksetup.pl script is designed so that you can run it
at any time without causing harm. You should run it after any
upgrade to Bugzilla.
_________________________________________________________________
-2.1.2.16. Setting Up Maintainers Manuall (Optional)
+2.1.2.16. Setting Up Maintainers Manually (Optional)
If you want to add someone else to every group by hand, you can do it
by typing the appropriate MySQL commands. Run ' mysql -u root -p bugs'
@@ -1125,7 +1149,7 @@ my $webservergid = 'Administrators'
2. I then ran checksetup.pl
3. I removed all the encrypt()
- Example 2-1. Removing encrypt() for Windows NT installations
+ Example 2-3. Removing encrypt() for Windows NT installations
Replace this:
SendSQL("SELECT encrypt(" . SqlQuote($enteredpwd) . ", " .
@@ -1148,6 +1172,64 @@ log";
The quotes around the dir is for the spaces. mail.log is for the
output
+
+ Tip: This was some late breaking information from Jan Evert. Sorry
+ for the lack of formatting.
+
+ I'm busy installing bugzilla on a WinNT machine and I thought I'd n
+ otify you
+ at this moment of the commments I have to section 2.2.1 of the bugz
+ illa
+ guide (at http://www.trilobyte.net/barnsons/html/).
+ Step 1:
+ I've used apache, installation is really straightforward.
+ After reading the Unix installation instructions, I found that it i
+ s
+ necessary to add the ExecCGI option to the bugzilla directory. Also
+ the
+ 'AddHandler' line for .cgi is by default commented out.
+ Step 3: although just a detail, 'ppm install <module%gt;' will also
+ work
+ (wihtout .ppd). And, it can also download these automatically from
+ ActiveState.
+ Step 4: although I have cygwin installed, it seems that it is not n
+ ecessary.
+ On my machine cygwin is not in the PATH and everything seems to wor
+ k as
+ expected.
+ However, I've not used everything yet.
+ Step 6: the 'bugs_password' given in SQL command d needs to be edit
+ ed into
+ localconfig later on (Step 7) if the password is not empty. I've al
+ so edited
+ it into globals.pl, but I'm not sure that is needed. In both places
+ , the
+ variable is named db_pass.
+ Step 8: all the sendmail replacements mentioned are not as simple a
+ s
+ described there. Since I am not familiar (yet) with perl, I don't h
+ ave any
+ mail working yet.
+ Step 9: in globals.pl the encrypt() call can be replaced by just th
+ e
+ unencrypted password. In CGI.pl, the complete SQL command can be re
+ moved.
+ Step 11: I've only changed the #! lines in *.cgi. I haven't noticed
+ problems
+ with the system() call yet.
+ There seem to be only four system() called programs: processmail.pl
+ (handled
+ by step 10), syncshadowdb (which should probably get the same treat
+ ment as
+ processmail.pl), diff and mysqldump. The last one is only needed wi
+ th the
+ shadowdb feature (which I don't use).
+ There seems to be one step missing: copying the bugzilla files some
+ hwere
+ that apache can serve them.
+ Just noticed the updated guide... Brian's comment is new. His first
+ comment
+ will work, but opens up a huge security hole.
_________________________________________________________________
Chapter 3. Administering Bugzilla
@@ -1789,14 +1871,33 @@ Chapter 3. Administering Bugzilla
user with a name, set via your httpd.conf file.
5. Ensure you have adequate access controls for the
$BUGZILLA_HOME/data/ and $BUGZILLA_HOME/shadow/ directories, as
- well as the $BUGZILLA_HOME/localconfig file. The localconfig file
- stores your "bugs" user password, which would be terrible to have
- in the hands of a criminal. Also some files under
- $BUGZILLA_HOME/data/ store sensitive information, and
- $BUGZILLA_HOME/shadow/ stores bug information for faster
- retrieval. If you fail to secure these directories and this file,
- you will expose bug information to those who may not be allowed to
- see it.
+ well as the $BUGZILLA_HOME/localconfig and
+ $BUGZILLA_HOME/globals.pl files. The localconfig file stores your
+ "bugs" user password, which would be terrible to have in the hands
+ of a criminal, while the "globals.pl" stores some default
+ information regarding your installation which could aid a system
+ cracker. In addition, some files under $BUGZILLA_HOME/data/ store
+ sensitive information, and $BUGZILLA_HOME/shadow/ stores bug
+ information for faster retrieval. If you fail to secure these
+ directories and this file, you will expose bug information to
+ those who may not be allowed to see it.
+
+ Note: Bugzilla provides default .htaccess files to protect the most
+ common Apache installations. However, you should verify these are
+ adequate according to the site-wide security policy of your web
+ server, and ensure that the .htaccess files are allowed to
+ "override" default permissions set in your Apache configuration
+ files. Covering Apache security is beyond the scope of this Guide;
+ please consult the Apache documentation for details.
+ If you are using a web server that does not support the .htaccess
+ control method, you are at risk! After installing, check to see if
+ you can view the file "localconfig" in your web browser (ergo:
+ http://bugzilla.mozilla.org/localconfig. If you can read the
+ contents of this file, your web server has not secured your
+ bugzilla directory properly and you must fix this problem before
+ deploying Bugzilla. If, however, it gives you a "Forbidden" error,
+ then it probably respects the .htaccess conventions and you are
+ good to go.
On Apache, you can use .htaccess files to protect access to these
directories, as outlined in Bug 57161 for the localconfig file,
and Bug 65572 for adequate protection in your data/ and shadow/
@@ -2790,76 +2891,81 @@ Appendix A. The Bugzilla FAQ
of fields and format of them, and the choice of
acceptable values?
- A.4.7. Does Bugzilla provide any reporting features, metrics,
+ A.4.7. The index.html page doesn't show the footer. It's really
+ annoying to have to go to the querypage just to check my
+ "my bugs" link. How do I get a footer on static HTML
+ pages?
+
+ A.4.8. Does Bugzilla provide any reporting features, metrics,
graphs, etc? You know, the type of stuff that management
likes to see. :)
- A.4.8. Is there email notification and if so, what do you see
+ A.4.9. Is there email notification and if so, what do you see
when you get an email? Do you see bug number and title or
is it only the number?
- A.4.9. Can email notification be set up to send to multiple
+ A.4.10. Can email notification be set up to send to multiple
people, some on the To List, CC List, BCC List etc?
- A.4.10. If there is email notification, do users have to have any
+ A.4.11. If there is email notification, do users have to have any
particular type of email application?
- A.4.11. If I just wanted to track certain bugs, as they go
+ A.4.12. If I just wanted to track certain bugs, as they go
through life, can I set it up to alert me via email
whenever that bug changes, whether it be owner, status or
description etc.?
- A.4.12. Does Bugzilla allow data to be imported and exported? If
+ A.4.13. Does Bugzilla allow data to be imported and exported? If
I had outsiders write up a bug report using a MS Word bug
template, could that template be imported into "matching"
fields? If I wanted to take the results of a query and
export that data to MS Excel, could I do that?
- A.4.13. Does Bugzilla allow fields to be added, changed or
+ A.4.14. Does Bugzilla allow fields to be added, changed or
deleted? If I want to customize the bug submission form
to meet our needs, can I do that using our terminology?
- A.4.14. Has anyone converted Bugzilla to another language to be
+ A.4.15. Has anyone converted Bugzilla to another language to be
used in other countries? Is it localizable?
- A.4.15. Can a user create and save reports? Can they do this in
+ A.4.16. Can a user create and save reports? Can they do this in
Word format? Excel format?
- A.4.16. Can a user re-run a report with a new project, same
+ A.4.17. Can a user re-run a report with a new project, same
query?
- A.4.17. Can a user modify an existing report and then save it
+ A.4.18. Can a user modify an existing report and then save it
into another name?
- A.4.18. Does Bugzilla have the ability to search by word, phrase,
+ A.4.19. Does Bugzilla have the ability to search by word, phrase,
compound search?
- A.4.19. Can the admin person establish separate group and
+ A.4.20. Can the admin person establish separate group and
individual user privileges?
- A.4.20. Does Bugzilla provide record locking when there is
+ A.4.21. Does Bugzilla provide record locking when there is
simultaneous access to the same bug? Does the second
person get a notice that the bug is in use or how are
they notified?
- A.4.21. Are there any backup features provided?
- A.4.22. Can users be on the system while a backup is in progress?
+ A.4.22. Are there any backup features provided?
+ A.4.23. Can users be on the system while a backup is in progress?
- A.4.23. What type of human resources are needed to be on staff to
+ A.4.24. What type of human resources are needed to be on staff to
install and maintain Bugzilla? Specifically, what type of
skills does the person need to have? I need to find out
if we were to go with Bugzilla, what types of individuals
would we need to hire and how much would that cost vs
buying an "Out-of-the-Box" solution.
- A.4.24. What time frame are we looking at if we decide to hire
+ A.4.25. What time frame are we looking at if we decide to hire
people to install and maintain the Bugzilla? Is this
something that takes hours or weeks to install and a
couple of hours per week to maintain and customize or is
this a multi-week install process, plus a full time job
for 1 person, 2 people, etc?
- A.4.25. Is there any licensing fee or other fees for using
+ A.4.26. Is there any licensing fee or other fees for using
Bugzilla? Any out-of-pocket cost other than the bodies
needed as identified above?
@@ -3356,7 +3462,53 @@ Appendix A. The Bugzilla FAQ
progression states, also require adjusting the program logic to
compensate for the change.
- A.4.7. Does Bugzilla provide any reporting features, metrics, graphs,
+ A.4.7. The index.html page doesn't show the footer. It's really
+ annoying to have to go to the querypage just to check my "my bugs"
+ link. How do I get a footer on static HTML pages?
+
+ This was a late-breaking question for the Guide, so I just have to
+ quote the relevant newsgroup thread on it.
+
+ > AFAIK, most sites (even if they have SSI enabled) won't have #exec c
+ md
+ > enabled. Perhaps what would be better is a #include virtual and a
+ > footer.cgi the basically has the "require 'CGI.pl' and PutFooter com
+ mand.
+ >
+ > Please note that under most configurations, this also requires namin
+ g
+ > the file from index.html to index.shtml (and making sure that it wil
+ l
+ > still be reconized as an index). Personally, I think this is better
+ on
+ > a per-installation basis (perhaps add something to the FAQ that says
+ how
+ > to do this).
+ Good point. Yeah, easy enough to do, that it shouldn't be a big deal
+ for
+ someone to take it on if they want it. FAQ is a good place for it.
+ > Dave Miller wrote:
+ >
+ >> I did a little experimenting with getting the command menu and foot
+ er on
+ >> the end of the index page while leaving it as an HTML file...
+ >>
+ >> I was successful. :)
+ >>
+ >> I added this line:
+ >>
+ >>
+ >>
+ >> Just before the </BODY> </HTML> at the end of the file. And it wor
+ ked.
+ >>
+ >> Thought I'd toss that out there. Should I check this in? For thos
+ e that
+ >> have SSI disabled, it'll act like a comment, so I wouldn't think it
+ would
+ >> break anything.
+
+ A.4.8. Does Bugzilla provide any reporting features, metrics, graphs,
etc? You know, the type of stuff that management likes to see. :)
Yes. Look at http://bugzilla.mozilla.org/reports.cgi for basic
@@ -3371,7 +3523,7 @@ Appendix A. The Bugzilla FAQ
Advanced Reporting is a Bugzilla 3.X proposed feature.
- A.4.8. Is there email notification and if so, what do you see when you
+ A.4.9. Is there email notification and if so, what do you see when you
get an email? Do you see bug number and title or is it only the
number?
@@ -3379,12 +3531,12 @@ Appendix A. The Bugzilla FAQ
bug report accompany each email notification, along with a list of the
changes made.
- A.4.9. Can email notification be set up to send to multiple people,
+ A.4.10. Can email notification be set up to send to multiple people,
some on the To List, CC List, BCC List etc?
Yes.
- A.4.10. If there is email notification, do users have to have any
+ A.4.11. If there is email notification, do users have to have any
particular type of email application?
Bugzilla email is sent in plain text, the most compatible mail format
@@ -3398,7 +3550,7 @@ Appendix A. The Bugzilla FAQ
user sends HTML-based email into Bugzilla the resulting comment
looks downright awful.
- A.4.11. If I just wanted to track certain bugs, as they go through
+ A.4.12. If I just wanted to track certain bugs, as they go through
life, can I set it up to alert me via email whenever that bug changes,
whether it be owner, status or description etc.?
@@ -3407,7 +3559,7 @@ Appendix A. The Bugzilla FAQ
tab of the User Preferences screen in Bugzilla to the "Only those bugs
which I am listed on the CC line" option.
- A.4.12. Does Bugzilla allow data to be imported and exported? If I had
+ A.4.13. Does Bugzilla allow data to be imported and exported? If I had
outsiders write up a bug report using a MS Word bug template, could
that template be imported into "matching" fields? If I wanted to take
the results of a query and export that data to MS Excel, could I do
@@ -3429,46 +3581,46 @@ Appendix A. The Bugzilla FAQ
find an excellent example at
http://www.mozilla.org/quality/help/bugzilla-helper.html
- A.4.13. Does Bugzilla allow fields to be added, changed or deleted? If
+ A.4.14. Does Bugzilla allow fields to be added, changed or deleted? If
I want to customize the bug submission form to meet our needs, can I
do that using our terminology?
Yes.
- A.4.14. Has anyone converted Bugzilla to another language to be used
+ A.4.15. Has anyone converted Bugzilla to another language to be used
in other countries? Is it localizable?
Currently, no. Internationalization support for Perl did not exist in
a robust fashion until the recent release of version 5.6.0; Bugzilla
is, and likely will remain (until 3.X) completely non-localized.
- A.4.15. Can a user create and save reports? Can they do this in Word
+ A.4.16. Can a user create and save reports? Can they do this in Word
format? Excel format?
Yes. No. No.
- A.4.16. Can a user re-run a report with a new project, same query?
+ A.4.17. Can a user re-run a report with a new project, same query?
Yes.
- A.4.17. Can a user modify an existing report and then save it into
+ A.4.18. Can a user modify an existing report and then save it into
another name?
You can save an unlimited number of queries in Bugzilla. You are free
to modify them and rename them to your heart's desire.
- A.4.18. Does Bugzilla have the ability to search by word, phrase,
+ A.4.19. Does Bugzilla have the ability to search by word, phrase,
compound search?
You have no idea. Bugzilla's query interface, particularly with the
advanced Boolean operators, is incredibly versatile.
- A.4.19. Can the admin person establish separate group and individual
+ A.4.20. Can the admin person establish separate group and individual
user privileges?
Yes.
- A.4.20. Does Bugzilla provide record locking when there is
+ A.4.21. Does Bugzilla provide record locking when there is
simultaneous access to the same bug? Does the second person get a
notice that the bug is in use or how are they notified?
@@ -3476,19 +3628,19 @@ Appendix A. The Bugzilla FAQ
detection, and offers the offending user a choice of options to deal
with the conflict.
- A.4.21. Are there any backup features provided?
+ A.4.22. Are there any backup features provided?
MySQL, the database back-end for Bugzilla, allows hot-backup of data.
You can find strategies for dealing with backup considerations at
http://www.mysql.com/doc/B/a/Backup.html
- A.4.22. Can users be on the system while a backup is in progress?
+ A.4.23. Can users be on the system while a backup is in progress?
Yes. However, commits to the database must wait until the tables are
unlocked. Bugzilla databases are typically very small, and backups
routinely take less than a minute.
- A.4.23. What type of human resources are needed to be on staff to
+ A.4.24. What type of human resources are needed to be on staff to
install and maintain Bugzilla? Specifically, what type of skills does
the person need to have? I need to find out if we were to go with
Bugzilla, what types of individuals would we need to hire and how much
@@ -3507,7 +3659,7 @@ Appendix A. The Bugzilla FAQ
me three to five hours to make Bugzilla happy on a Development
installation of Linux-Mandrake.
- A.4.24. What time frame are we looking at if we decide to hire people
+ A.4.25. What time frame are we looking at if we decide to hire people
to install and maintain the Bugzilla? Is this something that takes
hours or weeks to install and a couple of hours per week to maintain
and customize or is this a multi-week install process, plus a full
@@ -3520,7 +3672,7 @@ Appendix A. The Bugzilla FAQ
UNIX or Perl skills to handle your process management and bug-tracking
maintenance & customization.
- A.4.25. Is there any licensing fee or other fees for using Bugzilla?
+ A.4.26. Is there any licensing fee or other fees for using Bugzilla?
Any out-of-pocket cost other than the bodies needed as identified
above?
diff --git a/docs/xml/Bugzilla-Guide.xml b/docs/xml/Bugzilla-Guide.xml
index 9334472af..88daac2bb 100644
--- a/docs/xml/Bugzilla-Guide.xml
+++ b/docs/xml/Bugzilla-Guide.xml
@@ -59,7 +59,7 @@ http://www.linuxdoc.org/LDP/LDP-Author-Guide/tools-hints.html
<BOOKINFO>
<TITLE>The Bugzilla Guide</TITLE>
- <PUBDATE>v2.12.0, 24 April 2001</PUBDATE>
+ <PUBDATE>2001-04-25</PUBDATE>
<AUTHOR>
<FIRSTNAME>Matthew</FIRSTNAME>
<OTHERNAME>P.</OTHERNAME>
diff --git a/docs/xml/administration.xml b/docs/xml/administration.xml
index a35ba047d..8ca600c54 100644
--- a/docs/xml/administration.xml
+++ b/docs/xml/administration.xml
@@ -1049,14 +1049,38 @@ operating parameters for bugzilla.</PARA>
<LISTITEM>
<PARA>
Ensure you have adequate access controls for the $BUGZILLA_HOME/data/ and
- $BUGZILLA_HOME/shadow/ directories, as well as the $BUGZILLA_HOME/localconfig file.
+ $BUGZILLA_HOME/shadow/ directories, as well as the $BUGZILLA_HOME/localconfig and
+ $BUGZILLA_HOME/globals.pl files.
The localconfig file stores your "bugs" user password,
which would be terrible to have in the hands
- of a criminal. Also some files under $BUGZILLA_HOME/data/ store sensitive information, and
+ of a criminal, while the "globals.pl" stores some default information regarding your
+ installation which could aid a system cracker.
+ In addition, some files under $BUGZILLA_HOME/data/ store sensitive information, and
$BUGZILLA_HOME/shadow/ stores bug information for faster retrieval. If you fail to secure
these directories and this file, you will expose bug information to those who may not
be allowed to see it.
</PARA>
+ <NOTE>
+ <PARA>
+ Bugzilla provides default .htaccess files to protect the most common Apache
+ installations. However, you should verify these are adequate according to the site-wide
+ security policy of your web server, and ensure that the .htaccess files are
+ allowed to "override" default permissions set in your Apache configuration files.
+ Covering Apache security is beyond the scope of this Guide; please consult the Apache
+ documentation for details.
+ </PARA>
+ <PARA>
+ If you are using a web server that does not support the .htaccess control method,
+ <EMPHASIS>you are at risk!</EMPHASIS> After installing, check to see if you can
+ view the file "localconfig" in your web browser (ergo:
+ <ULINK URL="http://bugzilla.mozilla.org/localconfig">
+ http://bugzilla.mozilla.org/localconfig</ULINK>. If you can read the contents of this
+ file, your web server has not secured your bugzilla directory properly and you
+ must fix this problem before deploying Bugzilla. If, however, it gives you a
+ "Forbidden" error, then it probably respects the .htaccess conventions and you
+ are good to go.
+ </PARA>
+ </NOTE>
<PARA>
On Apache, you can use .htaccess files to protect access to these directories, as outlined
in <ULINK URL="http://bugzilla.mozilla.org/show_bug.cgi?id=57161">Bug 57161</ULINK> for the
diff --git a/docs/xml/faq.xml b/docs/xml/faq.xml
index b7ca03201..2b67890a9 100644
--- a/docs/xml/faq.xml
+++ b/docs/xml/faq.xml
@@ -680,6 +680,54 @@
</answer>
</qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
+ The index.html page doesn't show the footer. It's really annoying to have
+ to go to the querypage just to check my "my bugs" link. How do I get a footer
+ on static HTML pages?
+ </para>
+ </question>
+ <answer>
+ <para>
+ This was a late-breaking question for the Guide, so I just have to
+ quote the relevant newsgroup thread on it.
+ </para>
+ <literallayout>
+> AFAIK, most sites (even if they have SSI enabled) won't have #exec cmd
+> enabled. Perhaps what would be better is a #include virtual and a
+> footer.cgi the basically has the "require 'CGI.pl' and PutFooter command.
+>
+> Please note that under most configurations, this also requires naming
+> the file from index.html to index.shtml (and making sure that it will
+> still be reconized as an index). Personally, I think this is better on
+> a per-installation basis (perhaps add something to the FAQ that says how
+> to do this).
+
+Good point. Yeah, easy enough to do, that it shouldn't be a big deal for
+someone to take it on if they want it. FAQ is a good place for it.
+
+> Dave Miller wrote:
+>
+>> I did a little experimenting with getting the command menu and footer on
+>> the end of the index page while leaving it as an HTML file...
+>>
+>> I was successful. :)
+>>
+>> I added this line:
+>>
+>> <!--#exec cmd="/usr/bin/perl -e &quot;require 'CGI.pl';
+>>PutFooter();&quot;" -->
+>>
+>> Just before the &lt;/BODY&gt; &lt;/HTML&gt; at the end of the file. And it worked.
+>>
+>> Thought I'd toss that out there. Should I check this in? For those that
+>> have SSI disabled, it'll act like a comment, so I wouldn't think it would
+>> break anything.
+ </literallayout>
+ </answer>
+ </qandaentry>
<qandaentry>
<question>
<para>
diff --git a/docs/xml/installation.xml b/docs/xml/installation.xml
index 03ff0bd8d..8165afd6d 100644
--- a/docs/xml/installation.xml
+++ b/docs/xml/installation.xml
@@ -479,7 +479,7 @@
</PARA>
<TIP>
<PARA>
- HINT: If you symlink the bugzilla directory into your Apache's
+ If you symlink the bugzilla directory into your Apache's
HTML heirarchy, you may receive "Forbidden" errors unless you
add the "FollowSymLinks" directive to the &lt;Directory&gt; entry
for the HTML root.
@@ -493,11 +493,25 @@
installation.
</PARA>
<PARA>
- Lastly, you'll need to set up a symbolic link from /usr/bonsaitools/bin
- to the correct location of your perl executable (probably /usr/bin/perl).
+ 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. To make future upgrades easier, you should use the symlink
approach.
+ <EXAMPLE>
+ <TITLE>Setting up bonsaitools symlink</TITLE>
+ <PARA>
+ Here's how you set up the Perl symlink on Linux to make Bugzilla work.
+ Your mileage may vary; if you are running on Solaris, you probably need to subsitute
+ "/usr/local/bin/perl" for "/usr/bin/perl" below; if on certain other UNIX systems,
+ Perl may live in weird places like "/opt/perl". As root, run these commands:
+ <PROGRAMLISTING>
+bash# mkdir /usr/bonsaitools
+bash# mkdir /usr/bonsaitools/bin
+bash# ln -s /usr/bin/perl /usr/bosaitools/bin/perl
+ </PROGRAMLISTING>
+ </PARA>
+ </EXAMPLE>
<TIP>
<PARA>
If you don't have root access to set this symlink up, check out the
@@ -663,11 +677,26 @@
<ERRORCODE>Now regenerating the shadow database for all bugs.</ERRORCODE>
<NOTE>
<PARA>
- The second time you run checksetup.pl, it is recommended you be the same
- user as your web server runs under, and that you be sure you have set the
+ The second time you run checksetup.pl, you should become the
+ user your web server runs as, and that you ensure you have set the
"webservergroup" parameter in localconfig to match the web server's group
- name, if any. Under some systems, otherwise, checksetup.pl will goof up
- your file permissions and make them unreadable to your web server.
+ name, if any. I believe, for the next release of Bugzilla, this will
+ be fixed so that Bugzilla supports a "webserveruser" parameter in localconfig
+ as well.
+ <EXAMPLE>
+ <TITLE>Running checksetup.pl as the web user</TITLE>
+ <PARA>
+ Assuming your web server runs as user "apache", and Bugzilla is installed in
+ "/usr/local/bugzilla", here's one way to run checksetup.pl as the web server user.
+ As root, for the <EMPHASIS>second run</EMPHASIS> of checksetup.pl, do this:
+ <PROGRAMLISTING>
+bash# chown -R apache:apache /usr/local/bugzilla
+bash# su - apache
+bash# cd /usr/local/bugzilla
+bash# ./checksetup.pl
+ </PROGRAMLISTING>
+ </PARA>
+ </EXAMPLE>
</PARA>
</NOTE>
</PARA>
@@ -680,7 +709,7 @@
</SECTION>
<SECTION>
- <TITLE>Setting Up Maintainers Manuall (Optional)</TITLE>
+ <TITLE>Setting Up Maintainers Manually (Optional)</TITLE>
<PARA>
If you want to add someone else to every group by hand, you can do it
by typing the appropriate MySQL commands. Run '<COMPUTEROUTPUT>
@@ -1295,6 +1324,56 @@ open SENDMAIL, "|\"C:/General/Web/tools/Windmail 4.0 Beta/windmail\" -t > mail.l
</PROCEDURE>
</BLOCKQUOTE>
</TIP>
+ <TIP>
+ <PARA>
+ This was some late breaking information from Jan Evert. Sorry for the lack of formatting.
+ </PARA>
+ <LITERALLAYOUT>
+I'm busy installing bugzilla on a WinNT machine and I thought I'd notify you
+at this moment of the commments I have to section 2.2.1 of the bugzilla
+guide (at http://www.trilobyte.net/barnsons/html/).
+
+Step 1:
+I've used apache, installation is really straightforward.
+After reading the Unix installation instructions, I found that it is
+necessary to add the ExecCGI option to the bugzilla directory. Also the
+'AddHandler' line for .cgi is by default commented out.
+
+Step 3: although just a detail, 'ppm install &lt;module%gt;' will also work
+(wihtout .ppd). And, it can also download these automatically from
+ActiveState.
+
+Step 4: although I have cygwin installed, it seems that it is not necessary.
+On my machine cygwin is not in the PATH and everything seems to work as
+expected.
+However, I've not used everything yet.
+
+Step 6: the 'bugs_password' given in SQL command d needs to be edited into
+localconfig later on (Step 7) if the password is not empty. I've also edited
+it into globals.pl, but I'm not sure that is needed. In both places, the
+variable is named db_pass.
+
+Step 8: all the sendmail replacements mentioned are not as simple as
+described there. Since I am not familiar (yet) with perl, I don't have any
+mail working yet.
+
+Step 9: in globals.pl the encrypt() call can be replaced by just the
+unencrypted password. In CGI.pl, the complete SQL command can be removed.
+
+Step 11: I've only changed the #! lines in *.cgi. I haven't noticed problems
+with the system() call yet.
+There seem to be only four system() called programs: processmail.pl (handled
+by step 10), syncshadowdb (which should probably get the same treatment as
+processmail.pl), diff and mysqldump. The last one is only needed with the
+shadowdb feature (which I don't use).
+
+There seems to be one step missing: copying the bugzilla files somehwere
+that apache can serve them.
+
+Just noticed the updated guide... Brian's comment is new. His first comment
+will work, but opens up a huge security hole.
+ </LITERALLAYOUT>
+ </TIP>
</SECTION>
</SECTION>
</CHAPTER>