<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>The Bugzilla Guide - 4.4.11 Release</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="description" content="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."><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.11 Release"><link rel="next" href="about.html" title="Chapter 1. About This Guide"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">The Bugzilla Guide - 4.4.11
Release</th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="about.html">Next</a></td></tr></table><hr></div><div class="book"><div class="titlepage"><div><div><h1 class="title"><a name="index"></a>The Bugzilla Guide - 4.4.11
Release</h1></div><div><div class="authorgroup"><h3 class="corpauthor">The Bugzilla Team</h3></div></div><div><p class="pubdate">2015-12-22</p></div><div><div class="abstract"><p class="title"><b>Abstract</b></p><p>
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.
</p><p>
The most current version of this document can always be found on the
<a class="ulink" href="http://www.bugzilla.org/docs/" target="_top">Bugzilla
Documentation Page</a>.
</p></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="chapter"><a href="about.html">1. About This Guide</a></span></dt><dd><dl><dt><span class="section"><a href="copyright.html">1.1. Copyright Information</a></span></dt><dt><span class="section"><a href="disclaimer.html">1.2. Disclaimer</a></span></dt><dt><span class="section"><a href="newversions.html">1.3. New Versions</a></span></dt><dt><span class="section"><a href="credits.html">1.4. Credits</a></span></dt><dt><span class="section"><a href="conventions.html">1.5. Document Conventions</a></span></dt></dl></dd><dt><span class="chapter"><a href="installing-bugzilla.html">2. Installing Bugzilla</a></span></dt><dd><dl><dt><span class="section"><a href="installation.html">2.1. Installation</a></span></dt><dd><dl><dt><span class="section"><a href="installation.html#install-perl">2.1.1. Perl</a></span></dt><dt><span class="section"><a href="installation.html#install-database">2.1.2. Database Engine</a></span></dt><dt><span class="section"><a href="installation.html#install-webserver">2.1.3. Web Server</a></span></dt><dt><span class="section"><a href="installation.html#install-bzfiles">2.1.4. Bugzilla</a></span></dt><dt><span class="section"><a href="installation.html#install-perlmodules">2.1.5. Perl Modules</a></span></dt><dt><span class="section"><a href="installation.html#install-MTA">2.1.6. Mail Transfer Agent (MTA)</a></span></dt><dt><span class="section"><a href="installation.html#using-mod_perl-with-bugzilla">2.1.7. Installing Bugzilla on mod_perl</a></span></dt></dl></dd><dt><span class="section"><a href="configuration.html">2.2. Configuration</a></span></dt><dd><dl><dt><span class="section"><a href="configuration.html#localconfig">2.2.1. localconfig</a></span></dt><dt><span class="section"><a href="configuration.html#database-engine">2.2.2. Database Server</a></span></dt><dt><span class="section"><a href="configuration.html#idm140035943225376">2.2.3. checksetup.pl</a></span></dt><dt><span class="section"><a href="configuration.html#http">2.2.4. Web server</a></span></dt><dt><span class="section"><a href="configuration.html#install-config-bugzilla">2.2.5. Bugzilla</a></span></dt></dl></dd><dt><span class="section"><a href="extraconfig.html">2.3. Optional Additional Configuration</a></span></dt><dd><dl><dt><span class="section"><a href="extraconfig.html#idm140035937919008">2.3.1. Bug Graphs</a></span></dt><dt><span class="section"><a href="extraconfig.html#installation-whining-cron">2.3.2. The Whining Cron</a></span></dt><dt><span class="section"><a href="extraconfig.html#installation-whining">2.3.3. Whining</a></span></dt><dt><span class="section"><a href="extraconfig.html#apache-addtype">2.3.4. Serving Alternate Formats with the right MIME type</a></span></dt></dl></dd><dt><span class="section"><a href="multiple-bz-dbs.html">2.4. Multiple Bugzilla databases with a single installation</a></span></dt><dt><span class="section"><a href="os-specific.html">2.5. OS-Specific Installation Notes</a></span></dt><dd><dl><dt><span class="section"><a href="os-specific.html#os-win32">2.5.1. Microsoft Windows</a></span></dt><dt><span class="section"><a href="os-specific.html#os-macosx">2.5.2. <span class="productname">Mac OS X</span>™</a></span></dt><dt><span class="section"><a href="os-specific.html#os-linux">2.5.3. Linux/BSD Distributions</a></span></dt></dl></dd><dt><span class="section"><a href="nonroot.html">2.6. UNIX (non-root) Installation Notes</a></span></dt><dd><dl><dt><span class="section"><a href="nonroot.html#idm140035937821408">2.6.1. Introduction</a></span></dt><dt><span class="section"><a href="nonroot.html#idm140035937819168">2.6.2. MySQL</a></span></dt><dt><span class="section"><a href="nonroot.html#idm140035937797488">2.6.3. Perl</a></span></dt><dt><span class="section"><a href="nonroot.html#install-perlmodules-nonroot">2.6.4. Perl Modules</a></span></dt><dt><span class="section"><a href="nonroot.html#idm140035937782656">2.6.5. HTTP Server</a></span></dt><dt><span class="section"><a href="nonroot.html#idm140035937775648">2.6.6. Bugzilla</a></span></dt></dl></dd><dt><span class="section"><a href="upgrade.html">2.7. Upgrading to New Releases</a></span></dt><dd><dl><dt><span class="section"><a href="upgrade.html#upgrade-before">2.7.1. Before You Upgrade</a></span></dt><dt><span class="section"><a href="upgrade.html#upgrade-files">2.7.2. Getting The New Bugzilla</a></span></dt><dt><span class="section"><a href="upgrade.html#upgrade-completion">2.7.3. Completing Your Upgrade</a></span></dt><dt><span class="section"><a href="upgrade.html#upgrade-notifications">2.7.4. Automatic Notifications of New Releases</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="administration.html">3. Administering Bugzilla</a></span></dt><dd><dl><dt><span class="section"><a href="parameters.html">3.1. Bugzilla Configuration</a></span></dt><dd><dl><dt><span class="section"><a href="parameters.html#param-requiredsettings">3.1.1. Required Settings</a></span></dt><dt><span class="section"><a href="parameters.html#param-admin-policies">3.1.2. Administrative Policies</a></span></dt><dt><span class="section"><a href="parameters.html#param-user-authentication">3.1.3. User Authentication</a></span></dt><dt><span class="section"><a href="parameters.html#param-attachments">3.1.4. Attachments</a></span></dt><dt><span class="section"><a href="parameters.html#param-bug-change-policies">3.1.5. Bug Change Policies</a></span></dt><dt><span class="section"><a href="parameters.html#param-bugfields">3.1.6. Bug Fields</a></span></dt><dt><span class="section"><a href="parameters.html#param-bugmoving">3.1.7. Bug Moving</a></span></dt><dt><span class="section"><a href="parameters.html#param-dependency-graphs">3.1.8. Dependency Graphs</a></span></dt><dt><span class="section"><a href="parameters.html#param-group-security">3.1.9. Group Security</a></span></dt><dt><span class="section"><a href="parameters.html#bzldap">3.1.10. LDAP Authentication</a></span></dt><dt><span class="section"><a href="parameters.html#bzradius">3.1.11. RADIUS Authentication</a></span></dt><dt><span class="section"><a href="parameters.html#param-email">3.1.12. Email</a></span></dt><dt><span class="section"><a href="parameters.html#param-patchviewer">3.1.13. Patch Viewer</a></span></dt><dt><span class="section"><a href="parameters.html#param-querydefaults">3.1.14. Query Defaults</a></span></dt><dt><span class="section"><a href="parameters.html#param-shadowdatabase">3.1.15. Shadow Database</a></span></dt><dt><span class="section"><a href="parameters.html#admin-usermatching">3.1.16. User Matching</a></span></dt></dl></dd><dt><span class="section"><a href="useradmin.html">3.2. User Administration</a></span></dt><dd><dl><dt><span class="section"><a href="useradmin.html#defaultuser">3.2.1. Creating the Default User</a></span></dt><dt><span class="section"><a href="useradmin.html#manageusers">3.2.2. Managing Other Users</a></span></dt></dl></dd><dt><span class="section"><a href="classifications.html">3.3. Classifications</a></span></dt><dt><span class="section"><a href="products.html">3.4. Products</a></span></dt><dd><dl><dt><span class="section"><a href="products.html#create-product">3.4.1. Creating New Products</a></span></dt><dt><span class="section"><a href="products.html#edit-products">3.4.2. Editing Products</a></span></dt><dt><span class="section"><a href="products.html#comps-vers-miles-products">3.4.3. Adding or Editing Components, Versions and Target Milestones</a></span></dt><dt><span class="section"><a href="products.html#product-group-controls">3.4.4. Assigning Group Controls to Products</a></span></dt></dl></dd><dt><span class="section"><a href="components.html">3.5. Components</a></span></dt><dt><span class="section"><a href="versions.html">3.6. Versions</a></span></dt><dt><span class="section"><a href="milestones.html">3.7. Milestones</a></span></dt><dt><span class="section"><a href="flags-overview.html">3.8. Flags</a></span></dt><dd><dl><dt><span class="section"><a href="flags-overview.html#flags-simpleexample">3.8.1. A Simple Example</a></span></dt><dt><span class="section"><a href="flags-overview.html#flags-about">3.8.2. About Flags</a></span></dt><dt><span class="section"><a href="flags-overview.html#flag-askto">3.8.3. Using flag requests</a></span></dt><dt><span class="section"><a href="flags-overview.html#flag-types">3.8.4. Two Types of Flags</a></span></dt><dt><span class="section"><a href="flags-overview.html#flags-admin">3.8.5. Administering Flags</a></span></dt></dl></dd><dt><span class="section"><a href="keywords.html">3.9. Keywords</a></span></dt><dt><span class="section"><a href="custom-fields.html">3.10. Custom Fields</a></span></dt><dd><dl><dt><span class="section"><a href="custom-fields.html#add-custom-fields">3.10.1. Adding Custom Fields</a></span></dt><dt><span class="section"><a href="custom-fields.html#edit-custom-fields">3.10.2. Editing Custom Fields</a></span></dt><dt><span class="section"><a href="custom-fields.html#delete-custom-fields">3.10.3. Deleting Custom Fields</a></span></dt></dl></dd><dt><span class="section"><a href="edit-values.html">3.11. Legal Values</a></span></dt><dd><dl><dt><span class="section"><a href="edit-values.html#edit-values-list">3.11.1. Viewing/Editing legal values</a></span></dt><dt><span class="section"><a href="edit-values.html#edit-values-delete">3.11.2. Deleting legal values</a></span></dt></dl></dd><dt><span class="section"><a href="bug_status_workflow.html">3.12. Bug Status Workflow</a></span></dt><dt><span class="section"><a href="voting.html">3.13. Voting</a></span></dt><dt><span class="section"><a href="quips.html">3.14. Quips</a></span></dt><dt><span class="section"><a href="groups.html">3.15. Groups and Group Security</a></span></dt><dd><dl><dt><span class="section"><a href="groups.html#create-groups">3.15.1. Creating Groups</a></span></dt><dt><span class="section"><a href="groups.html#edit-groups">3.15.2. Editing Groups and Assigning Group Permissions</a></span></dt><dt><span class="section"><a href="groups.html#users-and-groups">3.15.3. Assigning Users to Groups</a></span></dt><dt><span class="section"><a href="groups.html#idm140035936180208">3.15.4. Assigning Group Controls to Products</a></span></dt></dl></dd><dt><span class="section"><a href="sanitycheck.html">3.16. Checking and Maintaining Database Integrity</a></span></dt></dl></dd><dt><span class="chapter"><a href="security.html">4. Bugzilla Security</a></span></dt><dd><dl><dt><span class="section"><a href="security-os.html">4.1. Operating System</a></span></dt><dd><dl><dt><span class="section"><a href="security-os.html#security-os-ports">4.1.1. TCP/IP Ports</a></span></dt><dt><span class="section"><a href="security-os.html#security-os-accounts">4.1.2. System User Accounts</a></span></dt><dt><span class="section"><a href="security-os.html#security-os-chroot">4.1.3. The <code class="filename">chroot</code> Jail</a></span></dt></dl></dd><dt><span class="section"><a href="security-webserver.html">4.2. Web server</a></span></dt><dd><dl><dt><span class="section"><a href="security-webserver.html#security-webserver-access">4.2.1. Disabling Remote Access to Bugzilla Configuration Files</a></span></dt></dl></dd><dt><span class="section"><a href="security-bugzilla.html">4.3. Bugzilla</a></span></dt><dd><dl><dt><span class="section"><a href="security-bugzilla.html#security-bugzilla-charset">4.3.1. Prevent users injecting malicious Javascript</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="using.html">5. Using Bugzilla</a></span></dt><dd><dl><dt><span class="section"><a href="using-intro.html">5.1. Introduction</a></span></dt><dt><span class="section"><a href="myaccount.html">5.2. Create a Bugzilla Account</a></span></dt><dt><span class="section"><a href="bug_page.html">5.3. Anatomy of a Bug</a></span></dt><dt><span class="section"><a href="lifecycle.html">5.4. Life Cycle of a Bug</a></span></dt><dt><span class="section"><a href="query.html">5.5. Searching for Bugs</a></span></dt><dd><dl><dt><span class="section"><a href="query.html#boolean">5.5.1. Boolean Charts</a></span></dt><dt><span class="section"><a href="query.html#quicksearch">5.5.2. Quicksearch</a></span></dt><dt><span class="section"><a href="query.html#casesensitivity">5.5.3. Case Sensitivity in Searches</a></span></dt><dt><span class="section"><a href="query.html#list">5.5.4. Bug Lists</a></span></dt><dt><span class="section"><a href="query.html#individual-buglists">5.5.5. Adding/removing tags to/from bugs</a></span></dt></dl></dd><dt><span class="section"><a href="bugreports.html">5.6. Filing Bugs</a></span></dt><dd><dl><dt><span class="section"><a href="bugreports.html#fillingbugs">5.6.1. Reporting a New Bug</a></span></dt><dt><span class="section"><a href="bugreports.html#cloningbugs">5.6.2. Clone an Existing Bug</a></span></dt></dl></dd><dt><span class="section"><a href="attachments.html">5.7. Attachments</a></span></dt><dd><dl><dt><span class="section"><a href="attachments.html#patchviewer">5.7.1. Patch Viewer</a></span></dt></dl></dd><dt><span class="section"><a href="hintsandtips.html">5.8. Hints and Tips</a></span></dt><dd><dl><dt><span class="section"><a href="hintsandtips.html#idm140035935813584">5.8.1. Autolinkification</a></span></dt><dt><span class="section"><a href="hintsandtips.html#commenting">5.8.2. Comments</a></span></dt><dt><span class="section"><a href="hintsandtips.html#comment-wrapping">5.8.3. Server-Side Comment Wrapping</a></span></dt><dt><span class="section"><a href="hintsandtips.html#dependencytree">5.8.4. Dependency Tree</a></span></dt></dl></dd><dt><span class="section"><a href="timetracking.html">5.9. Time Tracking Information</a></span></dt><dt><span class="section"><a href="userpreferences.html">5.10. User Preferences</a></span></dt><dd><dl><dt><span class="section"><a href="userpreferences.html#generalpreferences">5.10.1. General Preferences</a></span></dt><dt><span class="section"><a href="userpreferences.html#emailpreferences">5.10.2. Email Preferences</a></span></dt><dt><span class="section"><a href="userpreferences.html#savedsearches">5.10.3. Saved Searches</a></span></dt><dt><span class="section"><a href="userpreferences.html#accountpreferences">5.10.4. Name and Password</a></span></dt><dt><span class="section"><a href="userpreferences.html#permissionsettings">5.10.5. Permissions</a></span></dt></dl></dd><dt><span class="section"><a href="reporting.html">5.11. Reports and Charts</a></span></dt><dd><dl><dt><span class="section"><a href="reporting.html#reports">5.11.1. Reports</a></span></dt><dt><span class="section"><a href="reporting.html#charts">5.11.2. Charts</a></span></dt></dl></dd><dt><span class="section"><a href="flags.html">5.12. Flags</a></span></dt><dt><span class="section"><a href="whining.html">5.13. Whining</a></span></dt><dd><dl><dt><span class="section"><a href="whining.html#whining-overview">5.13.1. The Event</a></span></dt><dt><span class="section"><a href="whining.html#whining-schedule">5.13.2. Whining Schedule</a></span></dt><dt><span class="section"><a href="whining.html#whining-query">5.13.3. Whining Searches</a></span></dt><dt><span class="section"><a href="whining.html#idm140035936064256">5.13.4. Saving Your Changes</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="customization.html">6. Customizing Bugzilla</a></span></dt><dd><dl><dt><span class="section"><a href="extensions.html">6.1. Bugzilla Extensions</a></span></dt><dt><span class="section"><a href="cust-skins.html">6.2. Custom Skins</a></span></dt><dt><span class="section"><a href="cust-templates.html">6.3. Template Customization</a></span></dt><dd><dl><dt><span class="section"><a href="cust-templates.html#template-directory">6.3.1. Template Directory Structure</a></span></dt><dt><span class="section"><a href="cust-templates.html#template-method">6.3.2. Choosing a Customization Method</a></span></dt><dt><span class="section"><a href="cust-templates.html#template-edit">6.3.3. How To Edit Templates</a></span></dt><dt><span class="section"><a href="cust-templates.html#template-formats">6.3.4. Template Formats and Types</a></span></dt><dt><span class="section"><a href="cust-templates.html#template-specific">6.3.5. Particular Templates</a></span></dt><dt><span class="section"><a href="cust-templates.html#template-http-accept">6.3.6. Configuring Bugzilla to Detect the User's Language</a></span></dt></dl></dd><dt><span class="section"><a href="cust-change-permissions.html">6.4. Customizing Who Can Change What</a></span></dt><dt><span class="section"><a href="integration.html">6.5. Integrating Bugzilla with Third-Party Tools</a></span></dt></dl></dd><dt><span class="appendix"><a href="troubleshooting.html">A. Troubleshooting</a></span></dt><dd><dl><dt><span class="section"><a href="general-advice.html">A.1. General Advice</a></span></dt><dt><span class="section"><a href="trbl-testserver.html">A.2. The Apache web server is not serving Bugzilla pages</a></span></dt><dt><span class="section"><a href="trbl-perlmodule.html">A.3. I installed a Perl module, but
<code class="filename">checksetup.pl</code> claims it's not installed!</a></span></dt><dt><span class="section"><a href="trbl-dbdSponge.html">A.4. DBD::Sponge::db prepare failed</a></span></dt><dt><span class="section"><a href="paranoid-security.html">A.5. cannot chdir(/var/spool/mqueue)</a></span></dt><dt><span class="section"><a href="trbl-relogin-everyone.html">A.6. Everybody is constantly being forced to relogin</a></span></dt><dt><span class="section"><a href="trbl-index.html">A.7. <code class="filename">index.cgi</code> doesn't show up unless specified in the URL</a></span></dt><dt><span class="section"><a href="trbl-passwd-encryption.html">A.8.
checksetup.pl reports "Client does not support authentication protocol
requested by server..."
</a></span></dt></dl></dd><dt><span class="appendix"><a href="patches.html">B. Contrib</a></span></dt><dd><dl><dt><span class="section"><a href="cmdline.html">B.1. Command-line Search Interface</a></span></dt><dt><span class="section"><a href="cmdline-bugmail.html">B.2. Command-line 'Send Unsent Bug-mail' tool</a></span></dt></dl></dd><dt><span class="appendix"><a href="install-perlmodules-manual.html">C. Manual Installation of Perl Modules</a></span></dt><dd><dl><dt><span class="section"><a href="modules-manual-instructions.html">C.1. Instructions</a></span></dt><dt><span class="section"><a href="modules-manual-download.html">C.2. Download Locations</a></span></dt><dt><span class="section"><a href="modules-manual-optional.html">C.3. Optional Modules</a></span></dt></dl></dd><dt><span class="appendix"><a href="gfdl.html">D. GNU Free Documentation License</a></span></dt><dd><dl><dt><span class="section"><a href="gfdl-0.html">D.0. Preamble</a></span></dt><dt><span class="section"><a href="gfdl-1.html">D.1. Applicability and Definition</a></span></dt><dt><span class="section"><a href="gfdl-2.html">D.2. Verbatim Copying</a></span></dt><dt><span class="section"><a href="gfdl-3.html">D.3. Copying in Quantity</a></span></dt><dt><span class="section"><a href="gfdl-4.html">D.4. Modifications</a></span></dt><dt><span class="section"><a href="gfdl-5.html">D.5. Combining Documents</a></span></dt><dt><span class="section"><a href="gfdl-6.html">D.6. Collections of Documents</a></span></dt><dt><span class="section"><a href="gfdl-7.html">D.7. Aggregation with Independent Works</a></span></dt><dt><span class="section"><a href="gfdl-8.html">D.8. Translation</a></span></dt><dt><span class="section"><a href="gfdl-9.html">D.9. Termination</a></span></dt><dt><span class="section"><a href="gfdl-10.html">D.10. Future Revisions of this License</a></span></dt><dt><span class="section"><a href="gfdl-howto.html">D.. How to use this License for your documents</a></span></dt></dl></dd><dt><span class="glossary"><a href="glossary.html">Glossary</a></span></dt></dl></div><div class="list-of-figures"><p><b>List of Figures</b></p><dl><dt>5.1. <a href="lifecycle.html#lifecycle-image">Lifecycle of a Bugzilla Bug</a></dt></dl></div><div class="list-of-examples"><p><b>List of Examples</b></p><dl><dt>A.1. <a href="trbl-relogin-everyone.html#trbl-relogin-everyone-share">Examples of urlbase/cookiepath pairs for sharing login cookies</a></dt><dt>A.2. <a href="trbl-relogin-everyone.html#trbl-relogin-everyone-restrict">Examples of urlbase/cookiepath pairs to restrict the login cookie</a></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="about.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"> </td><td width="40%" align="right" valign="top"> Chapter 1. About This Guide</td></tr></table></div></body></html>
