\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}Web Server}{33}{section.3.5}
\contentsline {subsection}{\numberline {3.5.1}Apache}{33}{subsection.3.5.1}
\contentsline {subsubsection}{Securing Apache}{34}{subsubsection*.18}
\contentsline {subsubsection}{Apache with mod\_cgi}{34}{subsubsection*.19}
\contentsline {subsubsection}{Apache with mod\_perl}{34}{subsubsection*.20}
\contentsline {subsection}{\numberline {3.5.2}Apache on Windows}{35}{subsection.3.5.2}
\contentsline {subsubsection}{Installing}{35}{subsubsection*.21}
\contentsline {subsubsection}{Apache Account Permissions}{36}{subsubsection*.22}
\contentsline {subsubsection}{Logging}{36}{subsubsection*.23}
\contentsline {subsubsection}{Using Apache with SSL}{37}{subsubsection*.24}
\contentsline {subsubsection}{Restart Apache}{37}{subsubsection*.25}
\contentsline {subsection}{\numberline {3.5.3}Microsoft IIS}{37}{subsection.3.5.3}
\contentsline {subsubsection}{Create a New Application}{38}{subsubsection*.26}
\contentsline {subsubsection}{Configure the Default Document}{38}{subsubsection*.27}
\contentsline {subsubsection}{Add Handler Mappings}{38}{subsubsection*.28}
\contentsline {subsubsection}{Bugzilla Application}{38}{subsubsection*.29}
\contentsline {subsubsection}{Enable Rewrite Rules for REST}{39}{subsubsection*.30}
\contentsline {subsubsection}{Common Problems}{39}{subsubsection*.31}
\contentsline {section}{\numberline {3.6}Database Server}{39}{section.3.6}
\contentsline {subsection}{\numberline {3.6.1}MySQL}{40}{subsection.3.6.1}
\contentsline {subsubsection}{Installing}{40}{subsubsection*.32}
\contentsline {paragraph}{Windows}{40}{paragraph*.33}
\contentsline {paragraph}{Linux/Mac OS X}{40}{paragraph*.34}
\contentsline {subsubsection}{Add a User}{40}{subsubsection*.35}
\contentsline {subsubsection}{Change Configuration}{40}{subsubsection*.36}
\contentsline {paragraph}{Allow Large Attachments and Many Comments}{41}{paragraph*.37}
\contentsline {paragraph}{Allow Small Words in Full-Text Indexes}{41}{paragraph*.38}
\contentsline {subsubsection}{Permit Attachments Table to Grow Beyond 4GB}{41}{subsubsection*.39}
\contentsline {subsection}{\numberline {3.6.2}PostgreSQL}{42}{subsection.3.6.2}
\contentsline {subsubsection}{Add a User}{42}{subsubsection*.40}
\contentsline {subsubsection}{Permit Access}{42}{subsubsection*.41}
\contentsline {subsection}{\numberline {3.6.3}Oracle}{42}{subsection.3.6.3}
\contentsline {subsubsection}{Create a New Tablespace}{43}{subsubsection*.42}
\contentsline {subsubsection}{Add a User to Oracle}{43}{subsubsection*.43}
\contentsline {subsubsection}{Configure the Web Server}{43}{subsubsection*.44}
\contentsline {subsection}{\numberline {3.6.4}SQLite}{43}{subsection.3.6.4}
\contentsline {section}{\numberline {3.7}Essential Post-Installation Configuration}{44}{section.3.7}
\contentsline {subsection}{\numberline {3.7.1}Parameters}{44}{subsection.3.7.1}
\contentsline {subsection}{\numberline {3.7.2}Email}{44}{subsection.3.7.2}
\contentsline {subsubsection}{Use Another Mail Server}{44}{subsubsection*.45}
\contentsline {paragraph}{Gmail}{45}{paragraph*.46}
\contentsline {subsubsection}{Run Your Own Mail Server}{45}{subsubsection*.47}
\contentsline {subsubsection}{Troubleshooting}{46}{subsubsection*.48}
\contentsline {subsection}{\numberline {3.7.3}Products, Components, Versions and Milestones}{46}{subsection.3.7.3}
\contentsline {section}{\numberline {3.8}Optional Post-Install Configuration}{46}{section.3.8}
\contentsline {subsection}{\numberline {3.8.1}Recurring Tasks}{46}{subsection.3.8.1}
\contentsline {subsubsection}{Linux}{46}{subsubsection*.49}
\contentsline {subsubsection}{Windows}{47}{subsubsection*.50}
\contentsline {subsection}{\numberline {3.8.2}Bug Graphs}{47}{subsection.3.8.2}
\contentsline {subsection}{\numberline {3.8.3}Whining}{47}{subsection.3.8.3}
\contentsline {subsection}{\numberline {3.8.4}Whining at Untriaged Bugs}{47}{subsection.3.8.4}
\contentsline {subsection}{\numberline {3.8.5}Dependency Graphs}{48}{subsection.3.8.5}
\contentsline {subsubsection}{Linux}{48}{subsubsection*.51}
\contentsline {subsubsection}{Windows}{48}{subsubsection*.52}
\contentsline {subsection}{\numberline {3.8.6}Documentation}{48}{subsection.3.8.6}
\contentsline {subsubsection}{Linux}{48}{subsubsection*.53}
\contentsline {subsubsection}{Windows}{48}{subsubsection*.54}
\contentsline {section}{\numberline {3.9}Migrating From Other Bug-Tracking Systems}{49}{section.3.9}
\contentsline {section}{\numberline {3.10}Moving Bugzilla Between Machines}{49}{section.3.10}
\contentsline {section}{\numberline {3.11}Upgrading}{50}{section.3.11}
\contentsline {subsection}{\numberline {3.11.1}Upgrading with Git}{50}{subsection.3.11.1}
\contentsline {subsubsection}{Before You Upgrade}{51}{subsubsection*.55}
\contentsline {paragraph}{Customized Bugzilla?}{51}{paragraph*.56}
\contentsline {subsubsection}{Starting the Upgrade}{51}{subsubsection*.57}
\contentsline {subsubsection}{Getting The New Bugzilla}{51}{subsubsection*.58}
\contentsline {subsubsection}{Upgrading the Database}{52}{subsubsection*.59}
\contentsline {subsubsection}{Finishing The Upgrade}{52}{subsubsection*.60}
\contentsline {subsection}{\numberline {3.11.2}Migrating from Bazaar}{52}{subsection.3.11.2}
\contentsline {subsubsection}{Download Code from Git}{53}{subsubsection*.61}
\contentsline {subsubsection}{Save Any Local Customizations}{53}{subsubsection*.62}
\contentsline {subsubsection}{Shut Down Bugzilla}{53}{subsubsection*.63}
\contentsline {subsubsection}{Copy Across Data and Modules}{53}{subsubsection*.64}
\contentsline {subsubsection}{Reapply Local Customizations}{54}{subsubsection*.65}
\contentsline {subsubsection}{Swap The New Version In}{54}{subsubsection*.66}
\contentsline {subsubsection}{Re-enable Bugzilla}{54}{subsubsection*.67}
\contentsline {subsubsection}{Test Bugzilla}{54}{subsubsection*.68}
\contentsline {subsubsection}{Rolling Back}{55}{subsubsection*.69}
\contentsline {subsection}{\numberline {3.11.3}Migrating from CVS}{55}{subsection.3.11.3}
\contentsline {subsubsection}{Download Code from Git}{55}{subsubsection*.70}
\contentsline {subsubsection}{Save Any Local Customizations}{55}{subsubsection*.71}
\contentsline {subsubsection}{Shut Down Bugzilla}{56}{subsubsection*.72}
\contentsline {subsubsection}{Copy Across Data and Modules}{56}{subsubsection*.73}
\contentsline {subsubsection}{Reapply Local Customizations}{56}{subsubsection*.74}
\contentsline {subsubsection}{Swap The New Version In}{56}{subsubsection*.75}
\contentsline {subsubsection}{Re-enable Bugzilla}{57}{subsubsection*.76}
\contentsline {subsubsection}{Test Bugzilla}{57}{subsubsection*.77}
\contentsline {subsubsection}{Rolling Back}{57}{subsubsection*.78}
\contentsline {subsection}{\numberline {3.11.4}Migrating from a Tarball}{57}{subsection.3.11.4}
\contentsline {subsubsection}{Download Code from Git}{57}{subsubsection*.79}
\contentsline {subsubsection}{Save Any Local Customizations}{58}{subsubsection*.80}
\contentsline {subsubsection}{Shut Down Bugzilla}{58}{subsubsection*.81}
\contentsline {subsubsection}{Copy Across Data and Modules}{58}{subsubsection*.82}
\contentsline {subsubsection}{Reapply Local Customizations}{58}{subsubsection*.83}
\contentsline {subsubsection}{Swap The New Version In}{59}{subsubsection*.84}
\contentsline {subsubsection}{Re-enable Bugzilla}{59}{subsubsection*.85}
\contentsline {subsubsection}{Test Bugzilla}{59}{subsubsection*.86}
\contentsline {subsubsection}{Rolling Back}{59}{subsubsection*.87}
\contentsline {subsection}{\numberline {3.11.5}Upgrading with a Tarball}{59}{subsection.3.11.5}
\contentsline {subsubsection}{Before You Upgrade}{59}{subsubsection*.88}
\contentsline {paragraph}{Customized Bugzilla?}{60}{paragraph*.89}
\contentsline {subsubsection}{Getting The New Bugzilla}{60}{subsubsection*.90}
\contentsline {subsubsection}{Copy Across Data and Modules}{60}{subsubsection*.91}
\contentsline {subsubsection}{Swap The New Version In}{60}{subsubsection*.92}
\contentsline {subsubsection}{Upgrading the Database}{61}{subsubsection*.93}
\contentsline {subsubsection}{Finishing The Upgrade}{61}{subsubsection*.94}
\contentsline {subsection}{\numberline {3.11.6}Upgrading a Customized or Extended Bugzilla}{61}{subsection.3.11.6}
\contentsline {section}{\numberline {3.12}Backups}{62}{section.3.12}
\contentsline {subsection}{\numberline {3.12.1}Database}{62}{subsection.3.12.1}
\contentsline {subsubsection}{MySQL}{62}{subsubsection*.95}
\contentsline {subsubsection}{PostgreSQL}{62}{subsubsection*.96}
\contentsline {subsection}{\numberline {3.12.2}Bugzilla}{62}{subsection.3.12.2}
\contentsline {section}{\numberline {3.13}Sanity Check}{62}{section.3.13}
\contentsline {section}{\numberline {3.14}Merging Accounts}{63}{section.3.14}
\contentsline {section}{\numberline {3.15}One Installation, Multiple Instances}{63}{section.3.15}
\contentsline {chapter}{\numberline {4}Administration Guide}{65}{chapter.4}
\contentsline {section}{\numberline {4.1}Parameters}{65}{section.4.1}
\contentsline {subsection}{\numberline {4.1.1}Required Settings}{65}{subsection.4.1.1}
\contentsline {subsection}{\numberline {4.1.2}General}{65}{subsection.4.1.2}
\contentsline {subsection}{\numberline {4.1.3}Administrative Policies}{66}{subsection.4.1.3}
\contentsline {subsection}{\numberline {4.1.4}User Authentication}{66}{subsection.4.1.4}
\contentsline {subsection}{\numberline {4.1.5}Attachments}{68}{subsection.4.1.5}
\contentsline {subsection}{\numberline {4.1.6}Bug Change Policies}{68}{subsection.4.1.6}
\contentsline {subsection}{\numberline {4.1.7}Bug Fields}{69}{subsection.4.1.7}
\contentsline {subsection}{\numberline {4.1.8}Graphs}{70}{subsection.4.1.8}
\contentsline {subsection}{\numberline {4.1.9}Group Security}{70}{subsection.4.1.9}
\contentsline {subsection}{\numberline {4.1.10}LDAP}{71}{subsection.4.1.10}
\contentsline {subsection}{\numberline {4.1.11}RADIUS}{72}{subsection.4.1.11}
\contentsline {subsection}{\numberline {4.1.12}Email}{72}{subsection.4.1.12}
\contentsline {subsection}{\numberline {4.1.13}Query Defaults}{73}{subsection.4.1.13}
\contentsline {subsection}{\numberline {4.1.14}Shadow Database}{73}{subsection.4.1.14}
\contentsline {subsection}{\numberline {4.1.15}Memcached}{74}{subsection.4.1.15}
\contentsline {subsection}{\numberline {4.1.16}User Matching}{74}{subsection.4.1.16}
\contentsline {subsection}{\numberline {4.1.17}Advanced}{74}{subsection.4.1.17}
\contentsline {section}{\numberline {4.2}Default Preferences}{75}{section.4.2}
\contentsline {section}{\numberline {4.3}Users}{75}{section.4.3}
\contentsline {subsection}{\numberline {4.3.1}Creating Admin Users}{75}{subsection.4.3.1}
\contentsline {subsection}{\numberline {4.3.2}Searching For Users}{75}{subsection.4.3.2}
\contentsline {subsection}{\numberline {4.3.3}Modifying Users}{76}{subsection.4.3.3}
\contentsline {subsection}{\numberline {4.3.4}Creating New Users}{77}{subsection.4.3.4}
\contentsline {subsubsection}{Self-Registration}{77}{subsubsection*.97}
\contentsline {subsubsection}{Administrator Registration}{77}{subsubsection*.98}
\contentsline {subsection}{\numberline {4.3.5}Deleting Users}{77}{subsection.4.3.5}
\contentsline {subsection}{\numberline {4.3.6}Impersonating Users}{77}{subsection.4.3.6}
\contentsline {section}{\numberline {4.4}Classifications, Products, Components, Versions, and Milestones}{78}{section.4.4}
\contentsline {subsection}{\numberline {4.4.1}Classifications}{78}{subsection.4.4.1}
\contentsline {subsection}{\numberline {4.4.2}Products}{78}{subsection.4.4.2}
\contentsline {subsubsection}{Creating New Products}{79}{subsubsection*.99}
\contentsline {subsubsection}{Editing Products}{79}{subsubsection*.100}
\contentsline {subsubsection}{Adding or Editing Components, Versions and Target Milestones}{79}{subsubsection*.101}
\contentsline {subsubsection}{Assigning Group Controls to Products}{79}{subsubsection*.102}
\contentsline {subsubsection}{Common Applications of Group Controls}{80}{subsubsection*.103}
\contentsline {paragraph}{Basic Product/Group Restriction}{80}{paragraph*.104}
\contentsline {paragraph}{General User Access With Security Group}{81}{paragraph*.105}
\contentsline {paragraph}{General User Access With A Security Product}{81}{paragraph*.106}
\contentsline {paragraph}{Product Isolation With a Common Group}{81}{paragraph*.107}
\contentsline {paragraph}{Make a Product Read Only}{81}{paragraph*.108}
\contentsline {subsection}{\numberline {4.4.3}Components}{82}{subsection.4.4.3}
\contentsline {subsection}{\numberline {4.4.4}Versions}{82}{subsection.4.4.4}
\contentsline {subsection}{\numberline {4.4.5}Milestones}{82}{subsection.4.4.5}
\contentsline {section}{\numberline {4.5}Flags}{83}{section.4.5}
\contentsline {subsection}{\numberline {4.5.1}Flag Properties}{83}{subsection.4.5.1}
\contentsline {subsection}{\numberline {4.5.2}Deleting a Flag}{84}{subsection.4.5.2}
\contentsline {section}{\numberline {4.6}Custom Fields}{85}{section.4.6}
\contentsline {subsection}{\numberline {4.6.1}Adding Custom Fields}{85}{subsection.4.6.1}
\contentsline {subsection}{\numberline {4.6.2}Editing Custom Fields}{86}{subsection.4.6.2}
\contentsline {subsection}{\numberline {4.6.3}Deleting Custom Fields}{86}{subsection.4.6.3}
\contentsline {section}{\numberline {4.7}Field Values}{86}{section.4.7}
\contentsline {subsection}{\numberline {4.7.1}Viewing/Editing Legal Values}{86}{subsection.4.7.1}
\contentsline {subsection}{\numberline {4.7.2}Deleting Legal Values}{87}{subsection.4.7.2}
\contentsline {section}{\numberline {4.8}Workflow}{87}{section.4.8}
\contentsline {section}{\numberline {4.9}Groups and Security}{87}{section.4.9}
\contentsline {subsection}{\numberline {4.9.1}Creating Groups}{88}{subsection.4.9.1}
\contentsline {subsection}{\numberline {4.9.2}Editing Groups and Assigning Group Permissions}{89}{subsection.4.9.2}
\contentsline {subsection}{\numberline {4.9.3}Assigning Users to Groups}{89}{subsection.4.9.3}
\contentsline {subsection}{\numberline {4.9.4}Assigning Group Controls to Products}{90}{subsection.4.9.4}
\contentsline {section}{\numberline {4.10}Keywords}{90}{section.4.10}
\contentsline {section}{\numberline {4.11}Whining}{90}{section.4.11}
\contentsline {subsection}{\numberline {4.11.1}The Event}{91}{subsection.4.11.1}
\contentsline {subsection}{\numberline {4.11.2}Whining Schedule}{91}{subsection.4.11.2}
\contentsline {subsection}{\numberline {4.11.3}Whining Searches}{91}{subsection.4.11.3}
\contentsline {subsection}{\numberline {4.11.4}Saving Your Changes}{92}{subsection.4.11.4}
\contentsline {section}{\numberline {4.12}Quips}{92}{section.4.12}
\contentsline {section}{\numberline {4.13}Installed Extensions}{93}{section.4.13}
\contentsline {chapter}{\numberline {5}Integration and Customization Guide}{95}{chapter.5}
\contentsline {section}{\numberline {5.1}Customization FAQ}{95}{section.5.1}
\contentsline {section}{\numberline {5.2}Languages}{95}{section.5.2}
\contentsline {section}{\numberline {5.3}Skins}{96}{section.5.3}
\contentsline {section}{\numberline {5.4}Templates}{96}{section.5.4}
\contentsline {subsection}{\numberline {5.4.1}Template Directory Structure}{96}{subsection.5.4.1}
\contentsline {subsection}{\numberline {5.4.2}Choosing a Customization Method}{96}{subsection.5.4.2}
\contentsline {subsection}{\numberline {5.4.3}How To Edit Templates}{97}{subsection.5.4.3}
\contentsline {subsection}{\numberline {5.4.4}Template Formats and Types}{97}{subsection.5.4.4}
\contentsline {subsection}{\numberline {5.4.5}Particular Templates}{98}{subsection.5.4.5}
\contentsline {section}{\numberline {5.5}Extensions}{99}{section.5.5}
\contentsline {subsection}{\numberline {5.5.1}Adding A New Page to Bugzilla}{100}{subsection.5.5.1}
\contentsline {subsection}{\numberline {5.5.2}Altering Data On An Existing Page}{100}{subsection.5.5.2}
\contentsline {subsection}{\numberline {5.5.3}Adding New Fields To Bugs}{100}{subsection.5.5.3}
\contentsline {subsection}{\numberline {5.5.4}Adding New Fields To Other Things}{101}{subsection.5.5.4}
\contentsline {subsection}{\numberline {5.5.5}Adding Admin Configuration Panels}{101}{subsection.5.5.5}
\contentsline {subsection}{\numberline {5.5.6}Adding User Preferences}{101}{subsection.5.5.6}
\contentsline {subsection}{\numberline {5.5.7}Altering Who Can Change What}{102}{subsection.5.5.7}
\contentsline {subsection}{\numberline {5.5.8}Checking Syntax}{102}{subsection.5.5.8}
\contentsline {section}{\numberline {5.6}APIs}{102}{section.5.6}
\contentsline {subsection}{\numberline {5.6.1}Core Module API}{102}{subsection.5.6.1}
\contentsline {subsection}{\numberline {5.6.2}Ad-Hoc APIs}{102}{subsection.5.6.2}
\contentsline {subsection}{\numberline {5.6.3}XML-RPC}{103}{subsection.5.6.3}
\contentsline {subsection}{\numberline {5.6.4}JSON-RPC}{103}{subsection.5.6.4}
\contentsline {subsection}{\numberline {5.6.5}REST}{103}{subsection.5.6.5}
\contentsline {subsection}{\numberline {5.6.6}BzAPI/BzAPI-Compatible REST}{103}{subsection.5.6.6}
\contentsline {subsection}{\numberline {5.6.7}REST v2}{103}{subsection.5.6.7}
\contentsline {chapter}{\numberline {6}WebService API Reference}{105}{chapter.6}
\contentsline {section}{\numberline {6.1}Core API v1}{105}{section.6.1}
\contentsline {subsection}{\numberline {6.1.1}General}{105}{subsection.6.1.1}
\contentsline {subsubsection}{Basic Information}{105}{subsubsection*.110}
\contentsline {subsubsection}{Common Data Types}{106}{subsubsection*.111}
\contentsline {subsubsection}{Authentication}{106}{subsubsection*.112}
\contentsline {subsubsection}{Useful Parameters}{107}{subsubsection*.113}
\contentsline {subsection}{\numberline {6.1.2}Attachments}{108}{subsection.6.1.2}
\contentsline {subsubsection}{Get Attachment}{109}{subsubsection*.114}
\contentsline {subsubsection}{Create Attachment}{110}{subsubsection*.115}
\contentsline {subsubsection}{Update Attachment}{112}{subsubsection*.116}
\contentsline {subsection}{\numberline {6.1.3}Bugs}{114}{subsection.6.1.3}
\contentsline {subsubsection}{Get Bug}{114}{subsubsection*.117}
\contentsline {subsubsection}{Bug History}{118}{subsubsection*.118}
\contentsline {subsubsection}{Search Bugs}{120}{subsubsection*.119}
\contentsline {subsubsection}{Create Bug}{122}{subsubsection*.120}
\contentsline {subsubsection}{Update Bug}{124}{subsubsection*.121}
\contentsline {subsection}{\numberline {6.1.4}Bug User Last Visited}{132}{subsection.6.1.4}
\contentsline {subsubsection}{Update Last Visited}{132}{subsubsection*.122}
\contentsline {subsubsection}{Get Last Visited}{133}{subsubsection*.123}
\contentsline {subsection}{\numberline {6.1.5}Bugzilla Information}{134}{subsection.6.1.5}
\contentsline {subsubsection}{Version}{134}{subsubsection*.124}
\contentsline {subsubsection}{Extensions}{134}{subsubsection*.125}
\contentsline {subsubsection}{Timezone}{135}{subsubsection*.126}
\contentsline {subsubsection}{Time}{135}{subsubsection*.127}
\contentsline {subsubsection}{Parameters}{136}{subsubsection*.128}
\contentsline {subsubsection}{Last Audit Time}{138}{subsubsection*.129}
\contentsline {subsection}{\numberline {6.1.6}Classifications}{138}{subsection.6.1.6}
\contentsline {subsubsection}{Get Classification}{139}{subsubsection*.130}
\contentsline {subsection}{\numberline {6.1.7}Comments}{140}{subsection.6.1.7}
\contentsline {subsubsection}{Get Comments}{140}{subsubsection*.131}
\contentsline {subsubsection}{Create Comments}{141}{subsubsection*.132}
\contentsline {subsubsection}{Search Comment Tags}{142}{subsubsection*.133}
\contentsline {subsubsection}{Update Comment Tags}{142}{subsubsection*.134}
\contentsline {subsection}{\numberline {6.1.8}Components}{143}{subsection.6.1.8}
\contentsline {subsubsection}{Create Component}{143}{subsubsection*.135}
\contentsline {subsection}{\numberline {6.1.9}Bug Fields}{144}{subsection.6.1.9}
\contentsline {subsubsection}{Fields}{144}{subsubsection*.136}
\contentsline {subsubsection}{Legal Values}{147}{subsubsection*.137}
\contentsline {subsection}{\numberline {6.1.10}Flag Types}{148}{subsection.6.1.10}
\contentsline {subsubsection}{Get Flag Type}{148}{subsubsection*.138}
\contentsline {subsubsection}{Create Flag Type}{150}{subsubsection*.139}
\contentsline {subsubsection}{Update Flag Type}{152}{subsubsection*.140}
\contentsline {subsection}{\numberline {6.1.11}Groups}{154}{subsection.6.1.11}
\contentsline {subsubsection}{Create Group}{154}{subsubsection*.141}
\contentsline {subsubsection}{Update Group}{154}{subsubsection*.142}
\contentsline {subsubsection}{Get Group}{156}{subsubsection*.143}
\contentsline {subsection}{\numberline {6.1.12}Products}{158}{subsection.6.1.12}
\contentsline {subsubsection}{List Products}{158}{subsubsection*.144}
\contentsline {subsubsection}{Get Product}{158}{subsubsection*.145}
\contentsline {subsubsection}{Create Product}{161}{subsubsection*.146}
\contentsline {subsubsection}{Update Product}{162}{subsubsection*.147}
\contentsline {subsection}{\numberline {6.1.13}Users}{164}{subsection.6.1.13}
\contentsline {subsubsection}{Login}{164}{subsubsection*.148}
\contentsline {subsubsection}{Logout}{164}{subsubsection*.149}
\contentsline {subsubsection}{Valid Login}{164}{subsubsection*.150}
\contentsline {subsubsection}{Create User}{165}{subsubsection*.151}
\contentsline {subsubsection}{Update User}{165}{subsubsection*.152}
\contentsline {subsubsection}{Get User}{167}{subsubsection*.153}
