Big checkin of docs to resolve every
known outstanding doc bug! Yay release. Still many things to fix. Aren't there always? git-svn-id: svn://10.0.0.236/trunk@101604 18797224-902f-48f8-a5cc-f745e15eee43
This commit is contained in:
barnboy%trilobyte.net
@@ -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
|
||||
>
|
||||
for Windows.
|
||||
regarding your Apache configuration, particularly
|
||||
instructions regarding the <SPAN
|
||||
CLASS="QUOTE"
|
||||
>"AddHandler"</SPAN
|
||||
>
|
||||
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
|
||||
|
||||
Reference in New Issue
Block a user