><DL
><DT
>5.7.1. <A
-HREF="cust-templates.html#AEN1524"
+HREF="cust-templates.html#AEN1529"
>What to Edit</A
></DT
><DT
>5.7.2. <A
-HREF="cust-templates.html#AEN1542"
->Particular Templates</A
+HREF="cust-templates.html#AEN1551"
+>Template Formats</A
></DT
><DT
>5.7.3. <A
-HREF="cust-templates.html#AEN1563"
->Template Formats</A
+HREF="cust-templates.html#AEN1564"
+>Particular Templates</A
></DT
></DL
></DD
><H2
CLASS="section"
><A
-NAME="AEN1524">5.7.1. What to Edit</H2
+NAME="AEN1529">5.7.1. What to Edit</H2
><P
> There are several ways to take advantage of Bugzilla's templates,
and which you use depends on what you want to do. The Bugzilla
<TT
CLASS="filename"
>custom</TT
->. The <TT
+> (you may have to create
+ <TT
+CLASS="filename"
+>custom</TT
+> yourself.) The <TT
CLASS="filename"
>default</TT
>
the contents of this directory will not be touched during an upgrade,
and you can then decide whether to continue using your own templates,
or make the effort to merge your changes into the new versions by
- hand.
+ hand. This is also the correct method to use if you upgrade Bugzilla
+ by untarring tarballs over the top, rather than using CVS. It's perfectly
+ acceptable to mix and match these two methods.
+ </P
+><P
+> Editing templates is a good way of doing a "poor man's custom fields".
+ For example, if you don't use the Status Whiteboard, but want to have
+ a free-form text entry box for "Build Identifier", then you can just
+ edit the templates to change the field labels. It's still be called
+ status_whiteboard internally, but your users don't need to know that.
+ </P
+><P
+> If you are making changes to contribute back to Bugzilla (and we'd
+ love to have them), then please read the
+ <A
+HREF="http://www.bugzilla.org/developerguide.html"
+TARGET="_top"
+>Developers
+ Guide</A
+> first.
</P
><P
> The syntax of the Template Toolkit language is beyond the scope of
TARGET="_top"
>Template Toolkit home
page</A
->.
+>. However, you should particularly remember (for security
+ reasons) to always HTML filter things which come from the database or
+ user input, to prevent cross-site scripting attacks.
</P
><DIV
CLASS="note"
><H2
CLASS="section"
><A
-NAME="AEN1542">5.7.2. Particular Templates</H2
+NAME="AEN1551">5.7.2. Template Formats</H2
+><P
+> Some CGIs have the ability to use more than one template. For
+ example, buglist.cgi can output bug lists as RDF or two
+ different forms of HTML (complex and simple). (Try this out
+ by appending <TT
+CLASS="filename"
+>&format=simple</TT
+> to a buglist.cgi
+ URL on your Bugzilla installation.) This
+ mechanism, called template 'formats', is extensible.
+ </P
+><P
+> To see if a CGI supports multiple output formats, grep the
+ CGI for "ValidateOutputFormat". If it's not present, adding
+ multiple format support isn't too hard - see how it's done in
+ other CGIs.
+ </P
+><P
+> To make a new format template for a CGI which supports this,
+ open a current template for
+ that CGI and take note of the INTERFACE comment (if present.) This
+ comment defines what variables are passed into this template. If
+ there isn't one, I'm afraid you'll have to read the template and
+ the code to find out what information you get.
+ </P
+><P
+> Write your template in whatever markup or text style is appropriate.
+ </P
+><P
+> You now need to decide what content type you want your template
+ served as. Open up the <TT
+CLASS="filename"
+>localconfig</TT
+> file and find the
+ <TT
+CLASS="filename"
+>$contenttypes</TT
+>
+ variable. If your content type is not there, add it. Remember
+ the three- or four-letter tag assigned to you content type.
+ This tag will be part of the template filename.
+ </P
+><P
+> Save the template as <TT
+CLASS="filename"
+><stubname>-<formatname>.<contenttypetag>.tmpl</TT
+>.
+ Try out the template by calling the CGI as
+ <TT
+CLASS="filename"
+><cginame>.cgi?format=<formatname></TT
+> .
+ </P
+></DIV
+><DIV
+CLASS="section"
+><H2
+CLASS="section"
+><A
+NAME="AEN1564">5.7.3. Particular Templates</H2
><P
> There are a few templates you may be particularly interested in
customising for your installation.
><P
> <B
CLASS="command"
+>index.html.tmpl</B
+>:
+ This is the Bugzilla front page.
+ </P
+><P
+> <B
+CLASS="command"
>global/header.html.tmpl</B
> and
<B
field in the database. The bug entry system has been designed in an
extensible fashion to enable you to define arbitrary fields and widgets,
and have their values appear formatted in the initial
- Description (rather than in database fields.)
+ Description, rather than in database fields. An example of this
+ is the mozilla.org
+ <A
+HREF="http://bugzilla.mozilla.org/enter_bug.cgi?format=guided"
+TARGET="_top"
+>guided
+ bug submission form</A
+>.
</P
><P
> To make this work, create a custom template for
and either call it <TT
CLASS="filename"
>create.html.tmpl</TT
-> or
- <TT
+> or use a format and
+ call it <TT
CLASS="filename"
>create-<formatname>.html.tmpl</TT
>.
<TT
CLASS="filename"
>custom/bug/create/comment.txt.tmpl</TT
->, which
+>, also named
+ after your format if you are using one, which
references the form fields you have created. When a bug report is
submitted, the initial comment attached to the bug report will be
formatted according to the layout of this template.
COLOR="#000000"
><PRE
CLASS="programlisting"
-> <input type="text" name="buildid" size="30">
- </PRE
+><input type="text" name="buildid" size="30"></PRE
></FONT
></TD
></TR
COLOR="#000000"
><PRE
CLASS="programlisting"
-> BuildID: [% form.buildid %]
- </PRE
+>BuildID: [% form.buildid %]</PRE
></FONT
></TD
></TR
COLOR="#000000"
><PRE
CLASS="programlisting"
-> BuildID: 20020303
- </PRE
+>BuildID: 20020303</PRE
></FONT
></TD
></TR
would appear in the initial checkin comment.
</P
></DIV
-><DIV
-CLASS="section"
-><H2
-CLASS="section"
-><A
-NAME="AEN1563">5.7.3. Template Formats</H2
-><P
-> Some CGIs have the ability to use more than one template. For
- example, buglist.cgi can output bug lists as RDF or two
- different forms of HTML (complex and simple). (Try this out
- by appending <TT
-CLASS="filename"
->&format=simple</TT
-> to a buglist.cgi
- URL on your Bugzilla installation.) This
- mechanism, called template 'formats', is extensible.
- </P
-><P
-> To see if a CGI supports multiple output formats, grep the
- CGI for "ValidateOutputFormat". If it's not present, adding
- multiple format support isn't too hard - see how it's done in
- other CGIs.
- </P
-><P
-> To make a new format template for a CGI which supports this,
- open a current template for
- that CGI and take note of the INTERFACE comment (if present.) This
- comment defines what variables are passed into this template. If
- there isn't one, I'm afraid you'll have to read the template and
- the code to find out what information you get.
- </P
-><P
-> Write your template in whatever markup or text style is appropriate.
- </P
-><P
-> You now need to decide what content type you want your template
- served as. Open up the localconfig file and find the $contenttypes
- variable. If your content type is not there, add it. Remember
- the three- or four-letter tag assigned to you content type.
- This tag will be part of the template filename.
- </P
-><P
-> Save the template as <TT
-CLASS="filename"
-><stubname>-<formatname>.<contenttypetag>.tmpl</TT
->.
- Try out the template by calling the CGI as
- <TT
-CLASS="filename"
-><cginame>.cgi?format=<formatname></TT
-> .
- </P
-></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><H2
CLASS="section"
><A
-NAME="AEN2040">B.2.1. Bugzilla Database Basics</H2
+NAME="AEN2055">B.2.1. Bugzilla Database Basics</H2
><P
>If you were like me, at this point you're totally clueless about
the internals of MySQL, and if it weren't for this executive order from
><H3
CLASS="section"
><A
-NAME="AEN2067">B.2.1.1. Bugzilla Database Tables</H3
+NAME="AEN2082">B.2.1.1. Bugzilla Database Tables</H3
><P
>Imagine your MySQL database as a series of spreadsheets, and
you won't be too far off. If you use this command:</P
><H2
CLASS="section"
><A
-NAME="AEN840">4.2.1. Dependency Charts</H2
+NAME="AEN845">4.2.1. Dependency Charts</H2
><P
>As well as the text-based dependency graphs, Bugzilla also
supports dependency graphing, using a package called 'dot'.
><H2
CLASS="section"
><A
-NAME="AEN855">4.2.2. Bug Graphs</H2
+NAME="AEN860">4.2.2. Bug Graphs</H2
><P
>As long as you installed the GD and Graph::Base Perl modules you
might as well turn on the nifty Bugzilla bug reporting graphs.</P
><H2
CLASS="section"
><A
-NAME="AEN868">4.2.3. The Whining Cron</H2
+NAME="AEN873">4.2.3. The Whining Cron</H2
><P
>By now you have a fully functional Bugzilla, but what good are
bugs if they're not annoying? To help make those bugs more annoying you
><DL
><DT
>A.1.1. <A
-HREF="faq.html#AEN1612"
+HREF="faq.html#AEN1627"
> Where can I find information about Bugzilla?</A
></DT
><DT
>A.1.2. <A
-HREF="faq.html#AEN1618"
+HREF="faq.html#AEN1633"
> What license is Bugzilla distributed under?
</A
></DT
><DT
>A.1.3. <A
-HREF="faq.html#AEN1624"
+HREF="faq.html#AEN1639"
> How do I get commercial support for Bugzilla?
</A
></DT
><DT
>A.1.4. <A
-HREF="faq.html#AEN1631"
+HREF="faq.html#AEN1646"
> What major companies or projects are currently using Bugzilla
for bug-tracking?
</A
></DT
><DT
>A.1.5. <A
-HREF="faq.html#AEN1656"
+HREF="faq.html#AEN1671"
> Who maintains Bugzilla?
</A
></DT
><DT
>A.1.6. <A
-HREF="faq.html#AEN1662"
+HREF="faq.html#AEN1677"
> How does Bugzilla stack up against other bug-tracking databases?
</A
></DT
><DT
>A.1.7. <A
-HREF="faq.html#AEN1668"
+HREF="faq.html#AEN1683"
> Why doesn't Bugzilla offer this or that feature or compatability
with this other tracking software?
</A
></DT
><DT
>A.1.8. <A
-HREF="faq.html#AEN1675"
+HREF="faq.html#AEN1690"
> Why MySQL? I'm interested in seeing Bugzilla run on
Oracle/Sybase/Msql/PostgreSQL/MSSQL.
</A
></DT
><DT
>A.1.9. <A
-HREF="faq.html#AEN1680"
+HREF="faq.html#AEN1695"
> Why do the scripts say "/usr/bonsaitools/bin/perl" instead of
"/usr/bin/perl" or something else?
</A
></DT
><DT
>A.1.10. <A
-HREF="faq.html#AEN1686"
+HREF="faq.html#AEN1701"
> Is there an easy way to change the Bugzilla cookie name?
</A
></DT
><DT
>2. <A
HREF="faq.html#faq-phb"
->Pointy-Haired-Boss Questions</A
+>Managerial Questions</A
></DT
><DD
><DL
><DT
>A.2.1. <A
-HREF="faq.html#AEN1696"
+HREF="faq.html#AEN1711"
> Is Bugzilla web-based, or do you have to have specific software or
a specific operating system on your machine?
</A
></DT
><DT
>A.2.2. <A
-HREF="faq.html#AEN1701"
+HREF="faq.html#AEN1716"
> Can Bugzilla integrate with
Perforce (SCM software)?
</A
></DT
><DT
>A.2.3. <A
-HREF="faq.html#AEN1706"
+HREF="faq.html#AEN1721"
> Does Bugzilla allow the user to track multiple projects?
</A
></DT
><DT
>A.2.4. <A
-HREF="faq.html#AEN1711"
+HREF="faq.html#AEN1726"
> If I am on many projects, and search for all bugs assigned to me, will
Bugzilla list them for me and allow me to sort by project, severity etc?
</A
></DT
><DT
>A.2.5. <A
-HREF="faq.html#AEN1716"
+HREF="faq.html#AEN1731"
> Does Bugzilla allow attachments (text, screenshots, URLs etc)? If yes,
are there any that are NOT allowed?
</A
></DT
><DT
>A.2.6. <A
-HREF="faq.html#AEN1721"
+HREF="faq.html#AEN1736"
> Does Bugzilla allow us to define our own priorities and levels? Do we
have complete freedom to change the labels of fields and format of them, and
the choice of acceptable values?
></DT
><DT
>A.2.7. <A
-HREF="faq.html#AEN1728"
+HREF="faq.html#AEN1743"
> Does Bugzilla provide any reporting features, metrics, graphs, etc? You
know, the type of stuff that management likes to see. :)
</A
></DT
><DT
>A.2.8. <A
-HREF="faq.html#AEN1735"
+HREF="faq.html#AEN1750"
> Is there email notification and if so, what do you see when you get an
email?
</A
></DT
><DT
>A.2.9. <A
-HREF="faq.html#AEN1740"
+HREF="faq.html#AEN1755"
> Can email notification be set up to send to multiple
people, some on the To List, CC List, BCC List etc?
</A
></DT
><DT
>A.2.10. <A
-HREF="faq.html#AEN1745"
+HREF="faq.html#AEN1760"
> Do users have to have any particular
type of email application?
</A
></DT
><DT
>A.2.11. <A
-HREF="faq.html#AEN1752"
+HREF="faq.html#AEN1767"
> Does Bugzilla allow data to be imported and exported? If I had outsiders
write up a bug report using a MS Word bug template, could that template be
imported into "matching" fields? If I wanted to take the results of a query
></DT
><DT
>A.2.12. <A
-HREF="faq.html#AEN1760"
+HREF="faq.html#AEN1775"
> Has anyone converted Bugzilla to another language to be used in other
countries? Is it localizable?
</A
></DT
><DT
>A.2.13. <A
-HREF="faq.html#AEN1765"
+HREF="faq.html#AEN1780"
> Can a user create and save reports? Can they do this in Word format?
Excel format?
</A
></DT
><DT
>A.2.14. <A
-HREF="faq.html#AEN1770"
+HREF="faq.html#AEN1785"
> Does Bugzilla have the ability to search by word, phrase, compound
search?
</A
></DT
><DT
>A.2.15. <A
-HREF="faq.html#AEN1775"
+HREF="faq.html#AEN1790"
> Does Bugzilla provide record locking when there is simultaneous access
to the same bug? Does the second person get a notice that the bug is in use
or how are they notified?
></DT
><DT
>A.2.16. <A
-HREF="faq.html#AEN1780"
+HREF="faq.html#AEN1795"
> Are there any backup features provided?
</A
></DT
><DT
>A.2.17. <A
-HREF="faq.html#AEN1786"
+HREF="faq.html#AEN1801"
> Can users be on the system while a backup is in progress?
</A
></DT
><DT
>A.2.18. <A
-HREF="faq.html#AEN1791"
+HREF="faq.html#AEN1806"
> What type of human resources are needed to be on staff to install and
maintain Bugzilla? Specifically, what type of skills does the person need to
have? I need to find out if we were to go with Bugzilla, what types of
></DT
><DT
>A.2.19. <A
-HREF="faq.html#AEN1797"
+HREF="faq.html#AEN1812"
> What time frame are we looking at if we decide to hire people to install
and maintain the Bugzilla? Is this something that takes hours or weeks to
install and a couple of hours per week to maintain and customize or is this
></DT
><DT
>A.2.20. <A
-HREF="faq.html#AEN1802"
+HREF="faq.html#AEN1817"
> Is there any licensing fee or other fees for using Bugzilla? Any
out-of-pocket cost other than the bodies needed as identified above?
</A
><DL
><DT
>A.3.1. <A
-HREF="faq.html#AEN1809"
+HREF="faq.html#AEN1824"
> How do I completely disable MySQL security if it's giving me problems
(I've followed the instructions in the installation section of this guide)?
</A
></DT
><DT
>A.3.2. <A
-HREF="faq.html#AEN1815"
+HREF="faq.html#AEN1830"
> Are there any security problems with Bugzilla?
</A
></DT
><DT
>A.3.3. <A
-HREF="faq.html#AEN1820"
+HREF="faq.html#AEN1835"
> I've implemented the security fixes mentioned in Chris Yeh's security
advisory of 5/10/2000 advising not to run MySQL as root, and am running into
problems with MySQL no longer working correctly.
><DL
><DT
>A.4.1. <A
-HREF="faq.html#AEN1827"
+HREF="faq.html#AEN1842"
> I have a user who doesn't want to receive any more email from Bugzilla.
How do I stop it entirely for this user?
</A
></DT
><DT
>A.4.2. <A
-HREF="faq.html#AEN1832"
+HREF="faq.html#AEN1847"
> I'm evaluating/testing Bugzilla, and don't want it to send email to
anyone but me. How do I do it?
</A
></DT
><DT
>A.4.3. <A
-HREF="faq.html#AEN1837"
+HREF="faq.html#AEN1852"
> I want whineatnews.pl to whine at something more, or other than, only new
bugs. How do I do it?
</A
></DT
><DT
>A.4.4. <A
-HREF="faq.html#AEN1843"
+HREF="faq.html#AEN1858"
> I don't like/want to use Procmail to hand mail off to bug_email.pl.
What alternatives do I have?
</A
></DT
><DT
>A.4.5. <A
-HREF="faq.html#AEN1850"
+HREF="faq.html#AEN1865"
> How do I set up the email interface to submit/change bugs via email?
</A
></DT
><DT
>A.4.6. <A
-HREF="faq.html#AEN1855"
+HREF="faq.html#AEN1870"
> Email takes FOREVER to reach me from Bugzilla -- it's extremely slow.
What gives?
</A
></DT
><DT
>A.4.7. <A
-HREF="faq.html#AEN1862"
+HREF="faq.html#AEN1877"
> How come email from Bugzilla changes never reaches me?
</A
></DT
><DL
><DT
>A.5.1. <A
-HREF="faq.html#AEN1870"
+HREF="faq.html#AEN1885"
> I've heard Bugzilla can be used with Oracle?
</A
></DT
><DT
>A.5.2. <A
-HREF="faq.html#AEN1875"
+HREF="faq.html#AEN1890"
> I think my database might be corrupted, or contain invalid entries. What
do I do?
</A
></DT
><DT
>A.5.3. <A
-HREF="faq.html#AEN1883"
+HREF="faq.html#AEN1898"
> I want to manually edit some entries in my database. How?
</A
></DT
><DT
>A.5.4. <A
-HREF="faq.html#AEN1888"
+HREF="faq.html#AEN1903"
> I try to add myself as a user, but Bugzilla always tells me my password is wrong.
</A
></DT
><DT
>A.5.5. <A
-HREF="faq.html#AEN1893"
+HREF="faq.html#AEN1908"
> I think I've set up MySQL permissions correctly, but Bugzilla still can't
connect.
</A
></DT
><DT
>A.5.6. <A
-HREF="faq.html#AEN1898"
+HREF="faq.html#AEN1913"
> How do I synchronize bug information among multiple different Bugzilla
databases?
</A
><DL
><DT
>A.6.1. <A
-HREF="faq.html#AEN1907"
+HREF="faq.html#AEN1922"
> What is the easiest way to run Bugzilla on Win32 (Win98+/NT/2K)?
</A
></DT
><DT
>A.6.2. <A
-HREF="faq.html#AEN1912"
+HREF="faq.html#AEN1927"
> Is there a "Bundle::Bugzilla" equivalent for Win32?
</A
></DT
><DT
>A.6.3. <A
-HREF="faq.html#AEN1917"
+HREF="faq.html#AEN1932"
> CGI's are failing with a "something.cgi is not a valid Windows NT
application" error. Why?
</A
></DT
><DT
>A.6.4. <A
-HREF="faq.html#AEN1925"
+HREF="faq.html#AEN1940"
> I'm having trouble with the perl modules for NT not being able to talk to
to the database.
</A
><DL
><DT
>A.7.1. <A
-HREF="faq.html#AEN1946"
+HREF="faq.html#AEN1961"
> How do I change my user name (email address) in Bugzilla?
</A
></DT
><DT
>A.7.2. <A
-HREF="faq.html#AEN1951"
+HREF="faq.html#AEN1966"
> The query page is very confusing. Isn't there a simpler way to query?
</A
></DT
><DT
>A.7.3. <A
-HREF="faq.html#AEN1956"
+HREF="faq.html#AEN1971"
> I'm confused by the behavior of the "accept" button in the Show Bug form.
Why doesn't it assign the bug to me when I accept it?
</A
></DT
><DT
>A.7.4. <A
-HREF="faq.html#AEN1966"
+HREF="faq.html#AEN1981"
> I can't upload anything into the database via the "Create Attachment"
link. What am I doing wrong?
</A
></DT
><DT
>A.7.5. <A
-HREF="faq.html#AEN1971"
+HREF="faq.html#AEN1986"
> Email submissions to Bugzilla that have attachments end up asking me to
save it as a "cgi" file.
</A
></DT
><DT
>A.7.6. <A
-HREF="faq.html#AEN1976"
+HREF="faq.html#AEN1991"
> How do I change a keyword in Bugzilla, once some bugs are using it?
</A
></DT
><DL
><DT
>A.8.1. <A
-HREF="faq.html#AEN1983"
+HREF="faq.html#AEN1998"
> What bugs are in Bugzilla right now?
</A
></DT
><DT
>A.8.2. <A
-HREF="faq.html#AEN1992"
+HREF="faq.html#AEN2007"
> How can I change the default priority to a null value? For instance, have the default
priority be "---" instead of "P2"?
</A
></DT
><DT
>A.8.3. <A
-HREF="faq.html#AEN1998"
+HREF="faq.html#AEN2013"
> What's the best way to submit patches? What guidelines should I follow?
</A
></DT
CLASS="question"
><P
><A
-NAME="AEN1612"><B
+NAME="AEN1627"><B
>A.1.1. </B
>
Where can I find information about Bugzilla?</P
CLASS="question"
><P
><A
-NAME="AEN1618"><B
+NAME="AEN1633"><B
>A.1.2. </B
>
What license is Bugzilla distributed under?
CLASS="question"
><P
><A
-NAME="AEN1624"><B
+NAME="AEN1639"><B
>A.1.3. </B
>
How do I get commercial support for Bugzilla?
CLASS="question"
><P
><A
-NAME="AEN1631"><B
+NAME="AEN1646"><B
>A.1.4. </B
>
What major companies or projects are currently using Bugzilla
CLASS="question"
><P
><A
-NAME="AEN1656"><B
+NAME="AEN1671"><B
>A.1.5. </B
>
Who maintains Bugzilla?
CLASS="question"
><P
><A
-NAME="AEN1662"><B
+NAME="AEN1677"><B
>A.1.6. </B
>
How does Bugzilla stack up against other bug-tracking databases?
CLASS="question"
><P
><A
-NAME="AEN1668"><B
+NAME="AEN1683"><B
>A.1.7. </B
>
Why doesn't Bugzilla offer this or that feature or compatability
CLASS="question"
><P
><A
-NAME="AEN1675"><B
+NAME="AEN1690"><B
>A.1.8. </B
>
Why MySQL? I'm interested in seeing Bugzilla run on
CLASS="question"
><P
><A
-NAME="AEN1680"><B
+NAME="AEN1695"><B
>A.1.9. </B
>
Why do the scripts say "/usr/bonsaitools/bin/perl" instead of
CLASS="question"
><P
><A
-NAME="AEN1686"><B
+NAME="AEN1701"><B
>A.1.10. </B
>
Is there an easy way to change the Bugzilla cookie name?
CLASS="qandadiv"
><H3
><A
-NAME="faq-phb">2. Pointy-Haired-Boss Questions</H3
+NAME="faq-phb">2. Managerial Questions</H3
><P
> <DIV
CLASS="note"
ALIGN="LEFT"
VALIGN="TOP"
><P
-> The title of this section doesn't mean you're a PHB -- it just means
- you probably HAVE a PHB who wants to know this :)
+> Questions likely to be asked by managers. :-)
</P
></TD
></TR
CLASS="question"
><P
><A
-NAME="AEN1696"><B
+NAME="AEN1711"><B
>A.2.1. </B
>
Is Bugzilla web-based, or do you have to have specific software or
CLASS="question"
><P
><A
-NAME="AEN1701"><B
+NAME="AEN1716"><B
>A.2.2. </B
>
Can Bugzilla integrate with
CLASS="question"
><P
><A
-NAME="AEN1706"><B
+NAME="AEN1721"><B
>A.2.3. </B
>
Does Bugzilla allow the user to track multiple projects?
CLASS="question"
><P
><A
-NAME="AEN1711"><B
+NAME="AEN1726"><B
>A.2.4. </B
>
If I am on many projects, and search for all bugs assigned to me, will
CLASS="question"
><P
><A
-NAME="AEN1716"><B
+NAME="AEN1731"><B
>A.2.5. </B
>
Does Bugzilla allow attachments (text, screenshots, URLs etc)? If yes,
CLASS="question"
><P
><A
-NAME="AEN1721"><B
+NAME="AEN1736"><B
>A.2.6. </B
>
Does Bugzilla allow us to define our own priorities and levels? Do we
CLASS="question"
><P
><A
-NAME="AEN1728"><B
+NAME="AEN1743"><B
>A.2.7. </B
>
Does Bugzilla provide any reporting features, metrics, graphs, etc? You
TARGET="_top"
> http://bugzilla.mozilla.org/reports.cgi</A
> for basic reporting
- facilities.
+ and graphing facilities.
</P
><P
> For more advanced reporting, I recommend hooking up a professional
CLASS="question"
><P
><A
-NAME="AEN1735"><B
+NAME="AEN1750"><B
>A.2.8. </B
>
Is there email notification and if so, what do you see when you get an
CLASS="question"
><P
><A
-NAME="AEN1740"><B
+NAME="AEN1755"><B
>A.2.9. </B
>
Can email notification be set up to send to multiple
CLASS="question"
><P
><A
-NAME="AEN1745"><B
+NAME="AEN1760"><B
>A.2.10. </B
>
Do users have to have any particular
CLASS="question"
><P
><A
-NAME="AEN1752"><B
+NAME="AEN1767"><B
>A.2.11. </B
>
Does Bugzilla allow data to be imported and exported? If I had outsiders
CLASS="question"
><P
><A
-NAME="AEN1760"><B
+NAME="AEN1775"><B
>A.2.12. </B
>
Has anyone converted Bugzilla to another language to be used in other
CLASS="question"
><P
><A
-NAME="AEN1765"><B
+NAME="AEN1780"><B
>A.2.13. </B
>
Can a user create and save reports? Can they do this in Word format?
CLASS="question"
><P
><A
-NAME="AEN1770"><B
+NAME="AEN1785"><B
>A.2.14. </B
>
Does Bugzilla have the ability to search by word, phrase, compound
CLASS="question"
><P
><A
-NAME="AEN1775"><B
+NAME="AEN1790"><B
>A.2.15. </B
>
Does Bugzilla provide record locking when there is simultaneous access
CLASS="question"
><P
><A
-NAME="AEN1780"><B
+NAME="AEN1795"><B
>A.2.16. </B
>
Are there any backup features provided?
CLASS="question"
><P
><A
-NAME="AEN1786"><B
+NAME="AEN1801"><B
>A.2.17. </B
>
Can users be on the system while a backup is in progress?
CLASS="question"
><P
><A
-NAME="AEN1791"><B
+NAME="AEN1806"><B
>A.2.18. </B
>
What type of human resources are needed to be on staff to install and
> </B
>
If Bugzilla is set up correctly from the start, continuing maintenance
- needs
- are minimal and can be completed by unskilled labor.
+ needs are minimal and can be done easily using the web interface.
</P
><P
> Commercial Bug-tracking software typically costs somewhere upwards
CLASS="question"
><P
><A
-NAME="AEN1797"><B
+NAME="AEN1812"><B
>A.2.19. </B
>
What time frame are we looking at if we decide to hire people to install
CLASS="question"
><P
><A
-NAME="AEN1802"><B
+NAME="AEN1817"><B
>A.2.20. </B
>
Is there any licensing fee or other fees for using Bugzilla? Any
CLASS="question"
><P
><A
-NAME="AEN1809"><B
+NAME="AEN1824"><B
>A.3.1. </B
>
How do I completely disable MySQL security if it's giving me problems
CLASS="question"
><P
><A
-NAME="AEN1815"><B
+NAME="AEN1830"><B
>A.3.2. </B
>
Are there any security problems with Bugzilla?
CLASS="question"
><P
><A
-NAME="AEN1820"><B
+NAME="AEN1835"><B
>A.3.3. </B
>
I've implemented the security fixes mentioned in Chris Yeh's security
CLASS="question"
><P
><A
-NAME="AEN1827"><B
+NAME="AEN1842"><B
>A.4.1. </B
>
I have a user who doesn't want to receive any more email from Bugzilla.
CLASS="question"
><P
><A
-NAME="AEN1832"><B
+NAME="AEN1847"><B
>A.4.2. </B
>
I'm evaluating/testing Bugzilla, and don't want it to send email to
CLASS="question"
><P
><A
-NAME="AEN1837"><B
+NAME="AEN1852"><B
>A.4.3. </B
>
I want whineatnews.pl to whine at something more, or other than, only new
CLASS="question"
><P
><A
-NAME="AEN1843"><B
+NAME="AEN1858"><B
>A.4.4. </B
>
I don't like/want to use Procmail to hand mail off to bug_email.pl.
You can call bug_email.pl directly from your aliases file, with
an entry like this:
<A
-NAME="AEN18
47"><BLOCKQUOTE
+NAME="AEN18
62"><BLOCKQUOTE
CLASS="BLOCKQUOTE"
><P
> bugzilla-daemon: "|/usr/local/bin/bugzilla/contrib/bug_email.pl"
CLASS="question"
><P
><A
-NAME="AEN1850"><B
+NAME="AEN1865"><B
>A.4.5. </B
>
How do I set up the email interface to submit/change bugs via email?
CLASS="question"
><P
><A
-NAME="AEN1855"><B
+NAME="AEN1870"><B
>A.4.6. </B
>
Email takes FOREVER to reach me from Bugzilla -- it's extremely slow.
CLASS="question"
><P
><A
-NAME="AEN1862"><B
+NAME="AEN1877"><B
>A.4.7. </B
>
How come email from Bugzilla changes never reaches me?
CLASS="question"
><P
><A
-NAME="AEN1870"><B
+NAME="AEN1885"><B
>A.5.1. </B
>
I've heard Bugzilla can be used with Oracle?
CLASS="question"
><P
><A
-NAME="AEN1875"><B
+NAME="AEN1890"><B
>A.5.2. </B
>
I think my database might be corrupted, or contain invalid entries. What
CLASS="question"
><P
><A
-NAME="AEN1883"><B
+NAME="AEN1898"><B
>A.5.3. </B
>
I want to manually edit some entries in my database. How?
CLASS="question"
><P
><A
-NAME="AEN1888"><B
+NAME="AEN1903"><B
>A.5.4. </B
>
I try to add myself as a user, but Bugzilla always tells me my password is wrong.
CLASS="question"
><P
><A
-NAME="AEN1893"><B
+NAME="AEN1908"><B
>A.5.5. </B
>
I think I've set up MySQL permissions correctly, but Bugzilla still can't
CLASS="question"
><P
><A
-NAME="AEN1898"><B
+NAME="AEN1913"><B
>A.5.6. </B
>
How do I synchronize bug information among multiple different Bugzilla
CLASS="question"
><P
><A
-NAME="AEN1907"><B
+NAME="AEN1922"><B
>A.6.1. </B
>
What is the easiest way to run Bugzilla on Win32 (Win98+/NT/2K)?
CLASS="question"
><P
><A
-NAME="AEN1912"><B
+NAME="AEN1927"><B
>A.6.2. </B
>
Is there a "Bundle::Bugzilla" equivalent for Win32?
CLASS="question"
><P
><A
-NAME="AEN1917"><B
+NAME="AEN1932"><B
>A.6.3. </B
>
CGI's are failing with a "something.cgi is not a valid Windows NT
><P
> Microsoft has some advice on this matter, as well:
<A
-NAME="AEN19
22"><BLOCKQUOTE
+NAME="AEN19
37"><BLOCKQUOTE
CLASS="BLOCKQUOTE"
><P
> "Set application mappings. In the ISM, map the extension for the script
CLASS="question"
><P
><A
-NAME="AEN1925"><B
+NAME="AEN1940"><B
>A.6.4. </B
>
I'm having trouble with the perl modules for NT not being able to talk to
CLASS="question"
><P
><A
-NAME="AEN1946"><B
+NAME="AEN1961"><B
>A.7.1. </B
>
How do I change my user name (email address) in Bugzilla?
CLASS="question"
><P
><A
-NAME="AEN1951"><B
+NAME="AEN1966"><B
>A.7.2. </B
>
The query page is very confusing. Isn't there a simpler way to query?
CLASS="question"
><P
><A
-NAME="AEN1956"><B
+NAME="AEN1971"><B
>A.7.3. </B
>
I'm confused by the behavior of the "accept" button in the Show Bug form.
CLASS="question"
><P
><A
-NAME="AEN1966"><B
+NAME="AEN1981"><B
>A.7.4. </B
>
I can't upload anything into the database via the "Create Attachment"
CLASS="question"
><P
><A
-NAME="AEN1971"><B
+NAME="AEN1986"><B
>A.7.5. </B
>
Email submissions to Bugzilla that have attachments end up asking me to
CLASS="question"
><P
><A
-NAME="AEN1976"><B
+NAME="AEN1991"><B
>A.7.6. </B
>
How do I change a keyword in Bugzilla, once some bugs are using it?
CLASS="question"
><P
><A
-NAME="AEN1983"><B
+NAME="AEN1998"><B
>A.8.1. </B
>
What bugs are in Bugzilla right now?
CLASS="question"
><P
><A
-NAME="AEN1992"><B
+NAME="AEN2007"><B
>A.8.2. </B
>
How can I change the default priority to a null value? For instance, have the default
CLASS="question"
><P
><A
-NAME="AEN1998"><B
+NAME="AEN2013"><B
>A.8.3. </B
>
What's the best way to submit patches? What guidelines should I follow?
><H1
CLASS="glossdiv"
><A
-NAME="AEN2146">0-9, high ascii</H1
+NAME="AEN2161">0-9, high ascii</H1
><DL
><DT
><B
></TR
><TR
><TD
+>george@example.com</TD
+></TR
+><TR
+><TD
>ftp://ftp.mozilla.org</TD
></TR
><TR
><H2
CLASS="section"
><A
-NAME="AEN462">3.2.5. Filing Bugs</H2
+NAME="AEN463">3.2.5. Filing Bugs</H2
><P
>Try to make sure that everything said in the summary is also
said in the first comment. Summaries are often updated and this will
></DT
><DT
>4-1. <A
-HREF="win32.html#AEN979"
+HREF="win32.html#AEN984"
>Installing ActivePerl ppd Modules on Microsoft
Windows</A
></DT
><DT
>4-2. <A
-HREF="win32.html#AEN992"
+HREF="win32.html#AEN997"
>Installing OpenInteract ppd Modules manually on Microsoft
Windows</A
></DT
><DT
>4-3. <A
-HREF="win32.html#AEN1174"
+HREF="win32.html#AEN1179"
>Removing encrypt() for Windows NT Bugzilla version 2.12 or
earlier</A
></DT
><DL
><DT
>4.1.1. <A
-HREF="stepbystep.html#AEN491"
+HREF="stepbystep.html#AEN492"
>Introduction</A
></DT
><DT
>4.1.2. <A
-HREF="stepbystep.html#AEN495"
+HREF="stepbystep.html#AEN496"
>Package List</A
></DT
><DT
></DT
><DT
>4.1.6. <A
-HREF="stepbystep.html#AEN665"
+HREF="stepbystep.html#AEN669"
>HTTP Server</A
></DT
><DT
>4.1.7. <A
-HREF="stepbystep.html#AEN684"
+HREF="stepbystep.html#AEN688"
>Bugzilla</A
></DT
><DT
>4.1.8. <A
-HREF="stepbystep.html#AEN701"
+HREF="stepbystep.html#AEN705"
>Setting Up the MySQL Database</A
></DT
><DT
>4.1.9. <A
-HREF="stepbystep.html#AEN736"
+HREF="stepbystep.html#AEN741"
><TT
CLASS="filename"
>checksetup.pl</TT
></DT
><DT
>4.1.10. <A
-HREF="stepbystep.html#AEN768"
+HREF="stepbystep.html#AEN773"
>Securing MySQL</A
></DT
><DT
>4.1.11. <A
-HREF="stepbystep.html#AEN834"
+HREF="stepbystep.html#AEN839"
>Configuring Bugzilla</A
></DT
></DL
><DL
><DT
>4.2.1. <A
-HREF="extraconfig.html#AEN840"
+HREF="extraconfig.html#AEN845"
>Dependency Charts</A
></DT
><DT
>4.2.2. <A
-HREF="extraconfig.html#AEN855"
+HREF="extraconfig.html#AEN860"
>Bug Graphs</A
></DT
><DT
>4.2.3. <A
-HREF="extraconfig.html#AEN868"
+HREF="extraconfig.html#AEN873"
>The Whining Cron</A
></DT
><DT
><DL
><DT
>4.5.1. <A
-HREF="troubleshooting.html#AEN1208"
+HREF="troubleshooting.html#AEN1213"
>DBD::Sponge::db prepare failed</A
></DT
><DT
><H2
CLASS="section"
><A
-NAME="AEN491">4.1.1. Introduction</H2
+NAME="AEN492">4.1.1. Introduction</H2
><P
>Bugzilla has been successfully installed under Solaris, Linux,
and Win32. Win32 is not yet officially supported, but many people
><H2
CLASS="section"
><A
-NAME="AEN495">4.1.2. Package List</H2
+NAME="AEN496">4.1.2. Package List</H2
><DIV
CLASS="note"
><P
><H3
CLASS="section"
><A
-NAME="AEN641">4.1.5.1. DBI</H3
+NAME="AEN642">4.1.5.1. DBI</H3
><P
>The DBI module is a generic Perl module used the
MySQL-related modules. As long as your Perl installation was done
><H3
CLASS="section"
><A
-NAME="AEN644">4.1.5.2. Data::Dumper</H3
+NAME="AEN645">4.1.5.2. Data::Dumper</H3
><P
>The Data::Dumper module provides data structure persistence for
Perl (similar to Java's serialization). It comes with later
><H3
CLASS="section"
><A
-NAME="AEN647">4.1.5.3. MySQL-related modules</H3
+NAME="AEN648">4.1.5.3. MySQL-related modules</H3
><P
>The Perl/MySQL interface requires a few mutually-dependent Perl
modules. These modules are grouped together into the the
><H3
CLASS="section"
><A
-NAME="AEN652">4.1.5.4. TimeDate modules</H3
+NAME="AEN653">4.1.5.4. TimeDate modules</H3
><P
>Many of the more common date/time/calendar related Perl modules
have been grouped into a bundle similar to the MySQL modules bundle.
><H3
CLASS="section"
><A
-NAME="AEN655">4.1.5.5. GD (optional)</H3
+NAME="AEN656">4.1.5.5. GD (optional)</H3
><P
>The GD library was written by Thomas Boutell a long while ago to
programatically generate images in C. Since then it's become the
><H3
CLASS="section"
><A
-NAME="AEN662">4.1.5.6. Chart::Base (optional)</H3
+NAME="AEN663">4.1.5.6. Chart::Base (optional)</H3
><P
>The Chart module provides Bugzilla with on-the-fly charting
abilities. It can be installed in the usual fashion after it has been
Note that earlier versions that 0.99c used GIFs, which are no longer
supported by the latest versions of GD.</P
></DIV
+><DIV
+CLASS="section"
+><H3
+CLASS="section"
+><A
+NAME="AEN666">4.1.5.7. Template Toolkit</H3
+><P
+>When you install Template Toolkit, you'll get asked various
+ questions about features to enable. The defaults are fine, except
+ that it is recommended you use the high speed XS Stash of the Template
+ Toolkit, in order to achieve best performance. However, there are
+ known problems with XS Stash and Perl 5.005_02 and lower. If you
+ wish to use these older versions of Perl, please use the regular
+ stash.</P
+></DIV
></DIV
><DIV
CLASS="section"
><H2
CLASS="section"
><A
-NAME="AEN665">4.1.6. HTTP Server</H2
+NAME="AEN669">4.1.6. HTTP Server</H2
><P
>You have a freedom of choice here - Apache, Netscape or any other
server on UNIX would do. You can run the web server on a
><H2
CLASS="section"
><A
-NAME="AEN684">4.1.7. Bugzilla</H2
+NAME="AEN688">4.1.7. Bugzilla</H2
><P
>You should untar the Bugzilla files into a directory that you're
willing to make writable by the default web server user (probably
><H2
CLASS="section"
><A
-NAME="AEN701">4.1.8. Setting Up the MySQL Database</H2
+NAME="AEN705">4.1.8. Setting Up the MySQL Database</H2
><P
>After you've gotten all the software installed and working you're
ready to start preparing the database for its life as the back end to
and enter <new_password>. Remember that MySQL user names have
nothing to do with Unix user names (login names).</P
><P
->Next, we create the
+>Next, we use an SQL <B
+CLASS="command"
+>GRANT</B
+> command to create a
<SPAN
CLASS="QUOTE"
>"bugs"</SPAN
><H2
CLASS="section"
><A
-NAME="AEN736">4.1.9. <TT
+NAME="AEN741">4.1.9. <TT
CLASS="filename"
>checksetup.pl</TT
></H2
><H2
CLASS="section"
><A
-NAME="AEN768">4.1.10. Securing MySQL</H2
+NAME="AEN773">4.1.10. Securing MySQL</H2
><P
>If you followed the installation instructions for setting up your
"bugs" and "root" user in MySQL, much of this should not apply to you.
><H2
CLASS="section"
><A
-NAME="AEN834">4.1.11. Configuring Bugzilla</H2
+NAME="AEN839">4.1.11. Configuring Bugzilla</H2
><P
> You should run through the parameters on the Edit Parameters page
(link in the footer) and set them all to appropriate values.
><H2
CLASS="section"
><A
-NAME="AEN1208">4.5.1. DBD::Sponge::db prepare failed</H2
+NAME="AEN1213">4.5.1. DBD::Sponge::db prepare failed</H2
><P
> The following error message may appear due to a bug in DBD::mysql
(over which the Bugzilla team have no control):
NAME="upgrading">5.8. Upgrading to New Releases</H1
><P
>A plain Bugzilla is fairly easy to upgrade from one version to a
- newer one. However, things get a bit more complicated if you've made
- changes to Bugzilla's code. In this case, you may have to re-make or
- reapply those changes. It is recommended that you take a backup of your
- database and your entire Bugzilla installation before attempting an
+ newer one. Always read the release notes to see if there are any issues
+ that you might need to take note of. It is recommended that you take a
+ backup of your database and your entire Bugzilla installation before attempting an
upgrade. You can upgrade a 'clean' installation by untarring a new
tarball over the old installation. If you are upgrading from 2.12 or
- later, you can type
- <TT
+ later, and have cvs installed, you can type <TT
CLASS="filename"
>cvs -z3 update</TT
>,
- and resolve conflicts if there are any.</P
+ and resolve conflicts if there are any.
+ </P
+><P
+>However, things get a bit more complicated if you've made
+ changes to Bugzilla's code. In this case, you may have to re-make or
+ reapply those changes. One good method is to take a diff of your customised
+ version against the original, so you can survey all that you've changed.
+ Hopefully, templatisation will reduce the need for
+ this in the future.</P
><P
->Because the developers of Bugzilla are constantly adding new
+>From version 2.8 onwards, Bugzilla databases can be automatically
+ carried forward during an upgrade. However, because the developers of
+ Bugzilla are constantly adding new
tables, columns and fields, you'll probably get SQL errors if you just
update the code and attempt to use Bugzilla. Always run the
<TT
></DT
><DT
>3.2.5. <A
-HREF="hintsandtips.html#AEN462"
+HREF="hintsandtips.html#AEN463"
>Filing Bugs</A
></DT
></DL
><DIV
CLASS="example"
><A
><B
>Example 4-1. Installing ActivePerl ppd Modules on Microsoft
Windows</B
<DIV
CLASS="example"
><A
><B
>Example 4-2. Installing OpenInteract ppd Modules manually on Microsoft
Windows</B
><P
>From Andrew Pearson:
<A
-NAME="AEN116
2"><BLOCKQUOTE
+NAME="AEN116
7"><BLOCKQUOTE
CLASS="BLOCKQUOTE"
><P
>You can make Bugzilla work with Personal Web Server for
<DIV
CLASS="example"
><A
><B
>Example 4-3. Removing encrypt() for Windows NT Bugzilla version 2.12 or
earlier</B
projects / thirdparty / bugzilla.git / commitdiff
