7573dc0eaf
./images so we don't have multiple copies of the same image, fixed these doc bugs (in no particular order): 94949 97070 97071 97114 96498 95970 96677 94953 96501 96679 97068 97191 97192 git-svn-id: svn://10.0.0.236/trunk@101950 18797224-902f-48f8-a5cc-f745e15eee43
1634 lines
30 KiB
HTML
1634 lines
30 KiB
HTML
<HTML
|
|
><HEAD
|
|
><TITLE
|
|
>Win32 Installation Notes</TITLE
|
|
><META
|
|
NAME="GENERATOR"
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
|
|
"><LINK
|
|
REL="HOME"
|
|
TITLE="The Bugzilla Guide"
|
|
HREF="index.html"><LINK
|
|
REL="UP"
|
|
TITLE="Installation"
|
|
HREF="installation.html"><LINK
|
|
REL="PREVIOUS"
|
|
TITLE="Installation General Notes"
|
|
HREF="geninstall.html"><LINK
|
|
REL="NEXT"
|
|
TITLE="Administering Bugzilla"
|
|
HREF="administration.html"></HEAD
|
|
><BODY
|
|
CLASS="SECTION"
|
|
BGCOLOR="#FFFFFF"
|
|
TEXT="#000000"
|
|
LINK="#0000FF"
|
|
VLINK="#840084"
|
|
ALINK="#0000FF"
|
|
><DIV
|
|
CLASS="NAVHEADER"
|
|
><TABLE
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TH
|
|
COLSPAN="3"
|
|
ALIGN="center"
|
|
>The Bugzilla Guide</TH
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="left"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="geninstall.html"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="center"
|
|
VALIGN="bottom"
|
|
>Chapter 3. Installation</TD
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="right"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="administration.html"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"></DIV
|
|
><DIV
|
|
CLASS="SECTION"
|
|
><H1
|
|
CLASS="SECTION"
|
|
><A
|
|
NAME="WIN32"
|
|
>3.6. Win32 Installation Notes</A
|
|
></H1
|
|
><P
|
|
>This section covers installation on Microsoft Windows 95,
|
|
98, ME, NT, and 2000. Bugzilla works fine on Win32 platforms,
|
|
but please remember that the Bugzilla team and the author of the
|
|
Guide neither endorse nor support installation on Microsoft
|
|
Windows. Bugzilla installs and runs <EM
|
|
>best</EM
|
|
>
|
|
and <EM
|
|
>easiest</EM
|
|
> on UNIX-like operating systems,
|
|
and that is the way it will stay for the foreseeable future. The
|
|
Bugzilla team is considering supporting Win32 for the 2.16
|
|
release and later.</P
|
|
><P
|
|
>The easiest way to install Bugzilla on Intel-archiecture
|
|
machines is to install some variant of GNU/Linux, then follow
|
|
the UNIX installation instructions in this Guide. If you have
|
|
any influence in the platform choice for running this system,
|
|
please choose GNU/Linux instead of Microsoft Windows.</P
|
|
><DIV
|
|
CLASS="SECTION"
|
|
><H2
|
|
CLASS="SECTION"
|
|
><A
|
|
NAME="WININSTALL"
|
|
>3.6.1. Win32 Installation: Step-by-step</A
|
|
></H2
|
|
><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
|
|
> You should be familiar with, and cross-reference, the rest
|
|
of the
|
|
<A
|
|
HREF="installation.html"
|
|
>Bugzilla Installation</A
|
|
> section while performing your
|
|
Win32 installation.
|
|
</P
|
|
><P
|
|
> Making Bugzilla work on Microsoft Windows is no
|
|
picnic. Support for Win32 has improved dramatically in the
|
|
last few releases, but, if you choose to proceed, you should
|
|
be a <EM
|
|
>very</EM
|
|
> skilled Windows Systems
|
|
Administrator with strong troubleshooting abilities, a high
|
|
tolerance for pain, and moderate perl skills. Bugzilla on NT
|
|
requires hacking source code and implementing some advanced
|
|
utilities. What follows is the recommended installation
|
|
procedure for Win32; additional suggestions are provided in
|
|
<A
|
|
HREF="faq.html"
|
|
>Appendix A</A
|
|
>.
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
><DIV
|
|
CLASS="PROCEDURE"
|
|
><OL
|
|
TYPE="1"
|
|
><LI
|
|
><P
|
|
> Install <A
|
|
HREF="http://www.apache.org/"
|
|
TARGET="_top"
|
|
>Apache Web
|
|
Server</A
|
|
> for Windows, and copy the Bugzilla files
|
|
somewhere Apache can serve them. Please follow all the
|
|
instructions referenced in <A
|
|
HREF="installation.html"
|
|
>Bugzilla Installation</A
|
|
>
|
|
regarding your Apache configuration, particularly
|
|
instructions regarding the <SPAN
|
|
CLASS="QUOTE"
|
|
>"AddHandler"</SPAN
|
|
>
|
|
parameter and <SPAN
|
|
CLASS="QUOTE"
|
|
>"ExecCGI"</SPAN
|
|
>.
|
|
</P
|
|
><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
|
|
> You may also use Internet Information Server or Personal
|
|
Web Server for this purpose. However, setup is quite
|
|
different. If ActivePerl doesn't seem to handle your
|
|
file associations correctly (for .cgi and .pl files),
|
|
please consult <A
|
|
HREF="faq.html"
|
|
>Appendix A</A
|
|
>.
|
|
</P
|
|
><P
|
|
> If you are going to use IIS, if on Windows NT you must
|
|
be updated to at least Service Pack 4. Windows 2000
|
|
ships with a sufficient version of IIS.
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></LI
|
|
><LI
|
|
><P
|
|
> Install <A
|
|
HREF="http://www.activestate.com/"
|
|
TARGET="_top"
|
|
>ActivePerl</A
|
|
> for Windows. Check <A
|
|
HREF="http://aspn.activestate.com/ASPN/Downloads/ActivePerl/"
|
|
TARGET="_top"
|
|
>http://aspn.activestate.com/ASPN/Downloads/ActivePerl</A
|
|
> for a current compiled binary.
|
|
</P
|
|
><P
|
|
> Please also check the following links to fully understand the status
|
|
of ActivePerl on Win32:
|
|
<A
|
|
HREF="http://language.perl.com/newdocs/pod/perlport.html"
|
|
TARGET="_top"
|
|
> Perl Porting</A
|
|
>, and
|
|
<A
|
|
HREF="http://ftp.univie.ac.at/packages/perl/ports/nt/FAQ/perlwin32faq5.html"
|
|
TARGET="_top"
|
|
> Perl on Win32 FAQ</A
|
|
>
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> Use ppm from your perl\bin directory to install the following packs: DBI,
|
|
DBD-Mysql, TimeDate, Chart, Date-Calc, Date-Manip, and GD. You may need
|
|
to extract them from .zip format using Winzip or other unzip program first.
|
|
These additional ppm modules can be downloaded from ActiveState.
|
|
</P
|
|
><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
|
|
> You can find a list of modules at
|
|
<A
|
|
HREF="http://www.activestate.com/PPMPackages/zips/5xx-builds-only"
|
|
TARGET="_top"
|
|
> http://www.activestate.com/PPMPackages/zips/5xx-builds-only/</A
|
|
>
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
><P
|
|
> The syntax for ppm is:
|
|
<TT
|
|
CLASS="COMPUTEROUTPUT"
|
|
> <TT
|
|
CLASS="PROMPT"
|
|
>C:> </TT
|
|
><B
|
|
CLASS="COMMAND"
|
|
>ppm <modulename></B
|
|
>
|
|
</TT
|
|
>
|
|
</P
|
|
><DIV
|
|
CLASS="EXAMPLE"
|
|
><A
|
|
NAME="AEN1038"
|
|
></A
|
|
><P
|
|
><B
|
|
>Example 3-3. Installing ActivePerl ppd Modules on Microsoft Windows</B
|
|
></P
|
|
><P
|
|
><TT
|
|
CLASS="PROMPT"
|
|
>C:></TT
|
|
><B
|
|
CLASS="COMMAND"
|
|
>ppm
|
|
<TT
|
|
CLASS="OPTION"
|
|
>DBD-Mysql</TT
|
|
></B
|
|
></P
|
|
><P
|
|
>Watch your capitalization!</P
|
|
></DIV
|
|
><P
|
|
> You can find ActiveState ppm modules at
|
|
<A
|
|
HREF="http://www.activestate.com/PPMPackages/5.6plus/"
|
|
TARGET="_top"
|
|
> http://www.activestate.com/PPMPackages/5.6plus</A
|
|
>
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> Install MySQL for NT.
|
|
<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
|
|
> You can download MySQL for Windows NT from <A
|
|
HREF="http://www.mysql.com/"
|
|
TARGET="_top"
|
|
>MySQL.com</A
|
|
>. Some find it helpful to use the WinMySqlAdmin utility, included with the download, to set up the database.
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
>
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> Setup MySQL
|
|
</P
|
|
><OL
|
|
CLASS="SUBSTEPS"
|
|
TYPE="a"
|
|
><LI
|
|
><P
|
|
> <TT
|
|
CLASS="COMPUTEROUTPUT"
|
|
> <TT
|
|
CLASS="PROMPT"
|
|
>C:> </TT
|
|
>
|
|
<B
|
|
CLASS="COMMAND"
|
|
>C:\mysql\bin\mysql -u root mysql</B
|
|
>
|
|
</TT
|
|
>
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> <TT
|
|
CLASS="COMPUTEROUTPUT"
|
|
> <TT
|
|
CLASS="PROMPT"
|
|
>mysql></TT
|
|
>
|
|
<B
|
|
CLASS="COMMAND"
|
|
>DELETE FROM user WHERE Host='localhost' AND User='';</B
|
|
>
|
|
</TT
|
|
>
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> <TT
|
|
CLASS="COMPUTEROUTPUT"
|
|
> <TT
|
|
CLASS="PROMPT"
|
|
>mysql></TT
|
|
>
|
|
<B
|
|
CLASS="COMMAND"
|
|
>UPDATE user SET Password=PASSWORD ('new_password')
|
|
WHERE user='root';</B
|
|
>
|
|
</TT
|
|
>
|
|
</P
|
|
><P
|
|
><SPAN
|
|
CLASS="QUOTE"
|
|
>"new_password"</SPAN
|
|
>, above, indicates
|
|
whatever password you wish to use for your
|
|
<SPAN
|
|
CLASS="QUOTE"
|
|
>"root"</SPAN
|
|
> user.</P
|
|
></LI
|
|
><LI
|
|
><A
|
|
NAME="NTBUGS-PASSWORD"
|
|
></A
|
|
><P
|
|
> <TT
|
|
CLASS="COMPUTEROUTPUT"
|
|
> <TT
|
|
CLASS="PROMPT"
|
|
>mysql></TT
|
|
>
|
|
<B
|
|
CLASS="COMMAND"
|
|
>GRANT SELECT, INSERT, UPDATE, DELETE,
|
|
INDEX, ALTER, CREATE, DROP, REFERENCES
|
|
ON bugs.* to bugs@localhost
|
|
IDENTIFIED BY 'bugs_password';</B
|
|
>
|
|
</TT
|
|
>
|
|
</P
|
|
><P
|
|
><SPAN
|
|
CLASS="QUOTE"
|
|
>"bugs_password"</SPAN
|
|
>, above, indicates
|
|
whatever password you wish to use for your
|
|
<SPAN
|
|
CLASS="QUOTE"
|
|
>"bugs"</SPAN
|
|
> user.</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> <TT
|
|
CLASS="COMPUTEROUTPUT"
|
|
> <TT
|
|
CLASS="PROMPT"
|
|
>mysql></TT
|
|
>
|
|
<B
|
|
CLASS="COMMAND"
|
|
>FLUSH PRIVILEGES;</B
|
|
>
|
|
</TT
|
|
>
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> <TT
|
|
CLASS="COMPUTEROUTPUT"
|
|
> <TT
|
|
CLASS="PROMPT"
|
|
>mysql></TT
|
|
>
|
|
<B
|
|
CLASS="COMMAND"
|
|
>create database bugs;</B
|
|
>
|
|
</TT
|
|
>
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> <TT
|
|
CLASS="COMPUTEROUTPUT"
|
|
> <TT
|
|
CLASS="PROMPT"
|
|
>mysql></TT
|
|
>
|
|
<B
|
|
CLASS="COMMAND"
|
|
>exit;</B
|
|
>
|
|
</TT
|
|
>
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> <TT
|
|
CLASS="COMPUTEROUTPUT"
|
|
> <TT
|
|
CLASS="PROMPT"
|
|
>C:></TT
|
|
>
|
|
<B
|
|
CLASS="COMMAND"
|
|
>C:\mysql\bin\mysqladmin -u root -p reload</B
|
|
>
|
|
</TT
|
|
>
|
|
</P
|
|
></LI
|
|
></OL
|
|
></LI
|
|
><LI
|
|
><P
|
|
> Edit <TT
|
|
CLASS="FILENAME"
|
|
>checksetup.pl</TT
|
|
> in your Bugzilla directory. Change
|
|
this line:
|
|
</P
|
|
><P
|
|
> <TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>my $webservergid = getgrnam($my_webservergroup);
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
</P
|
|
><P
|
|
> to
|
|
</P
|
|
><P
|
|
> <TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>my $webservergid = $my_webservergroup;
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
or the name of the group you wish to own the files explicitly:
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>my $webservergid = 'Administrators'
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> Run <TT
|
|
CLASS="FILENAME"
|
|
>checksetup.pl</TT
|
|
> from the Bugzilla directory.
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Edit <TT
|
|
CLASS="FILENAME"
|
|
>localconfig</TT
|
|
> to suit your
|
|
requirements. Set <TT
|
|
CLASS="VARNAME"
|
|
>$db_pass</TT
|
|
> to your
|
|
<SPAN
|
|
CLASS="QUOTE"
|
|
>"bugs_password"</SPAN
|
|
> from <A
|
|
HREF="win32.html#NTBUGS-PASSWORD"
|
|
>step 5.d</A
|
|
>, and <TT
|
|
CLASS="VARNAME"
|
|
>$webservergroup</TT
|
|
> to <SPAN
|
|
CLASS="QUOTE"
|
|
>"8"</SPAN
|
|
>.</P
|
|
><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
|
|
>Not sure on the <SPAN
|
|
CLASS="QUOTE"
|
|
>"8"</SPAN
|
|
> for
|
|
<TT
|
|
CLASS="VARNAME"
|
|
>$webservergroup</TT
|
|
> above. If it's
|
|
wrong, please send corrections.</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></LI
|
|
><LI
|
|
><P
|
|
> Edit <TT
|
|
CLASS="FILENAME"
|
|
>defparams.pl</TT
|
|
> to suit your
|
|
requirements. Particularly, set
|
|
<TT
|
|
CLASS="VARNAME"
|
|
>DefParam("maintainer")</TT
|
|
> and
|
|
<TT
|
|
CLASS="VARNAME"
|
|
>DefParam("urlbase") to match your
|
|
install.</TT
|
|
>
|
|
</P
|
|
><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
|
|
>This is yet another step I'm not sure of, since the
|
|
maintainer of this documentation does not maintain
|
|
Bugzilla on NT. If you can confirm or deny that this
|
|
step is required, please let me know.</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></LI
|
|
><LI
|
|
><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
|
|
> There are several alternatives to Sendmail that will work on Win32.
|
|
The one mentioned here is a <EM
|
|
>suggestion</EM
|
|
>, not
|
|
a requirement. Some other mail packages that can work include
|
|
<A
|
|
HREF="http://www.blat.net/"
|
|
TARGET="_top"
|
|
>BLAT</A
|
|
>,
|
|
<A
|
|
HREF="http://www.geocel.com/windmail/"
|
|
TARGET="_top"
|
|
>Windmail</A
|
|
>,
|
|
<A
|
|
HREF="http://www.dynamicstate.com/"
|
|
TARGET="_top"
|
|
>Mercury Sendmail</A
|
|
>,
|
|
and the CPAN Net::SMTP Perl module (available in .ppm).
|
|
Every option requires some hacking of the Perl scripts for Bugzilla
|
|
to make it work. The option here simply requires the least.
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
><DIV
|
|
CLASS="PROCEDURE"
|
|
><OL
|
|
TYPE="1"
|
|
><LI
|
|
><P
|
|
> Download NTsendmail, available from<A
|
|
HREF="http://www.ntsendmail.com/"
|
|
TARGET="_top"
|
|
> www.ntsendmail.com</A
|
|
>. You must have a "real" mail server which allows you to relay off it in your $ENV{"NTsendmail"} (which you should probably place in globals.pl)
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Put ntsendmail.pm into your .\perl\lib directory.</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Add to globals.pl:</P
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
># these settings configure the NTsendmail process
|
|
use NTsendmail;
|
|
$ENV{"NTsendmail"}="your.smtpserver.box";
|
|
$ENV{"NTsendmail_debug"}=1;
|
|
$ENV{"NTsendmail_max_tries"}=5;
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><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
|
|
> Some mention to also edit
|
|
<TT
|
|
CLASS="VARNAME"
|
|
>$db_pass</TT
|
|
> in
|
|
<TT
|
|
CLASS="FILENAME"
|
|
>globals.pl</TT
|
|
> to be your
|
|
<SPAN
|
|
CLASS="QUOTE"
|
|
>"bugs_password"</SPAN
|
|
>. Although this may get
|
|
you around some problem authenticating to your
|
|
database, since globals.pl is not normally
|
|
restricted by <TT
|
|
CLASS="FILENAME"
|
|
>.htaccess</TT
|
|
>, your
|
|
database password is exposed to whoever uses your
|
|
web server.
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></LI
|
|
><LI
|
|
><P
|
|
> Find and comment out all occurences of
|
|
<SPAN
|
|
CLASS="QUOTE"
|
|
>"<B
|
|
CLASS="COMMAND"
|
|
>open(SENDMAIL</B
|
|
>"</SPAN
|
|
> in
|
|
your Bugzilla directory. Then replace them with:
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
># new sendmail functionality
|
|
my $mail=new NTsendmail;
|
|
my $from="bugzilla\@your.machine.name.tld";
|
|
my $to=$login;
|
|
my $subject=$urlbase;
|
|
$mail->send($from,$to,$subject,$msg);
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
</P
|
|
><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
|
|
> Some have found success using the commercial product,
|
|
<SPAN
|
|
CLASS="PRODUCTNAME"
|
|
>Windmail</SPAN
|
|
>.
|
|
You could try replacing your sendmail calls with:
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>open SENDMAIL, "|\"C:/General/Web/tools/Windmail 4.0 Beta/windmail\" -t > mail.log";
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
or something to that effect.
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></LI
|
|
></OL
|
|
></DIV
|
|
></LI
|
|
><LI
|
|
><P
|
|
> Change all references in all files from
|
|
<TT
|
|
CLASS="FILENAME"
|
|
>processmail</TT
|
|
> to
|
|
<TT
|
|
CLASS="FILENAME"
|
|
>processmail.pl</TT
|
|
>, and
|
|
rename <TT
|
|
CLASS="FILENAME"
|
|
>processmail</TT
|
|
> to
|
|
<TT
|
|
CLASS="FILENAME"
|
|
>processmail.pl</TT
|
|
>.
|
|
</P
|
|
><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
|
|
> Many think this may be a change we want to make for
|
|
main-tree Bugzilla. It's painless for the UNIX folks,
|
|
and will make the Win32 people happier.
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
><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
|
|
> Some people have suggested using the Net::SMTP Perl module instead of NTsendmail or the other options listed here. You can change processmail.pl to make this work.
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
> my $smtp = Net::SMTP->new('<Name of your SMTP server>'); #connect to SMTP server
|
|
$smtp->mail('<your name>@<you smpt server>');# use the sender's adress here
|
|
$smtp->to($tolist); # recipient's address
|
|
$smtp->data(); # Start the mail
|
|
$smtp->datasend($msg);
|
|
$smtp->dataend(); # Finish sending the mail
|
|
$smtp->quit; # Close the SMTP connection
|
|
$logstr = "$logstr; mail sent to $tolist $cclist";
|
|
} </PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
here is a test mail program for Net::SMTP:
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
> use Net::SMTP;
|
|
my $smtp = Net::SMTP->new('<Name of your SMTP server', Timeout => 30, Debug
|
|
=> 1, ); # connect to SMTP server
|
|
$smtp->auth;
|
|
$smtp->mail('you@yourcompany.com');# use the sender's adress
|
|
here
|
|
$smtp->to('someotherAddress@someotherdomain.com'); #
|
|
recipient's address
|
|
$smtp->data(); # Start the mail
|
|
$smtp->datasend('test');
|
|
$smtp->dataend(); # Finish sending the mail
|
|
$smtp->quit; # Close the SMTP connection
|
|
exit; </PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></LI
|
|
><LI
|
|
><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
|
|
> This step is optional if you are using IIS or another
|
|
web server which only decides on an interpreter based
|
|
upon the file extension (.pl), rather than the
|
|
<SPAN
|
|
CLASS="QUOTE"
|
|
>"shebang"</SPAN
|
|
> line (#/usr/bonsaitools/bin/perl)
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
><P
|
|
> Modify the path to perl on the first line (#!) of all
|
|
files to point to your Perl installation, and add
|
|
<SPAN
|
|
CLASS="QUOTE"
|
|
>"perl"</SPAN
|
|
> to the beginning of all Perl system
|
|
calls that use a perl script as an argument. This may
|
|
take you a while. There is a <SPAN
|
|
CLASS="QUOTE"
|
|
>"setperl.csh"</SPAN
|
|
>
|
|
utility to speed part of this procedure, available in the
|
|
<A
|
|
HREF="patches.html"
|
|
>Useful Patches and Utilities for Bugzilla</A
|
|
> section of The Bugzilla Guide.
|
|
However, it requires the Cygwin GNU-compatible environment
|
|
for Win32 be set up in order to work. See <A
|
|
HREF="http://www.cygwin.com/"
|
|
TARGET="_top"
|
|
>http://www.cygwin.com/</A
|
|
> for details on obtaining Cygwin.
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> Modify the invocation of all system() calls in all perl
|
|
scripts in your Bugzilla directory. For instance, change
|
|
this line in processmail:
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>
|
|
system ("./processmail.pl",@ARGLIST);
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
> to
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>
|
|
system ("perl processmail.pl",@ARGLIST);
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> Add <TT
|
|
CLASS="FUNCTION"
|
|
>binmode()</TT
|
|
> calls so attachments
|
|
will work (<A
|
|
HREF="http://bugzilla.mozilla.org/show_bug.cgi?id=62000"
|
|
TARGET="_top"
|
|
>bug 62000</A
|
|
>).
|
|
</P
|
|
><P
|
|
> Because Microsoft Windows based systems handle binary
|
|
files different than Unix based systems, you need to add
|
|
the following lines to
|
|
<TT
|
|
CLASS="FILENAME"
|
|
>createattachment.cgi</TT
|
|
> and
|
|
<TT
|
|
CLASS="FILENAME"
|
|
>showattachment.cgi</TT
|
|
> before the
|
|
<TT
|
|
CLASS="FUNCTION"
|
|
>require 'CGI.pl';</TT
|
|
> line.</P
|
|
><P
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>binmode(STDIN);
|
|
binmode(STDOUT);</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
</P
|
|
><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
|
|
> According to <A
|
|
HREF="http://bugzilla.mozilla.org/show_bug.cgi?id=62000"
|
|
TARGET="_top"
|
|
>bug 62000</A
|
|
>, the perl documentation says that you should always use <TT
|
|
CLASS="FUNCTION"
|
|
>binmode()</TT
|
|
> when dealing with binary files, but never when dealing with text files. That seems to suggest that rather than aribtrarily putting <TT
|
|
CLASS="FUNCTION"
|
|
>binmode()</TT
|
|
> at the begining of the attachment files, there should be logic to determine if <TT
|
|
CLASS="FUNCTION"
|
|
>binmode()</TT
|
|
> is needed or not.
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></LI
|
|
></OL
|
|
></DIV
|
|
><DIV
|
|
CLASS="TIP"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
CLASS="TIP"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="25"
|
|
ALIGN="CENTER"
|
|
VALIGN="TOP"
|
|
><IMG
|
|
SRC="../images/tip.gif"
|
|
HSPACE="5"
|
|
ALT="Tip"></TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
><P
|
|
> If you are using IIS or Personal Web Server, you must add cgi
|
|
relationships to Properties -> Home directory (tab) ->
|
|
Application Settings (section) -> Configuration (button),
|
|
such as:
|
|
</P
|
|
><P
|
|
> <TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>
|
|
.cgi to: <perl install directory>\perl.exe %s %s
|
|
.pl to: <perl install directory>\perl.exe %s %s
|
|
GET,HEAD,POST
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
Change the path to Perl to match your
|
|
install, of course.
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECTION"
|
|
><H2
|
|
CLASS="SECTION"
|
|
><A
|
|
NAME="ADDLWINTIPS"
|
|
>3.6.2. Additional Windows Tips</A
|
|
></H2
|
|
><DIV
|
|
CLASS="TIP"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
CLASS="TIP"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="25"
|
|
ALIGN="CENTER"
|
|
VALIGN="TOP"
|
|
><IMG
|
|
SRC="../images/tip.gif"
|
|
HSPACE="5"
|
|
ALT="Tip"></TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
><P
|
|
> From Andrew Pearson:
|
|
<A
|
|
NAME="AEN1212"
|
|
></A
|
|
><BLOCKQUOTE
|
|
CLASS="BLOCKQUOTE"
|
|
><P
|
|
> You can make Bugzilla work with Personal Web Server for
|
|
Windows 98 and higher, as well as for IIS 4.0.
|
|
Microsoft has information available at <A
|
|
HREF=" http://support.microsoft.com/support/kb/articles/Q231/9/98.ASP"
|
|
TARGET="_top"
|
|
> http://support.microsoft.com/support/kb/articles/Q231/9/98.ASP</A
|
|
>
|
|
</P
|
|
><P
|
|
> Basically you need to add two String Keys in the
|
|
registry at the following location:
|
|
</P
|
|
><P
|
|
> <TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC\Parameters\ScriptMap
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
</P
|
|
><P
|
|
> The keys should be called ".pl" and ".cgi", and both
|
|
should have a value something like:
|
|
<B
|
|
CLASS="COMMAND"
|
|
>c:/perl/bin/perl.exe "%s" "%s"</B
|
|
>
|
|
</P
|
|
><P
|
|
> The KB article only talks about .pl, but it goes into
|
|
more detail and provides a perl test script.
|
|
</P
|
|
></BLOCKQUOTE
|
|
>
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
><DIV
|
|
CLASS="TIP"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
CLASS="TIP"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="25"
|
|
ALIGN="CENTER"
|
|
VALIGN="TOP"
|
|
><IMG
|
|
SRC="../images/tip.gif"
|
|
HSPACE="5"
|
|
ALT="Tip"></TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
><P
|
|
> If attempting to run Bugzilla 2.12 or older, you will need
|
|
to remove encrypt() calls from the Perl source. This is
|
|
<EM
|
|
>not necessary</EM
|
|
> for Bugzilla 2.13 and
|
|
later, which includes the current release, Bugzilla
|
|
2.14.
|
|
<DIV
|
|
CLASS="EXAMPLE"
|
|
><A
|
|
NAME="AEN1224"
|
|
></A
|
|
><P
|
|
><B
|
|
>Example 3-4. Removing encrypt() for Windows NT Bugzilla version
|
|
2.12 or earlier</B
|
|
></P
|
|
><P
|
|
> Replace this:
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>
|
|
SendSQL("SELECT encrypt(" . SqlQuote($enteredpwd) . ", " . SQLQuote(substr($realcryptpwd, 0, 2)) . ")");
|
|
my $enteredcryptpwd = FetchOneColumn();
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
with this:
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>
|
|
my $enteredcryptpwd = $enteredpwd
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
in cgi.pl.
|
|
</P
|
|
></DIV
|
|
>
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECTION"
|
|
><H2
|
|
CLASS="SECTION"
|
|
><A
|
|
NAME="BZLDAP"
|
|
>3.6.3. Bugzilla LDAP Integration</A
|
|
></H2
|
|
><P
|
|
> What follows is some late-breaking information on using the
|
|
LDAP authentication options with Bugzilla. The author has not
|
|
tested these (nor even formatted this section!) so please
|
|
contribute feedback to the newsgroup.
|
|
</P
|
|
><P
|
|
CLASS="LITERALLAYOUT"
|
|
>Mozilla::LDAP module<br>
|
|
<br>
|
|
The Mozilla::LDAP module allows you to use LDAP for authentication to<br>
|
|
the Bugzilla system. This module is not required if you are not using<br>
|
|
LDAP.<br>
|
|
<br>
|
|
Mozilla::LDAP (aka PerLDAP) is available for download from<br>
|
|
http://www.mozilla.org/directory.<br>
|
|
<br>
|
|
NOTE: The Mozilla::LDAP module requires Netscape's Directory SDK.<br>
|
|
Follow the link for "Directory SDK for C" on that same page to<br>
|
|
download the SDK first. After you have installed this SDK, then<br>
|
|
install the PerLDAP module.<br>
|
|
----------------------------------------------------------------------<br>
|
|
<br>
|
|
Post-Installation Checklist<br>
|
|
----------------------------------------------------------------------<br>
|
|
Set useLDAP to "On" **only** if you will be using an LDAP directory<br>
|
|
for authentication. Be very careful when setting up this parameter;<br>
|
|
if you set LDAP authentication, but do not have a valid LDAP directory<br>
|
|
set up, you will not be able to log back in to Bugzilla once you log<br>
|
|
out. (If this happens, you can get back in by manually editing the<br>
|
|
data/params file, and setting useLDAP back to 0.)<br>
|
|
<br>
|
|
If using LDAP, you must set the three additional parameters:<br>
|
|
<br>
|
|
Set LDAPserver to the name (and optionally port) of your LDAP server.<br>
|
|
If no port is specified, it defaults to the default port of 389. (e.g<br>
|
|
"ldap.mycompany.com" or "ldap.mycompany.com:1234")<br>
|
|
<br>
|
|
Set LDAPBaseDN to the base DN for searching for users in your LDAP<br>
|
|
directory. (e.g. "ou=People,o=MyCompany") uids must be unique under<br>
|
|
the DN specified here.<br>
|
|
<br>
|
|
Set LDAPmailattribute to the name of the attribute in your LDAP<br>
|
|
directory which contains the primary email address. On most directory<br>
|
|
servers available, this is "mail", but you may need to change this.<br>
|
|
----------------------------------------------------------------------<br>
|
|
<br>
|
|
(Not sure where this bit should go, but it's important that it be in<br>
|
|
there somewhere...)<br>
|
|
----------------------------------------------------------------------<br>
|
|
Using LDAP authentication for Bugzilla:<br>
|
|
<br>
|
|
The existing authentication scheme for Bugzilla uses email addresses<br>
|
|
as the primary user ID, and a password to authenticate that user. All<br>
|
|
places within Bugzilla where you need to deal with user ID (e.g<br>
|
|
assigning a bug) use the email address.<br>
|
|
<br>
|
|
The LDAP authentication builds on top of this scheme, rather than<br>
|
|
replacing it. The initial log in is done with a username and password<br>
|
|
for the LDAP directory. This then fetches the email address from LDAP<br>
|
|
and authenticates seamlessly in the standard Bugzilla authentication<br>
|
|
scheme using this email address. If an account for this address<br>
|
|
already exists in your Bugzilla system, it will log in to that<br>
|
|
account. If no account for that email address exists, one is created<br>
|
|
at the time of login. (In this case, Bugzilla will attempt to use the<br>
|
|
"displayName" or "cn" attribute to determine the user's full name.)<br>
|
|
<br>
|
|
After authentication, all other user-related tasks are still handled<br>
|
|
by email address, not LDAP username. You still assign bugs by email<br>
|
|
address, query on users by email address, etc.<br>
|
|
----------------------------------------------------------------------<br>
|
|
</P
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="NAVFOOTER"
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"><TABLE
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="geninstall.html"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="index.html"
|
|
>Home</A
|
|
></TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="administration.html"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
>Installation General Notes</TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="installation.html"
|
|
>Up</A
|
|
></TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
>Administering Bugzilla</TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></BODY
|
|
></HTML
|
|
> |