diff options
| author | gerv%gerv.net <> | 2004-01-16 07:34:12 +0100 |
|---|---|---|
| committer | gerv%gerv.net <> | 2004-01-16 07:34:12 +0100 |
| commit | 4bbb07e8048ef859cfc29c6b9d221840f2c6aed1 (patch) | |
| tree | 69ebbdef36708c17345d3220223190a3ce0b682e /docs/html/http.html | |
| parent | 85e651ef9836d43613c3bb55f7c1c3ff150f76d0 (diff) | |
| download | bugzilla-4bbb07e8048ef859cfc29c6b9d221840f2c6aed1.tar.gz bugzilla-4bbb07e8048ef859cfc29c6b9d221840f2c6aed1.tar.xz | |
Phase 1 of a big documentation update before 2.17.6.
Diffstat (limited to 'docs/html/http.html')
| -rw-r--r-- | docs/html/http.html | 248 |
1 files changed, 43 insertions, 205 deletions
diff --git a/docs/html/http.html b/docs/html/http.html index 8f3b76d05..a950acce5 100644 --- a/docs/html/http.html +++ b/docs/html/http.html @@ -4,19 +4,21 @@ >HTTP Server Configuration</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ +"><LINK REL="HOME" -TITLE="The Bugzilla Guide - 2.17.5 Development Release" +TITLE="The Bugzilla Guide - 2.17.5 + Development Release" HREF="index.html"><LINK REL="UP" TITLE="Installation" HREF="installation.html"><LINK REL="PREVIOUS" -TITLE="OS Specific Installation Notes" -HREF="os-specific.html"><LINK +TITLE="Step-by-step Install" +HREF="stepbystep.html"><LINK REL="NEXT" -TITLE="Troubleshooting" -HREF="troubleshooting.html"></HEAD +TITLE="Optional Additional Configuration" +HREF="extraconfig.html"></HEAD ><BODY CLASS="section" BGCOLOR="#FFFFFF" @@ -36,7 +38,8 @@ CELLSPACING="0" ><TH COLSPAN="3" ALIGN="center" ->The Bugzilla Guide - 2.17.5 Development Release</TH +>The Bugzilla Guide - 2.17.5 + Development Release</TH ></TR ><TR ><TD @@ -44,7 +47,7 @@ WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A -HREF="os-specific.html" +HREF="stepbystep.html" ACCESSKEY="P" >Prev</A ></TD @@ -58,7 +61,7 @@ WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A -HREF="troubleshooting.html" +HREF="extraconfig.html" ACCESSKEY="N" >Next</A ></TD @@ -74,7 +77,7 @@ CLASS="section" ><A NAME="http" ></A ->4.4. HTTP Server Configuration</H1 +>4.2. HTTP Server Configuration</H1 ><P >The Bugzilla Team recommends Apache when using Bugzilla, however, any web server that can be configured to run <A @@ -88,7 +91,7 @@ CLASS="glossterm" especially if you choose something other than Apache, you should be sure to read <A HREF="security.html#security-access" ->Section 5.6.4</A +>Section 4.5.4</A >. </P ><P @@ -102,13 +105,12 @@ CLASS="section" ><A NAME="http-apache" ></A ->4.4.1. Apache <SPAN +>4.2.1. Apache <SPAN CLASS="productname" >httpd</SPAN ></H2 ><P ->As mentioned above, the Bugzilla Team recommends Apache for use - with Bugzilla. You will have to make sure that Apache is properly +>You will have to make sure that Apache is properly configured to run the Bugzilla CGI scripts. You also need to make sure that the <TT CLASS="filename" @@ -117,41 +119,21 @@ CLASS="filename" <B CLASS="command" >./checksetup.pl</B -> (shown in <A -HREF="http.html#http-apache-htaccess" ->Example 4-2</A -> - for the curious) are allowed to override Apache's normal access +> are allowed to override Apache's normal access permissions or else important password information may be exposed to the Internet. </P ><P ->Many Apache installations are not configured to run scripts - anywhere but in the <TT -CLASS="filename" ->cgi-bin</TT -> - directory; however, we recommend that Bugzilla not be installed in the +>You need to configure Apache to run .cgi files outside the <TT CLASS="filename" >cgi-bin</TT ->, otherwise the static - files such as images and <A -HREF="glossary.html#gloss-javascript" -><I -CLASS="glossterm" ->JavaScript</I -></A -> - will not work correctly. To allow scripts to run in the normal - web space, the following changes should be made to your +> directory. + Open your <TT CLASS="filename" >httpd.conf</TT -> file. - </P -><P ->To allow files with a .cgi extension to be run, make sure the +> file and make sure the following line exists and is uncommented:</P ><TABLE BORDER="0" @@ -199,6 +181,21 @@ AllowOverride Limit ></TD ></TR ></TABLE +><P +>You should modify the <DirectoryIndex> parameter for + the Apache virtual host running your Bugzilla installation to + allow <TT +CLASS="filename" +>index.cgi</TT +> as the index page for a + directory, as well as the usual <TT +CLASS="filename" +>index.html</TT +>, + <TT +CLASS="filename" +>index.htm</TT +>, and so forth. </P ><DIV CLASS="note" ><P @@ -233,165 +230,6 @@ CLASS="glossterm" ></TR ></TABLE ></DIV -><DIV -CLASS="example" -><A -NAME="http-apache-htaccess" -></A -><P -><B ->Example 4-2. <TT -CLASS="filename" ->.htaccess</TT -> files for Apache</B -></P -><P -><TT -CLASS="filename" ->$BUGZILLA_HOME/.htaccess</TT -> - <TABLE -BORDER="0" -BGCOLOR="#E0E0E0" -WIDTH="100%" -><TR -><TD -><FONT -COLOR="#000000" -><PRE -CLASS="programlisting" -> # don't allow people to retrieve non-cgi executable files or our private data -<FilesMatch ^(.*\.pl|.*localconfig.*|runtests.sh)$> - deny from all -</FilesMatch> -<FilesMatch ^(localconfig.js|localconfig.rdf)$> - allow from all -</FilesMatch> - </PRE -></FONT -></TD -></TR -></TABLE -> - </P -><P -><TT -CLASS="filename" ->$BUGZILLA_HOME/data/.htaccess</TT -> - <TABLE -BORDER="0" -BGCOLOR="#E0E0E0" -WIDTH="100%" -><TR -><TD -><FONT -COLOR="#000000" -><PRE -CLASS="programlisting" -> # nothing in this directory is retrievable unless overriden by an .htaccess -# in a subdirectory; the only exception is duplicates.rdf, which is used by -# duplicates.xul and must be loadable over the web -deny from all -<Files duplicates.rdf> - allow from all -</Files> - </PRE -></FONT -></TD -></TR -></TABLE -> - </P -><P -><TT -CLASS="filename" ->$BUGZILLA_HOME/data/webdot</TT -> - <TABLE -BORDER="0" -BGCOLOR="#E0E0E0" -WIDTH="100%" -><TR -><TD -><FONT -COLOR="#000000" -><PRE -CLASS="programlisting" -> # Restrict access to .dot files to the public webdot server at research.att.com -# if research.att.com ever changed their IP, or if you use a different -# webdot server, you'll need to edit this -<FilesMatch ^[0-9]+\.dot$> - Allow from 192.20.225.10 - Deny from all -</FilesMatch> - -# Allow access by a local copy of 'dot' to .png, .gif, .jpg, and -# .map files -<FilesMatch ^[0-9]+\.(png|gif|jpg|map)$> - Allow from all -</FilesMatch> - -# And no directory listings, either. -Deny from all - </PRE -></FONT -></TD -></TR -></TABLE -> - </P -><P -><TT -CLASS="filename" ->$BUGZILLA_HOME/Bugzilla/.htaccess</TT -> - <TABLE -BORDER="0" -BGCOLOR="#E0E0E0" -WIDTH="100%" -><TR -><TD -><FONT -COLOR="#000000" -><PRE -CLASS="programlisting" -> # nothing in this directory is retrievable unless overriden by an .htaccess -# in a subdirectory -deny from all - </PRE -></FONT -></TD -></TR -></TABLE -> - </P -><P -><TT -CLASS="filename" ->$BUGZILLA_HOME/template/.htaccess</TT -> - <TABLE -BORDER="0" -BGCOLOR="#E0E0E0" -WIDTH="100%" -><TR -><TD -><FONT -COLOR="#000000" -><PRE -CLASS="programlisting" -> # nothing in this directory is retrievable unless overriden by an .htaccess -# in a subdirectory -deny from all - </PRE -></FONT -></TD -></TR -></TABLE -> - </P -></DIV ></DIV ><DIV CLASS="section" @@ -400,7 +238,7 @@ CLASS="section" ><A NAME="http-iis" ></A ->4.4.2. Microsoft <SPAN +>4.2.2. Microsoft <SPAN CLASS="productname" >Internet Information Services</SPAN ></H2 @@ -446,7 +284,7 @@ CLASS="filename" > directory are secured as described in <A HREF="security.html#security-access" ->Section 5.6.4</A +>Section 4.5.4</A >. </P ></DIV @@ -457,7 +295,7 @@ CLASS="section" ><A NAME="http-aol" ></A ->4.4.3. AOL Server</H2 +>4.2.3. AOL Server</H2 ><P >Ben FrantzDale reported success using AOL Server with Bugzilla. He reported his experience and what appears below is based on that. @@ -646,7 +484,7 @@ WIDTH="33%" ALIGN="left" VALIGN="top" ><A -HREF="os-specific.html" +HREF="stepbystep.html" ACCESSKEY="P" >Prev</A ></TD @@ -664,7 +502,7 @@ WIDTH="33%" ALIGN="right" VALIGN="top" ><A -HREF="troubleshooting.html" +HREF="extraconfig.html" ACCESSKEY="N" >Next</A ></TD @@ -674,7 +512,7 @@ ACCESSKEY="N" WIDTH="33%" ALIGN="left" VALIGN="top" ->OS Specific Installation Notes</TD +>Step-by-step Install</TD ><TD WIDTH="34%" ALIGN="center" @@ -688,7 +526,7 @@ ACCESSKEY="U" WIDTH="33%" ALIGN="right" VALIGN="top" ->Troubleshooting</TD +>Optional Additional Configuration</TD ></TR ></TABLE ></DIV |