The Bugzilla Guide

Matthew P. Barnson

barnboy@trilobyte.net

zach AT zachlipton DOT com

2001-04-25

Revision History
Revision v2.11	20 December 2000	Revised by: MPB
Converted the README, FAQ, and DATABASE information into SGML docbook format.
Revision 2.11.1	06 March 2001	Revised by: MPB
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.
Revision 2.12.0	24 April 2001	Revised by: MPB
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.
Revision 2.14.0	07 August 2001	Revised by: MPB
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.

This is the documentation for Bugzilla, the Mozilla bug-tracking system.

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.

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!

Table of Contents

1. About This Guide

1.1. Purpose and Scope of this Guide
1.2. Copyright Information
1.3. Disclaimer
1.4. New Versions
1.5. Credits
1.6. Contributors
1.7. Feedback
1.8. Translations
1.9. Document Conventions

2. Using Bugzilla

2.1. What is Bugzilla?
2.2. Why Should We Use Bugzilla?
2.3. How do I use Bugzilla?
2.4. Where can I find my user preferences?
2.5. Using Bugzilla-Conclusion

3. Installation

3.1. ERRATA
3.2. Step-by-step Install
3.3. Mac OS X Installation Notes
3.4. BSD Installation Notes
3.5. Installation General Notes
3.6. Win32 Installation Notes

4. Administering Bugzilla

4.1. Post-Installation Checklist
4.2. User Administration
4.3. Product, Component, Milestone, and Version Administration
4.4. Bugzilla Security

5. Integrating Bugzilla with Third-Party Tools

5.1. Bonsai
5.2. CVS
5.3. Perforce SCM
5.4. Tinderbox/Tinderbox2

6. The Future of Bugzilla

7. Bugzilla Variants and Competitors

7.1. Red Hat Bugzilla
7.2. Loki Bugzilla (Fenris)
7.3. Issuezilla
7.4. Scarab
7.5. Perforce SCM
7.6. SourceForge

A. The Bugzilla FAQ

B. Software Download Links

C. The Bugzilla Database

C.1. Database Schema Chart
C.2. MySQL Bugzilla Database Introduction
C.3. MySQL Permissions & Grant Tables

D. Useful Patches and Utilities for Bugzilla

D.1. Apache mod_rewrite magic
D.2. The setperl.csh Utility
D.3. Command-line Bugzilla Queries
D.4. The Quicksearch Utility
D.5. Hacking Bugzilla

E. GNU Free Documentation License

0. PREAMBLE
1. APPLICABILITY AND DEFINITIONS
2. VERBATIM COPYING
3. COPYING IN QUANTITY
4. MODIFICATIONS
5. COMBINING DOCUMENTS
6. COLLECTIONS OF DOCUMENTS
7. AGGREGATION WITH INDEPENDENT WORKS
8. TRANSLATION
9. TERMINATION
10. FUTURE REVISIONS OF THIS LICENSE
How to use this License for your documents

List of Examples
2-1. Some Famous Software Versions
2-2. Mozilla's Bugzilla Components
3-1. Setting up bonsaitools symlink
3-2. Running checksetup.pl as the web user
3-3. Installing ActivePerl ppd Modules on Microsoft Windows
3-4. Installing OpenInteract ppd Modules manually on Microsoft Windows
3-5. Removing encrypt() for Windows NT Bugzilla version 2.12 or earlier
4-1. Creating some Components
4-2. Common Use of Versions
4-3. A Different Use of Versions
4-4. Using SortKey with Target Milestone
4-5. When to Use Group Security
4-6. Creating a New Group
4-7. Bugzilla Groups
D-1. Using Setperl to set your perl path
1. A Sample Product

		Next
		About This Guide