From 863e8cc898dbee2fedbe1ac0321a0617c5f47c7c Mon Sep 17 00:00:00 2001
From: "jake%bugzilla.org"
Perl Modules (minimum version):
-
Bundle::Bugzilla
- (Will allow you to skip the rest)
-
AppConfig
- (1.52)
-
CGI
- (2.88)
-
Data::Dumper
- (any)
-
Date::Format
- (2.21)
-
DBI
- (1.32)
-
DBD::mysql
- (2.1010)
-
File::Spec
- (0.82)
-
File::Temp
- (any)
-
Template Toolkit
- (2.08)
-
Text::Wrap
- (2001.0131)
-
GD
- (1.20) for bug charting
-
Chart::Base
- (0.99c) for bug charting
-
XML::Parser
- (any) for the XML interface
-
GD::Graph
- (any) for bug charting
-
GD::Text::Align
- (any) for bug charting
-
MIME::Parser
- (any) for the email interface
-
- and, optionally:
-
-
This information on using the LDAP - authentication options with Bugzilla is old, and the authors do - not know of anyone who has tested it. Approach with caution. +>LDAP authentication has been rewritten for the 2.18 release of + Bugzilla. It no longer requires the Mozilla::LDAP module and now uses + Net::LDAP instead. This rewrite was part of a larger landing that + allowed for additional authentication schemes to be easily added + (bug + 180642). + This patch originally landed in 21-Mar-2003 and was included + in the 2.17.4 development release. |
The existing authentication scheme for Bugzilla uses email addresses as the primary user ID, and a @@ -4313,92 +4321,189 @@ VALIGN="TOP" email address, not LDAP username. You still assign bugs by email address, query on users by email address, etc.
Using LDAP for Bugzilla authentication requires the - Mozilla::LDAP (aka PerLDAP) Perl module. The - Mozilla::LDAP module in turn requires Netscape's Directory SDK for C. - After you have installed the SDK, then install the PerLDAP module. - Mozilla::LDAP and the Directory SDK for C are both - available for - download from mozilla.org. -
Set the Param 'useLDAP' to "On" **only** if you will be using an LDAP - directory for - authentication. Be very careful when setting up this parameter; if you - set LDAP authentication, but do not have a valid LDAP directory set up, - you will not be able to log back in to Bugzilla once you log out. (If - this happens, you can get back in by manually editing the data/params - file, and setting useLDAP back to 0.) -
If using LDAP, you must set the - three additional parameters: Set LDAPserver to the name (and optionally - port) of your LDAP server. If no port is specified, it defaults to the - default port of 389. (e.g "ldap.mycompany.com" or - "ldap.mycompany.com:1234") Set LDAPBaseDN to the base DN for searching - for users in your LDAP directory. (e.g. "ou=People,o=MyCompany") uids - must be unique under the DN specified here. Set LDAPmailattribute to - the name of the attribute in your LDAP directory which contains the - primary email address. On most directory servers available, this is - "mail", but you may need to change this. -
You can also try using OpenLDAP with Bugzilla, using any of a number of administration - tools. You should apply the patch attached to - bug 158630 - , then set the following object classes for your users: - -
objectClass: person objectClass: organizationalPerson objectClass: inetOrgPerson objectClass: top objectClass: posixAccount objectClass: shadowAccount |
Parameters required to use LDAP Authentication:
This parameter should be set to "LDAP" + only if you will be using an LDAP directory + for authentication. If you set this param to "LDAP" but + fail to set up the other parameters listed below you will not be + able to log back in to Bugzilla one you log out. If this happens + to you, you will need to manually edit + data/params and set loginmethod to + "DB". +
This parameter should be set to the name (and optionally the + port) of your LDAP server. If no port is specified, it assumes + the default LDAP port of 389. +
Ex. "ldap.company.com" + or "ldap.company.com:3268" +
Some LDAP servers will not allow an anonymous bind to search + the directory. If this is the case with your configuration you + should set the LDAPbinddn parameter to the user account Bugzilla + should use instead of the anonymous bind. +
Ex. "cn=default,cn=user:password"
The LDAPBaseDN parameter should be set to the location in + your LDAP tree that you would like to search for e-mail addresses. + Your uids should be unique under the DN specified here. +
Ex. "ou=People,o=Company"
The LDAPuidattribute parameter should be set to the attribute + which contains the unique UID of your users. The value retrieved + from this attribute will be used when attempting to bind as the + user to confirm their password. +
Ex. "uid"
The LDAPmailattribute parameter should be the name of the + attribute which contains the e-mail address your users will enter + into the Bugzilla login boxes. +
Ex. "mail"
# Send all data using the ISO-8859-1 charset
+ $self->charset('ISO-8859-1');
+ |
All this one-liner command does is search for all instances of - "Content-type: text/html" - - and replaces it with - "Content-Type: text/html; charset=ISO-8859-1" - - . This specification prevents possible Javascript attacks on the - browser, and is suggested for all English-speaking sites. For - non-English-speaking Bugzilla sites, I suggest changing - "ISO-8859-1", above, to - "UTF-8".
use Net::SMTP; -$smtp_server = 'smtp.mycompany.com'; # change this +my $smtp_server = 'smtp.mycompany.com'; # change this # Use die on error, so that the mail will be in the 'unsent mails' and # can be sent from the sanity check page. @@ -5057,110 +5164,172 @@ TARGET="_top" >.Follow the instructions for setting up Fink. Once it's installed, - you'll want to run the following as root: - fink install gd + you'll want to use it to install the gd2 package.
It will prompt you for a number of dependencies, type 'y' and hit - enter to install all of the dependencies. Then watch it work.
To prevent creating conflicts with the software that Apple installs - by default, Fink creates its own directory tree at /sw where it installs - most of the software that it installs. This means your libraries and - headers for libgd will be at /sw/lib and /sw/include instead of /usr/lib - and /usr/local/include. Because of these changed locations for the - libraries, the Perl GD module will not install directly via CPAN, because it - looks for the specific paths instead of getting them from your - environment. But there's a way around that :-)
Instead of typing - "install GD" - at the - cpan> - prompt, type - look GD. - This should go through the motions of downloading the latest version of - the GD module, then it will open a shell and drop you into the build - directory. Apply this patch - to the Makefile.PL file (save the - patch into a file and use the command - patch < patchfile.) + enter to install all of the dependencies and then watch it work. You will + then be able to use CPAN to + install the GD perl module.
Then, run these commands to finish the installation of the GD - module: -
+>To prevent creating conflicts with the software that Apple + installs by default, Fink creates its own directory tree at + /sw where it installs most of + the software that it installs. This means your libraries and headers be + at /sw/lib and + /sw/include instead of + /usr/lib and + /usr/local/include. When the + Perl module config script asks where your libgd is, be sure to tell it + /sw/lib. +
perl Makefile.PL - make - make test - make install - And don't forget to run - exit - - to get back to CPAN.
Also available via Fink is expat. Once running using fink to + install the expat package you will be able to install + XML::Parser using CPAN. There is one caveat. Unlike recent versions of + the GD module, XML::Parser doesn't prompt for the location of the + required libraries. When using CPAN, you will need to use the following + command sequence:
# perl -MCPAN -e'look XML::Parser' |
5.9. Upgrading to New Releases
Upgrading is a one-way process. You should backup your database + and current Bugzilla directory before attempting the upgrade. If you wish + to revert to the old Bugzilla version for any reason, you will have to + restore from these backups. + |
Upgrading Bugzilla is something we all want to do from time to time, be it to get new features or pick up the latest security fix. How easy @@ -11005,7 +11204,7 @@ CLASS="answer" You can call bug_email.pl directly from your aliases file, with an entry like this:
Microsoft has some advice on this matter, as well:
B.2.1. Bugzilla Database Basics
B.2.1.1. Bugzilla Database Tables
Version 1.1, March 2000
0-9, high ascii
- contrib
The contrib directory is + a location to put scripts that have been contributed to Bugzilla but + are not a part of the official distribution. These scripts are written + by third parties and may be in languages other than perl. For those + that are in perl, there may be additional modules or other requirements + than those of the offical distribution. +
+
Scripts in the contrib + directory are not offically supported by the Bugzilla team and may + break in between versions. +
This information on using the LDAP - authentication options with Bugzilla is old, and the authors do - not know of anyone who has tested it. Approach with caution. +>LDAP authentication has been rewritten for the 2.18 release of + Bugzilla. It no longer requires the Mozilla::LDAP module and now uses + Net::LDAP instead. This rewrite was part of a larger landing that + allowed for additional authentication schemes to be easily added + (bug + 180642). + This patch originally landed in 21-Mar-2003 and was included + in the 2.17.4 development release. |
The existing authentication scheme for Bugzilla uses email addresses as the primary user ID, and a @@ -346,92 +354,189 @@ VALIGN="TOP" email address, not LDAP username. You still assign bugs by email address, query on users by email address, etc.
Using LDAP for Bugzilla authentication requires the - Mozilla::LDAP (aka PerLDAP) Perl module. The - Mozilla::LDAP module in turn requires Netscape's Directory SDK for C. - After you have installed the SDK, then install the PerLDAP module. - Mozilla::LDAP and the Directory SDK for C are both - available for - download from mozilla.org. -
Set the Param 'useLDAP' to "On" **only** if you will be using an LDAP - directory for - authentication. Be very careful when setting up this parameter; if you - set LDAP authentication, but do not have a valid LDAP directory set up, - you will not be able to log back in to Bugzilla once you log out. (If - this happens, you can get back in by manually editing the data/params - file, and setting useLDAP back to 0.) -
If using LDAP, you must set the - three additional parameters: Set LDAPserver to the name (and optionally - port) of your LDAP server. If no port is specified, it defaults to the - default port of 389. (e.g "ldap.mycompany.com" or - "ldap.mycompany.com:1234") Set LDAPBaseDN to the base DN for searching - for users in your LDAP directory. (e.g. "ou=People,o=MyCompany") uids - must be unique under the DN specified here. Set LDAPmailattribute to - the name of the attribute in your LDAP directory which contains the - primary email address. On most directory servers available, this is - "mail", but you may need to change this. -
You can also try using OpenLDAP with Bugzilla, using any of a number of administration - tools. You should apply the patch attached to - bug 158630 - , then set the following object classes for your users: - -
objectClass: person objectClass: organizationalPerson objectClass: inetOrgPerson objectClass: top objectClass: posixAccount objectClass: shadowAccount |
Parameters required to use LDAP Authentication:
This parameter should be set to "LDAP" + only if you will be using an LDAP directory + for authentication. If you set this param to "LDAP" but + fail to set up the other parameters listed below you will not be + able to log back in to Bugzilla one you log out. If this happens + to you, you will need to manually edit + data/params and set loginmethod to + "DB". +
This parameter should be set to the name (and optionally the + port) of your LDAP server. If no port is specified, it assumes + the default LDAP port of 389. +
Ex. "ldap.company.com" + or "ldap.company.com:3268" +
Some LDAP servers will not allow an anonymous bind to search + the directory. If this is the case with your configuration you + should set the LDAPbinddn parameter to the user account Bugzilla + should use instead of the anonymous bind. +
Ex. "cn=default,cn=user:password"
The LDAPBaseDN parameter should be set to the location in + your LDAP tree that you would like to search for e-mail addresses. + Your uids should be unique under the DN specified here. +
Ex. "ou=People,o=Company"
The LDAPuidattribute parameter should be set to the attribute + which contains the unique UID of your users. The value retrieved + from this attribute will be used when attempting to bind as the + user to confirm their password. +
Ex. "uid"
The LDAPmailattribute parameter should be the name of the + attribute which contains the e-mail address your users will enter + into the Bugzilla login boxes. +
Ex. "mail"
# Send all data using the ISO-8859-1 charset
+ $self->charset('ISO-8859-1');
+ |
All this one-liner command does is search for all instances of - "Content-type: text/html" - - and replaces it with - "Content-Type: text/html; charset=ISO-8859-1" - - . This specification prevents possible Javascript attacks on the - browser, and is suggested for all English-speaking sites. For - non-English-speaking Bugzilla sites, I suggest changing - "ISO-8859-1", above, to - "UTF-8".
Microsoft has some advice on this matter, as well:
Version 1.1, March 2000
0-9, high ascii
- contrib
The contrib directory is + a location to put scripts that have been contributed to Bugzilla but + are not a part of the official distribution. These scripts are written + by third parties and may be in languages other than perl. For those + that are in perl, there may be additional modules or other requirements + than those of the offical distribution. +
+
Scripts in the contrib + directory are not offically supported by the Bugzilla team and may + break in between versions. +
| perl Makefile.PL - |
| make - |
| make test - |
| make install - |
| And don't forget to run - exit - - to get back to CPAN. |
Also available via Fink is expat. Once running using fink to + install the expat package you will be able to install + XML::Parser using CPAN. There is one caveat. Unlike recent versions of + the GD module, XML::Parser doesn't prompt for the location of the + required libraries. When using CPAN, you will need to use the following + command sequence:
# perl -MCPAN -e'look XML::Parser' |
Perl Modules (minimum version): -
Bundle::Bugzilla - (Will allow you to skip the rest) -
AppConfig - (1.52) -
CGI - (2.88) -
Data::Dumper - (any) -
Date::Format - (2.21) -
DBI - (1.32) -
DBD::mysql - (2.1010) -
File::Spec - (0.82) -
File::Temp - (any) -
Template Toolkit - (2.08) -
Text::Wrap - (2001.0131) -
GD - (1.20) for bug charting -
Chart::Base - (0.99c) for bug charting -
XML::Parser - (any) for the XML interface -
GD::Graph - (any) for bug charting -
GD::Text::Align - (any) for bug charting -
MIME::Parser - (any) for the email interface -
5.9. Upgrading to New Releases
Upgrading is a one-way process. You should backup your database + and current Bugzilla directory before attempting the upgrade. If you wish + to revert to the old Bugzilla version for any reason, you will have to + restore from these backups. + |
Upgrading Bugzilla is something we all want to do from time to time,
be it to get new features or pick up the latest security fix. How easy
diff --git a/mozilla/webtools/bugzilla/docs/pdf/Bugzilla-Guide.pdf b/mozilla/webtools/bugzilla/docs/pdf/Bugzilla-Guide.pdf
index 6eb5287b3959c309b271d783a6cb967499d518d7..c045e1fba93fbf2485fa8268703963b17584fbac 100644
GIT binary patch
literal 563909
zcmcFsX+Tp)*M7U&+N#xBcQM-5oh5tX0x!F?vWOt=G(dnT5D1AZvh=N6D @N$tetcH;{YTH+@>BDRS|g_TCpjixkBoaU
za$nKvb181?_K!W`SuyOy{T*bcqThx(1T_EYBMmE@>Qa%f>iVFe@N)isC;344S@XVC
zX6N)7V6?Ekg*rq2UTZ=TZR<+0UlZ1_sKT cr
z&|&CB(K(yuDHKVR#WfMO7o6!{&|i7wrX8arn+UJvUJF4HXRNj#B&uvKZ+#jx`y4C(
zO1|eE^J|u^Dm5Hi8H`kF*S2tRm~O?!LA@h`#;_?|R322r?bW8S;vf$7lT~lHP
zQ$l@HJPX2
T#Y8
zL`^Vl5)$f5w|(np9fd=VqyNgi|12+?kA#5Ba$4N<+9wX?$d^v@GMOVa+TT$12Bc~s
zJG%xd7o|8;tK^(11`L}yk0AAp3P%n*mVFFL(>7vZZztb_f0VrZw6n{Ag)pW#n1X-g
z4Yencn+Bx?W-O}D(|5=+S9WcT
`*@;6#;t%!{+)5^~xM_@imA?diMK0?L$R0MXYLakq
zW8UJ#!-2&MC&+nbAKWf#V&B~U0D3#arwrn@L5gs$>jNJ+VgX}gK4T;O8ve8>YI*69
zEYawA`YQ1W$ysQrWbewhP7j-MI2F}bR#!Ad2clj*_2<43yM*p*&r#^d=<>c%aU2cq
zyNap-Zob@;&yDM?g|}XP7o&n8$xqT+@e8h$vEH)_hi>|SmxH)8(|1Vfd!Rg;x!D(k
z*{>T@(_><8g;)6C^-LS$!-cE|(^&8Gtv(7(_xkkc7eP#G!HgHD_Tz}gM&B?+U9X52
zyCOg%z1QiwWVdktja!=;YCr6!BDxZo!=wjVg|TRwf*
zDZN&-yS3~%--AHIDU=T@HLhhy5LDsNYIAI6+}~JhtSSLVQLqqqhjx=cy0JfkP!F10
zA5U#19YQ5z`x^2QtD1lUe#vBJl+w*mJ=hN#@yp1
zNJX7x^`79^Tg8P9M3BSB6jKw0PV?Aylex;QM>#n~MY2-!*?a~n6Keeh48$EBPHu`W
zG=1Grc54IF4sRQ)PSsGMz63!pg+R{61ZEG471i7gjW}5ee4z{-;uXmX$G+v^?%0>+
zv2R(mf-qAN-|FV}B@WL&!(nO?XvBQsPP7k|pVpk6kiOOO