The Bugzilla Guide − 2.16.3 Release Matthew P. Barnson The Bugzilla Team 2003−04−23 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 Bugzilla Guide − 2.16.3 Release Table of Contents Chapter 1. About This Guide.............................................................................................................................1 1.1. Copyright Information......................................................................................................................1 1.2. Disclaimer.........................................................................................................................................1 1.3. New Versions....................................................................................................................................1 1.4. Credits...............................................................................................................................................2 1.5. Document Conventions.....................................................................................................................2 Chapter 2. Introduction......................................................................................................................................4 2.1. What is Bugzilla?..............................................................................................................................4 2.2. Why Should We Use Bugzilla?........................................................................................................4 Chapter 3. Using Bugzilla...................................................................................................................................6 3.1. How do I use Bugzilla?.....................................................................................................................6 3.1.1. Create a Bugzilla Account.......................................................................................................6 3.1.2. Anatomy of a Bug...................................................................................................................6 3.1.3. Searching for Bugs..................................................................................................................7 3.1.4. Bug Lists..................................................................................................................................7 3.1.5. Filing Bugs..............................................................................................................................8 3.2. Hints and Tips...................................................................................................................................8 3.2.1. Autolinkification.....................................................................................................................8 3.2.2. Quicksearch.............................................................................................................................9 3.2.3. Comments................................................................................................................................9 3.2.4. Attachments.............................................................................................................................9 3.2.5. Filing Bugs..............................................................................................................................9 3.3. User Preferences.............................................................................................................................10 3.3.1. Account Settings....................................................................................................................10 3.3.2. Email Settings........................................................................................................................10 3.3.3. Page Footer............................................................................................................................10 3.3.4. Permissions............................................................................................................................10 Chapter 4. Installation......................................................................................................................................11 4.1. Step−by−step Install.......................................................................................................................11 4.1.1. Introduction...........................................................................................................................11 4.1.2. Package List..........................................................................................................................11 4.1.3. MySQL..................................................................................................................................12 4.1.4. Perl.........................................................................................................................................12 4.1.5. Perl Modules..........................................................................................................................13 4.1.6. HTTP Server..........................................................................................................................14 4.1.7. Bugzilla.................................................................................................................................15 4.1.8. Setting Up the MySQL Database..........................................................................................16 4.1.9. checksetup.pl.........................................................................................................................16 4.1.10. Configuring Bugzilla...........................................................................................................17 4.2. Optional Additional Configuration.................................................................................................17 4.2.1. Dependency Charts................................................................................................................17 4.2.2. Bug Graphs............................................................................................................................17 4.2.3. The Whining Cron.................................................................................................................18 4.2.4. LDAP Authentication............................................................................................................18 4.2.5. Preventing untrusted Bugzilla content from executing malicious Javascript code...............19 i The Bugzilla Guide − 2.16.3 Release Table of Contents Chapter 4. Installation 4.2.6. .htaccess files and security..............................................................................................19 4.2.7. mod_throttle and Security.....................................................................................................20 4.3. Win32 Installation Notes................................................................................................................20 4.3.1. Win32 Installation: Step−by−step.........................................................................................20 4.3.2. Additional Windows Tips.....................................................................................................25 4.4. Mac OS X Installation Notes..........................................................................................................25 4.5. Troubleshooting..............................................................................................................................26 4.5.1. Bundle::Bugzilla makes me upgrade to Perl 5.6.1................................................................26 4.5.2. DBD::Sponge::db prepare failed...........................................................................................26 4.5.3. cannot chdir(/var/spool/mqueue)...........................................................................................27 4.5.4. Your vendor has not defined Fcntl macro O_NOINHERIT.................................................27 Chapter 5. Administering Bugzilla..................................................................................................................29 5.1. Bugzilla Configuration...................................................................................................................29 5.2. User Administration........................................................................................................................30 5.2.1. Creating the Default User......................................................................................................30 5.2.2. Managing Other Users...........................................................................................................31 5.3. Product, Component, Milestone, and Version Administration.......................................................32 5.3.1. Products.................................................................................................................................32 5.3.2. Components...........................................................................................................................32