The Bugzilla Guide

Matthew P. Barnson

This is the documentation for Bugzilla, the mozilla.org bug-tracking system. Bugzilla is an enterprise-class piece of software that powers issue-tracking for hundreds of organizations around the world, tracking millions of bugs.

This documentation is maintained in DocBook 4.1.2 XML format. Changes are best submitted as plain text or SGML diffs, attached to a Bugzilla bug.

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. Translations
1.7. 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. Bugzilla Variants and Competitors

6.1. Red Hat Bugzilla
6.2. Loki Bugzilla (Fenris)
6.3. Issuezilla
6.4. Scarab
6.5. Perforce SCM
6.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

Glossary

List of Examples
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