744 lines
11 KiB
HTML
744 lines
11 KiB
HTML
<HTML
|
|
><HEAD
|
|
><TITLE
|
|
>The Bugzilla Guide</TITLE
|
|
><META
|
|
NAME="GENERATOR"
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
|
|
"><LINK
|
|
REL="NEXT"
|
|
TITLE="About This Guide"
|
|
HREF="about.html"><META
|
|
NAME="KEYWORD"
|
|
CONTENT="Bugzilla"><META
|
|
NAME="KEYWORD"
|
|
CONTENT="Guide"><META
|
|
NAME="KEYWORD"
|
|
CONTENT="installation"><META
|
|
NAME="KEYWORD"
|
|
CONTENT="FAQ"><META
|
|
NAME="KEYWORD"
|
|
CONTENT="administration"><META
|
|
NAME="KEYWORD"
|
|
CONTENT="integration"><META
|
|
NAME="KEYWORD"
|
|
CONTENT="MySQL"><META
|
|
NAME="KEYWORD"
|
|
CONTENT="Mozilla"><META
|
|
NAME="KEYWORD"
|
|
CONTENT="webtools"></HEAD
|
|
><BODY
|
|
CLASS="book"
|
|
BGCOLOR="#FFFFFF"
|
|
TEXT="#000000"
|
|
LINK="#0000FF"
|
|
VLINK="#840084"
|
|
ALINK="#0000FF"
|
|
><DIV
|
|
CLASS="BOOK"
|
|
><A
|
|
NAME="index"><DIV
|
|
CLASS="TITLEPAGE"
|
|
><H1
|
|
CLASS="title"
|
|
><A
|
|
NAME="AEN2">The Bugzilla Guide</H1
|
|
><H3
|
|
CLASS="author"
|
|
><A
|
|
NAME="AEN27">Matthew P. Barnson</H3
|
|
><DIV
|
|
CLASS="affiliation"
|
|
><DIV
|
|
CLASS="address"
|
|
><P
|
|
CLASS="address"
|
|
>barnboy@trilobyte.net</P
|
|
></DIV
|
|
></DIV
|
|
><SPAN
|
|
CLASS="collab"
|
|
><SPAN
|
|
CLASS="collabname"
|
|
>Zach Lipton</SPAN
|
|
><DIV
|
|
CLASS="affiliation"
|
|
><DIV
|
|
CLASS="address"
|
|
><P
|
|
CLASS="address"
|
|
>zach AT zachlipton DOT com</P
|
|
></DIV
|
|
></DIV
|
|
><BR></SPAN
|
|
><P
|
|
CLASS="pubdate"
|
|
>2001-04-25<BR></P
|
|
><DIV
|
|
CLASS="revhistory"
|
|
><TABLE
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
><TR
|
|
><TH
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
COLSPAN="3"
|
|
><B
|
|
>Revision History</B
|
|
></TH
|
|
></TR
|
|
><TR
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>Revision v2.11</TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>20 December 2000</TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>Revised by: MPB</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
ALIGN="LEFT"
|
|
COLSPAN="3"
|
|
>Converted the README, FAQ, and DATABASE information into
|
|
SGML docbook format.</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>Revision 2.11.1</TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>06 March 2001</TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>Revised by: MPB</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
ALIGN="LEFT"
|
|
COLSPAN="3"
|
|
>Took way too long to revise this for 2.12 release. Updated
|
|
FAQ to use qandaset tags instead of literallayout, cleaned
|
|
up administration section, added User Guide section,
|
|
miscellaneous FAQ updates and third-party integration
|
|
information. From this point on all new tags are lowercase
|
|
in preparation for the 2.13 release of the Guide in XML
|
|
format instead of SGML.</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>Revision 2.12.0</TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>24 April 2001</TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>Revised by: MPB</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
ALIGN="LEFT"
|
|
COLSPAN="3"
|
|
>Things fixed this release: Elaborated on queryhelp
|
|
interface, added FAQ regarding moving bugs from one keyword
|
|
to another, clarified possible problems with the Landfill
|
|
tutorial, fixed a boatload of typos and unclear sentence
|
|
structures. Incorporated the README into the UNIX
|
|
installation section, and changed the README to indicate the
|
|
deprecated status. Things I know need work: Used
|
|
"simplelist" a lot, where I should have used "procedure" to
|
|
tag things. Need to lowercase all tags to be XML compliant.</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>Revision 2.14.0</TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>07 August 2001</TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>Revised by: MPB</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
ALIGN="LEFT"
|
|
COLSPAN="3"
|
|
>Attempted to integrate relevant portions of the UNIX and
|
|
Windows installation instructions, moved some data from FAQ
|
|
to Install, removed references to README from text, added
|
|
Mac OS X install instructions, fixed a bunch
|
|
of tpyos (Mark Harig), linked text that referenced other
|
|
parts of the Guide, and nuked the old MySQL permissions
|
|
section.</TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
><DIV
|
|
><DIV
|
|
CLASS="abstract"
|
|
><A
|
|
NAME="AEN39"><P
|
|
></P
|
|
><P
|
|
> This is the documentation for Bugzilla, the Mozilla
|
|
bug-tracking system.
|
|
</P
|
|
><P
|
|
> Bugzilla is an enterprise-class set of software utilities
|
|
that, when used together, power issue-tracking for hundreds of
|
|
organizations around the world, tracking millions of bugs.
|
|
While it is easy to use and quite flexible, it is
|
|
difficult for a novice to install and maintain. Although we
|
|
have provided step-by-step directions, Bugzilla is not always
|
|
easy to get working. Please be sure the person responsible
|
|
for installing and maintaining this software is a qualified
|
|
professional for the operating system upon which you install
|
|
Bugzilla.
|
|
</P
|
|
><P
|
|
> THIS DOCUMENTATION IS MAINTAINED IN DOCBOOK 4.1.2 XML FORMAT.
|
|
IF YOU WISH TO MAKE CORRECTIONS, PLEASE MAKE THEM IN PLAIN
|
|
TEXT OR SGML DIFFS AGAINST THE SOURCE. I CANNOT ACCEPT
|
|
ADDITIONS TO THE GUIDE WRITTEN IN HTML!
|
|
</P
|
|
><P
|
|
></P
|
|
></DIV
|
|
></DIV
|
|
><HR></DIV
|
|
><DIV
|
|
CLASS="TOC"
|
|
><DL
|
|
><DT
|
|
><B
|
|
>Table of Contents</B
|
|
></DT
|
|
><DT
|
|
>1. <A
|
|
HREF="about.html"
|
|
>About This Guide</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>1.1. <A
|
|
HREF="aboutthisguide.html"
|
|
>Purpose and Scope of this Guide</A
|
|
></DT
|
|
><DT
|
|
>1.2. <A
|
|
HREF="copyright.html"
|
|
>Copyright Information</A
|
|
></DT
|
|
><DT
|
|
>1.3. <A
|
|
HREF="disclaimer.html"
|
|
>Disclaimer</A
|
|
></DT
|
|
><DT
|
|
>1.4. <A
|
|
HREF="newversions.html"
|
|
>New Versions</A
|
|
></DT
|
|
><DT
|
|
>1.5. <A
|
|
HREF="credits.html"
|
|
>Credits</A
|
|
></DT
|
|
><DT
|
|
>1.6. <A
|
|
HREF="contributors.html"
|
|
>Contributors</A
|
|
></DT
|
|
><DT
|
|
>1.7. <A
|
|
HREF="feedback.html"
|
|
>Feedback</A
|
|
></DT
|
|
><DT
|
|
>1.8. <A
|
|
HREF="translations.html"
|
|
>Translations</A
|
|
></DT
|
|
><DT
|
|
>1.9. <A
|
|
HREF="conventions.html"
|
|
>Document Conventions</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>2. <A
|
|
HREF="using.html"
|
|
>Using Bugzilla</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>2.1. <A
|
|
HREF="whatis.html"
|
|
>What is Bugzilla?</A
|
|
></DT
|
|
><DT
|
|
>2.2. <A
|
|
HREF="why.html"
|
|
>Why Should We Use Bugzilla?</A
|
|
></DT
|
|
><DT
|
|
>2.3. <A
|
|
HREF="how.html"
|
|
>How do I use Bugzilla?</A
|
|
></DT
|
|
><DT
|
|
>2.4. <A
|
|
HREF="init4me.html"
|
|
>Where can I find my user preferences?</A
|
|
></DT
|
|
><DT
|
|
>2.5. <A
|
|
HREF="usingbz-conc.html"
|
|
>Using Bugzilla-Conclusion</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>3. <A
|
|
HREF="installation.html"
|
|
>Installation</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>3.1. <A
|
|
HREF="errata.html"
|
|
>ERRATA</A
|
|
></DT
|
|
><DT
|
|
>3.2. <A
|
|
HREF="stepbystep.html"
|
|
>Step-by-step Install</A
|
|
></DT
|
|
><DT
|
|
>3.3. <A
|
|
HREF="osx.html"
|
|
>Mac OS X Installation Notes</A
|
|
></DT
|
|
><DT
|
|
>3.4. <A
|
|
HREF="bsdinstall.html"
|
|
>BSD Installation Notes</A
|
|
></DT
|
|
><DT
|
|
>3.5. <A
|
|
HREF="geninstall.html"
|
|
>Installation General Notes</A
|
|
></DT
|
|
><DT
|
|
>3.6. <A
|
|
HREF="win32.html"
|
|
>Win32 Installation Notes</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>4. <A
|
|
HREF="administration.html"
|
|
>Administering Bugzilla</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>4.1. <A
|
|
HREF="postinstall-check.html"
|
|
>Post-Installation Checklist</A
|
|
></DT
|
|
><DT
|
|
>4.2. <A
|
|
HREF="useradmin.html"
|
|
>User Administration</A
|
|
></DT
|
|
><DT
|
|
>4.3. <A
|
|
HREF="programadmin.html"
|
|
>Product, Component, Milestone, and Version
|
|
Administration</A
|
|
></DT
|
|
><DT
|
|
>4.4. <A
|
|
HREF="security.html"
|
|
>Bugzilla Security</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>5. <A
|
|
HREF="integration.html"
|
|
>Integrating Bugzilla with Third-Party Tools</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>5.1. <A
|
|
HREF="bonsai.html"
|
|
>Bonsai</A
|
|
></DT
|
|
><DT
|
|
>5.2. <A
|
|
HREF="cvs.html"
|
|
>CVS</A
|
|
></DT
|
|
><DT
|
|
>5.3. <A
|
|
HREF="scm.html"
|
|
>Perforce SCM</A
|
|
></DT
|
|
><DT
|
|
>5.4. <A
|
|
HREF="tinderbox.html"
|
|
>Tinderbox/Tinderbox2</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>6. <A
|
|
HREF="future.html"
|
|
>The Future of Bugzilla</A
|
|
></DT
|
|
><DT
|
|
>7. <A
|
|
HREF="variants.html"
|
|
>Bugzilla Variants and Competitors</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>7.1. <A
|
|
HREF="rhbugzilla.html"
|
|
>Red Hat Bugzilla</A
|
|
></DT
|
|
><DT
|
|
>7.2. <A
|
|
HREF="variant-fenris.html"
|
|
>Loki Bugzilla (Fenris)</A
|
|
></DT
|
|
><DT
|
|
>7.3. <A
|
|
HREF="variant-issuezilla.html"
|
|
>Issuezilla</A
|
|
></DT
|
|
><DT
|
|
>7.4. <A
|
|
HREF="variant-scarab.html"
|
|
>Scarab</A
|
|
></DT
|
|
><DT
|
|
>7.5. <A
|
|
HREF="variant-perforce.html"
|
|
>Perforce SCM</A
|
|
></DT
|
|
><DT
|
|
>7.6. <A
|
|
HREF="variant-sourceforge.html"
|
|
>SourceForge</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>A. <A
|
|
HREF="faq.html"
|
|
>The Bugzilla FAQ</A
|
|
></DT
|
|
><DT
|
|
>B. <A
|
|
HREF="downloadlinks.html"
|
|
>Software Download Links</A
|
|
></DT
|
|
><DT
|
|
>C. <A
|
|
HREF="database.html"
|
|
>The Bugzilla Database</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>C.1. <A
|
|
HREF="dbschema.html"
|
|
>Database Schema Chart</A
|
|
></DT
|
|
><DT
|
|
>C.2. <A
|
|
HREF="dbdoc.html"
|
|
>MySQL Bugzilla Database Introduction</A
|
|
></DT
|
|
><DT
|
|
>C.3. <A
|
|
HREF="granttables.html"
|
|
>MySQL Permissions & Grant Tables</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>D. <A
|
|
HREF="patches.html"
|
|
>Useful Patches and Utilities for Bugzilla</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>D.1. <A
|
|
HREF="rewrite.html"
|
|
>Apache <TT
|
|
CLASS="filename"
|
|
>mod_rewrite</TT
|
|
> magic</A
|
|
></DT
|
|
><DT
|
|
>D.2. <A
|
|
HREF="setperl.html"
|
|
>The setperl.csh Utility</A
|
|
></DT
|
|
><DT
|
|
>D.3. <A
|
|
HREF="cmdline.html"
|
|
>Command-line Bugzilla Queries</A
|
|
></DT
|
|
><DT
|
|
>D.4. <A
|
|
HREF="quicksearch.html"
|
|
>The Quicksearch Utility</A
|
|
></DT
|
|
><DT
|
|
>D.5. <A
|
|
HREF="bzhacking.html"
|
|
>Hacking Bugzilla</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>E. <A
|
|
HREF="gfdl.html"
|
|
>GNU Free Documentation License</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>0. <A
|
|
HREF="gfdl-0.html"
|
|
>PREAMBLE</A
|
|
></DT
|
|
><DT
|
|
>1. <A
|
|
HREF="gfdl-1.html"
|
|
>APPLICABILITY AND DEFINITIONS</A
|
|
></DT
|
|
><DT
|
|
>2. <A
|
|
HREF="gfdl-2.html"
|
|
>VERBATIM COPYING</A
|
|
></DT
|
|
><DT
|
|
>3. <A
|
|
HREF="gfdl-3.html"
|
|
>COPYING IN QUANTITY</A
|
|
></DT
|
|
><DT
|
|
>4. <A
|
|
HREF="gfdl-4.html"
|
|
>MODIFICATIONS</A
|
|
></DT
|
|
><DT
|
|
>5. <A
|
|
HREF="gfdl-5.html"
|
|
>COMBINING DOCUMENTS</A
|
|
></DT
|
|
><DT
|
|
>6. <A
|
|
HREF="gfdl-6.html"
|
|
>COLLECTIONS OF DOCUMENTS</A
|
|
></DT
|
|
><DT
|
|
>7. <A
|
|
HREF="gfdl-7.html"
|
|
>AGGREGATION WITH INDEPENDENT WORKS</A
|
|
></DT
|
|
><DT
|
|
>8. <A
|
|
HREF="gfdl-8.html"
|
|
>TRANSLATION</A
|
|
></DT
|
|
><DT
|
|
>9. <A
|
|
HREF="gfdl-9.html"
|
|
>TERMINATION</A
|
|
></DT
|
|
><DT
|
|
>10. <A
|
|
HREF="gfdl-10.html"
|
|
>FUTURE REVISIONS OF THIS LICENSE</A
|
|
></DT
|
|
><DT
|
|
><A
|
|
HREF="gfdl-howto.html"
|
|
>How to use this License for your documents</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
><A
|
|
HREF="glossary.html"
|
|
>Glossary</A
|
|
></DT
|
|
></DL
|
|
></DIV
|
|
><DIV
|
|
CLASS="LOT"
|
|
><DL
|
|
CLASS="LOT"
|
|
><DT
|
|
><B
|
|
>List of Examples</B
|
|
></DT
|
|
><DT
|
|
>2-1. <A
|
|
HREF="how.html#AEN307"
|
|
>Some Famous Software Versions</A
|
|
></DT
|
|
><DT
|
|
>2-2. <A
|
|
HREF="how.html#AEN317"
|
|
>Mozilla's Bugzilla Components</A
|
|
></DT
|
|
><DT
|
|
>3-1. <A
|
|
HREF="stepbystep.html#AEN709"
|
|
>Setting up bonsaitools symlink</A
|
|
></DT
|
|
><DT
|
|
>3-2. <A
|
|
HREF="stepbystep.html#AEN800"
|
|
>Running checksetup.pl as the web user</A
|
|
></DT
|
|
><DT
|
|
>3-3. <A
|
|
HREF="win32.html#AEN1051"
|
|
>Installing ActivePerl ppd Modules on Microsoft Windows</A
|
|
></DT
|
|
><DT
|
|
>3-4. <A
|
|
HREF="win32.html#AEN1064"
|
|
>Installing OpenInteract ppd Modules manually on Microsoft
|
|
Windows</A
|
|
></DT
|
|
><DT
|
|
>3-5. <A
|
|
HREF="win32.html#AEN1246"
|
|
>Removing encrypt() for Windows NT Bugzilla version
|
|
2.12 or earlier</A
|
|
></DT
|
|
><DT
|
|
>4-1. <A
|
|
HREF="programadmin.html#AEN1483"
|
|
>Creating some Components</A
|
|
></DT
|
|
><DT
|
|
>4-2. <A
|
|
HREF="programadmin.html#AEN1512"
|
|
>Common Use of Versions</A
|
|
></DT
|
|
><DT
|
|
>4-3. <A
|
|
HREF="programadmin.html#AEN1516"
|
|
>A Different Use of Versions</A
|
|
></DT
|
|
><DT
|
|
>4-4. <A
|
|
HREF="programadmin.html#AEN1544"
|
|
>Using SortKey with Target Milestone</A
|
|
></DT
|
|
><DT
|
|
>4-5. <A
|
|
HREF="programadmin.html#AEN1580"
|
|
>When to Use Group Security</A
|
|
></DT
|
|
><DT
|
|
>4-6. <A
|
|
HREF="programadmin.html#AEN1597"
|
|
>Creating a New Group</A
|
|
></DT
|
|
><DT
|
|
>4-7. <A
|
|
HREF="programadmin.html#AEN1614"
|
|
>Bugzilla Groups</A
|
|
></DT
|
|
><DT
|
|
>D-1. <A
|
|
HREF="setperl.html#AEN2461"
|
|
>Using Setperl to set your perl path</A
|
|
></DT
|
|
><DT
|
|
>1. <A
|
|
HREF="glossary.html#AEN2782"
|
|
>A Sample Product</A
|
|
></DT
|
|
></DL
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="NAVFOOTER"
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"><TABLE
|
|
SUMMARY="Footer navigation table"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
> </TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
> </TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="about.html"
|
|
ACCESSKEY="N"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
> </TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
> </TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
>About This Guide</TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></BODY
|
|
></HTML
|
|
> |