\select@language {english}
\contentsline {chapter}{\numberline {1}About This Documentation}{1}{chapter.1}
\contentsline {section}{\numberline {1.1}Evaluating Bugzilla}{1}{section.1.1}
\contentsline {section}{\numberline {1.2}Getting More Help}{1}{section.1.2}
\contentsline {section}{\numberline {1.3}Document Conventions}{1}{section.1.3}
\contentsline {section}{\numberline {1.4}License}{2}{section.1.4}
\contentsline {section}{\numberline {1.5}Credits}{2}{section.1.5}
\contentsline {chapter}{\numberline {2}User Guide}{3}{chapter.2}
\contentsline {section}{\numberline {2.1}Creating an Account}{3}{section.2.1}
\contentsline {section}{\numberline {2.2}Filing a Bug}{3}{section.2.2}
\contentsline {subsection}{\numberline {2.2.1}Reporting a New Bug}{3}{subsection.2.2.1}
\contentsline {subsection}{\numberline {2.2.2}Clone an Existing Bug}{4}{subsection.2.2.2}
\contentsline {section}{\numberline {2.3}Understanding a Bug}{4}{section.2.3}
\contentsline {subsection}{\numberline {2.3.1}Flags}{6}{subsection.2.3.1}
\contentsline {subsubsection}{A Simple Example}{6}{subsubsection*.3}
\contentsline {subsubsection}{About Flags}{7}{subsubsection*.4}
\contentsline {subsubsection}{Flag Requests}{7}{subsubsection*.5}
\contentsline {subsubsection}{Attachment Flags}{7}{subsubsection*.7}
\contentsline {subsubsection}{Bug Flags}{7}{subsubsection*.8}
\contentsline {section}{\numberline {2.4}Editing a Bug}{8}{section.2.4}
\contentsline {subsection}{\numberline {2.4.1}Attachments}{8}{subsection.2.4.1}
\contentsline {subsection}{\numberline {2.4.2}Flags}{8}{subsection.2.4.2}
\contentsline {subsection}{\numberline {2.4.3}Time Tracking}{8}{subsection.2.4.3}
\contentsline {subsection}{\numberline {2.4.4}Life Cycle of a Bug}{9}{subsection.2.4.4}
\contentsline {section}{\numberline {2.5}Finding Bugs}{9}{section.2.5}
\contentsline {subsection}{\numberline {2.5.1}Quicksearch}{10}{subsection.2.5.1}
\contentsline {subsection}{\numberline {2.5.2}Simple Search}{10}{subsection.2.5.2}
\contentsline {subsection}{\numberline {2.5.3}Advanced Search}{10}{subsection.2.5.3}
\contentsline {subsection}{\numberline {2.5.4}Custom Search}{10}{subsection.2.5.4}
\contentsline {subsubsection}{Advanced Features}{11}{subsubsection*.9}
\contentsline {subsubsection}{Negation}{11}{subsubsection*.10}
\contentsline {subsubsection}{Pronoun Substitution}{12}{subsubsection*.11}
\contentsline {subsection}{\numberline {2.5.5}Bug Lists}{12}{subsection.2.5.5}
\contentsline {section}{\numberline {2.6}Reports and Charts}{13}{section.2.6}
\contentsline {subsection}{\numberline {2.6.1}Reports}{13}{subsection.2.6.1}
\contentsline {subsection}{\numberline {2.6.2}Charts}{13}{subsection.2.6.2}
\contentsline {subsubsection}{Creating Charts}{13}{subsubsection*.12}
\contentsline {subsubsection}{Creating New Data Sets}{14}{subsubsection*.13}
\contentsline {section}{\numberline {2.7}Pro Tips}{14}{section.2.7}
\contentsline {subsection}{\numberline {2.7.1}Autolinkification}{14}{subsection.2.7.1}
\contentsline {subsection}{\numberline {2.7.2}Comments}{15}{subsection.2.7.2}
\contentsline {section}{\numberline {2.8}User Preferences}{15}{section.2.8}
\contentsline {subsection}{\numberline {2.8.1}General Preferences}{15}{subsection.2.8.1}
\contentsline {subsection}{\numberline {2.8.2}Email Preferences}{15}{subsection.2.8.2}
\contentsline {subsection}{\numberline {2.8.3}Saved Searches}{16}{subsection.2.8.3}
\contentsline {subsection}{\numberline {2.8.4}Account Information}{16}{subsection.2.8.4}
\contentsline {subsection}{\numberline {2.8.5}API Keys}{16}{subsection.2.8.5}
\contentsline {subsection}{\numberline {2.8.6}Permissions}{17}{subsection.2.8.6}
\contentsline {section}{\numberline {2.9}Installed Extensions}{17}{section.2.9}
\contentsline {chapter}{\numberline {3}Installation and Maintenance Guide}{19}{chapter.3}
\contentsline {section}{\numberline {3.1}Quick Start (Ubuntu Linux 14.04)}{19}{section.3.1}
\contentsline {subsection}{\numberline {3.1.1}Obtain Your Hardware}{19}{subsection.3.1.1}
\contentsline {subsection}{\numberline {3.1.2}Install the OS}{19}{subsection.3.1.2}
\contentsline {subsection}{\numberline {3.1.3}Become root}{20}{subsection.3.1.3}
\contentsline {subsection}{\numberline {3.1.4}Install Prerequisites}{20}{subsection.3.1.4}
\contentsline {subsection}{\numberline {3.1.5}Download Bugzilla}{20}{subsection.3.1.5}
\contentsline {subsection}{\numberline {3.1.6}Configure MySQL}{20}{subsection.3.1.6}
\contentsline {subsection}{\numberline {3.1.7}Configure Apache}{21}{subsection.3.1.7}
\contentsline {subsection}{\numberline {3.1.8}Check Setup}{21}{subsection.3.1.8}
\contentsline {subsection}{\numberline {3.1.9}Edit \sphinxstyleliteralintitle {localconfig}}{21}{subsection.3.1.9}
\contentsline {subsection}{\numberline {3.1.10}Check Setup (again)}{22}{subsection.3.1.10}
\contentsline {subsection}{\numberline {3.1.11}Test Server}{22}{subsection.3.1.11}
\contentsline {subsection}{\numberline {3.1.12}Access Via Web Browser}{22}{subsection.3.1.12}
\contentsline {subsection}{\numberline {3.1.13}Configure Bugzilla}{22}{subsection.3.1.13}
\contentsline {section}{\numberline {3.2}Linux}{23}{section.3.2}
\contentsline {subsection}{\numberline {3.2.1}Install Packages}{23}{subsection.3.2.1}
\contentsline {subsubsection}{Fedora and Red Hat}{23}{subsubsection*.14}
\contentsline {subsubsection}{Ubuntu and Debian}{24}{subsubsection*.15}
\contentsline {subsubsection}{Gentoo}{24}{subsubsection*.16}
\contentsline {subsection}{\numberline {3.2.2}Perl}{24}{subsection.3.2.2}
\contentsline {subsection}{\numberline {3.2.3}Bugzilla}{24}{subsection.3.2.3}
\contentsline {subsection}{\numberline {3.2.4}Perl Modules}{25}{subsection.3.2.4}
\contentsline {subsection}{\numberline {3.2.5}Web Server}{25}{subsection.3.2.5}
\contentsline {subsection}{\numberline {3.2.6}Database Engine}{25}{subsection.3.2.6}
\contentsline {subsection}{\numberline {3.2.7}localconfig}{25}{subsection.3.2.7}
\contentsline {subsection}{\numberline {3.2.8}checksetup.pl}{26}{subsection.3.2.8}
\contentsline {subsection}{\numberline {3.2.9}Success}{26}{subsection.3.2.9}
\contentsline {section}{\numberline {3.3}Windows}{27}{section.3.3}
\contentsline {subsection}{\numberline {3.3.1}Perl}{27}{subsection.3.3.1}
\contentsline {subsection}{\numberline {3.3.2}Bugzilla}{27}{subsection.3.3.2}
\contentsline {subsection}{\numberline {3.3.3}Perl Modules}{27}{subsection.3.3.3}
\contentsline {subsection}{\numberline {3.3.4}Web Server}{29}{subsection.3.3.4}
\contentsline {subsection}{\numberline {3.3.5}Database Engine}{29}{subsection.3.3.5}
\contentsline {subsection}{\numberline {3.3.6}localconfig}{29}{subsection.3.3.6}
\contentsline {subsection}{\numberline {3.3.7}checksetup.pl}{30}{subsection.3.3.7}
\contentsline {subsection}{\numberline {3.3.8}Success}{30}{subsection.3.3.8}
\contentsline {section}{\numberline {3.4}Mac OS X}{31}{section.3.4}
\contentsline {subsection}{\numberline {3.4.1}Install Packages}{31}{subsection.3.4.1}
\contentsline {subsection}{\numberline {3.4.2}Bugzilla}{31}{subsection.3.4.2}
\contentsline {subsection}{\numberline {3.4.3}Additional System Libraries}{31}{subsection.3.4.3}
\contentsline {subsection}{\numberline {3.4.4}Perl Modules}{31}{subsection.3.4.4}
\contentsline {subsection}{\numberline {3.4.5}Web Server}{32}{subsection.3.4.5}
\contentsline {subsection}{\numberline {3.4.6}Database Engine}{32}{subsection.3.4.6}
\contentsline {subsection}{\numberline {3.4.7}localconfig}{32}{subsection.3.4.7}
\contentsline {subsection}{\numberline {3.4.8}checksetup.pl}{33}{subsection.3.4.8}
\contentsline {subsection}{\numberline {3.4.9}Success}{33}{subsection.3.4.9}
\contentsline {section}{\numberline {3.5}Essential Post-Installation Configuration}{33}{section.3.5}
\contentsline {subsection}{\numberline {3.5.1}Parameters}{33}{subsection.3.5.1}
\contentsline {subsection}{\numberline {3.5.2}Email}{34}{subsection.3.5.2}
\contentsline {subsubsection}{Use Another Mail Server}{34}{subsubsection*.18}
\contentsline {paragraph}{Gmail}{34}{paragraph*.19}
\contentsline {subsubsection}{Run Your Own Mail Server}{35}{subsubsection*.20}
\contentsline {subsubsection}{Troubleshooting}{35}{subsubsection*.21}
\contentsline {subsection}{\numberline {3.5.3}Products, Components, Versions and Milestones}{35}{subsection.3.5.3}
\contentsline {section}{\numberline {3.6}Optional Post-Install Configuration}{36}{section.3.6}
\contentsline {subsection}{\numberline {3.6.1}Recurring Tasks}{36}{subsection.3.6.1}
\contentsline {subsubsection}{Linux}{36}{subsubsection*.22}
\contentsline {subsubsection}{Windows}{36}{subsubsection*.23}
\contentsline {subsection}{\numberline {3.6.2}Bug Graphs}{36}{subsection.3.6.2}
\contentsline {subsection}{\numberline {3.6.3}Whining}{37}{subsection.3.6.3}
\contentsline {subsection}{\numberline {3.6.4}Whining at Untriaged Bugs}{37}{subsection.3.6.4}
\contentsline {subsection}{\numberline {3.6.5}Dependency Graphs}{37}{subsection.3.6.5}
\contentsline {subsubsection}{Linux}{37}{subsubsection*.24}
\contentsline {subsubsection}{Windows}{37}{subsubsection*.25}
\contentsline {subsection}{\numberline {3.6.6}Documentation}{37}{subsection.3.6.6}
\contentsline {section}{\numberline {3.7}Migrating From Other Bug-Tracking Systems}{38}{section.3.7}
\contentsline {section}{\numberline {3.8}Moving Bugzilla Between Machines}{38}{section.3.8}
\contentsline {section}{\numberline {3.9}Upgrading}{39}{section.3.9}
\contentsline {subsection}{\numberline {3.9.1}Upgrading with Git}{40}{subsection.3.9.1}
\contentsline {subsubsection}{Before You Upgrade}{40}{subsubsection*.26}
\contentsline {paragraph}{Customized Bugzilla?}{40}{paragraph*.27}
\contentsline {subsubsection}{Starting the Upgrade}{40}{subsubsection*.28}
\contentsline {subsubsection}{Getting The New Bugzilla}{41}{subsubsection*.29}
\contentsline {subsubsection}{Upgrading the Database}{41}{subsubsection*.30}
\contentsline {subsubsection}{Finishing The Upgrade}{41}{subsubsection*.31}
\contentsline {subsection}{\numberline {3.9.2}Migrating from Bazaar}{42}{subsection.3.9.2}
\contentsline {subsubsection}{Download Code from Git}{42}{subsubsection*.32}
\contentsline {subsubsection}{Save Any Local Customizations}{42}{subsubsection*.33}
\contentsline {subsubsection}{Shut Down Bugzilla}{43}{subsubsection*.34}
\contentsline {subsubsection}{Copy Across Data and Modules}{43}{subsubsection*.35}
\contentsline {subsubsection}{Reapply Local Customizations}{43}{subsubsection*.36}
\contentsline {subsubsection}{Swap The New Version In}{43}{subsubsection*.37}
\contentsline {subsubsection}{Re-enable Bugzilla}{44}{subsubsection*.38}
\contentsline {subsubsection}{Test Bugzilla}{44}{subsubsection*.39}
\contentsline {subsubsection}{Rolling Back}{44}{subsubsection*.40}
\contentsline {subsection}{\numberline {3.9.3}Migrating from CVS}{44}{subsection.3.9.3}
\contentsline {subsubsection}{Download Code from Git}{44}{subsubsection*.41}
\contentsline {subsubsection}{Save Any Local Customizations}{45}{subsubsection*.42}
\contentsline {subsubsection}{Shut Down Bugzilla}{45}{subsubsection*.43}
\contentsline {subsubsection}{Copy Across Data and Modules}{45}{subsubsection*.44}
\contentsline {subsubsection}{Reapply Local Customizations}{45}{subsubsection*.45}
\contentsline {subsubsection}{Swap The New Version In}{46}{subsubsection*.46}
\contentsline {subsubsection}{Re-enable Bugzilla}{46}{subsubsection*.47}
\contentsline {subsubsection}{Test Bugzilla}{46}{subsubsection*.48}
\contentsline {subsubsection}{Rolling Back}{46}{subsubsection*.49}
\contentsline {subsection}{\numberline {3.9.4}Migrating from a Tarball}{46}{subsection.3.9.4}
\contentsline {subsubsection}{Download Code from Git}{46}{subsubsection*.50}
\contentsline {subsubsection}{Save Any Local Customizations}{47}{subsubsection*.51}
\contentsline {subsubsection}{Shut Down Bugzilla}{47}{subsubsection*.52}
\contentsline {subsubsection}{Copy Across Data and Modules}{47}{subsubsection*.53}
\contentsline {subsubsection}{Reapply Local Customizations}{47}{subsubsection*.54}
\contentsline {subsubsection}{Swap The New Version In}{48}{subsubsection*.55}
\contentsline {subsubsection}{Re-enable Bugzilla}{48}{subsubsection*.56}
\contentsline {subsubsection}{Test Bugzilla}{48}{subsubsection*.57}
\contentsline {subsubsection}{Rolling Back}{48}{subsubsection*.58}
\contentsline {subsection}{\numberline {3.9.5}Upgrading with a Tarball}{48}{subsection.3.9.5}
\contentsline {subsubsection}{Before You Upgrade}{49}{subsubsection*.59}
\contentsline {paragraph}{Customized Bugzilla?}{49}{paragraph*.60}
\contentsline {subsubsection}{Getting The New Bugzilla}{49}{subsubsection*.61}
\contentsline {subsubsection}{Copy Across Data and Modules}{49}{subsubsection*.62}
\contentsline {subsubsection}{Swap The New Version In}{50}{subsubsection*.63}
\contentsline {subsubsection}{Upgrading the Database}{50}{subsubsection*.64}
\contentsline {subsubsection}{Finishing The Upgrade}{50}{subsubsection*.65}
\contentsline {subsection}{\numberline {3.9.6}Upgrading a Customized or Extended Bugzilla}{50}{subsection.3.9.6}
\contentsline {section}{\numberline {3.10}Backups}{51}{section.3.10}
\contentsline {subsection}{\numberline {3.10.1}Database}{51}{subsection.3.10.1}
\contentsline {subsubsection}{MySQL}{51}{subsubsection*.66}
\contentsline {subsubsection}{PostgreSQL}{51}{subsubsection*.67}
\contentsline {subsection}{\numberline {3.10.2}Bugzilla}{51}{subsection.3.10.2}
\contentsline {section}{\numberline {3.11}Sanity Check}{52}{section.3.11}
\contentsline {section}{\numberline {3.12}Merging Accounts}{52}{section.3.12}
\contentsline {section}{\numberline {3.13}One Installation, Multiple Instances}{52}{section.3.13}
\contentsline {chapter}{\numberline {4}Administration Guide}{55}{chapter.4}
\contentsline {section}{\numberline {4.1}Parameters}{55}{section.4.1}
\contentsline {subsection}{\numberline {4.1.1}Required Settings}{55}{subsection.4.1.1}
\contentsline {subsection}{\numberline {4.1.2}General}{55}{subsection.4.1.2}
\contentsline {subsection}{\numberline {4.1.3}Administrative Policies}{56}{subsection.4.1.3}
\contentsline {subsection}{\numberline {4.1.4}User Authentication}{56}{subsection.4.1.4}
\contentsline {subsection}{\numberline {4.1.5}Attachments}{58}{subsection.4.1.5}
\contentsline {subsection}{\numberline {4.1.6}Bug Change Policies}{58}{subsection.4.1.6}
\contentsline {subsection}{\numberline {4.1.7}Bug Fields}{59}{subsection.4.1.7}
\contentsline {subsection}{\numberline {4.1.8}Graphs}{60}{subsection.4.1.8}
\contentsline {subsection}{\numberline {4.1.9}Group Security}{60}{subsection.4.1.9}
\contentsline {subsection}{\numberline {4.1.10}LDAP}{61}{subsection.4.1.10}
\contentsline {subsection}{\numberline {4.1.11}RADIUS}{62}{subsection.4.1.11}
\contentsline {subsection}{\numberline {4.1.12}Email}{62}{subsection.4.1.12}
\contentsline {subsection}{\numberline {4.1.13}Query Defaults}{63}{subsection.4.1.13}
\contentsline {subsection}{\numberline {4.1.14}Shadow Database}{63}{subsection.4.1.14}
\contentsline {subsection}{\numberline {4.1.15}Memcached}{64}{subsection.4.1.15}
\contentsline {subsection}{\numberline {4.1.16}User Matching}{64}{subsection.4.1.16}
\contentsline {subsection}{\numberline {4.1.17}Advanced}{64}{subsection.4.1.17}
\contentsline {section}{\numberline {4.2}Default Preferences}{65}{section.4.2}
\contentsline {section}{\numberline {4.3}Users}{65}{section.4.3}
\contentsline {subsection}{\numberline {4.3.1}Creating Admin Users}{65}{subsection.4.3.1}
\contentsline {subsection}{\numberline {4.3.2}Searching For Users}{65}{subsection.4.3.2}
\contentsline {subsection}{\numberline {4.3.3}Modifying Users}{66}{subsection.4.3.3}
\contentsline {subsection}{\numberline {4.3.4}Creating New Users}{67}{subsection.4.3.4}
\contentsline {subsubsection}{Self-Registration}{67}{subsubsection*.68}
\contentsline {subsubsection}{Administrator Registration}{67}{subsubsection*.69}
\contentsline {subsection}{\numberline {4.3.5}Deleting Users}{67}{subsection.4.3.5}
\contentsline {subsection}{\numberline {4.3.6}Impersonating Users}{67}{subsection.4.3.6}
\contentsline {section}{\numberline {4.4}Classifications, Products, Components, Versions, and Milestones}{68}{section.4.4}
\contentsline {subsection}{\numberline {4.4.1}Classifications}{68}{subsection.4.4.1}
\contentsline {subsection}{\numberline {4.4.2}Products}{68}{subsection.4.4.2}
\contentsline {subsubsection}{Creating New Products}{69}{subsubsection*.70}
\contentsline {subsubsection}{Editing Products}{69}{subsubsection*.71}
\contentsline {subsubsection}{Adding or Editing Components, Versions and Target Milestones}{69}{subsubsection*.72}
\contentsline {subsubsection}{Assigning Group Controls to Products}{69}{subsubsection*.73}
\contentsline {subsubsection}{Common Applications of Group Controls}{70}{subsubsection*.74}
\contentsline {paragraph}{Basic Product/Group Restriction}{70}{paragraph*.75}
\contentsline {paragraph}{General User Access With Security Group}{71}{paragraph*.76}
\contentsline {paragraph}{General User Access With A Security Product}{71}{paragraph*.77}
\contentsline {paragraph}{Product Isolation With a Common Group}{71}{paragraph*.78}
\contentsline {paragraph}{Make a Product Read Only}{71}{paragraph*.79}
\contentsline {subsection}{\numberline {4.4.3}Components}{72}{subsection.4.4.3}
\contentsline {subsection}{\numberline {4.4.4}Versions}{72}{subsection.4.4.4}
\contentsline {subsection}{\numberline {4.4.5}Milestones}{72}{subsection.4.4.5}
\contentsline {section}{\numberline {4.5}Flags}{73}{section.4.5}
\contentsline {subsection}{\numberline {4.5.1}Flag Properties}{73}{subsection.4.5.1}
\contentsline {subsection}{\numberline {4.5.2}Deleting a Flag}{74}{subsection.4.5.2}
\contentsline {section}{\numberline {4.6}Custom Fields}{75}{section.4.6}
\contentsline {subsection}{\numberline {4.6.1}Adding Custom Fields}{75}{subsection.4.6.1}
\contentsline {subsection}{\numberline {4.6.2}Editing Custom Fields}{76}{subsection.4.6.2}
\contentsline {subsection}{\numberline {4.6.3}Deleting Custom Fields}{76}{subsection.4.6.3}
\contentsline {section}{\numberline {4.7}Field Values}{76}{section.4.7}
\contentsline {subsection}{\numberline {4.7.1}Viewing/Editing Legal Values}{76}{subsection.4.7.1}
\contentsline {subsection}{\numberline {4.7.2}Deleting Legal Values}{77}{subsection.4.7.2}
\contentsline {section}{\numberline {4.8}Workflow}{77}{section.4.8}
\contentsline {section}{\numberline {4.9}Groups and Security}{77}{section.4.9}
\contentsline {subsection}{\numberline {4.9.1}Creating Groups}{78}{subsection.4.9.1}
\contentsline {subsection}{\numberline {4.9.2}Editing Groups and Assigning Group Permissions}{79}{subsection.4.9.2}
\contentsline {subsection}{\numberline {4.9.3}Assigning Users to Groups}{79}{subsection.4.9.3}
\contentsline {subsection}{\numberline {4.9.4}Assigning Group Controls to Products}{80}{subsection.4.9.4}
\contentsline {section}{\numberline {4.10}Keywords}{80}{section.4.10}
\contentsline {section}{\numberline {4.11}Whining}{80}{section.4.11}
\contentsline {subsection}{\numberline {4.11.1}The Event}{81}{subsection.4.11.1}
\contentsline {subsection}{\numberline {4.11.2}Whining Schedule}{81}{subsection.4.11.2}
\contentsline {subsection}{\numberline {4.11.3}Whining Searches}{81}{subsection.4.11.3}
\contentsline {subsection}{\numberline {4.11.4}Saving Your Changes}{82}{subsection.4.11.4}
\contentsline {section}{\numberline {4.12}Quips}{82}{section.4.12}
\contentsline {section}{\numberline {4.13}Installed Extensions}{83}{section.4.13}
\contentsline {chapter}{\numberline {5}Integration and Customization Guide}{85}{chapter.5}
\contentsline {section}{\numberline {5.1}Customization FAQ}{85}{section.5.1}
\contentsline {section}{\numberline {5.2}Languages}{85}{section.5.2}
\contentsline {section}{\numberline {5.3}Skins}{86}{section.5.3}
\contentsline {section}{\numberline {5.4}Templates}{86}{section.5.4}
\contentsline {subsection}{\numberline {5.4.1}Template Directory Structure}{86}{subsection.5.4.1}
\contentsline {subsection}{\numberline {5.4.2}Choosing a Customization Method}{86}{subsection.5.4.2}
\contentsline {subsection}{\numberline {5.4.3}How To Edit Templates}{87}{subsection.5.4.3}
\contentsline {subsection}{\numberline {5.4.4}Template Formats and Types}{87}{subsection.5.4.4}
\contentsline {subsection}{\numberline {5.4.5}Particular Templates}{88}{subsection.5.4.5}
\contentsline {section}{\numberline {5.5}Extensions}{89}{section.5.5}
\contentsline {subsection}{\numberline {5.5.1}Adding A New Page to Bugzilla}{90}{subsection.5.5.1}
\contentsline {subsection}{\numberline {5.5.2}Altering Data On An Existing Page}{90}{subsection.5.5.2}
\contentsline {subsection}{\numberline {5.5.3}Adding New Fields To Bugs}{90}{subsection.5.5.3}
\contentsline {subsection}{\numberline {5.5.4}Adding New Fields To Other Things}{91}{subsection.5.5.4}
\contentsline {subsection}{\numberline {5.5.5}Adding Admin Configuration Panels}{91}{subsection.5.5.5}
\contentsline {subsection}{\numberline {5.5.6}Adding User Preferences}{91}{subsection.5.5.6}
\contentsline {subsection}{\numberline {5.5.7}Altering Who Can Change What}{92}{subsection.5.5.7}
\contentsline {subsection}{\numberline {5.5.8}Checking Syntax}{92}{subsection.5.5.8}
\contentsline {section}{\numberline {5.6}APIs}{92}{section.5.6}
\contentsline {subsection}{\numberline {5.6.1}Ad-Hoc APIs}{92}{subsection.5.6.1}
\contentsline {subsection}{\numberline {5.6.2}XML-RPC}{93}{subsection.5.6.2}
\contentsline {subsection}{\numberline {5.6.3}JSON-RPC}{93}{subsection.5.6.3}
\contentsline {subsection}{\numberline {5.6.4}REST}{93}{subsection.5.6.4}
\contentsline {subsection}{\numberline {5.6.5}BzAPI/BzAPI-Compatible REST}{93}{subsection.5.6.5}
\contentsline {subsection}{\numberline {5.6.6}REST v2}{93}{subsection.5.6.6}
\contentsline {chapter}{\numberline {6}WebService API Reference}{95}{chapter.6}
\contentsline {section}{\numberline {6.1}Core API v1}{95}{section.6.1}
\contentsline {subsection}{\numberline {6.1.1}General}{95}{subsection.6.1.1}
\contentsline {subsubsection}{Basic Information}{95}{subsubsection*.81}
\contentsline {subsubsection}{Common Data Types}{96}{subsubsection*.82}
\contentsline {subsubsection}{Authentication}{96}{subsubsection*.83}
\contentsline {subsubsection}{Useful Parameters}{97}{subsubsection*.84}
\contentsline {subsection}{\numberline {6.1.2}Attachments}{98}{subsection.6.1.2}
\contentsline {subsubsection}{Get Attachment}{99}{subsubsection*.85}
\contentsline {subsubsection}{Create Attachment}{100}{subsubsection*.86}
\contentsline {subsubsection}{Update Attachment}{102}{subsubsection*.87}
\contentsline {subsection}{\numberline {6.1.3}Bugs}{104}{subsection.6.1.3}
\contentsline {subsubsection}{Get Bug}{104}{subsubsection*.88}
\contentsline {subsubsection}{Bug History}{108}{subsubsection*.89}
\contentsline {subsubsection}{Search Bugs}{110}{subsubsection*.90}
\contentsline {subsubsection}{Create Bug}{112}{subsubsection*.91}
\contentsline {subsubsection}{Update Bug}{114}{subsubsection*.92}
\contentsline {subsection}{\numberline {6.1.4}Bug User Last Visited}{122}{subsection.6.1.4}
\contentsline {subsubsection}{Update Last Visited}{122}{subsubsection*.93}
\contentsline {subsubsection}{Get Last Visited}{123}{subsubsection*.94}
\contentsline {subsection}{\numberline {6.1.5}Bugzilla Information}{124}{subsection.6.1.5}
\contentsline {subsubsection}{Version}{124}{subsubsection*.95}
\contentsline {subsubsection}{Extensions}{124}{subsubsection*.96}
\contentsline {subsubsection}{Timezone}{125}{subsubsection*.97}
\contentsline {subsubsection}{Time}{125}{subsubsection*.98}
\contentsline {subsubsection}{Parameters}{126}{subsubsection*.99}
\contentsline {subsubsection}{Last Audit Time}{128}{subsubsection*.100}
\contentsline {subsection}{\numberline {6.1.6}Classifications}{128}{subsection.6.1.6}
\contentsline {subsubsection}{Get Classification}{129}{subsubsection*.101}
\contentsline {subsection}{\numberline {6.1.7}Comments}{130}{subsection.6.1.7}
\contentsline {subsubsection}{Get Comments}{130}{subsubsection*.102}
\contentsline {subsubsection}{Create Comments}{131}{subsubsection*.103}
\contentsline {subsubsection}{Search Comment Tags}{132}{subsubsection*.104}
\contentsline {subsubsection}{Update Comment Tags}{132}{subsubsection*.105}
\contentsline {subsection}{\numberline {6.1.8}Components}{133}{subsection.6.1.8}
\contentsline {subsubsection}{Create Component}{133}{subsubsection*.106}
\contentsline {subsection}{\numberline {6.1.9}Bug Fields}{134}{subsection.6.1.9}
\contentsline {subsubsection}{Fields}{134}{subsubsection*.107}
\contentsline {subsubsection}{Legal Values}{137}{subsubsection*.108}
\contentsline {subsection}{\numberline {6.1.10}Flag Types}{138}{subsection.6.1.10}
\contentsline {subsubsection}{Get Flag Type}{138}{subsubsection*.109}
\contentsline {subsubsection}{Create Flag Type}{140}{subsubsection*.110}
\contentsline {subsubsection}{Update Flag Type}{142}{subsubsection*.111}
\contentsline {subsection}{\numberline {6.1.11}Groups}{144}{subsection.6.1.11}
\contentsline {subsubsection}{Create Group}{144}{subsubsection*.112}
\contentsline {subsubsection}{Update Group}{144}{subsubsection*.113}
\contentsline {subsubsection}{Get Group}{146}{subsubsection*.114}
\contentsline {subsection}{\numberline {6.1.12}Products}{148}{subsection.6.1.12}
\contentsline {subsubsection}{List Products}{148}{subsubsection*.115}
\contentsline {subsubsection}{Get Product}{148}{subsubsection*.116}
\contentsline {subsubsection}{Create Product}{151}{subsubsection*.117}
\contentsline {subsubsection}{Update Product}{152}{subsubsection*.118}
\contentsline {subsection}{\numberline {6.1.13}Users}{154}{subsection.6.1.13}
\contentsline {subsubsection}{Login}{154}{subsubsection*.119}
\contentsline {subsubsection}{Logout}{154}{subsubsection*.120}
\contentsline {subsubsection}{Valid Login}{154}{subsubsection*.121}
\contentsline {subsubsection}{Create User}{155}{subsubsection*.122}
\contentsline {subsubsection}{Update User}{155}{subsubsection*.123}
\contentsline {subsubsection}{Get User}{157}{subsubsection*.124}
\contentsline {chapter}{\numberline {7}MySQL}{161}{chapter.7}
\contentsline {section}{\numberline {7.1}Installing}{161}{section.7.1}
\contentsline {subsection}{\numberline {7.1.1}Windows}{161}{subsection.7.1.1}
\contentsline {subsection}{\numberline {7.1.2}Linux/Mac OS X}{161}{subsection.7.1.2}
\contentsline {section}{\numberline {7.2}Add a User}{161}{section.7.2}
\contentsline {section}{\numberline {7.3}Change Configuration}{162}{section.7.3}
\contentsline {subsection}{\numberline {7.3.1}Allow Large Attachments and Many Comments}{162}{subsection.7.3.1}
\contentsline {subsection}{\numberline {7.3.2}Allow Small Words in Full-Text Indexes}{162}{subsection.7.3.2}
\contentsline {section}{\numberline {7.4}Permit Attachments Table to Grow Beyond 4GB}{162}{section.7.4}
\contentsline {chapter}{\numberline {8}PostgreSQL}{165}{chapter.8}
\contentsline {section}{\numberline {8.1}Add a User}{165}{section.8.1}
\contentsline {section}{\numberline {8.2}Permit Access}{165}{section.8.2}
\contentsline {chapter}{\numberline {9}Oracle}{167}{chapter.9}
\contentsline {section}{\numberline {9.1}Create a New Tablespace}{167}{section.9.1}
\contentsline {section}{\numberline {9.2}Add a User to Oracle}{167}{section.9.2}
\contentsline {section}{\numberline {9.3}Configure the Web Server}{168}{section.9.3}
\contentsline {chapter}{\numberline {10}SQLite}{169}{chapter.10}
\contentsline {chapter}{\numberline {11}Apache}{171}{chapter.11}
\contentsline {section}{\numberline {11.1}Securing Apache}{171}{section.11.1}
\contentsline {section}{\numberline {11.2}Apache with mod\_cgi}{171}{section.11.2}
\contentsline {section}{\numberline {11.3}Apache with mod\_perl}{172}{section.11.3}
\contentsline {chapter}{\numberline {12}Apache}{175}{chapter.12}
\contentsline {section}{\numberline {12.1}Installing}{175}{section.12.1}
\contentsline {section}{\numberline {12.2}Apache Account Permissions}{176}{section.12.2}
\contentsline {section}{\numberline {12.3}Logging}{176}{section.12.3}
\contentsline {section}{\numberline {12.4}Using Apache with SSL}{176}{section.12.4}
\contentsline {section}{\numberline {12.5}Restart Apache}{177}{section.12.5}
\contentsline {chapter}{\numberline {13}Microsoft IIS}{179}{chapter.13}
\contentsline {section}{\numberline {13.1}Create a New Application}{179}{section.13.1}
\contentsline {section}{\numberline {13.2}Configure the Default Document}{179}{section.13.2}
\contentsline {section}{\numberline {13.3}Add Handler Mappings}{179}{section.13.3}
\contentsline {section}{\numberline {13.4}Bugzilla Application}{180}{section.13.4}
\contentsline {section}{\numberline {13.5}Enable Rewrite Rules for REST}{180}{section.13.5}
\contentsline {section}{\numberline {13.6}Common Problems}{181}{section.13.6}
