The Bugzilla Guide Matthew P. Barnson [email protected] This is the documentation for Bugzilla, the Mozilla bug−tracking system. The Bugzilla Guide Table of Contents Chapter 1. About This Guide.............................................................................................................................1 1.1. Purpose and Scope of this Guide......................................................................................................1 1.2. Copyright Information......................................................................................................................1 1.3. Disclaimer.........................................................................................................................................2 1.4. New Versions....................................................................................................................................2 1.5. Credits...............................................................................................................................................2 1.6. Contributors......................................................................................................................................3 1.7. Feedback...........................................................................................................................................3 1.8. Translations.......................................................................................................................................3 1.9. Document Conventions.....................................................................................................................3 Chapter 2. Installing Bugzilla............................................................................................................................5 2.1. UNIX Installation..............................................................................................................................5 2.2. Win32 (Win98+/NT/2K) Installation...............................................................................................5 2.2.1. Win32 Installation: Step−by−step.................................................................................................5 2.2.2. Additional Windows Tips..............................................................................................................7 Chapter 3. Administering Bugzilla....................................................................................................................8 3.1. Post−Installation Checklist...............................................................................................................8 3.2. User Administration..........................................................................................................................9 3.2.1. Creating the Default User..............................................................................................................9 3.2.2. Managing Other Users...................................................................................................................9 3.2.2.1. Logging In......................................................................................................................9 3.2.2.2. Creating new users.......................................................................................................10 3.2.2.3. Disabling Users............................................................................................................10 3.2.2.4. Modifying Users..........................................................................................................10 3.3. Product, Component, Milestone, and Version Administration.......................................................12 3.3.1. Products.......................................................................................................................................12 3.3.2. Components.................................................................................................................................13 3.3.3. Versions.......................................................................................................................................13 3.3.4. Milestones....................................................................................................................................14 3.3.5. Voting..........................................................................................................................................15 3.3.6. Groups and Group Security.........................................................................................................16 3.4. Bugzilla Security.............................................................................................................................18 Chapter 4. Using Bugzilla.................................................................................................................................20 4.1. What is Bugzilla?............................................................................................................................20 4.2. Why Should We Use Bugzilla?......................................................................................................20 4.3. How do I use Bugzilla?...................................................................................................................21 4.3.1. Create a Bugzilla Account...........................................................................................................21 4.3.2. The Bugzilla Query Page.............................................................................................................22 4.3.3. Creating and Managing Bug Reports...........................................................................................25 4.3.3.1. Writing a Great Bug Report.........................................................................................25 4.3.3.2. Managing your Bug Reports........................................................................................26 4.4. What's in it for me?.........................................................................................................................26 4.4.1. Account Settings..........................................................................................................................26 4.4.2. Email Settings..............................................................................................................................27 4.4.2.1. Email Notification........................................................................................................27 i The Bugzilla Guide Table of Contents 4.4.2.2. New Email Technology...............................................................................................27 4.4.2.3. "Watching" Users........................................................................................................27 4.4.3. Page Footer..................................................................................................................................28 4.4.4. Permissions..................................................................................................................................28 4.5. Using Bugzilla−Conclusion............................................................................................................28 Chapter 5. Integrating Bugzilla with Third−Party Tools.............................................................................29 5.1. Bonsai.............................................................................................................................................29 5.2. CVS.................................................................................................................................................29 5.3. Perforce SCM..................................................................................................................................29 5.4. Tinderbox........................................................................................................................................29 Chapter 6. The Future of Bugzilla...................................................................................................................30 6.1. Reducing Spam...............................................................................................................................30 6.2. Better Searching..............................................................................................................................31 6.3. Description Flags and Tracking Bugs.............................................................................................32 6.4. Bug Issues.......................................................................................................................................33 6.5. Database Integrity...........................................................................................................................35 6.6. Bugzilla 3.0.....................................................................................................................................35 1. General Questions.................................................................................................................36 2. Red Hat Bugzilla...................................................................................................................38 3. Loki Bugzilla (AKA Fenris).................................................................................................40