The Bugzilla Guide - 2.18.6 Release The Bugzilla Team The Bugzilla Guide - 2.18.6 Release by The Bugzilla Team Published 2006-10-15 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. MySQL..............................................................................................................................................5 2.1.3. Web Server.........................................................................................................................................5 2.1.4. Bugzilla..............................................................................................................................................5 2.1.5. Perl Modules......................................................................................................................................5 2.1.5.1. DBD::mysql..........................................................................................................................7 2.1.5.2. Template Toolkit (2.08).........................................................................................................7 2.1.5.3. GD (1.20)..............................................................................................................................7 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::Parser (any)................................................................................................................8 2.1.5.8. MIME::Parser (any)..............................................................................................................8 2.1.5.9. PatchReader (0.9.4)...............................................................................................................8 2.1.6. Mail Transfer Agent (MTA)..............................................................................................................8 2.2. Configuration..................................................................................................................................................9 2.2.1. localconfig..........................................................................................................................................9 2.2.2. MySQL..............................................................................................................................................9 2.2.2.1. Allow large attachments........................................................................................................9 2.2.2.2. Allow small words in full-text indexes...............................................................................10 2.2.2.3. Add a user to MySQL.........................................................................................................10 2.2.2.4. Permit attachments table to grow beyond 4GB...................................................................11 2.2.3. checksetup.pl...................................................................................................................................11 2.2.4. Web server.......................................................................................................................................11 2.2.4.1. Apache httpd.......................................................................................................................11 2.2.4.2. Microsoft Internet Information Services.............................................................................12 2.2.4.3. AOL Server.........................................................................................................................13 2.2.5. Bugzilla............................................................................................................................................14 2.3. Optional Additional Configuration...............................................................................................................14 2.3.1. Bug Graphs......................................................................................................................................14 2.3.2. Dependency Charts..........................................................................................................................15 2.3.3. The Whining Cron...........................................................................................................................15 2.3.4. Patch Viewer....................................................................................................................................16 2.3.5. LDAP Authentication......................................................................................................................16 2.3.6. Serving Alternate Formats with the right MIME type.....................................................................17 2.4. OS-Specific Installation Notes.....................................................................................................................17 2.4.1. Microsoft Windows.........................................................................................................................18 iii 2.4.1.1. Win32 Perl...........................................................................................................................18 2.4.1.2. Perl Modules on Win32.......................................................................................................18 2.4.1.3. Code changes required to run on Win32.............................................................................18 2.4.1.4. Serving the web pages.........................................................................................................19 2.4.2. Mac OS X........................................................................................................................................19 2.4.2.1. Sendmail..............................................................................................................................20 2.4.2.2. Libraries & Perl Modules on Mac OS X.............................................................................20 2.4.3. Linux-Mandrake 8.0........................................................................................................................21 2.5. UNIX (non-root) Installation Notes.............................................................................................................21 2.5.1. Introduction......................................................................................................................................21 2.5.2. MySQL............................................................................................................................................21 2.5.2.1. Running MySQL as Non-Root...........................................................................................21 2.5.3. Perl...................................................................................................................................................23 2.5.4. Perl Modules....................................................................................................................................23 2.5.4.1. The Independant Method....................................................................................................23 2.5.4.2. The Mixed Method..............................................................................................................24 2.5.5. HTTP Server....................................................................................................................................25