The Bugzilla Guide

Matthew P. Barnson

barnboy@trilobyte.net

Revision History
Revision v2.1120 December 2000Revised by: MPB
Converted the README, FAQ, and DATABASE information into SGML docbook format.
Revision 2.11.106 March 2001Revised by: MPB
Took way too long to revise this for 2.12 release. Updated FAQ to use qandaset tags instead of literallayout, cleaned up administration section, added User Guide section, miscellaneous FAQ updates and third-party integration information. From this point on all new tags are lowercase in preparation for the 2.13 release of the Guide in XML format instead of SGML.
Revision 2.12.024 April 2001Revised by: MPB
Things fixed this release: Elaborated on queryhelp interface, added FAQ regarding moving bugs from one keyword to another, clarified possible problems with the Landfill tutorial, fixed a boatload of typos and unclear sentence structures. Incorporated the README into the UNIX installation section, and changed the README to indicate the deprecated status. Things I know need work: Used "simplelist" a lot, where I should have used "procedure" to tag things. Need to lowercase all tags to be XML compliant.

This is the documentation for Bugzilla, the Mozilla bug-tracking system.


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. Contributors
1.7. Feedback
1.8. Translations
1.9. Document Conventions
2. Installing Bugzilla
2.1. UNIX Installation
2.1.1. ERRATA
2.1.2. Step-by-step Install
2.1.2.1. Introduction
2.1.2.2. Installing the Prerequisites
2.1.2.3. Installing MySQL Database
2.1.2.4. Perl (5.004 or greater)
2.1.2.5. DBI Perl Module
2.1.2.6. Data::Dumper Perl Module
2.1.2.7. MySQL related Perl Module Collection
2.1.2.8. TimeDate Perl Module Collection
2.1.2.9. GD Perl Module (1.8.3)
2.1.2.10. Chart::Base Perl Module (0.99c)
2.1.2.11. DB_File Perl Module
2.1.2.12. HTTP Server
2.1.2.13. Installing the Bugzilla Files
2.1.2.14. Setting Up the MySQL Database
2.1.2.15. Tweaking "localconfig"
2.1.2.16. Setting Up Maintainers Manually (Optional)
2.1.2.17. The Whining Cron (Optional)
2.1.2.18. Bug Graphs (Optional)
2.1.2.19. Securing MySQL
2.1.2.20. Installation General Notes
2.2. Win32 (Win98+/NT/2K) Installation
2.2.1. Win32 Installation: Step-by-step
2.2.2. Additional Windows Tips
3. Administering Bugzilla
3.1. Post-Installation Checklist
3.2. User Administration
3.2.1. Creating the Default User
3.2.2. Managing Other Users
3.2.2.1. Logging In
3.2.2.2. Creating new users
3.2.2.3. Disabling Users
3.2.2.4. Modifying Users
3.3. Product, Component, Milestone, and Version Administration
3.3.1. Products
3.3.2. Components
3.3.3. Versions
3.3.4. Milestones
3.3.5. Voting
3.3.6. Groups and Group Security
3.4. Bugzilla Security
4. Using Bugzilla
4.1. What is Bugzilla?
4.2. Why Should We Use Bugzilla?
4.3. How do I use Bugzilla?
4.3.1. Create a Bugzilla Account
4.3.2. The Bugzilla Query Page
4.3.3. Creating and Managing Bug Reports
4.3.3.1. Writing a Great Bug Report
4.3.3.2. Managing your Bug Reports
4.4. What's in it for me?
4.4.1. Account Settings
4.4.2. Email Settings
4.4.2.1. Email Notification
4.4.2.2. New Email Technology
4.4.2.3. "Watching" Users
4.4.3. Page Footer
4.4.4. Permissions
4.5. Using Bugzilla-Conclusion
5. Integrating Bugzilla with Third-Party Tools
5.1. Bonsai
5.2. CVS
5.3. Perforce SCM
5.4. Tinderbox
6. The Future of Bugzilla
6.1. Reducing Spam
6.2. Better Searching
6.3. Description Flags and Tracking Bugs
6.4. Bug Issues
6.5. Database Integrity
6.6. Bugzilla 3.0
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
C.4. Cleaning up after mucking with Bugzilla
7. Bugzilla Variants
7.1. Red Hat Bugzilla
D. Useful Patches and Utilities for Bugzilla
D.1. The setperl.csh Utility
D.2. Command-line Bugzilla Queries
D.3. The Quicksearch Utility
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
2-1. Setting up bonsaitools symlink
2-2. Running checksetup.pl as the web user
2-3. Removing encrypt() for Windows NT installations
3-1. Creating some Components
3-2. Common Use of Versions
3-3. A Different Use of Versions
3-4. Using SortKey with Target Milestone
3-5. When to Use Group Security
3-6. Creating a New Group
4-1. Some Famous Software Versions
4-2. Mozilla Webtools Components
D-1. Using Setperl to set your perl path
1. A Sample Product
] >