The Bugzilla Guide - 2.20.7 Release

The Bugzilla Team

2008-11-06

This is the documentation for Bugzilla, a bug-tracking system from mozilla.org. Bugzilla is an enterprise-class piece of software that tracks millions of bugs and issues for hundreds of organizations around the world.

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

2.1. Installation
2.2. Configuration
2.3. Optional Additional Configuration
2.4. OS-Specific Installation Notes
2.5. UNIX (non-root) Installation Notes

3. Administering Bugzilla

3.1. Bugzilla Configuration
3.2. User Administration
3.3. Classifications
3.4. Products
3.5. Components
3.6. Versions
3.7. Milestones
3.8. Flags
3.9. Keywords
3.10. Legal Values
3.11. Voting
3.12. Quips
3.13. Groups and Group Security
3.14. Checking and Maintaining Database Integrity
3.15. Upgrading to New Releases

4. Bugzilla Security

4.1. Operating System
4.2. MySQL
4.3. Web server
4.4. Bugzilla

5. Using Bugzilla

5.1. Introduction
5.2. Create a Bugzilla Account
5.3. Anatomy of a Bug
5.4. Life Cycle of a Bug
5.5. Searching for Bugs
5.6. Bug Lists
5.7. Filing Bugs
5.8. Attachments
5.9. Hints and Tips
5.10. Time Tracking Information
5.11. User Preferences
5.12. Reports and Charts
5.13. Flags
5.14. Whining

6. Customizing Bugzilla

6.1. Template Customization
6.2. Template Hooks
6.3. Customizing Who Can Change What
6.4. Modifying Your Running System
6.5. Integrating Bugzilla with Third-Party Tools

A. The Bugzilla FAQ

B. Troubleshooting

B.1. General Advice
B.2. The Apache webserver is not serving Bugzilla pages
B.3. I installed a Perl module, but checksetup.pl claims it's not installed!
B.4. DBD::Sponge::db prepare failed
B.5. cannot chdir(/var/spool/mqueue)
B.6. Your vendor has not defined Fcntl macro O_NOINHERIT
B.7. Everybody is constantly being forced to relogin
B.8. Some users are constantly being forced to relogin
B.9. index.cgi doesn't show up unless specified in the URL
B.10. checksetup.pl reports "Client does not support authentication protocol requested by server..."

C. Contrib

C.1. Command-line Search Interface
C.2. Command-line 'Send Unsent Bug-mail' tool

D. Manual Installation of Perl Modules

D.1. Instructions
D.2. Download Locations
D.3. Optional Modules

E. GNU Free Documentation License

0. Preamble
1. Applicability and Definition
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 Figures
5-1. Lifecycle of a Bugzilla Bug

List of Examples
4-1. Assigning the MySQL "root" User a Password
4-2. Disabling the MySQL "anonymous" User
4-3. Disabling Networking in MySQL
4-4. Forcing Bugzilla to output a charset
B-1. Examples of urlbase/cookiepath pairs for sharing login cookies
B-2. Examples of urlbase/cookiepath pairs to restrict the login cookie