\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}{26}{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}{30}{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}{37}{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}{39}{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}{40}{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}{41}{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}{42}{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}{43}{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}{44}{paragraph*.46} \contentsline {subsubsection}{Run Your Own Mail Server}{45}{subsubsection*.47} \contentsline {subsubsection}{Troubleshooting}{45}{subsubsection*.48} \contentsline {subsection}{\numberline {3.7.3}Products, Components, Versions and Milestones}{45}{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}{46}{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}{47}{subsection.3.8.5} \contentsline {subsubsection}{Linux}{47}{subsubsection*.51} \contentsline {subsubsection}{Windows}{47}{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}{48}{section.3.9} \contentsline {section}{\numberline {3.10}Moving Bugzilla Between Machines}{49}{section.3.10} \contentsline {section}{\numberline {3.11}Upgrading}{49}{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}