diff options
Diffstat (limited to 'docs/html/readme.windows.html')
| -rw-r--r-- | docs/html/readme.windows.html | 812 |
1 files changed, 0 insertions, 812 deletions
diff --git a/docs/html/readme.windows.html b/docs/html/readme.windows.html deleted file mode 100644 index d1f46ca61..000000000 --- a/docs/html/readme.windows.html +++ /dev/null @@ -1,812 +0,0 @@ -<HTML -><HEAD -><TITLE ->Win32 (Win98+/NT/2K) Installation</TITLE -><META -NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.64 -"><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="AEN633" -></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 -CLASS="TIP" -><BLOCKQUOTE -CLASS="TIP" -><P -><B ->Tip: </B ->"Brian" had this to add, about upgrading to Bugzilla 2.12 from previous versions:</P -><A -NAME="AEN643" -></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 -><PRE -CLASS="PROGRAMLISTING" ->my $webservergid = getgrnam($my_webservergroup); - </PRE -></TD -></TR -></TABLE -><P ->to</P -><TABLE -BORDER="0" -BGCOLOR="#E0E0E0" -WIDTH="100%" -><TR -><TD -><PRE -CLASS="PROGRAMLISTING" ->my $webservergid = 'Administrators' - </PRE -></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="AEN655" -></A -><P -><B ->Example 2-3. Removing encrypt() for Windows NT installations</B -></P -><P -> Replace this: - <TABLE -BORDER="0" -BGCOLOR="#E0E0E0" -WIDTH="100%" -><TR -><TD -><PRE -CLASS="PROGRAMLISTING" ->SendSQL("SELECT encrypt(" . SqlQuote($enteredpwd) . ", " . - SqlQuote(substr($realcryptpwd, 0, 2)) . ")"); -my $enteredcryptpwd = FetchOneColumn(); - </PRE -></TD -></TR -></TABLE -> - with this: - <TABLE -BORDER="0" -BGCOLOR="#E0E0E0" -WIDTH="100%" -><TR -><TD -><PRE -CLASS="PROGRAMLISTING" ->my $enteredcryptpwd = $enteredpwd - </PRE -></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 -><PRE -CLASS="PROGRAMLISTING" -> -open SENDMAIL, "|\"C:/General/Web/tools/Windmail 4.0 Beta/windmail\" -t > mail.log"; - </PRE -></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 -></BLOCKQUOTE -></DIV -><DIV -CLASS="TIP" -><BLOCKQUOTE -CLASS="TIP" -><P -><B ->Tip: </B -> 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> -(wihtout .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 -></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 |