The Bugzilla Guide - 2.22.7 Release The Bugzilla Team The Bugzilla Guide - 2.22.7 Release by The Bugzilla Team Published 2009-02-02 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 (http://www.bugzilla.org/documentation.html). Table of Contents 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 2. Installing Bugzilla.....................................................................................................................................................4 2.1. Installation......................................................................................................................................................4 2.1.1. Perl.....................................................................................................................................................4 2.1.2. Database Engine................................................................................................................................4 2.1.2.1. MySQL..................................................................................................................................5 2.1.2.2. PostgreSQL...........................................................................................................................5 2.1.3. Web Server.........................................................................................................................................5 2.1.4. Bugzilla..............................................................................................................................................5 2.1.5. Perl Modules......................................................................................................................................6 2.1.5.1. DBD::mysql..........................................................................................................................7 2.1.5.2. Template Toolkit (2.10).........................................................................................................8 2.1.5.3. GD (1.20)..............................................................................................................................8 2.1.5.4. Chart::Base (1.0)...................................................................................................................8 2.1.5.5. GD::Graph (any)...................................................................................................................8 2.1.5.6. GD::Text::Align (any)...........................................................................................................8 2.1.5.7. XML::Twig (any)..................................................................................................................8 2.1.5.8. PatchReader (0.9.4)...............................................................................................................8 2.1.6. Mail Transfer Agent (MTA)..............................................................................................................9 2.2. Configuration..................................................................................................................................................9 2.2.1. localconfig..........................................................................................................................................9 2.2.2. Database Server...............................................................................................................................10 2.2.2.1. Bugzilla Database Schema..................................................................................................10 2.2.2.2. MySQL................................................................................................................................10 2.2.2.3. PostgreSQL.........................................................................................................................12 2.2.3. checksetup.pl...................................................................................................................................13 2.2.4. Web server.......................................................................................................................................13 2.2.4.1. Apache httpd.......................................................................................................................13 2.2.4.2. Microsoft Internet Information Services.............................................................................14 2.2.5. Bugzilla............................................................................................................................................15 2.3. Optional Additional Configuration...............................................................................................................15 2.3.1. Bug Graphs......................................................................................................................................15 2.3.2. Dependency Charts..........................................................................................................................16 2.3.3. The Whining Cron...........................................................................................................................16 2.3.4. Whining...........................................................................................................................................16 2.3.5. Patch Viewer....................................................................................................................................17 2.3.6. LDAP Authentication......................................................................................................................17 2.3.7. Serving Alternate Formats with the right MIME type.....................................................................18 2.4. Multiple Bugzilla databases with a single installation.................................................................................19 2.5. OS-Specific Installation Notes.....................................................................................................................19 iii 2.5.1. Microsoft Windows.........................................................................................................................20 2.5.1.1. Win32 Perl...........................................................................................................................20 2.5.1.2. Perl Modules on Win32.......................................................................................................20 2.5.1.3. Code changes required to run on Win32.............................................................................20 2.5.1.4. Serving the web pages.........................................................................................................20 2.5.1.5. Sending Email.....................................................................................................................21 2.5.2. Mac OS X........................................................................................................................................21 2.5.2.1. Sendmail..............................................................................................................................21 2.5.2.2. Libraries & Perl Modules on Mac OS X.............................................................................21 2.5.3. Linux Distributions..........................................................................................................................22 2.6. UNIX (non-root) Installation Notes.............................................................................................................22 2.6.1. Introduction......................................................................................................................................22 2.6.2. MySQL............................................................................................................................................22 2.6.2.1. Running MySQL as Non-Root...........................................................................................23 2.6.3. Perl...................................................................................................................................................24 2.6.4. Perl Modules....................................................................................................................................24