diff options
Diffstat (limited to 'docs/html/win32.html')
| -rw-r--r-- | docs/html/win32.html | 1515 |
1 files changed, 1515 insertions, 0 deletions
diff --git a/docs/html/win32.html b/docs/html/win32.html new file mode 100644 index 000000000..d0c1c8064 --- /dev/null +++ b/docs/html/win32.html @@ -0,0 +1,1515 @@ +<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" +>Chapter 3</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 both strong troubleshooting abilities and + a high tolerance for pain. 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" +>The Bugzilla FAQ</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. + </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 slightly more + difficult. If ActivePerl doesn't seem to handle your file + associations correctly (for .cgi and .pl files), please + consult <A +HREF="faq.html" +>The Bugzilla FAQ</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="AEN910" +></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 +> "my $webservergid = getgrnam($my_webservergroup); " + </P +><P +> to + </P +><P +> "my $webservergid = $my_webservergroup; " + </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 +>The code above needs testing as well to make sure it is correct.</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 completely 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 +></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 5.0 or higher, you must add cgi + relationships to Properties -> Home directory (tab) -> + Application Settings (section) -> Configuration (button), + such as: <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="AEN1062" +></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 +> HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC\Parameters\ScriptMap + </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 +>"Brian" had this to add, about upgrading to Bugzilla 2.12 from previous versions:</P +><A +NAME="AEN1072" +></A +><BLOCKQUOTE +CLASS="BLOCKQUOTE" +><P +> Hi - I am updating bugzilla to 2.12 so I can tell you what I did (after I + deleted the current dir and copied the files in). + </P +><P +> In checksetup.pl, I did the following... + </P +><DIV +CLASS="PROCEDURE" +><OL +TYPE="1" +><LI +><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 +>to</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><FONT +COLOR="#000000" +><PRE +CLASS="PROGRAMLISTING" +>my $webservergid = 'Administrators' + </PRE +></FONT +></TD +></TR +></TABLE +></LI +><LI +><P +> I then ran checksetup.pl + </P +></LI +><LI +><P +> I removed all the encrypt() + <DIV +CLASS="EXAMPLE" +><A +NAME="AEN1084" +></A +><P +><B +>Example 3-4. Removing encrypt() for Windows NT installations</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 +></LI +><LI +><P +> I renamed processmail to processmail.pl + </P +></LI +><LI +><P +> I altered the sendmail statements to windmail: + <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 +> + </P +><P +> The quotes around the dir is for the spaces. mail.log is for the output + </P +></LI +></OL +></DIV +></BLOCKQUOTE +></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 +> This was some late breaking information from Jan Evert. Sorry for the lack of formatting. + </P +><P +CLASS="LITERALLAYOUT" +>I'm busy installing bugzilla on a WinNT machine and I thought I'd notify you<br> +at this moment of the commments I have to section 2.2.1 of the bugzilla<br> +guide (at http://www.trilobyte.net/barnsons/html/).<br> +<br> +Step 1:<br> +I've used apache, installation is really straightforward.<br> +After reading the Unix installation instructions, I found that it is<br> +necessary to add the ExecCGI option to the bugzilla directory. Also the<br> +'AddHandler' line for .cgi is by default commented out.<br> +<br> +Step 3: although just a detail, 'ppm install <module%gt;' will also work<br> +(without .ppd). And, it can also download these automatically from<br> +ActiveState.<br> +<br> +Step 4: although I have cygwin installed, it seems that it is not necessary.<br> +On my machine cygwin is not in the PATH and everything seems to work as<br> +expected.<br> +However, I've not used everything yet.<br> +<br> +Step 6: the 'bugs_password' given in SQL command d needs to be edited into<br> +localconfig later on (Step 7) if the password is not empty. I've also edited<br> +it into globals.pl, but I'm not sure that is needed. In both places, the<br> +variable is named db_pass.<br> +<br> +Step 8: all the sendmail replacements mentioned are not as simple as<br> +described there. Since I am not familiar (yet) with perl, I don't have any<br> +mail working yet.<br> +<br> +Step 9: in globals.pl the encrypt() call can be replaced by just the<br> +unencrypted password. In CGI.pl, the complete SQL command can be removed.<br> +<br> +Step 11: I've only changed the #! lines in *.cgi. I haven't noticed problems<br> +with the system() call yet.<br> +There seem to be only four system() called programs: processmail.pl (handled<br> +by step 10), syncshadowdb (which should probably get the same treatment as<br> +processmail.pl), diff and mysqldump. The last one is only needed with the<br> +shadowdb feature (which I don't use).<br> +<br> +There seems to be one step missing: copying the bugzilla files somehwere<br> +that apache can serve them.<br> +<br> +Just noticed the updated guide... Brian's comment is new. His first comment<br> +will work, but opens up a huge security hole.<br> + </P +></TD +></TR +></TABLE +></DIV +></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 +>
\ No newline at end of file |