Bugzilla-Guide.pdf

(465 KB) Pobierz
The Bugzilla Guide − 2.16.3 Release
Matthew P. Barnson
The Bugzilla Team
2003−04−23
This is the documentation for Bugzilla, the mozilla.org bug−tracking system. Bugzilla is an enterprise−class
piece of software that powers issue−tracking for hundreds of organizations around the world, tracking
millions of bugs.
This documentation is maintained in DocBook 4.1.2 XML format. Changes are best submitted as plain text or
XML diffs, attached to a bug filed in mozilla.org's Bugzilla .
834853066.087.png
 
The Bugzilla Guide − 2.16.3 Release
Table of Contents
Chapter 1. About This Guide. ............................................................................................................................1
1.1. Copyright Information. .....................................................................................................................1
1.2. Disclaimer. ........................................................................................................................................1
1.3. New Versions. ...................................................................................................................................1
1.4. Credits. ..............................................................................................................................................2
1.5. Document Conventions. ....................................................................................................................2
Chapter 2. Introduction. .....................................................................................................................................4
2.1. What is Bugzilla?. .............................................................................................................................4
2.2. Why Should We Use Bugzilla?. .......................................................................................................4
Chapter 3. Using Bugzilla. ..................................................................................................................................6
3.1. How do I use Bugzilla?. ....................................................................................................................6
3.1.1. Create a Bugzilla Accoun. ......................................................................................................6
3.1.2. Anatomy of a Bug. ..................................................................................................................6
3.1.3. Searching for Bugs. .................................................................................................................7
3.1.4. Bug Lists. .................................................................................................................................7
3.1.5. Filing Bugs. .............................................................................................................................8
3.2. Hints and Tips. ..................................................................................................................................8
3.2.1. Autolinkification .....................................................................................................................8
3.2.2. Quicksearch. ............................................................................................................................9
3.2.3. Comments. ...............................................................................................................................9
3.2.4. Attachments. ............................................................................................................................9
3.2.5. Filing Bugs. .............................................................................................................................9
3.3. User Preferences. ............................................................................................................................10
3.3.1. Account Settings. ...................................................................................................................10
3.3.2. Email Settings. .......................................................................................................................10
3.3.3. Page Footer. ...........................................................................................................................10
3.3.4. Permissions. ...........................................................................................................................10
Chapter 4. Installation. .....................................................................................................................................11
4.1. Step−by−step Install .......................................................................................................................11
4.1.1. Introduction. ..........................................................................................................................11
4.1.2. Package List. .........................................................................................................................11
4.1.3. MySQL. .................................................................................................................................12
4.1.4. Per. ........................................................................................................................................12
4.1.5. Perl Modules.. ........................................................................................................................13
4.1.6. HTTP Serve .. ........................................................................................................................14
4.1.7. Bugzilla. ................................................................................................................................15
4.1.8. Setting Up the MySQL Database. .........................................................................................16
4.1.9. checksetup.pl. ........................................................................................................................16
4.1.10. Configuring Bugzilla. ..........................................................................................................17
4.2. Optional Additional Configuration. ................................................................................................17
4.2.1. Dependency Charts. ...............................................................................................................17
4.2.2. Bug Graphs. ...........................................................................................................................17
4.2.3. The Whining Cron. ................................................................................................................18
4.2.4. LDAP Authentication. ...........................................................................................................18
i
834853066.108.png 834853066.119.png 834853066.001.png 834853066.012.png 834853066.023.png 834853066.034.png 834853066.042.png 834853066.043.png 834853066.044.png 834853066.045.png 834853066.046.png 834853066.047.png 834853066.048.png 834853066.049.png 834853066.050.png 834853066.051.png 834853066.052.png 834853066.053.png 834853066.054.png 834853066.055.png 834853066.056.png 834853066.057.png 834853066.058.png 834853066.059.png 834853066.060.png 834853066.061.png 834853066.062.png 834853066.063.png 834853066.064.png 834853066.065.png 834853066.066.png 834853066.067.png 834853066.068.png 834853066.069.png 834853066.070.png 834853066.071.png 834853066.072.png 834853066.073.png 834853066.074.png 834853066.075.png 834853066.076.png 834853066.077.png 834853066.078.png 834853066.079.png
 
The Bugzilla Guide − 2.16.3 Release
Table of Contents
4.2.6. .htaccess files and security. .............................................................................................19
4.2.7. mod_throttle and Security. ....................................................................................................20
4.3. Win32 Installation Notes. ...............................................................................................................20
4.3.1. Win32 Installation: Step−by−step. ........................................................................................20
4.3.2. Additional Windows Tips. ....................................................................................................25
4.4. Mac OS X Installation Notes. .........................................................................................................25
4.5. Troubleshooting. .............................................................................................................................26
4.5.1. Bundle::Bugzilla makes me upgrade to Perl 5.6.1. ...............................................................26
4.5.2. DBD::Sponge::db prepare failed. ..........................................................................................26
4.5.3. cannot chdir(/var/spool/mqueue). ..........................................................................................27
4.5.4. Your vendor has not defined Fcntl macro O_NOINHERIT. ................................................27
Chapter 5. Administering Bugzilla. .................................................................................................................29
5.1. Bugzilla Configuration ...................................................................................................................29
5.2. User Administration. .......................................................................................................................30
5.2.1. Creating the Default User. .....................................................................................................30
5.2.2. Managing Other Users.. .........................................................................................................31
5.3. Product, Component, Milestone, and Version Administration. ......................................................32
5.3.1. Products. ................................................................................................................................32
5.3.2. Components. ..........................................................................................................................32
5.3.3. Versions. ................................................................................................................................33
5.3.4. Milestones. ............................................................................................................................33
5.4. Voting. ............................................................................................................................................34
5.5. Groups and Group Security. ...........................................................................................................34
5.6. Bugzilla Security. ............................................................................................................................35
5.6.1. TCP/IP Ports. .........................................................................................................................35
5.6.2. MySQL. .................................................................................................................................35
5.6.3. Daemon Accounts. ................................................................................................................36
5.6.4. Web Server Access Controls. ................................................................................................36
5.7. Template Customisation. ................................................................................................................37
5.7.1. What to Edi.. .........................................................................................................................37
5.7.2. How To Edit Templates. .......................................................................................................38
5.7.3. Template Formats. .................................................................................................................38
5.7.4. Particular Templates. .............................................................................................................39
5.8. Upgrading to New Releases. ...........................................................................................................40
5.9. Integrating Bugzilla with Third−Party Tools. .................................................................................42
5.9.1. Bonsai. ...................................................................................................................................42
5.9.2. CVS. ......................................................................................................................................42
5.9.3. Perforce SCM. .......................................................................................................................43
5.9.4. Tinderbox/Tinderbox2.. .........................................................................................................43
Appendix A. The Bugzilla FAQ. ......................................................................................................................44
Appendix B. The Bugzilla Database. ...............................................................................................................56
B.1. Database Schema Char. .................................................................................................................56
B.2. MySQL Bugzilla Database Introduction. .......................................................................................58
B.2.1. Bugzilla Database Basics. .....................................................................................................58
ii
834853066.080.png 834853066.081.png 834853066.082.png 834853066.083.png 834853066.084.png 834853066.085.png 834853066.086.png 834853066.088.png 834853066.089.png 834853066.090.png 834853066.091.png 834853066.092.png 834853066.093.png 834853066.094.png 834853066.095.png 834853066.096.png 834853066.097.png 834853066.098.png 834853066.099.png 834853066.100.png 834853066.101.png 834853066.102.png 834853066.103.png 834853066.104.png 834853066.105.png 834853066.106.png 834853066.107.png 834853066.109.png 834853066.110.png 834853066.111.png 834853066.112.png 834853066.113.png 834853066.114.png 834853066.115.png 834853066.116.png 834853066.117.png 834853066.118.png 834853066.120.png 834853066.121.png 834853066.122.png 834853066.123.png 834853066.124.png 834853066.125.png 834853066.126.png
 
The Bugzilla Guide − 2.16.3 Release
Table of Contents
Appendix C. Useful Patches and Utilities for Bugzilla. .................................................................................64
C.1. Apache mod_rewrite magic ...........................................................................................................64
C.2. Command−line Bugzilla Queries. ..................................................................................................64
Appendix D. Bugzilla Variants and Competitors. .........................................................................................65
D.1. Red Hat Bugzilla. ...........................................................................................................................65
D.2. Loki Bugzilla (Fenris). ...................................................................................................................65
D.3. Issuezilla. ........................................................................................................................................65
D.4. Scarab. ............................................................................................................................................65
D.5. Perforce SCM. ................................................................................................................................65
D.6. SourceForge. ..................................................................................................................................66
Appendix E. GNU Free Documentation License ...........................................................................................67
0. PREAMBLE. .....................................................................................................................................67
1. APPLICABILITY AND DEFINITIONS. .........................................................................................67
2. VERBATIM COPYING. ...................................................................................................................68
3. COPYING IN QUANTITY. ..............................................................................................................68
4. MODIFICATIONS. ...........................................................................................................................69
5. COMBINING DOCUMENTS.. .........................................................................................................70
6. COLLECTIONS OF DOCUMENTS. ...............................................................................................70
7. AGGREGATION WITH INDEPENDENT WORKS. ......................................................................71
8. TRANSLATION. ...............................................................................................................................71
9. TERMINATION. ...............................................................................................................................71
10. FUTURE REVISIONS OF THIS LICENSE. ..................................................................................71
How to use this License for your documents. ........................................................................................72
Glossary. ............................................................................................................................................................73
0−9, high ascii. .......................................................................................................................................73
A. ............................................................................................................................................................73
B. ............................................................................................................................................................73
C. ............................................................................................................................................................74
D. ............................................................................................................................................................74
G. ............................................................................................................................................................74
M. ...........................................................................................................................................................74
P. ............................................................................................................................................................74
Q. ............................................................................................................................................................75
R. ............................................................................................................................................................75
S. ............................................................................................................................................................75
T. ............................................................................................................................................................75
Z. ............................................................................................................................................................75
iii
834853066.127.png 834853066.128.png 834853066.002.png 834853066.003.png 834853066.004.png 834853066.005.png 834853066.006.png 834853066.007.png 834853066.008.png 834853066.009.png 834853066.010.png 834853066.011.png 834853066.013.png 834853066.014.png 834853066.015.png 834853066.016.png 834853066.017.png 834853066.018.png 834853066.019.png 834853066.020.png 834853066.021.png 834853066.022.png 834853066.024.png 834853066.025.png 834853066.026.png 834853066.027.png 834853066.028.png 834853066.029.png 834853066.030.png 834853066.031.png 834853066.032.png 834853066.033.png 834853066.035.png 834853066.036.png 834853066.037.png 834853066.038.png
 
Chapter 1. About This Guide
1.1. Copyright Information
Permission is granted to copy, distribute and/or modify this document under the terms
of the GNU Free Documentation License, Version 1.1 or any later version published by
the Free Software Foundation; with no Invariant Sections, no Front−Cover Texts, and
with no Back−Cover Texts. A copy of the license is included in Appendix E .
−−Copyright (c) 2000−2003 Matthew P. Barnson and The Bugzilla Team
If you have any questions regarding this document, its copyright, or publishing this document in
non−electronic form, please contact The Bugzilla Team.
1.2. Disclaimer
No liability for the contents of this document can be accepted. Use the concepts, examples, and other content
at your own risk. This document may contain errors and inaccuracies that may damage your system, cause
your partner to leave you, your boss to fire you, your cats to pee on your furniture and clothing, and global
thermonuclear war. Proceed with caution.
All copyrights are held by their respective owners, unless specifically noted otherwise. Use of a term in this
document should not be regarded as affecting the validity of any trademark or service mark.
Naming of particular products or brands should not be seen as endorsements, with the exception of the term
"GNU/Linux". We wholeheartedly endorse the use of GNU/Linux in every situation where it is appropriate. It
is an extremely versatile, stable, and robust operating system that offers an ideal operating environment for
Bugzilla.
You are strongly recommended to make a backup of your system before installing Bugzilla and at regular
intervals thereafter. If you implement any suggestion in this Guide, implement this one!
Although the Bugzilla development team has taken great care to ensure that all easily−exploitable bugs or
options are documented or fixed in the code, security holes surely exist. Great care should be taken both in the
installation and usage of this software. Carefully consider the implications of installing other network services
with Bugzilla. The Bugzilla development team members, Netscape Communications, America Online Inc.,
and any affiliated developers or sponsors assume no liability for your use of this product. You have the source
code to this product, and are responsible for auditing it yourself to ensure your security needs are met.
1.3. New Versions
This is the 2.16.3 version of The Bugzilla Guide. It is so named to match the version of Bugzilla it is
disributed with. If you are reading this from any source other than those below, please check one of these
mirrors to make sure you are reading an up−to−date version of the Guide.
The newest version of this guide can always be found at bugzilla.org ; including documentation for past
releases and the current development version.
Chapter 1. About This Guide
1
834853066.039.png 834853066.040.png 834853066.041.png
 

Plik z chomika:

Inne pliki z tego folderu:

Inne foldery tego chomika:

Zgłoś jeśli naruszono regulamin