The Bugzilla Guide

Matthew P. Barnson

The Bugzilla Team

2.17.3 Development Release Edition

2003-01-02

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 bug filed in the Bugzilla Documentation compontent.

This is a development version of this guide. Information in it is subject to change before the 2.18 release of this guide (which will correspond with the 2.18 release of Bugzilla).


Table of Contents
1. About This Guide
1.1. Copyright Information
1.2. Disclaimer
1.3. New Versions
1.4. Credits
1.5. Document Conventions
2. Introduction
2.1. What is Bugzilla?
2.2. Why Should We Use Bugzilla?
3. Using Bugzilla
3.1. How do I use Bugzilla?
3.2. Hints and Tips
3.3. User Preferences
4. Installation
4.1. Step-by-step Install
4.2. Optional Additional Configuration
4.3. OS Specific Installation Notes
4.4. HTTP Server Configuration
4.5. Troubleshooting
5. Administering Bugzilla
5.1. Bugzilla Configuration
5.2. User Administration
5.3. Product, Component, Milestone, and Version Administration
5.4. Voting
5.5. Groups and Group Security
5.6. Bugzilla Security
5.7. Template Customization
5.8. Change Permission Customization
5.9. Upgrading to New Releases
5.10. Integrating Bugzilla with Third-Party Tools
A. The Bugzilla FAQ
B. The Bugzilla Database
B.1. Modifying Your Running System
B.2. MySQL Bugzilla Database Introduction
C. Useful Patches and Utilities for Bugzilla
C.1. Apache mod_rewrite magic
C.2. Command-line Bugzilla Queries
D. Bugzilla Variants and Competitors
D.1. Red Hat Bugzilla
D.2. Loki Bugzilla (Fenris)
D.3. Issuezilla
D.4. Scarab
D.5. Perforce SCM
D.6. SourceForge
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
4-1. .htaccess files for Apache
5-1. Upgrading using CVS
5-2. Upgrading using the tarball
5-3. Upgrading using patches