| <!--#if expr="$FAQMASTER" --> |
| <!--#set var="STANDALONE" value="" --> |
| <!--#set var="INCLUDED" value="YES" --> |
| <!--#if expr="$QUERY_STRING = TOC" --> |
| <!--#set var="TOC" value="YES" --> |
| <!--#set var="CONTENT" value="" --> |
| <!--#else --> |
| <!--#set var="TOC" value="" --> |
| <!--#set var="CONTENT" value="YES" --> |
| <!--#endif --> |
| <!--#else --> |
| <!--#set var="STANDALONE" value="YES" --> |
| <!--#set var="INCLUDED" value="" --> |
| <!--#set var="TOC" value="" --> |
| <!--#set var="CONTENT" value="" --> |
| <!--#endif --> |
| <!--#if expr="$STANDALONE" --> |
| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> |
| <HTML> |
| <HEAD> |
| <TITLE>Apache Server Frequently Asked Questions</TITLE> |
| </HEAD> |
| <!-- Background white, links blue (unvisited), navy (visited), red (active) --> |
| <BODY |
| BGCOLOR="#FFFFFF" |
| TEXT="#000000" |
| LINK="#0000FF" |
| VLINK="#000080" |
| ALINK="#FF0000" |
| > |
| <!--#include virtual="header.html" --> |
| <H1 ALIGN="CENTER">Apache Server Frequently Asked Questions</H1> |
| <P> |
| $Revision: 1.4 $ ($Date: 2000/01/16 20:52:30 $) |
| </P> |
| <P> |
| The latest version of this FAQ is always available from the main |
| Apache web site, at |
| <<A |
| HREF="http://www.apache.org/docs/misc/FAQ.html" |
| REL="Help" |
| ><SAMP>http://www.apache.org/docs/misc/FAQ.html</SAMP></A>>. |
| </P> |
| <!-- Notes about changes: --> |
| <!-- - If adding a relative link to another part of the --> |
| <!-- documentation, *do* include the ".html" portion. There's a --> |
| <!-- good chance that the user will be reading the documentation --> |
| <!-- on his own system, which may not be configured for --> |
| <!-- multiviews. --> |
| <!-- - When adding items, make sure they're put in the right place --> |
| <!-- - verify that the numbering matches up. --> |
| <!-- - *Don't* use <PRE></PRE> blocks - they don't appear --> |
| <!-- correctly in a reliable way when this is converted to text --> |
| <!-- with Lynx. Use <DL><DD><CODE>xxx<BR>xx</CODE></DD></DL> --> |
| <!-- blocks inside a <P></P> instead. This is necessary to get --> |
| <!-- the horizontal and vertical indenting right. --> |
| <!-- - Don't forget to include an HR tag after the last /P tag --> |
| <!-- but before the /LI in an item. --> |
| <P> |
| If you are reading a text-only version of this FAQ, you may find numbers |
| enclosed in brackets (such as "[12]"). These refer to the list of |
| reference URLs to be found at the end of the document. These references |
| do not appear, and are not needed, for the hypertext version. |
| </P> |
| <H2>The Questions</H2> |
| <OL TYPE="A"> |
| <!--#endif --> |
| <!--#if expr="$TOC || $STANDALONE" --> |
| <LI VALUE="9"><STRONG>Features</STRONG> |
| <OL> |
| <LI><A HREF="#proxy">Does or will Apache act as a Proxy server?</A> |
| </LI> |
| <LI><A HREF="#multiviews">What are "multiviews"?</A> |
| </LI> |
| <LI><A HREF="#putsupport">Why can't I publish to my Apache server |
| using PUT on Netscape Gold and other programs?</A> |
| </LI> |
| <LI><A HREF="#SSL-i">Why doesn't Apache include SSL?</A> |
| </LI> |
| <LI><A HREF="#footer">How can I attach a footer to my documents |
| without using SSI?</A> |
| </LI> |
| <LI><A HREF="#search">Does Apache include a search engine?</A> |
| </LI> |
| <LI><A HREF="#rotate">How can I rotate my log files?</A> |
| </LI> |
| </OL> |
| </LI> |
| <!--#endif --> |
| <!--#if expr="$STANDALONE" --> |
| </OL> |
| |
| <HR> |
| |
| <H2>The Answers</H2> |
| <!--#endif --> |
| <!--#if expr="! $TOC" --> |
| |
| <H3>I. Features</H3> |
| <OL> |
| |
| <LI><A NAME="proxy"> |
| <STRONG>Does or will Apache act as a Proxy server?</STRONG> |
| </A> |
| <P> |
| Apache version 1.1 and above comes with a |
| <A HREF="../mod/mod_proxy.html">proxy module</A>. |
| If compiled in, this will make Apache act as a caching-proxy server. |
| </P> |
| <HR> |
| </LI> |
| |
| <LI><A NAME="multiviews"> |
| <STRONG>What are "multiviews"?</STRONG> |
| </A> |
| <P> |
| "Multiviews" is the general name given to the Apache |
| server's ability to provide language-specific document variants in |
| response to a request. This is documented quite thoroughly in the |
| <A HREF="../content-negotiation.html" REL="Help">content negotiation</A> |
| description page. In addition, <CITE>Apache Week</CITE> carried an |
| article on this subject entitled |
| "<A HREF="http://www.apacheweek.com/features/negotiation" REL="Help" |
| ><CITE>Content Negotiation Explained</CITE></A>". |
| </P> |
| <HR> |
| </LI> |
| |
| <LI><A NAME="putsupport"> |
| <STRONG>Why can't I publish to my Apache server using PUT on |
| Netscape Gold and other programs?</STRONG> |
| </A> |
| <P> |
| Because you need to install and configure a script to handle |
| the uploaded files. This script is often called a "PUT" handler. |
| There are several available, but they may have security problems. |
| Using FTP uploads may be easier and more secure, at least for now. |
| For more information, see the <CITE>Apache Week</CITE> article |
| <A HREF="http://www.apacheweek.com/features/put" |
| ><CITE>Publishing Pages with PUT</CITE></A>. |
| </P> |
| <HR> |
| </LI> |
| |
| <LI><A NAME="SSL-i"> |
| <STRONG>Why doesn't Apache include SSL?</STRONG> |
| </A> |
| <P> |
| SSL (Secure Socket Layer) data transport requires encryption, and many |
| governments have restrictions upon the import, export, and use of |
| encryption technology. If Apache included SSL in the base package, |
| its distribution would involve all sorts of legal and bureaucratic |
| issues, and it would no longer be freely available. Also, some of |
| the technology required to talk to current clients using SSL is |
| patented by <A HREF="http://www.rsa.com/">RSA Data Security</A>, |
| who restricts its use without a license. |
| </P> |
| <P> |
| Some SSL implementations of Apache are available, however; see the |
| "<A HREF="http://www.apache.org/related_projects.html" |
| >related projects</A>" |
| page at the main Apache web site. |
| </P> |
| <P> |
| You can find out more about this topic in the <CITE>Apache Week</CITE> |
| article about |
| <A HREF="http://www.apacheweek.com/features/ssl" REL="Help" |
| ><CITE>Apache and Secure Transactions</CITE></A>. |
| </P> |
| <HR> |
| </LI> |
| <LI><A NAME="footer"> |
| <STRONG>How can I attach a footer to my documents |
| without using SSI?</STRONG> |
| </A> |
| <P> |
| You can make arbitrary changes to static documents by configuring an |
| <A HREF="http://www.apache.org/docs/mod/mod_actions.html#action"> |
| Action</A> which launches a CGI script. The CGI is then |
| responsible for setting a content-type and delivering the requested |
| document (the location of which is passed in the |
| <SAMP>PATH_TRANSLATED</SAMP> environment variable), along with |
| whatever footer is needed. |
| </P> |
| <P> |
| Busy sites may not want to run a CGI script on every request, and |
| should consider using an Apache module to add the footer. There are |
| several third party modules available through the <A |
| HREF="http://modules.apache.org/">Apache Module Registry</A> which |
| will add footers to documents. These include mod_trailer, PHP |
| (<SAMP>php3_auto_append_file</SAMP>), and mod_perl |
| (<SAMP>Apache::Sandwich</SAMP>). |
| </P> |
| <HR> |
| </LI> |
| <LI><A NAME="search"> |
| <STRONG>Does Apache include a search engine?</STRONG> |
| </A> |
| <P>Apache does not include a search engine, but there are many good |
| commercial and free search engines which can be used easily with |
| Apache. Some of them are listed on the <A |
| HREF="http://www.searchtools.com/tools/tools.html">Web Site Search |
| Tools</A> page. Open source search engines that are often used with |
| Apache include <A HREF="http://www.htdig.org/">ht://Dig</A> and <A |
| HREF="http://sunsite.berkeley.edu/SWISH-E/">SWISH-E</A>. |
| </P> |
| <HR> |
| </LI> |
| <LI><A NAME="rotate"> |
| <STRONG>How can I rotate my log files?</STRONG> |
| </A> |
| <P>The simple answer: by piping the transfer log into an appropriate |
| log file rotation utility.</P> |
| <P>The longer answer: In the src/support/ directory, you will find a |
| utility called <CODE>rotatelogs</CODE> which can be used like this:<PRE> |
| TransferLog "|/path/to/rotatelogs /path/to/logs/access_log 86400" |
| </PRE> to enable daily rotation of the log files.<BR> |
| A more sophisticated solution of a logfile rotation utility is |
| available under the name <CODE>cronolog</CODE> from Andrew Ford's site at |
| <A HREF="http://www.ford-mason.co.uk/resources/cronolog/" |
| >http://www.ford-mason.co.uk/resources/cronolog/</A>. It can automatically |
| create logfile subdirectories based on time and date, and can have a |
| constant symlink point to the rotating logfiles. (As of version 1.6.1, |
| cronolog is available under the <A HREF="../LICENSE">Apache License</A>). |
| Use it like this:<PRE> |
| CustomLog "|/path/to/cronolog --symlink=/usr/local/apache/logs/access_log /usr/local/apache/logs/%Y/%m/access_log" combined |
| </PRE></P> |
| <HR> |
| </LI> |
| </OL> |
| <!--#endif --> |
| <!--#if expr="$STANDALONE" --> |
| <!-- Don't forget to add HR tags at the end of each list item.. --> |
| |
| <!--#include virtual="footer.html" --> |
| </BODY> |
| </HTML> |
| <!--#endif --> |