diff options
| author | barnboy%trilobyte.net <> | 2001-08-22 12:44:14 +0200 |
|---|---|---|
| committer | barnboy%trilobyte.net <> | 2001-08-22 12:44:14 +0200 |
| commit | bf8ac7551058df22dd5eb712631d9e383fc587a5 (patch) | |
| tree | 8cf0b9bb7d0755c75266bd30cf7059d556a23703 /docs/html/win32.html | |
| parent | f210bb460c786a31bc7677f0e547a67880997558 (diff) | |
| download | bugzilla-bf8ac7551058df22dd5eb712631d9e383fc587a5.tar.gz bugzilla-bf8ac7551058df22dd5eb712631d9e383fc587a5.tar.xz | |
Big checkin of docs to resolve every
known outstanding doc bug! Yay release.
Still many things to fix. Aren't there always?
Diffstat (limited to 'docs/html/win32.html')
| -rw-r--r-- | docs/html/win32.html | 358 |
1 files changed, 143 insertions, 215 deletions
diff --git a/docs/html/win32.html b/docs/html/win32.html index d0c1c8064..32f2515e8 100644 --- a/docs/html/win32.html +++ b/docs/html/win32.html @@ -126,7 +126,7 @@ VALIGN="TOP" of the <A HREF="installation.html" ->Chapter 3</A +>Bugzilla Installation</A > section while performing your Win32 installation. </P @@ -137,13 +137,14 @@ HREF="installation.html" 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 + 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" ->The Bugzilla FAQ</A +>Appendix A</A >. </P ></TD @@ -159,9 +160,23 @@ TYPE="1" > Install <A HREF="http://www.apache.org/" TARGET="_top" ->Apache Web Server</A +>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 > - for Windows. + parameter and <SPAN +CLASS="QUOTE" +>"ExecCGI"</SPAN +>. </P ><DIV CLASS="NOTE" @@ -184,13 +199,13 @@ ALT="Note"></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 +> 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" ->The Bugzilla FAQ</A +>Appendix A</A >. </P ><P @@ -286,7 +301,7 @@ CLASS="COMMAND" ><DIV CLASS="EXAMPLE" ><A -NAME="AEN910" +NAME="AEN1012" ></A ><P ><B @@ -526,13 +541,63 @@ CLASS="FILENAME" this line: </P ><P -> "my $webservergid = getgrnam($my_webservergroup); " +> <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 -> "my $webservergid = $my_webservergroup; " +> <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 @@ -841,7 +906,31 @@ ALT="Note"></TD ALIGN="LEFT" VALIGN="TOP" ><P ->The code above needs testing as well to make sure it is correct.</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 @@ -1002,9 +1091,9 @@ ALT="Note"></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 +> 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 @@ -1102,10 +1191,11 @@ ALT="Tip"></TD ALIGN="LEFT" VALIGN="TOP" ><P -> If you are using IIS 5.0 or higher, you must add cgi +> 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: <TABLE + such as: + <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" @@ -1164,18 +1254,17 @@ VALIGN="TOP" ><P > From Andrew Pearson: <A -NAME="AEN1062" +NAME="AEN1169" ></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" +> 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 +> http://support.microsoft.com/support/kb/articles/Q231/9/98.ASP</A > </P ><P @@ -1225,79 +1314,25 @@ ALT="Tip"></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 +> 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. + <DIV CLASS="EXAMPLE" ><A -NAME="AEN1084" +NAME="AEN1180" ></A ><P ><B ->Example 3-4. Removing encrypt() for Windows NT installations</B +>Example 3-4. Removing encrypt() for Windows NT Bugzilla version + 2.12 or earlier</B ></P ><P -> Replace this: - <TABLE +> Replace this: + <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" @@ -1307,17 +1342,17 @@ WIDTH="100%" COLOR="#000000" ><PRE CLASS="PROGRAMLISTING" ->SendSQL("SELECT encrypt(" . SqlQuote($enteredpwd) . ", " . - SqlQuote(substr($realcryptpwd, 0, 2)) . ")"); -my $enteredcryptpwd = FetchOneColumn(); - </PRE +> +SendSQL("SELECT encrypt(" . SqlQuote($enteredpwd) . ", " . SqlQuote(substr($realcryptpwd, 0, 2)) . ")"); +my $enteredcryptpwd = FetchOneColumn(); + </PRE ></FONT ></TD ></TR ></TABLE > - with this: - <TABLE + with this: + <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" @@ -1327,125 +1362,18 @@ WIDTH="100%" COLOR="#000000" ><PRE CLASS="PROGRAMLISTING" ->my $enteredcryptpwd = $enteredpwd - </PRE +> +my $enteredcryptpwd = $enteredpwd + </PRE ></FONT ></TD ></TR ></TABLE > - in cgi.pl. - </P + 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 |