The Bugzilla Guide

Matthew P. Barnson

The Bugzilla Team

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 mozilla.org's Bugzilla.

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. 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 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

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