diff options
Diffstat (limited to 'docs/html/readme.windows.html')
| -rw-r--r-- | docs/html/readme.windows.html | 612 |
1 files changed, 612 insertions, 0 deletions
diff --git a/docs/html/readme.windows.html b/docs/html/readme.windows.html new file mode 100644 index 000000000..b89c1c7d1 --- /dev/null +++ b/docs/html/readme.windows.html @@ -0,0 +1,612 @@ +<HTML +><HEAD +><TITLE +>Win32 (Win98+/NT/2K) Installation</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="Installing Bugzilla" +HREF="installation.html"><LINK +REL="PREVIOUS" +TITLE="UNIX Installation" +HREF="readme.unix.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="readme.unix.html" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +>Chapter 2. Installing Bugzilla</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="README.WINDOWS" +>2.2. Win32 (Win98+/NT/2K) Installation</A +></H1 +><P +> These directions have <EM +>not</EM +> been extensively tested. + We need testers! Please try these out and post any changes to the + newsgroup. + </P +><DIV +CLASS="SECTION" +><H2 +CLASS="SECTION" +><A +NAME="NTVERIFIED" +>2.2.1. Win32 Installation: Step-by-step</A +></H2 +><DIV +CLASS="NOTE" +><BLOCKQUOTE +CLASS="NOTE" +><P +><B +>Note: </B +> You should be familiar with, and cross-reference, the UNIX README + while performing your Win32 installation. Unfortunately, Win32 + directions are not yet as detailed as those for UNIX. + </P +><P +> The <EM +>most critical</EM +> difference for Win32 users is + the lack of support for a crypt() function in MySQL for Windows. It does not + have it! All ENCRYPT statements must be modified. + </P +></BLOCKQUOTE +></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" +><BLOCKQUOTE +CLASS="NOTE" +><P +><B +>Note: </B +> 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 the FAQ, in the "Win32" section. + </P +><P +> If you are going to use IIS, if on Windows NT you must be updated + to at least Service Pack 4. + </P +></BLOCKQUOTE +></DIV +></LI +><LI +><P +> Install <A +HREF="http://www.activestate.com/" +TARGET="_top" +>ActivePerl</A +> + </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" +> Hixie Click Here</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 +><P +> The syntax for ppm is: + <TT +CLASS="COMPUTEROUTPUT" +> <TT +CLASS="PROMPT" +>C:> </TT +><B +CLASS="COMMAND" +>ppm install <module>.ppd</B +> + </TT +> + </P +><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 +> Download and install the Windows GNU tools from + <A +HREF="http://www.cygwin.com/" +TARGET="_top" +>www.cygwin.com</A +>. + Make sure the GNU utilities are in your $PATH. + </P +></LI +><LI +><P +> Install MySQL for NT. + <DIV +CLASS="NOTE" +><BLOCKQUOTE +CLASS="NOTE" +><P +><B +>Note: </B +> Your configuration file for MySQL <EM +>must</EM +> be named C:\MY.CNF. + </P +></BLOCKQUOTE +></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 +></LI +><LI +><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 +></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 +> Configure Bugzilla. For Win32, this involves editing "defparams.pl" + and "localconfig" to taste. Running "checksetup.pl" should create + localconfig for you. Note that getgrnam() doesn't work, and should be + deleted. Change this line: + "my $webservergid = getgrnam($my_webservergroup); " + to + "my $webservergid = $my_webservergroup; " + </P +></LI +><LI +><DIV +CLASS="NOTE" +><BLOCKQUOTE +CLASS="NOTE" +><P +><B +>Note: </B +> 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 +></BLOCKQUOTE +></DIV +><P +> Download NTsendmail, available from<A +HREF="http://www.ntsendmail.com/" +TARGET="_top" +> www.ntsendmail.com</A +>. In order for it to work, you must set up some + new environment variables (detailed on the ntsendmail home page). Figuring + out where to put those variables is left as an exercise for the reader. + 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 +><P +> Once downloaded and installed, modify all open(SENDMAIL) calls to open + "| c:\ntsendmail\ntsendmail -t" instead of "|/usr/lib/sendmail -t". + </P +><DIV +CLASS="NOTE" +><BLOCKQUOTE +CLASS="NOTE" +><P +><B +>Note: </B +> We need someone to test this and make sure this works as advertised. + </P +></BLOCKQUOTE +></DIV +></LI +><LI +><P +> Modify globals.pl and CGI.pl to remove the word "encrypt". + </P +><DIV +CLASS="NOTE" +><BLOCKQUOTE +CLASS="NOTE" +><P +><B +>Note: </B +> I'm not sure this is all that is involved to remove crypt. Any + NT Bugzilla hackers want to pipe up? + </P +></BLOCKQUOTE +></DIV +></LI +><LI +><P +> Change all references to "processmail" to "processmail.pl" in + all files, and rename "processmail" to "processmail.pl" + </P +><DIV +CLASS="NOTE" +><BLOCKQUOTE +CLASS="NOTE" +><P +><B +>Note: </B +> I really 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 +></BLOCKQUOTE +></DIV +></LI +><LI +><P +> Modify the path to perl on the first line (#!) of all files + to point to your Perl installation, and + add "perl" 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 "setperl.pl" utility to speed part of this procedure, + available in the "Patches and Utilities" section of The Bugzilla Guide. + </P +></LI +><LI +><P +> In processmail.pl, add "binmode(HANDLE)" before all read() calls. + This may not be necessary, but in some cases the read() under + Win32 doesn't count the EOL's without using a binary read(). + </P +></LI +></OL +></DIV +></DIV +><DIV +CLASS="SECTION" +><H2 +CLASS="SECTION" +><A +NAME="ADDLWINTIPS" +>2.2.2. Additional Windows Tips</A +></H2 +><DIV +CLASS="TIP" +><BLOCKQUOTE +CLASS="TIP" +><P +><B +>Tip: </B +> From Andrew Pearson: + <A +NAME="AEN304" +></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 +></BLOCKQUOTE +></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="readme.unix.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" +>UNIX Installation</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 |