Skip to content

bugzilla
bugzilla
Commit d6fe6257 authored by jake%bugzilla.org's avatar jake%bugzilla.org
Browse files
Options

Recompile the docs

parent 028ccb87
Show whitespace changes
Inline Side-by-side
Showing with 1065 additions and 507 deletions
docs/html/Bugzilla-Guide.html
View file @ d6fe6257
...@@ -4263,13 +4263,12 @@ CLASS="section" ...@@ -4263,13 +4263,12 @@ CLASS="section"
NAME="bzldap" NAME="bzldap"
></A ></A
>4.2.4. LDAP Authentication</H2 >4.2.4. LDAP Authentication</H2
><P ><DIV
>&#13; <DIV CLASS="note"
CLASS="warning"
><P ><P
></P ></P
><TABLE ><TABLE
CLASS="warning" CLASS="note"
WIDTH="100%" WIDTH="100%"
BORDER="0" BORDER="0"
><TR ><TR
...@@ -4278,23 +4277,32 @@ WIDTH="25" ...@@ -4278,23 +4277,32 @@ WIDTH="25"
ALIGN="CENTER" ALIGN="CENTER"
VALIGN="TOP" VALIGN="TOP"
><IMG ><IMG
SRC="../images/warning.gif" SRC="../images/note.gif"
HSPACE="5" HSPACE="5"
ALT="Warning"></TD ALT="Note"></TD
><TD ><TD
ALIGN="LEFT" ALIGN="LEFT"
VALIGN="TOP" VALIGN="TOP"
><P ><P
>This information on using the LDAP >LDAP authentication has been rewritten for the 2.18 release of
authentication options with Bugzilla is old, and the authors do Bugzilla. It no longer requires the Mozilla::LDAP module and now uses
not know of anyone who has tested it. Approach with caution. Net::LDAP instead. This rewrite was part of a larger landing that
allowed for additional authentication schemes to be easily added
(<A
HREF="http://bugzilla.mozilla.org/show_bug.cgi?id=180642"
TARGET="_top"
>bug
180642</A
>).
</P
><P
>This patch originally landed in 21-Mar-2003 and was included
in the 2.17.4 development release.
</P </P
></TD ></TD
></TR ></TR
></TABLE ></TABLE
></DIV ></DIV
>
</P
><P ><P
>&#13; The existing authentication >&#13; The existing authentication
scheme for Bugzilla uses email addresses as the primary user ID, and a scheme for Bugzilla uses email addresses as the primary user ID, and a
...@@ -4313,92 +4321,189 @@ VALIGN="TOP" ...@@ -4313,92 +4321,189 @@ VALIGN="TOP"
email address, not LDAP username. You still assign bugs by email email address, not LDAP username. You still assign bugs by email
address, query on users by email address, etc. address, query on users by email address, etc.
</P </P
><DIV
CLASS="caution"
><P
></P
><TABLE
CLASS="caution"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="../images/caution.gif"
HSPACE="5"
ALT="Caution"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P ><P
>Using LDAP for Bugzilla authentication requires the >Because the Bugzilla account is not created until the first time
Mozilla::LDAP (aka PerLDAP) Perl module. The a user logs in, a user who has not yet logged is unknown to Bugzilla.
Mozilla::LDAP module in turn requires Netscape's Directory SDK for C. This means they cannot be used as an assignee or QA contact (default or
After you have installed the SDK, then install the PerLDAP module. otherwise), added to any cc list, or any other such operation. One
Mozilla::LDAP and the Directory SDK for C are both possible workaround is the <TT
CLASS="filename"
>bugzilla_ldapsync.rb</TT
>
script in the
<A
HREF="#gloss-contrib"
><I
CLASS="glossterm"
><TT
CLASS="filename"
>contrib</TT
></I
></A
> directory. Another possible solution is fixing
<A <A
HREF="http://www.mozilla.org/directory/" HREF="http://bugzilla.mozilla.org/show_bug.cgi?id=201069"
TARGET="_top" TARGET="_top"
>available for >bug
download</A 201069</A
> from mozilla.org. >.
</P </P
></TD
></TR
></TABLE
></DIV
><P
>Parameters required to use LDAP Authentication:</P
><P
></P
><DIV
CLASS="variablelist"
><DL
><DT
><A
NAME="param-loginmethod"
></A
>loginmethod</DT
><DD
><P ><P
>&#13; Set the Param 'useLDAP' to "On" **only** if you will be using an LDAP >This parameter should be set to <SPAN
directory for CLASS="QUOTE"
authentication. Be very careful when setting up this parameter; if you >"LDAP"</SPAN
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 <EM
this happens, you can get back in by manually editing the data/params >only</EM
file, and setting useLDAP back to 0.) > if you will be using an LDAP directory
for authentication. If you set this param to <SPAN
CLASS="QUOTE"
>"LDAP"</SPAN
> 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
<TT
CLASS="filename"
>data/params</TT
> and set loginmethod to
<SPAN
CLASS="QUOTE"
>"DB"</SPAN
>.
</P </P
></DD
><DT
><A
NAME="param-LDAPserver"
></A
>LDAPserver</DT
><DD
><P ><P
>If using LDAP, you must set the >This parameter should be set to the name (and optionally the
three additional parameters: Set LDAPserver to the name (and optionally port) of your LDAP server. If no port is specified, it assumes
port) of your LDAP server. If no port is specified, it defaults to the the default LDAP port of 389.
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.
</P </P
><P ><P
>You can also try using <A >Ex. <SPAN
HREF="http://www.openldap.org/" CLASS="QUOTE"
TARGET="_top" >"ldap.company.com"</SPAN
>&#13; OpenLDAP</A
> with Bugzilla, using any of a number of administration
tools. You should apply the patch attached to
<A
HREF="http://bugzilla.mozilla.org/show_bug.cgi?id=158630"
TARGET="_top"
>bug 158630</A
> >
, then set the following object classes for your users: or <SPAN
CLASS="QUOTE"
<P >"ldap.company.com:3268"</SPAN
></P >
><OL </P
TYPE="1" ></DD
><LI ><DT
><A
NAME="param-LDAPbinddn"
></A
>LDAPbinddn [Optional]</DT
><DD
><P ><P
>objectClass: person</P >Some LDAP servers will not allow an anonymous bind to search
></LI the directory. If this is the case with your configuration you
><LI should set the LDAPbinddn parameter to the user account Bugzilla
should use instead of the anonymous bind.
</P
><P ><P
>objectClass: organizationalPerson</P >Ex. <SPAN
></LI CLASS="QUOTE"
><LI >"cn=default,cn=user:password"</SPAN
></P
></DD
><DT
><A
NAME="param-LDAPBaseDN"
></A
>LDAPBaseDN</DT
><DD
><P ><P
>objectClass: inetOrgPerson</P >The LDAPBaseDN parameter should be set to the location in
></LI your LDAP tree that you would like to search for e-mail addresses.
><LI Your uids should be unique under the DN specified here.
</P
><P ><P
>objectClass: top</P >Ex. <SPAN
></LI CLASS="QUOTE"
><LI >"ou=People,o=Company"</SPAN
></P
></DD
><DT
><A
NAME="param-LDAPuidattribute"
></A
>LDAPuidattribute</DT
><DD
><P ><P
>objectClass: posixAccount</P >The LDAPuidattribute parameter should be set to the attribute
></LI which contains the unique UID of your users. The value retrieved
><LI from this attribute will be used when attempting to bind as the
user to confirm their password.
</P
><P ><P
>objectClass: shadowAccount</P >Ex. <SPAN
></LI CLASS="QUOTE"
></OL >"uid"</SPAN
> ></P
></DD
Please note that this patch <EM ><DT
>has not</EM ><A
> yet been NAME="param-LDAPmailattribute"
accepted by the Bugzilla team, and so you may need to do some ></A
manual tweaking. That said, it looks like Net::LDAP is probably >LDAPmailattribute</DT
the way to go in the future. ><DD
><P
>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.
</P </P
><P
>Ex. <SPAN
CLASS="QUOTE"
>"mail"</SPAN
></P
></DD
></DL
></DIV
></DIV ></DIV
><DIV ><DIV
CLASS="section" CLASS="section"
...@@ -4419,13 +4524,19 @@ HREF="http://www.cet.org/tech_tips/malicious_code_mitigation.html/#3" ...@@ -4419,13 +4524,19 @@ HREF="http://www.cet.org/tech_tips/malicious_code_mitigation.html/#3"
TARGET="_top" TARGET="_top"
>http://www.cet.org/tech_tips/malicious_code_mitigation.html/#3</A >http://www.cet.org/tech_tips/malicious_code_mitigation.html/#3</A
>. >.
Executing the following code snippet from a UNIX command shell will Making the change below will fix the problem if your installation is for
rectify the problem if your Bugzilla installation is intended for an an English speaking audience.
English-speaking audience. As always, be sure your Bugzilla </P
installation has a good backup before making changes, and I recommend
you understand what the script is doing before executing it.</P
><P ><P
>&#13; <TABLE >Telling Bugzilla to output a charset as part of the HTTP header is
much easier in version 2.18 and higher (including any cvs
pull after 4-May-2003 and development release after 2.17.5) than it was
in previous versions. Simply locate the following line in
<TT
CLASS="filename"
>Bugzilla/CGI.pm</TT
>:
<TABLE
BORDER="0" BORDER="0"
BGCOLOR="#E0E0E0" BGCOLOR="#E0E0E0"
WIDTH="100%" WIDTH="100%"
...@@ -4435,38 +4546,34 @@ WIDTH="100%" ...@@ -4435,38 +4546,34 @@ WIDTH="100%"
COLOR="#000000" COLOR="#000000"
><PRE ><PRE
CLASS="programlisting" CLASS="programlisting"
>&#13;bash# perl -pi -e "s/Content-Type\: text\/html/Content-Type\: text\/html\; charset=ISO-8859-1/i" *.cgi *.pl >&#13; # Make sure that we don't send any charset headers
$self-&#62;charset('');
</PRE </PRE
></FONT ></FONT
></TD ></TD
></TR ></TR
></TABLE ></TABLE
> >
</P and change it to:
><P <TABLE
>All this one-liner command does is search for all instances of BORDER="0"
<SPAN BGCOLOR="#E0E0E0"
CLASS="QUOTE" WIDTH="100%"
>"Content-type: text/html"</SPAN ><TR
> ><TD
><FONT
and replaces it with COLOR="#000000"
<SPAN ><PRE
CLASS="QUOTE" CLASS="programlisting"
>"Content-Type: text/html; charset=ISO-8859-1"</SPAN >&#13; # Send all data using the ISO-8859-1 charset
$self-&#62;charset('ISO-8859-1');
</PRE
></FONT
></TD
></TR
></TABLE
> >
</P
. 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
<SPAN
CLASS="QUOTE"
>"ISO-8859-1"</SPAN
>, above, to
<SPAN
CLASS="QUOTE"
>"UTF-8"</SPAN
>.</P
><DIV ><DIV
CLASS="note" CLASS="note"
><P ><P
...@@ -4945,7 +5052,7 @@ COLOR="#000000" ...@@ -4945,7 +5052,7 @@ COLOR="#000000"
><PRE ><PRE
CLASS="programlisting" CLASS="programlisting"
>&#13;use Net::SMTP; >&#13;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 # Use die on error, so that the mail will be in the 'unsent mails' and
# can be sent from the sanity check page. # can be sent from the sanity check page.
...@@ -5057,110 +5164,172 @@ TARGET="_top" ...@@ -5057,110 +5164,172 @@ TARGET="_top"
>.</P >.</P
><P ><P
>Follow the instructions for setting up Fink. Once it's installed, >Follow the instructions for setting up Fink. Once it's installed,
you'll want to run the following as root: you'll want to use it to install the gd2 package.
<B
CLASS="command"
>fink install gd</B
>
</P </P
><P ><P
>It will prompt you for a number of dependencies, type 'y' and hit >It will prompt you for a number of dependencies, type 'y' and hit
enter to install all of the dependencies. Then watch it work.</P enter to install all of the dependencies and then watch it work. You will
><P then be able to use <A
>To prevent creating conflicts with the software that Apple installs HREF="#gloss-cpan"
by default, Fink creates its own directory tree at /sw where it installs ><I
most of the software that it installs. This means your libraries and CLASS="glossterm"
headers for libgd will be at /sw/lib and /sw/include instead of /usr/lib >CPAN</I
and /usr/local/include. Because of these changed locations for the ></A
libraries, the Perl GD module will not install directly via CPAN, because it > to
looks for the specific paths instead of getting them from your install the GD perl module.
environment. But there's a way around that :-)</P
><P
>Instead of typing
<SPAN
CLASS="QUOTE"
>"install GD"</SPAN
>
at the
<TT
CLASS="prompt"
>cpan&#62;</TT
>
prompt, type
<B
CLASS="command"
>look GD</B
>.
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 <A
HREF="../xml/gd-makefile.patch"
TARGET="_top"
>this patch</A
>
to the Makefile.PL file (save the
patch into a file and use the command
<B
CLASS="command"
>patch &#60; patchfile</B
>.)
</P </P
><DIV
CLASS="note"
><P ><P
>Then, run these commands to finish the installation of the GD
module:
<P
></P ></P
><TABLE ><TABLE
CLASS="note"
WIDTH="100%"
BORDER="0" BORDER="0"
><TBODY
><TR ><TR
><TD ><TD
>&#13; <B WIDTH="25"
CLASS="command" ALIGN="CENTER"
>perl Makefile.PL</B VALIGN="TOP"
> ><IMG
</TD SRC="../images/note.gif"
></TR HSPACE="5"
><TR ALT="Note"></TD
><TD ><TD
>&#13; <B ALIGN="LEFT"
CLASS="command" VALIGN="TOP"
>make</B ><P
> >To prevent creating conflicts with the software that Apple
</TD installs by default, Fink creates its own directory tree at
<TT
CLASS="filename"
>/sw</TT
> where it installs most of
the software that it installs. This means your libraries and headers be
at <TT
CLASS="filename"
>/sw/lib</TT
> and
<TT
CLASS="filename"
>/sw/include</TT
> instead of
<TT
CLASS="filename"
>/usr/lib</TT
> and
<TT
CLASS="filename"
>/usr/local/include</TT
>. When the
Perl module config script asks where your libgd is, be sure to tell it
<TT
CLASS="filename"
>/sw/lib</TT
>.
</P
></TD
></TR ></TR
></TABLE
></DIV
><P
>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:
</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR ><TR
><TD ><TD
>&#13; <B ><FONT
CLASS="command" COLOR="#000000"
>make test</B ><PRE
CLASS="screen"
>&#13;# perl -MCPAN -e'look XML::Parser' <A
NAME="macosx-look"
><IMG
SRC="../images/callouts/1.gif"
HSPACE="0"
VSPACE="0"
BORDER="0"
ALT="(1)"></A
> >
</TD # perl Makefile.PL EXPATLIBPATH=/sw/lib EXPATINCPATH=/sw/include
></TR # make; make test; make install <A
><TR NAME="macosx-make"
><TD ><IMG
>&#13; <B SRC="../images/callouts/2.gif"
CLASS="command" HSPACE="0"
>make install</B VSPACE="0"
BORDER="0"
ALT="(2)"></A
> >
</TD # exit <A
></TR NAME="macosx-exit"
><TR ><IMG
><TD SRC="../images/callouts/3.gif"
>And don't forget to run HSPACE="0"
<B VSPACE="0"
CLASS="command" BORDER="0"
>exit</B ALT="(3)"></A
> >
</PRE
to get back to CPAN.</TD ></FONT
></TD
></TR ></TR
></TBODY
></TABLE ></TABLE
><P ><DIV
></P CLASS="calloutlist"
> ><DL
</P COMPACT="COMPACT"
><DT
><A
HREF="#macosx-look"
><IMG
SRC="../images/callouts/1.gif"
HSPACE="0"
VSPACE="0"
BORDER="0"
ALT="(1)"></A
><A
HREF="#macosx-exit"
><IMG
SRC="../images/callouts/3.gif"
HSPACE="0"
VSPACE="0"
BORDER="0"
ALT="(3)"></A
></DT
><DD
>The look command will download the module and spawn a
new shell with the extracted files as the current working directory.
The exit command will return you to your original shell.
</DD
><DT
><A
HREF="#macosx-make"
><IMG
SRC="../images/callouts/2.gif"
HSPACE="0"
VSPACE="0"
BORDER="0"
ALT="(2)"></A
></DT
><DD
>You should watch the output from these make commands,
especially <SPAN
CLASS="QUOTE"
>"make test"</SPAN
> as errors may prevent XML::Parser
from functioning correctly with Bugzilla.
</DD
></DL
></DIV
></DIV ></DIV
><DIV ><DIV
CLASS="section" CLASS="section"
...@@ -5842,7 +6011,7 @@ CLASS="section" ...@@ -5842,7 +6011,7 @@ CLASS="section"
><HR><H2 ><HR><H2
CLASS="section" CLASS="section"
><A ><A
NAME="AEN1086" NAME="AEN1111"
></A ></A
>4.5.1. Bundle::Bugzilla makes me upgrade to Perl 5.6.1</H2 >4.5.1. Bundle::Bugzilla makes me upgrade to Perl 5.6.1</H2
><P ><P
...@@ -5867,7 +6036,7 @@ CLASS="section" ...@@ -5867,7 +6036,7 @@ CLASS="section"
><HR><H2 ><HR><H2
CLASS="section" CLASS="section"
><A ><A
NAME="AEN1091" NAME="AEN1116"
></A ></A
>4.5.2. DBD::Sponge::db prepare failed</H2 >4.5.2. DBD::Sponge::db prepare failed</H2
><P ><P
...@@ -7953,7 +8122,7 @@ CLASS="section" ...@@ -7953,7 +8122,7 @@ CLASS="section"
><HR><H2 ><HR><H2
CLASS="section" CLASS="section"
><A ><A
NAME="AEN1534" NAME="AEN1559"
></A ></A
>5.7.1. What to Edit</H2 >5.7.1. What to Edit</H2
><P ><P
...@@ -8068,7 +8237,7 @@ CLASS="section" ...@@ -8068,7 +8237,7 @@ CLASS="section"
><HR><H2 ><HR><H2
CLASS="section" CLASS="section"
><A ><A
NAME="AEN1553" NAME="AEN1578"
></A ></A
>5.7.2. How To Edit Templates</H2 >5.7.2. How To Edit Templates</H2
><P ><P
...@@ -8150,7 +8319,7 @@ CLASS="section" ...@@ -8150,7 +8319,7 @@ CLASS="section"
><HR><H2 ><HR><H2
CLASS="section" CLASS="section"
><A ><A
NAME="AEN1563" NAME="AEN1588"
></A ></A
>5.7.3. Template Formats</H2 >5.7.3. Template Formats</H2
><P ><P
...@@ -8212,7 +8381,7 @@ CLASS="section" ...@@ -8212,7 +8381,7 @@ CLASS="section"
><HR><H2 ><HR><H2
CLASS="section" CLASS="section"
><A ><A
NAME="AEN1576" NAME="AEN1601"
></A ></A
>5.7.4. Particular Templates</H2 >5.7.4. Particular Templates</H2
><P ><P
...@@ -8576,6 +8745,36 @@ CLASS="section" ...@@ -8576,6 +8745,36 @@ CLASS="section"
NAME="upgrading" NAME="upgrading"
></A ></A
>5.9. Upgrading to New Releases</H1 >5.9. Upgrading to New Releases</H1
><DIV
CLASS="warning"
><P
></P
><TABLE
CLASS="warning"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="../images/warning.gif"
HSPACE="5"
ALT="Warning"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>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.
</P
></TD
></TR
></TABLE
></DIV
><P ><P
>Upgrading Bugzilla is something we all want to do from time to time, >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 be it to get new features or pick up the latest security fix. How easy
...@@ -11005,7 +11204,7 @@ CLASS="answer" ...@@ -11005,7 +11204,7 @@ CLASS="answer"
You can call bug_email.pl directly from your aliases file, with You can call bug_email.pl directly from your aliases file, with
an entry like this: an entry like this:
<A <A
NAME="AEN1980" NAME="AEN2007"
></A ></A
><BLOCKQUOTE ><BLOCKQUOTE
CLASS="BLOCKQUOTE" CLASS="BLOCKQUOTE"
...@@ -11449,7 +11648,7 @@ CLASS="answer" ...@@ -11449,7 +11648,7 @@ CLASS="answer"
><P ><P
>&#13; Microsoft has some advice on this matter, as well: >&#13; Microsoft has some advice on this matter, as well:
<A <A
NAME="AEN2063" NAME="AEN2090"
></A ></A
><BLOCKQUOTE ><BLOCKQUOTE
CLASS="BLOCKQUOTE" CLASS="BLOCKQUOTE"
...@@ -12077,7 +12276,7 @@ CLASS="section" ...@@ -12077,7 +12276,7 @@ CLASS="section"
><HR><H2 ><HR><H2
CLASS="section" CLASS="section"
><A ><A
NAME="AEN2185" NAME="AEN2212"
></A ></A
>B.2.1. Bugzilla Database Basics</H2 >B.2.1. Bugzilla Database Basics</H2
><P ><P
...@@ -12191,7 +12390,7 @@ CLASS="section" ...@@ -12191,7 +12390,7 @@ CLASS="section"
><HR><H3 ><HR><H3
CLASS="section" CLASS="section"
><A ><A
NAME="AEN2212" NAME="AEN2239"
></A ></A
>B.2.1.1. Bugzilla Database Tables</H3 >B.2.1.1. Bugzilla Database Tables</H3
><P ><P
...@@ -12754,7 +12953,7 @@ NAME="gfdl" ...@@ -12754,7 +12953,7 @@ NAME="gfdl"
><P ><P
>Version 1.1, March 2000</P >Version 1.1, March 2000</P
><A ><A
NAME="AEN2300" NAME="AEN2327"
></A ></A
><BLOCKQUOTE ><BLOCKQUOTE
CLASS="BLOCKQUOTE" CLASS="BLOCKQUOTE"
...@@ -13217,7 +13416,7 @@ NAME="gfdl-howto" ...@@ -13217,7 +13416,7 @@ NAME="gfdl-howto"
of the License in the document and put the following copyright and of the License in the document and put the following copyright and
license notices just after the title page:</P license notices just after the title page:</P
><A ><A
NAME="AEN2390" NAME="AEN2417"
></A ></A
><BLOCKQUOTE ><BLOCKQUOTE
CLASS="BLOCKQUOTE" CLASS="BLOCKQUOTE"
...@@ -13254,7 +13453,7 @@ CLASS="glossdiv" ...@@ -13254,7 +13453,7 @@ CLASS="glossdiv"
><H1 ><H1
CLASS="glossdiv" CLASS="glossdiv"
><A ><A
NAME="AEN2395" NAME="AEN2422"
></A ></A
>0-9, high ascii</H1 >0-9, high ascii</H1
><DL ><DL
...@@ -13559,6 +13758,62 @@ CLASS="glossterm" ...@@ -13559,6 +13758,62 @@ CLASS="glossterm"
modules - encapsulated chunks of code for performing a modules - encapsulated chunks of code for performing a
particular task.</P particular task.</P
></DD ></DD
><DT
><A
NAME="gloss-contrib"
></A
><B
><TT
CLASS="filename"
>contrib</TT
></B
></DT
><DD
><P
>The <TT
CLASS="filename"
>contrib</TT
> 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.
<DIV
CLASS="note"
><P
></P
><TABLE
CLASS="note"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="../images/note.gif"
HSPACE="5"
ALT="Note"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>Scripts in the <TT
CLASS="filename"
>contrib</TT
>
directory are not offically supported by the Bugzilla team and may
break in between versions.
</P
></TD
></TR
></TABLE
></DIV
>
</P
></DD
></DL ></DL
></DIV ></DIV
><DIV ><DIV
...@@ -14062,7 +14317,7 @@ NAME="gloss-zarro" ...@@ -14062,7 +14317,7 @@ NAME="gloss-zarro"
Terry had the following to say: Terry had the following to say:
</P </P
><A ><A
NAME="AEN2621" NAME="AEN2657"
></A ></A
><TABLE ><TABLE
BORDER="0" BORDER="0"
......
docs/html/administration.html
View file @ d6fe6257
...@@ -180,22 +180,22 @@ HREF="cust-templates.html" ...@@ -180,22 +180,22 @@ HREF="cust-templates.html"
><DL ><DL
><DT ><DT
>5.7.1. <A >5.7.1. <A
HREF="cust-templates.html#AEN1534" HREF="cust-templates.html#AEN1559"
>What to Edit</A >What to Edit</A
></DT ></DT
><DT ><DT
>5.7.2. <A >5.7.2. <A
HREF="cust-templates.html#AEN1553" HREF="cust-templates.html#AEN1578"
>How To Edit Templates</A >How To Edit Templates</A
></DT ></DT
><DT ><DT
>5.7.3. <A >5.7.3. <A
HREF="cust-templates.html#AEN1563" HREF="cust-templates.html#AEN1588"
>Template Formats</A >Template Formats</A
></DT ></DT
><DT ><DT
>5.7.4. <A >5.7.4. <A
HREF="cust-templates.html#AEN1576" HREF="cust-templates.html#AEN1601"
>Particular Templates</A >Particular Templates</A
></DT ></DT
></DL ></DL
......
docs/html/cust-templates.html
View file @ d6fe6257
...@@ -99,7 +99,7 @@ CLASS="section" ...@@ -99,7 +99,7 @@ CLASS="section"
><H2 ><H2
CLASS="section" CLASS="section"
><A ><A
NAME="AEN1534" NAME="AEN1559"
></A ></A
>5.7.1. What to Edit</H2 >5.7.1. What to Edit</H2
><P ><P
...@@ -214,7 +214,7 @@ CLASS="section" ...@@ -214,7 +214,7 @@ CLASS="section"
><H2 ><H2
CLASS="section" CLASS="section"
><A ><A
NAME="AEN1553" NAME="AEN1578"
></A ></A
>5.7.2. How To Edit Templates</H2 >5.7.2. How To Edit Templates</H2
><P ><P
...@@ -296,7 +296,7 @@ CLASS="section" ...@@ -296,7 +296,7 @@ CLASS="section"
><H2 ><H2
CLASS="section" CLASS="section"
><A ><A
NAME="AEN1563" NAME="AEN1588"
></A ></A
>5.7.3. Template Formats</H2 >5.7.3. Template Formats</H2
><P ><P
...@@ -358,7 +358,7 @@ CLASS="section" ...@@ -358,7 +358,7 @@ CLASS="section"
><H2 ><H2
CLASS="section" CLASS="section"
><A ><A
NAME="AEN1576" NAME="AEN1601"
></A ></A
>5.7.4. Particular Templates</H2 >5.7.4. Particular Templates</H2
><P ><P
......
docs/html/dbdoc.html
View file @ d6fe6257
...@@ -135,7 +135,7 @@ CLASS="section" ...@@ -135,7 +135,7 @@ CLASS="section"
><H2 ><H2
CLASS="section" CLASS="section"
><A ><A
NAME="AEN2185" NAME="AEN2212"
></A ></A
>B.2.1. Bugzilla Database Basics</H2 >B.2.1. Bugzilla Database Basics</H2
><P ><P
...@@ -249,7 +249,7 @@ CLASS="section" ...@@ -249,7 +249,7 @@ CLASS="section"
><H3 ><H3
CLASS="section" CLASS="section"
><A ><A
NAME="AEN2212" NAME="AEN2239"
></A ></A
>B.2.1.1. Bugzilla Database Tables</H3 >B.2.1.1. Bugzilla Database Tables</H3
><P ><P
......
docs/html/extraconfig.html
View file @ d6fe6257
...@@ -296,13 +296,12 @@ CLASS="section" ...@@ -296,13 +296,12 @@ CLASS="section"
NAME="bzldap" NAME="bzldap"
></A ></A
>4.2.4. LDAP Authentication</H2 >4.2.4. LDAP Authentication</H2
><P ><DIV
>&#13; <DIV CLASS="note"
CLASS="warning"
><P ><P
></P ></P
><TABLE ><TABLE
CLASS="warning" CLASS="note"
WIDTH="100%" WIDTH="100%"
BORDER="0" BORDER="0"
><TR ><TR
...@@ -311,23 +310,32 @@ WIDTH="25" ...@@ -311,23 +310,32 @@ WIDTH="25"
ALIGN="CENTER" ALIGN="CENTER"
VALIGN="TOP" VALIGN="TOP"
><IMG ><IMG
SRC="../images/warning.gif" SRC="../images/note.gif"
HSPACE="5" HSPACE="5"
ALT="Warning"></TD ALT="Note"></TD
><TD ><TD
ALIGN="LEFT" ALIGN="LEFT"
VALIGN="TOP" VALIGN="TOP"
><P ><P
>This information on using the LDAP >LDAP authentication has been rewritten for the 2.18 release of
authentication options with Bugzilla is old, and the authors do Bugzilla. It no longer requires the Mozilla::LDAP module and now uses
not know of anyone who has tested it. Approach with caution. Net::LDAP instead. This rewrite was part of a larger landing that
allowed for additional authentication schemes to be easily added
(<A
HREF="http://bugzilla.mozilla.org/show_bug.cgi?id=180642"
TARGET="_top"
>bug
180642</A
>).
</P
><P
>This patch originally landed in 21-Mar-2003 and was included
in the 2.17.4 development release.
</P </P
></TD ></TD
></TR ></TR
></TABLE ></TABLE
></DIV ></DIV
>
</P
><P ><P
>&#13; The existing authentication >&#13; The existing authentication
scheme for Bugzilla uses email addresses as the primary user ID, and a scheme for Bugzilla uses email addresses as the primary user ID, and a
...@@ -346,92 +354,189 @@ VALIGN="TOP" ...@@ -346,92 +354,189 @@ VALIGN="TOP"
email address, not LDAP username. You still assign bugs by email email address, not LDAP username. You still assign bugs by email
address, query on users by email address, etc. address, query on users by email address, etc.
</P </P
><DIV
CLASS="caution"
><P
></P
><TABLE
CLASS="caution"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="../images/caution.gif"
HSPACE="5"
ALT="Caution"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P ><P
>Using LDAP for Bugzilla authentication requires the >Because the Bugzilla account is not created until the first time
Mozilla::LDAP (aka PerLDAP) Perl module. The a user logs in, a user who has not yet logged is unknown to Bugzilla.
Mozilla::LDAP module in turn requires Netscape's Directory SDK for C. This means they cannot be used as an assignee or QA contact (default or
After you have installed the SDK, then install the PerLDAP module. otherwise), added to any cc list, or any other such operation. One
Mozilla::LDAP and the Directory SDK for C are both possible workaround is the <TT
CLASS="filename"
>bugzilla_ldapsync.rb</TT
>
script in the
<A
HREF="glossary.html#gloss-contrib"
><I
CLASS="glossterm"
><TT
CLASS="filename"
>contrib</TT
></I
></A
> directory. Another possible solution is fixing
<A <A
HREF="http://www.mozilla.org/directory/" HREF="http://bugzilla.mozilla.org/show_bug.cgi?id=201069"
TARGET="_top" TARGET="_top"
>available for >bug
download</A 201069</A
> from mozilla.org. >.
</P </P
></TD
></TR
></TABLE
></DIV
><P
>Parameters required to use LDAP Authentication:</P
><P
></P
><DIV
CLASS="variablelist"
><DL
><DT
><A
NAME="param-loginmethod"
></A
>loginmethod</DT
><DD
><P ><P
>&#13; Set the Param 'useLDAP' to "On" **only** if you will be using an LDAP >This parameter should be set to <SPAN
directory for CLASS="QUOTE"
authentication. Be very careful when setting up this parameter; if you >"LDAP"</SPAN
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 <EM
this happens, you can get back in by manually editing the data/params >only</EM
file, and setting useLDAP back to 0.) > if you will be using an LDAP directory
for authentication. If you set this param to <SPAN
CLASS="QUOTE"
>"LDAP"</SPAN
> 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
<TT
CLASS="filename"
>data/params</TT
> and set loginmethod to
<SPAN
CLASS="QUOTE"
>"DB"</SPAN
>.
</P </P
></DD
><DT
><A
NAME="param-LDAPserver"
></A
>LDAPserver</DT
><DD
><P ><P
>If using LDAP, you must set the >This parameter should be set to the name (and optionally the
three additional parameters: Set LDAPserver to the name (and optionally port) of your LDAP server. If no port is specified, it assumes
port) of your LDAP server. If no port is specified, it defaults to the the default LDAP port of 389.
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.
</P </P
><P ><P
>You can also try using <A >Ex. <SPAN
HREF="http://www.openldap.org/" CLASS="QUOTE"
TARGET="_top" >"ldap.company.com"</SPAN
>&#13; OpenLDAP</A
> with Bugzilla, using any of a number of administration
tools. You should apply the patch attached to
<A
HREF="http://bugzilla.mozilla.org/show_bug.cgi?id=158630"
TARGET="_top"
>bug 158630</A
> >
, then set the following object classes for your users: or <SPAN
CLASS="QUOTE"
<P >"ldap.company.com:3268"</SPAN
></P >
><OL </P
TYPE="1" ></DD
><LI ><DT
><A
NAME="param-LDAPbinddn"
></A
>LDAPbinddn [Optional]</DT
><DD
><P ><P
>objectClass: person</P >Some LDAP servers will not allow an anonymous bind to search
></LI the directory. If this is the case with your configuration you
><LI should set the LDAPbinddn parameter to the user account Bugzilla
should use instead of the anonymous bind.
</P
><P ><P
>objectClass: organizationalPerson</P >Ex. <SPAN
></LI CLASS="QUOTE"
><LI >"cn=default,cn=user:password"</SPAN
></P
></DD
><DT
><A
NAME="param-LDAPBaseDN"
></A
>LDAPBaseDN</DT
><DD
><P ><P
>objectClass: inetOrgPerson</P >The LDAPBaseDN parameter should be set to the location in
></LI your LDAP tree that you would like to search for e-mail addresses.
><LI Your uids should be unique under the DN specified here.
</P
><P ><P
>objectClass: top</P >Ex. <SPAN
></LI CLASS="QUOTE"
><LI >"ou=People,o=Company"</SPAN
></P
></DD
><DT
><A
NAME="param-LDAPuidattribute"
></A
>LDAPuidattribute</DT
><DD
><P ><P
>objectClass: posixAccount</P >The LDAPuidattribute parameter should be set to the attribute
></LI which contains the unique UID of your users. The value retrieved
><LI from this attribute will be used when attempting to bind as the
user to confirm their password.
</P
><P ><P
>objectClass: shadowAccount</P >Ex. <SPAN
></LI CLASS="QUOTE"
></OL >"uid"</SPAN
> ></P
></DD
Please note that this patch <EM ><DT
>has not</EM ><A
> yet been NAME="param-LDAPmailattribute"
accepted by the Bugzilla team, and so you may need to do some ></A
manual tweaking. That said, it looks like Net::LDAP is probably >LDAPmailattribute</DT
the way to go in the future. ><DD
><P
>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.
</P </P
><P
>Ex. <SPAN
CLASS="QUOTE"
>"mail"</SPAN
></P
></DD
></DL
></DIV
></DIV ></DIV
><DIV ><DIV
CLASS="section" CLASS="section"
...@@ -452,13 +557,19 @@ HREF="http://www.cet.org/tech_tips/malicious_code_mitigation.html/#3" ...@@ -452,13 +557,19 @@ HREF="http://www.cet.org/tech_tips/malicious_code_mitigation.html/#3"
TARGET="_top" TARGET="_top"
>http://www.cet.org/tech_tips/malicious_code_mitigation.html/#3</A >http://www.cet.org/tech_tips/malicious_code_mitigation.html/#3</A
>. >.
Executing the following code snippet from a UNIX command shell will Making the change below will fix the problem if your installation is for
rectify the problem if your Bugzilla installation is intended for an an English speaking audience.
English-speaking audience. As always, be sure your Bugzilla </P
installation has a good backup before making changes, and I recommend
you understand what the script is doing before executing it.</P
><P ><P
>&#13; <TABLE >Telling Bugzilla to output a charset as part of the HTTP header is
much easier in version 2.18 and higher (including any cvs
pull after 4-May-2003 and development release after 2.17.5) than it was
in previous versions. Simply locate the following line in
<TT
CLASS="filename"
>Bugzilla/CGI.pm</TT
>:
<TABLE
BORDER="0" BORDER="0"
BGCOLOR="#E0E0E0" BGCOLOR="#E0E0E0"
WIDTH="100%" WIDTH="100%"
...@@ -468,38 +579,34 @@ WIDTH="100%" ...@@ -468,38 +579,34 @@ WIDTH="100%"
COLOR="#000000" COLOR="#000000"
><PRE ><PRE
CLASS="programlisting" CLASS="programlisting"
>&#13;bash# perl -pi -e "s/Content-Type\: text\/html/Content-Type\: text\/html\; charset=ISO-8859-1/i" *.cgi *.pl >&#13; # Make sure that we don't send any charset headers
$self-&#62;charset('');
</PRE </PRE
></FONT ></FONT
></TD ></TD
></TR ></TR
></TABLE ></TABLE
> >
</P and change it to:
><P <TABLE
>All this one-liner command does is search for all instances of BORDER="0"
<SPAN BGCOLOR="#E0E0E0"
CLASS="QUOTE" WIDTH="100%"
>"Content-type: text/html"</SPAN ><TR
> ><TD
><FONT
and replaces it with COLOR="#000000"
<SPAN ><PRE
CLASS="QUOTE" CLASS="programlisting"
>"Content-Type: text/html; charset=ISO-8859-1"</SPAN >&#13; # Send all data using the ISO-8859-1 charset
$self-&#62;charset('ISO-8859-1');
</PRE
></FONT
></TD
></TR
></TABLE
> >
</P
. 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
<SPAN
CLASS="QUOTE"
>"ISO-8859-1"</SPAN
>, above, to
<SPAN
CLASS="QUOTE"
>"UTF-8"</SPAN
>.</P
><DIV ><DIV
CLASS="note" CLASS="note"
><P ><P
......
docs/html/faq.html
View file @ d6fe6257
...@@ -1879,7 +1879,7 @@ CLASS="answer" ...@@ -1879,7 +1879,7 @@ CLASS="answer"
You can call bug_email.pl directly from your aliases file, with You can call bug_email.pl directly from your aliases file, with
an entry like this: an entry like this:
<A <A
NAME="AEN1980" NAME="AEN2007"
></A ></A
><BLOCKQUOTE ><BLOCKQUOTE
CLASS="BLOCKQUOTE" CLASS="BLOCKQUOTE"
...@@ -2323,7 +2323,7 @@ CLASS="answer" ...@@ -2323,7 +2323,7 @@ CLASS="answer"
><P ><P
>&#13; Microsoft has some advice on this matter, as well: >&#13; Microsoft has some advice on this matter, as well:
<A <A
NAME="AEN2063" NAME="AEN2090"
></A ></A
><BLOCKQUOTE ><BLOCKQUOTE
CLASS="BLOCKQUOTE" CLASS="BLOCKQUOTE"
......
docs/html/gfdl-howto.html
View file @ d6fe6257
...@@ -81,7 +81,7 @@ NAME="gfdl-howto" ...@@ -81,7 +81,7 @@ NAME="gfdl-howto"
of the License in the document and put the following copyright and of the License in the document and put the following copyright and
license notices just after the title page:</P license notices just after the title page:</P
><A ><A
NAME="AEN2390" NAME="AEN2417"
></A ></A
><BLOCKQUOTE ><BLOCKQUOTE
CLASS="BLOCKQUOTE" CLASS="BLOCKQUOTE"
......
docs/html/gfdl.html
View file @ d6fe6257
...@@ -144,7 +144,7 @@ HREF="gfdl-howto.html" ...@@ -144,7 +144,7 @@ HREF="gfdl-howto.html"
><P ><P
>Version 1.1, March 2000</P >Version 1.1, March 2000</P
><A ><A
NAME="AEN2300" NAME="AEN2327"
></A ></A
><BLOCKQUOTE ><BLOCKQUOTE
CLASS="BLOCKQUOTE" CLASS="BLOCKQUOTE"
......
docs/html/glossary.html
View file @ d6fe6257
...@@ -70,7 +70,7 @@ CLASS="glossdiv" ...@@ -70,7 +70,7 @@ CLASS="glossdiv"
><H1 ><H1
CLASS="glossdiv" CLASS="glossdiv"
><A ><A
NAME="AEN2395" NAME="AEN2422"
></A ></A
>0-9, high ascii</H1 >0-9, high ascii</H1
><DL ><DL
...@@ -375,6 +375,62 @@ CLASS="glossterm" ...@@ -375,6 +375,62 @@ CLASS="glossterm"
modules - encapsulated chunks of code for performing a modules - encapsulated chunks of code for performing a
particular task.</P particular task.</P
></DD ></DD
><DT
><A
NAME="gloss-contrib"
></A
><B
><TT
CLASS="filename"
>contrib</TT
></B
></DT
><DD
><P
>The <TT
CLASS="filename"
>contrib</TT
> 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.
<DIV
CLASS="note"
><P
></P
><TABLE
CLASS="note"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="../images/note.gif"
HSPACE="5"
ALT="Note"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>Scripts in the <TT
CLASS="filename"
>contrib</TT
>
directory are not offically supported by the Bugzilla team and may
break in between versions.
</P
></TD
></TR
></TABLE
></DIV
>
</P
></DD
></DL ></DL
></DIV ></DIV
><DIV ><DIV
...@@ -878,7 +934,7 @@ NAME="gloss-zarro" ...@@ -878,7 +934,7 @@ NAME="gloss-zarro"
Terry had the following to say: Terry had the following to say:
</P </P
><A ><A
NAME="AEN2621" NAME="AEN2657"
></A ></A
><TABLE ><TABLE
BORDER="0" BORDER="0"
......
docs/html/installation.html
View file @ d6fe6257
...@@ -258,12 +258,12 @@ HREF="troubleshooting.html" ...@@ -258,12 +258,12 @@ HREF="troubleshooting.html"
><DL ><DL
><DT ><DT
>4.5.1. <A >4.5.1. <A
HREF="troubleshooting.html#AEN1086" HREF="troubleshooting.html#AEN1111"
>Bundle::Bugzilla makes me upgrade to Perl 5.6.1</A >Bundle::Bugzilla makes me upgrade to Perl 5.6.1</A
></DT ></DT
><DT ><DT
>4.5.2. <A >4.5.2. <A
HREF="troubleshooting.html#AEN1091" HREF="troubleshooting.html#AEN1116"
>DBD::Sponge::db prepare failed</A >DBD::Sponge::db prepare failed</A
></DT ></DT
><DT ><DT
......
docs/html/os-specific.html
View file @ d6fe6257
...@@ -414,7 +414,7 @@ COLOR="#000000" ...@@ -414,7 +414,7 @@ COLOR="#000000"
><PRE ><PRE
CLASS="programlisting" CLASS="programlisting"
>&#13;use Net::SMTP; >&#13;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 # Use die on error, so that the mail will be in the 'unsent mails' and
# can be sent from the sanity check page. # can be sent from the sanity check page.
...@@ -526,110 +526,172 @@ TARGET="_top" ...@@ -526,110 +526,172 @@ TARGET="_top"
>.</P >.</P
><P ><P
>Follow the instructions for setting up Fink. Once it's installed, >Follow the instructions for setting up Fink. Once it's installed,
you'll want to run the following as root: you'll want to use it to install the gd2 package.
<B
CLASS="command"
>fink install gd</B
>
</P </P
><P ><P
>It will prompt you for a number of dependencies, type 'y' and hit >It will prompt you for a number of dependencies, type 'y' and hit
enter to install all of the dependencies. Then watch it work.</P enter to install all of the dependencies and then watch it work. You will
><P then be able to use <A
>To prevent creating conflicts with the software that Apple installs HREF="glossary.html#gloss-cpan"
by default, Fink creates its own directory tree at /sw where it installs ><I
most of the software that it installs. This means your libraries and CLASS="glossterm"
headers for libgd will be at /sw/lib and /sw/include instead of /usr/lib >CPAN</I
and /usr/local/include. Because of these changed locations for the ></A
libraries, the Perl GD module will not install directly via CPAN, because it > to
looks for the specific paths instead of getting them from your install the GD perl module.
environment. But there's a way around that :-)</P
><P
>Instead of typing
<SPAN
CLASS="QUOTE"
>"install GD"</SPAN
>
at the
<TT
CLASS="prompt"
>cpan&#62;</TT
>
prompt, type
<B
CLASS="command"
>look GD</B
>.
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 <A
HREF="../xml/gd-makefile.patch"
TARGET="_top"
>this patch</A
>
to the Makefile.PL file (save the
patch into a file and use the command
<B
CLASS="command"
>patch &#60; patchfile</B
>.)
</P </P
><DIV
CLASS="note"
><P ><P
>Then, run these commands to finish the installation of the GD
module:
<P
></P ></P
><TABLE ><TABLE
CLASS="note"
WIDTH="100%"
BORDER="0" BORDER="0"
><TBODY
><TR ><TR
><TD ><TD
>&#13; <B WIDTH="25"
CLASS="command" ALIGN="CENTER"
>perl Makefile.PL</B VALIGN="TOP"
> ><IMG
</TD SRC="../images/note.gif"
></TR HSPACE="5"
><TR ALT="Note"></TD
><TD ><TD
>&#13; <B ALIGN="LEFT"
CLASS="command" VALIGN="TOP"
>make</B ><P
> >To prevent creating conflicts with the software that Apple
</TD installs by default, Fink creates its own directory tree at
<TT
CLASS="filename"
>/sw</TT
> where it installs most of
the software that it installs. This means your libraries and headers be
at <TT
CLASS="filename"
>/sw/lib</TT
> and
<TT
CLASS="filename"
>/sw/include</TT
> instead of
<TT
CLASS="filename"
>/usr/lib</TT
> and
<TT
CLASS="filename"
>/usr/local/include</TT
>. When the
Perl module config script asks where your libgd is, be sure to tell it
<TT
CLASS="filename"
>/sw/lib</TT
>.
</P
></TD
></TR ></TR
></TABLE
></DIV
><P
>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:
</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR ><TR
><TD ><TD
>&#13; <B ><FONT
CLASS="command" COLOR="#000000"
>make test</B ><PRE
CLASS="screen"
>&#13;# perl -MCPAN -e'look XML::Parser' <A
NAME="macosx-look"
><IMG
SRC="../images/callouts/1.gif"
HSPACE="0"
VSPACE="0"
BORDER="0"
ALT="(1)"></A
> >
</TD # perl Makefile.PL EXPATLIBPATH=/sw/lib EXPATINCPATH=/sw/include
></TR # make; make test; make install <A
><TR NAME="macosx-make"
><TD ><IMG
>&#13; <B SRC="../images/callouts/2.gif"
CLASS="command" HSPACE="0"
>make install</B VSPACE="0"
BORDER="0"
ALT="(2)"></A
> >
</TD # exit <A
></TR NAME="macosx-exit"
><TR ><IMG
><TD SRC="../images/callouts/3.gif"
>And don't forget to run HSPACE="0"
<B VSPACE="0"
CLASS="command" BORDER="0"
>exit</B ALT="(3)"></A
> >
</PRE
to get back to CPAN.</TD ></FONT
></TD
></TR ></TR
></TBODY
></TABLE ></TABLE
><P ><DIV
></P CLASS="calloutlist"
> ><DL
</P COMPACT="COMPACT"
><DT
><A
HREF="os-specific.html#macosx-look"
><IMG
SRC="../images/callouts/1.gif"
HSPACE="0"
VSPACE="0"
BORDER="0"
ALT="(1)"></A
><A
HREF="os-specific.html#macosx-exit"
><IMG
SRC="../images/callouts/3.gif"
HSPACE="0"
VSPACE="0"
BORDER="0"
ALT="(3)"></A
></DT
><DD
>The look command will download the module and spawn a
new shell with the extracted files as the current working directory.
The exit command will return you to your original shell.
</DD
><DT
><A
HREF="os-specific.html#macosx-make"
><IMG
SRC="../images/callouts/2.gif"
HSPACE="0"
VSPACE="0"
BORDER="0"
ALT="(2)"></A
></DT
><DD
>You should watch the output from these make commands,
especially <SPAN
CLASS="QUOTE"
>"make test"</SPAN
> as errors may prevent XML::Parser
from functioning correctly with Bugzilla.
</DD
></DL
></DIV
></DIV ></DIV
><DIV ><DIV
CLASS="section" CLASS="section"
......
docs/html/troubleshooting.html
View file @ d6fe6257
...@@ -85,7 +85,7 @@ CLASS="section" ...@@ -85,7 +85,7 @@ CLASS="section"
><H2 ><H2
CLASS="section" CLASS="section"
><A ><A
NAME="AEN1086" NAME="AEN1111"
></A ></A
>4.5.1. Bundle::Bugzilla makes me upgrade to Perl 5.6.1</H2 >4.5.1. Bundle::Bugzilla makes me upgrade to Perl 5.6.1</H2
><P ><P
...@@ -110,7 +110,7 @@ CLASS="section" ...@@ -110,7 +110,7 @@ CLASS="section"
><H2 ><H2
CLASS="section" CLASS="section"
><A ><A
NAME="AEN1091" NAME="AEN1116"
></A ></A
>4.5.2. DBD::Sponge::db prepare failed</H2 >4.5.2. DBD::Sponge::db prepare failed</H2
><P ><P
......
docs/html/upgrading.html
View file @ d6fe6257
...@@ -76,6 +76,36 @@ CLASS="section" ...@@ -76,6 +76,36 @@ CLASS="section"
NAME="upgrading" NAME="upgrading"
></A ></A
>5.9. Upgrading to New Releases</H1 >5.9. Upgrading to New Releases</H1
><DIV
CLASS="warning"
><P
></P
><TABLE
CLASS="warning"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="../images/warning.gif"
HSPACE="5"
ALT="Warning"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>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.
</P
></TD
></TR
></TABLE
></DIV
><P ><P
>Upgrading Bugzilla is something we all want to do from time to time, >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 be it to get new features or pick up the latest security fix. How easy
......
docs/txt/Bugzilla-Guide.txt
View file @ d6fe6257
...@@ -1251,11 +1251,16 @@ bash# ./checksetup.pl ...@@ -1251,11 +1251,16 @@ bash# ./checksetup.pl
4.2.4. LDAP Authentication 4.2.4. LDAP Authentication
Warning Note
This information on using the LDAP authentication options with LDAP authentication has been rewritten for the 2.18 release of
Bugzilla is old, and the authors do not know of anyone who has tested Bugzilla. It no longer requires the Mozilla::LDAP module and now uses
it. Approach with caution. 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 The existing authentication scheme for Bugzilla uses email addresses
as the primary user ID, and a password to authenticate that user. All as the primary user ID, and a password to authenticate that user. All
...@@ -1273,43 +1278,61 @@ bash# ./checksetup.pl ...@@ -1273,43 +1278,61 @@ bash# ./checksetup.pl
tasks are still handled by email address, not LDAP username. You still tasks are still handled by email address, not LDAP username. You still
assign bugs by email address, query on users by email address, etc. assign bugs by email address, query on users by email address, etc.
Using LDAP for Bugzilla authentication requires the Mozilla::LDAP (aka Caution
PerLDAP) Perl module. The Mozilla::LDAP module in turn requires
Netscape's Directory SDK for C. After you have installed the SDK, then Because the Bugzilla account is not created until the first time a
install the PerLDAP module. Mozilla::LDAP and the Directory SDK for C user logs in, a user who has not yet logged is unknown to Bugzilla.
are both available for download from mozilla.org. This means they cannot be used as an assignee or QA contact (default
or otherwise), added to any cc list, or any other such operation. One
Set the Param 'useLDAP' to "On" **only** if you will be using an LDAP possible workaround is the bugzilla_ldapsync.rb script in the contrib
directory for authentication. Be very careful when setting up this directory. Another possible solution is fixing bug 201069.
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 Parameters required to use LDAP Authentication:
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.) loginmethod
This parameter should be set to "LDAP" only if you will be
If using LDAP, you must set the three additional parameters: Set using an LDAP directory for authentication. If you set this
LDAPserver to the name (and optionally port) of your LDAP server. If param to "LDAP" but fail to set up the other parameters listed
no port is specified, it defaults to the default port of 389. (e.g below you will not be able to log back in to Bugzilla one you
"ldap.mycompany.com" or "ldap.mycompany.com:1234") Set LDAPBaseDN to log out. If this happens to you, you will need to manually edit
the base DN for searching for users in your LDAP directory. (e.g. data/params and set loginmethod to "DB".
"ou=People,o=MyCompany") uids must be unique under the DN specified
here. Set LDAPmailattribute to the name of the attribute in your LDAP LDAPserver
directory which contains the primary email address. On most directory This parameter should be set to the name (and optionally the
servers available, this is "mail", but you may need to change this. port) of your LDAP server. If no port is specified, it assumes
the default LDAP port of 389.
You can also try using OpenLDAP with Bugzilla, using any of a number
of administration tools. You should apply the patch attached to bug Ex. "ldap.company.com" or "ldap.company.com:3268"
158630 , then set the following object classes for your users:
LDAPbinddn [Optional]
1. objectClass: person Some LDAP servers will not allow an anonymous bind to search
2. objectClass: organizationalPerson the directory. If this is the case with your configuration you
3. objectClass: inetOrgPerson should set the LDAPbinddn parameter to the user account
4. objectClass: top Bugzilla should use instead of the anonymous bind.
5. objectClass: posixAccount
6. objectClass: shadowAccount Ex. "cn=default,cn=user:password"
Please note that this patch has not yet been accepted by the Bugzilla LDAPBaseDN
team, and so you may need to do some manual tweaking. That said, it The LDAPBaseDN parameter should be set to the location in your
looks like Net::LDAP is probably the way to go in the future. 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"
LDAPuidattribute
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"
LDAPmailattribute
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"
_________________________________________________________________ _________________________________________________________________
4.2.5. Preventing untrusted Bugzilla content from executing malicious 4.2.5. Preventing untrusted Bugzilla content from executing malicious
...@@ -1319,22 +1342,21 @@ Javascript code ...@@ -1319,22 +1342,21 @@ Javascript code
Due to internationalization concerns, we are unable to incorporate the Due to internationalization concerns, we are unable to incorporate the
code changes necessary to fulfill the CERT advisory requirements code changes necessary to fulfill the CERT advisory requirements
mentioned in mentioned in
http://www.cet.org/tech_tips/malicious_code_mitigation.html/#3. http://www.cet.org/tech_tips/malicious_code_mitigation.html/#3. Making
Executing the following code snippet from a UNIX command shell will the change below will fix the problem if your installation is for an
rectify the problem if your Bugzilla installation is intended for an English speaking audience.
English-speaking audience. As always, be sure your Bugzilla
installation has a good backup before making changes, and I recommend Telling Bugzilla to output a charset as part of the HTTP header is
you understand what the script is doing before executing it. much easier in version 2.18 and higher (including any cvs pull after
4-May-2003 and development release after 2.17.5) than it was in
bash# perl -pi -e "s/Content-Type\: text\/html/Content-Type\: text\/html\; char previous versions. Simply locate the following line in
set=ISO-8859-1/i" *.cgi *.pl Bugzilla/CGI.pm:
# Make sure that we don't send any charset headers
All this one-liner command does is search for all instances of $self->charset('');
"Content-type: text/html" and replaces it with "Content-Type:
text/html; charset=ISO-8859-1" . This specification prevents possible and change it to:
Javascript attacks on the browser, and is suggested for all # Send all data using the ISO-8859-1 charset
English-speaking sites. For non-English-speaking Bugzilla sites, I $self->charset('ISO-8859-1');
suggest changing "ISO-8859-1", above, to "UTF-8".
Note Note
...@@ -1464,7 +1486,7 @@ close SENDMAIL; ...@@ -1464,7 +1486,7 @@ close SENDMAIL;
to to
use Net::SMTP; 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 # Use die on error, so that the mail will be in the 'unsent mails' and
# can be sent from the sanity check page. # can be sent from the sanity check page.
...@@ -1510,33 +1532,39 @@ $smtp->quit; ...@@ -1510,33 +1532,39 @@ $smtp->quit;
http://sourceforge.net/projects/fink/. http://sourceforge.net/projects/fink/.
Follow the instructions for setting up Fink. Once it's installed, 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 It will prompt you for a number of dependencies, type 'y' and hit
enter to install all of the dependencies. Then watch it work. 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.
Note
To prevent creating conflicts with the software that Apple installs by To prevent creating conflicts with the software that Apple installs by
default, Fink creates its own directory tree at /sw where it installs default, Fink creates its own directory tree at /sw where it installs
most of the software that it installs. This means your libraries and 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 headers be at /sw/lib and /sw/include instead of /usr/lib and
/usr/lib and /usr/local/include. Because of these changed locations /usr/local/include. When the Perl module config script asks where your
for the libraries, the Perl GD module will not install directly via libgd is, be sure to tell it /sw/lib.
CPAN, because it looks for the specific paths instead of getting them
from your environment. But there's a way around that :-) 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.
Instead of typing "install GD" at the cpan> prompt, type look GD. This There is one caveat. Unlike recent versions of the GD module,
should go through the motions of downloading the latest version of the XML::Parser doesn't prompt for the location of the required libraries.
GD module, then it will open a shell and drop you into the build When using CPAN, you will need to use the following command sequence:
directory. Apply this patch to the Makefile.PL file (save the patch # perl -MCPAN -e'look XML::Parser' (1)
into a file and use the command patch < patchfile.) # perl Makefile.PL EXPATLIBPATH=/sw/lib EXPATINCPATH=/sw/include
# make; make test; make install (2)
Then, run these commands to finish the installation of the GD module: # exit (3)
perl Makefile.PL (1) (3)
make The look command will download the module and spawn a new shell
make test with the extracted files as the current working directory. The
make install exit command will return you to your original shell.
And don't forget to run exit to get back to CPAN. (2)
You should watch the output from these make commands,
especially "make test" as errors may prevent XML::Parser from
functioning correctly with Bugzilla.
_________________________________________________________________ _________________________________________________________________
4.3.3. Linux-Mandrake 8.0 4.3.3. Linux-Mandrake 8.0
...@@ -2659,6 +2687,13 @@ skip-networking ...@@ -2659,6 +2687,13 @@ skip-networking
5.9. Upgrading to New Releases 5.9. Upgrading to New Releases
Warning
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, 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 be it to get new features or pick up the latest security fix. How easy
it is to update depends on a few factors. it is to update depends on a few factors.
...@@ -4553,6 +4588,19 @@ C ...@@ -4553,6 +4588,19 @@ C
maintains a large number of extremely useful Perl modules - maintains a large number of extremely useful Perl modules -
encapsulated chunks of code for performing a particular task. encapsulated chunks of code for performing a particular task.
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.
Note
Scripts in the contrib directory are not offically supported by the
Bugzilla team and may break in between versions.
D D
daemon daemon
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment