From d8caf6045d10344c431918128e3803ca497565f3 Mon Sep 17 00:00:00 2001 From: "gerv%gerv.net" <> Date: Sun, 28 Jul 2002 05:00:17 +0000 Subject: Merging new docs from 2.16 branch. --- docs/html/faq.html | 2006 +++++++++++----------------------------------------- 1 file changed, 431 insertions(+), 1575 deletions(-) (limited to 'docs/html/faq.html') diff --git a/docs/html/faq.html b/docs/html/faq.html index 50bccc40b..0b0dfcca5 100644 --- a/docs/html/faq.html +++ b/docs/html/faq.html @@ -10,11 +10,11 @@ REL="HOME" TITLE="The Bugzilla Guide" HREF="index.html">
PrevNextThis FAQ includes questions not covered elsewhere in the Guide. +
A.1.1. Where can I find information about Bugzilla?
You can stay up-to-date with the latest Bugzilla information at http://www.mozilla.org/projects/bugzilla/ http://www.bugzilla.org/A.1.2.
What license is Bugzilla distributed under?
@@ -735,7 +614,7 @@ CLASS="qandaentry"
CLASS="question"
> A.1.3.
How do I get commercial support for Bugzilla?
@@ -759,7 +638,7 @@ TARGET="_top"
>
There are several experienced
Bugzilla hackers on the mailing list/newsgroup who are willing
- to whore themselves out for generous compensation.
+ to make themselves available for generous compensation.
Try sending a message to the mailing list asking for a volunteer.
A.1.4.
What major companies or projects are currently using Bugzilla
@@ -802,15 +681,15 @@ BORDER="0"
> A.1.5.
Who maintains Bugzilla?
@@ -890,12 +769,13 @@ CLASS="answer"
>
- Bugzilla maintenance has been in a state of flux recently.
- Please check the Bugzilla Project Page for the latest details.
+>core team,
+ led by Dave Miller (justdave@syndicomm.com).
If you happen to be a commercial bug-tracker vendor, please
- step forward with a rebuttal so I can include it in the
- FAQ. We're not in pursuit of Bugzilla ueber alles; we
- simply love having a powerful, open-source tool to get our
- jobs done.
+ step forward with a list of advantages your product has over
+ Bugzilla. We'd be happy to include it in the "Competitors"
+ section.
A.1.7.
- How do I change my user name in Bugzilla?
-
- You can't. However, the administrative account can, by simply opening
- your user account in editusers.cgi and changing the login name.
- A.1.8.
Why doesn't Bugzilla offer this or that feature or compatability
with this other tracking software?
@@ -992,7 +846,7 @@ CLASS="answer"
that supports the functionality you require, or else submitting a
"Request for Enhancement" (RFE) using the bug submission interface
at bugzilla.mozilla.org.
@@ -1005,11 +859,11 @@ CLASS="qandaentry"
CLASS="question"
>
Things aren't quite that grim these days, however. Terry pretty much
- sums up much of the thinking many of us have for Bugzilla, but there
- is light on the horizon for database-independence! Here are some options:
-
Here's Terry Weissman's comment, for some historical context:
-
[This was] purely my own convention. I wanted a place to put a version of
- Perl and other tools that was strictly under my control for the
- various webtools, and not subject to anyone else. Edit it to point
- to whatever you like.
-
We always recommend that, if possible, you keep the path
- as /usr/bonsaitools/bin/perl, and simply add a /usr/bonsaitools
- and /usr/bonsaitools/bin directory, then symlink your version
- of perl to /usr/bonsaitools/bin/perl. This will make upgrading
- your Bugzilla much easier in the future.
-
Obviously, if you do not have root access to your Bugzilla
- box, our suggestion is irrelevant.
-
This section is no longer up-to-date.
- Please see the section on "Red Hat Bugzilla" under "Variants" in The Bugzilla Guide.
-
- Red Hat Bugzilla is arguably more user-friendly, customizable, and scalable
- than stock Bugzilla. Check it out at
- http://bugzilla.redhat.com and the sources at ftp://people.redhat.com/dkl/.
- They've set their Bugzilla up to work with Oracle out of the box.
- Note that Redhat Bugzilla is based upon the 2.8 Bugzilla tree;
- Bugzilla has made some tremendous advances since the 2.8 release.
- Why not download both Bugzillas to check out the differences for
- yourself?
-
Dave Lawrence, the original Red Hat Bugzilla maintainer, mentions:
-
Somebody needs to take the ball and run with it. I'm the only
- maintainer and am very pressed for time.
-
- Loki Games has a customized version of Bugzilla available at
- http://fenris.lokigames.com. There are some advantages to using Fenris, chief being separation of comments based upon user privacy level, data hiding, forced login for any data retrieval, and some additional fields. Loki has mainted their code, originally a fork from the Bugzilla 2.8 code base, and it is quite a bit different than stock Bugzilla at this point. I recommend you stick with official Bugzilla version 2.16 rather than using a fork, but it's up to you.
+ At present, no.
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. :-)
A.4.3. A.2.3.
Does Bugzilla allow the user to track multiple projects?
A.4.6. A.2.6.
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
@@ -1716,193 +1130,8 @@ CLASS="qandaentry"
CLASS="question"
>
- It's possible to get the footer on the static index page using
- Server Side Includes (SSI). The trick to doing this is making
- sure that your web server is set up to allow SSI and specifically,
- the #exec directive. You should also rename index.html
- to index.shtml.
-
After you've done all that, you can add the following line to
- index.shtml:
-
This line will be replaced with the actual HTML for the footer
- when the page is requested, so you should put this line where you
- want the footer to appear.
-
Because this method depends on being able to use a #exec directive,
- and most ISP's will not allow that, there is an alternative method.
- You could have a small script (such as api.cgi)
- that basically looks like:
-
This still requires being able to use Server Side Includes, if
- this simply will not work for you, see bug 80183
- for a third option.
- A.4.8. A.2.7.
Does Bugzilla provide any reporting features, metrics, graphs, etc? You
know, the type of stuff that management likes to see. :)
@@ -1919,7 +1148,7 @@ HREF="http://bugzilla.mozilla.org/reports.cgi"
TARGET="_top"
>
http://bugzilla.mozilla.org/reports.cgi for basic reporting
- facilities.
+ and graphing facilities.
For more advanced reporting, I recommend hooking up a professional
@@ -1929,9 +1158,6 @@ TARGET="_top"
better accomplished through third-party utilities that can
interface with the database directly.
Advanced Reporting is a Bugzilla 3.X proposed feature.
-
- Yes. Place yourself in the "cc" field of the bug you wish to monitor.
- Then change your "Notify me of changes to" field in the Email Settings
- tab of the User Preferences screen in Bugzilla to the "Only those
- bugs which I am listed on the CC line" option.
-
- Mozilla allows data export through a custom DTD in XML format.
- It does not, however, export to specific formats other than the
- XML Mozilla DTD. Importing the data into Excel or any other application
- is left as an exercise for the reader.
-
If you create import filters to other applications from Mozilla's XML,
- please submit your modifications for inclusion in future Bugzilla
- distributions.
-
As for data import, any application can send data to Bugzilla through
- the HTTP protocol, or through Mozilla's XML API. However, it seems
- kind of silly to put another front-end in front of Bugzilla;
- it makes more sense to create a simplified bug submission form in
- HTML. You can find an excellent example at
-
http://www.mozilla.org/quality/help/bugzilla-helper.html
-
- Currently, no. Internationalization support for Perl did not
- exist in a robust fashion until the recent release of version 5.6.0;
- Bugzilla is, and likely will remain (until 3.X) completely
- non-localized.
-
If you create import filters to other applications from Mozilla's XML,
+ please submit your modifications for inclusion in future Bugzilla
+ distributions.
+
As for data import, any application can send data to Bugzilla through
+ the HTTP protocol, or through Mozilla's XML API. However, it seems
+ kind of silly to put another front-end in front of Bugzilla;
+ it makes more sense to create a simplified bug submission form in
+ HTML. You can find an excellent example at
+
http://www.mozilla.org/quality/help/bugzilla-helper.html
A.4.20. A.2.15.
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
@@ -2283,8 +1414,8 @@ CLASS="qandaentry"
CLASS="question"
> A.4.21. A.2.16.
Are there any backup features provided?
A.4.22. A.2.17.
Can users be on the system while a backup is in progress?
Commercial Bug-tracking software typically costs somewhere upwards
of $20,000 or more for 5-10 floating licenses. Bugzilla consultation
- is available from skilled members of the newsgroup.
-
As an example, as of this writing I typically charge
- $115 for the first hour, and $89 each hour thereafter
- for consulting work. It takes me three to five hours to make Bugzilla
- happy on a Development installation of Linux-Mandrake.
+ is available from skilled members of the newsgroup. Simple questions
+ are answered there and then.
A.4.24. A.2.19.
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
@@ -2405,8 +1530,8 @@ CLASS="qandaentry"
CLASS="question"
> A.4.25. A.2.20.
Is there any licensing fee or other fees for using Bugzilla? Any
out-of-pocket cost other than the bodies needed as identified above?
@@ -2428,96 +1553,18 @@ CLASS="answer"
CLASS="qandadiv"
>
- Check
http://www.mozilla.org/projects/bugzilla/ for details.
- Once you download it, untar it, read the Bugzilla Guide.
-
- Installation on Windows NT has its own section in
- "The Bugzilla Guide".
-
- At present, no.
- A.6.2. A.3.2.
Are there any security problems with Bugzilla?
A.6.3. A.3.3.
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
@@ -2591,15 +1638,15 @@ CLASS="answer"
CLASS="qandadiv"
> A.7.3. A.4.3.
I want whineatnews.pl to whine at something more, or other than, only new
bugs. How do I do it?
@@ -2676,8 +1723,8 @@ CLASS="qandaentry"
CLASS="question"
> A.7.4. A.4.4.
I don't like/want to use Procmail to hand mail off to bug_email.pl.
What alternatives do I have?
@@ -2692,7 +1739,7 @@ CLASS="answer"
You can call bug_email.pl directly from your aliases file, with
an entry like this:
bugzilla-daemon: "|/usr/local/bin/bugzilla/contrib/bug_email.pl"
@@ -2711,8 +1758,8 @@ CLASS="qandaentry"
CLASS="question"
> A.7.5. A.4.5.
How do I set up the email interface to submit/change bugs via email?
- You've almost certainly enabled the "shadow database", but for some
- reason it hasn't been updated for all your bugs. This is the database
- against which queries are run, so that really complex or slow queries won't
- lock up portions of the database for other users. You can turn off the
- shadow database in editparams.cgi. If you wish to continue using the shadow
- database, then as your "bugs" user run "./syncshadowdb -syncall" from the
- command line in the bugzilla installation directory to recreate your shadow
- database. After it finishes, be sure to check the params and make sure that
- "queryagainstshadowdb" is still turned on. The syncshadowdb program turns it
- off if it was on, and is supposed to turn it back on when completed; that
- way, if it crashes in the middle of recreating the database, it will stay
- off forever until someone turns it back on by hand. Apparently, it doesn't
- always do that yet.
+ Bugzilla 2.14 and 2.16 if you go with the 2.8-based Redhat version.
A.8.3. A.5.2.
I think my database might be corrupted, or contain invalid entries. What
do I do?
@@ -2907,8 +1920,8 @@ CLASS="qandaentry"
CLASS="question"
> A.8.4. A.5.3.
I want to manually edit some entries in my database. How?
A.8.5. A.5.4.
I try to add myself as a user, but Bugzilla always tells me my password is wrong.
- If you're sure your MySQL parameters are correct, you might want turn
- "strictvaluechecks" OFF in editparams.cgi. If you have "usebugsentry" set
- "On", you also cannot submit a bug as readable by more than one group with
- "strictvaluechecks" ON.
-
- This should only happen with Bugzilla 2.16 if you are
- using the "shadow database" feature, and your
- shadow database is out of sync. Try running
- syncshadowdb
- -syncall to make sure your shadow
- database is in synch with your primary database.
- A.9.1. A.6.1.
What is the easiest way to run Bugzilla on Win32 (Win98+/NT/2K)?
A.9.2. A.6.2.
Is there a "Bundle::Bugzilla" equivalent for Win32?
A.9.3. A.6.3.
CGI's are failing with a "something.cgi is not a valid Windows NT
application" error. Why?
@@ -3157,7 +2108,7 @@ CLASS="answer"
>
Microsoft has some advice on this matter, as well:
"Set application mappings. In the ISM, map the extension for the script
@@ -3180,120 +2131,8 @@ CLASS="qandaentry"
CLASS="question"
> A.9.4.
- Can I have some general instructions on how to make Bugzilla on Win32 work?
-
- The following couple entries are deprecated in favor of the Windows installation
- instructions available in the "Administration" portion of "The Bugzilla Guide".
- However, they are provided here for historical interest and insight.
- A.9.5. A.6.4.
I'm having trouble with the perl modules for NT not being able to talk to
to the database.
@@ -3358,15 +2197,38 @@ TARGET="_top"
CLASS="qandadiv"
>
+ New in 2.16 - go to the Account section of the Preferences. You will
+ be emailed at both addresses for confirmation.
+ A.10.1. A.7.2.
The query page is very confusing. Isn't there a simpler way to query?
A.10.5. A.7.6.
How do I change a keyword in Bugzilla, once some bugs are using it?
A.11.1. A.8.1.
What bugs are in Bugzilla right now?
You can view bugs marked for 2.16 release
+>
You can view bugs marked for 2.18 release
here.
- This list includes bugs for the 2.16 release that have already
+ This list includes bugs for the 2.18 release that have already
been fixed and checked into CVS. Please consult the
A.11.3. A.8.3.
What's the best way to submit patches? What guidelines should I follow?
Upload your patch as a unified DIFF (having used "diff -u" against
+>
Upload your patch as a unified diff (having used "diff -u" against
the current sources checked out of CVS),
or new source file by clicking
"Create a new attachment" link on the bug page you've just created, and
include any descriptions of database changes you may make, into the bug
- ID you submitted in step #1. Be sure and click the "Patch" radio
- button to indicate the text you are sending is a patch!
+ ID you submitted in step #1. Be sure and click the "Patch" checkbox
+ to indicate the text you are sending is a patch!
Announce your patch and the associated URL
- (http://bugzilla.mozilla.org/show_bug.cgi?id=XXXX) for discussion in
+ (http://bugzilla.mozilla.org/show_bug.cgi?id=XXXXXX) for discussion in
the newsgroup (netscape.public.mozilla.webtools). You'll get a really
good, fairly immediate reaction to the implications of your patch,
which will also give us an idea how well-received the change would
@@ -3689,7 +2545,7 @@ WIDTH="33%"
ALIGN="left"
VALIGN="top"
>PrevNextSourceForgeIntegrating Bugzilla with Third-Party ToolsAtHome Corporation NASARed Hat Software AtHome CorporationLoki Entertainment Software Red Hat SoftwareThe Eazel Project AbiSource Ximian Linux-Mandrake
Red Hat Bugzilla:
- Runs a modified Bugzilla 2.8 atop an Oracle database.
-
Interzilla:
- A project to run Bugzilla on Interbase. No code released yet, however.
-
Bugzilla 3.0: One of the primary stated goals
- is multiple database support.
-
We always recommend that, if possible, you keep the path
+ as /usr/bonsaitools/bin/perl, and simply add symlink.
+ This will make upgrading
+ your Bugzilla much easier in the future.
+
2. Red Hat Bugzilla
- If you, or someone you know, has the time and expertise to do the integration
- work so main-tree Bugzilla 2.12 and higher integrates the Red
- Hat Bugzilla Oracle modifications, please donate your
- time to supporting the Bugzilla project.
- 3. Loki Bugzilla (AKA Fenris)
4. Pointy-Haired-Boss Questions
2. Managerial Questions
-
-<!--#exec cmd="/usr/bin/perl -e "require 'CGI.pl'; PutFooter();"" -->
-
-
- and then put this line in index.shtml.
-
-#!/usr/bonsaitools/bin/perl -w
-
-require 'globals.pl';
-
-if ($::FORM{sub} eq 'PutFooter') {
- PutFooter();
-} else {
- die 'api.cgi was incorrectly called';
-}
-
-
-
-<!--#include virtual="api.cgi?sub=PutFooter"-->
-
-
5. Bugzilla Installation
6. Bugzilla Security
3. Bugzilla Security7. Bugzilla Email
4. Bugzilla Email8. Bugzilla Database
5. Bugzilla Database9. Bugzilla and Win32
6. Bugzilla and Win32
- 1. #!C:/perl/bin/perl had to be added to every perl file.
- 2. Converted to Net::SMTP to handle mail messages instead of
- /usr/bin/sendmail.
- 3. The crypt function isn't available on Windows NT (at least none that I
- am aware), so I made encrypted passwords = plaintext passwords.
- 4. The system call to diff had to be changed to the Cygwin diff.
- 5. This was just to get a demo running under NT, it seems to be working
- good, and I have inserted almost 100 bugs from another bug tracking
- system. Since this work was done just to get an in-house demo, I am NOT
- planning on making a patch for submission to Bugzilla. If you would
- like a zip file, let me know.
-
-Q: Hmm, couldn't figure it out from the general instructions above. How
-about step-by-step?
-A: Sure! Here ya go!
-
- 1. Install IIS 4.0 from the NT Option Pack #4.
- 2. Download and install Active Perl.
- 3. Install the Windows GNU tools from Cygwin. Make sure to add the bin
- directory to your system path. (Everyone should have these, whether
- they decide to use Bugzilla or not. :-) )
- 4. Download relevant packages from ActiveState at
- http://www.activestate.com/packages/zips/. + DBD-Mysql.zip
- 5. Extract each zip file with WinZip, and install each ppd file using the
- notation: ppm install <module>.ppd
- 6. Install Mysql. *Note: If you move the default install from c:\mysql,
- you must add the appropriate startup parameters to the NT service. (ex.
- -b e:\\programs\\mysql)
- 7. Download any Mysql client. http://www.mysql.com/download_win.html
- 8. Setup MySql. (These are the commands that I used.)
-
- I. Cleanup default database settings.
- C:\mysql\bin\mysql -u root mysql
- mysql> DELETE FROM user WHERE Host='localhost' AND User='';
- mysql> quit
- C:\mysql\bin\mysqladmin reload
-
- II. Set password for root.
- C:\mysql\bin\mysql -u root mysql
- mysql> UPDATE user SET Password=PASSWORD('new_password')
- WHERE user='root';
- mysql> FLUSH PRIVILEGES;
- mysql> quit
- C:\mysql\bin\mysqladmin -u root reload
-
- III. Create bugs user.
- C:\mysql\bin\mysql -u root -p
- mysql> insert into user (host,user,password)
- values('localhost','bugs','');
- mysql> quit
- C:\mysql\bin\mysqladmin -u root reload
-
- IV. Create the bugs database.
- C:\mysql\bin\mysql -u root -p
- mysql> create database bugs;
-
- V. Give the bugs user access to the bugs database.
- mysql> insert into db
- (host,db,user,select_priv,insert_priv,update_priv,delete_priv,create_priv,drop_priv)
- values('localhost','bugs','bugs','Y','Y','Y','Y','Y','N')
- mysql> quit
- C:\mysql\bin\mysqladmin -u root reload
- 9. Run the table scripts to setup the bugs database.
- 10. Change CGI.pm to use the following regular expression because of
- differing backslashes in NT versus UNIX.
- o $0 =~ m:[^\\]*$:;
- 11. Had to make the crypt password = plain text password in the database.
- (Thanks to Andrew Lahser" <andrew_lahser@merck.com>" on this one.) The
- files that I changed were:
- o globals.pl
- o CGI.pl
- o alternately, you can try commenting all references to 'crypt'
- string and replace them with similar lines but without encrypt()
- or crypr() functions insida all files.
- 12. Replaced sendmail with Windmail. Basically, you have to come up with a
- sendmail substitute for NT. Someone said that they used a Perl module
- (Net::SMTP), but I was trying to save time and do as little Perl coding
- as possible.
- 13. Added "perl" to the beginning of all Perl system calls that use a perl
- script as an argument and renamed processmail to processmail.pl.
- 14. In processmail.pl, I added binmode(HANDLE) before all read() calls. I'm
- not sure about this one, but the read() under NT wasn't counting the
- EOLs without the binary read."
- 10. Bugzilla Usage
7. Bugzilla Usage11. Bugzilla Hacking
8. Bugzilla HackingSoftware Download Links The Bugzilla Database