The Bugzilla Guide - 2.16.4 Release

Matthew P. Barnson

The Bugzilla Team

2003-11-01

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 XML diffs, attached to a bug filed in mozilla.org's Bugzilla.

The most current version of this document can always be found on the Bugzilla Documentation Page.

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. Win32 Installation Notes
4.4. Mac OS X Installation Notes
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 Customisation
5.8. Upgrading to New Releases
5.9. Integrating Bugzilla with Third-Party Tools

A. The Bugzilla FAQ

B. The Bugzilla Database

B.1. Database Schema Chart
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

List of Figures
4-1. Other File::Temp error messages
4-2. Patch for File::Temp in Perl 5.6.0

List of Examples
4-1. Installing ActivePerl ppd Modules on Microsoft Windows
4-2. Installing OpenInteract ppd Modules manually on Microsoft Windows
4-3. Removing encrypt() for Windows NT Bugzilla version 2.12 or earlier
5-1. Upgrading using CVS
5-2. Upgrading using the tarball
5-3. Upgrading using patches

		Next
		About This Guide