coar 97/10/20 18:10:28
Modified: htdocs/manual/misc FAQ.html
Log:
{Sigh} Add the suddenly FAQ about why virtual hosts don't
work after 1.3b2 upgrades..
PR: Too many to mention
Revision Changes Path
1.90 +46 -1 apachen/htdocs/manual/misc/FAQ.html
Index: FAQ.html
===================================================================
RCS file: /export/home/cvs/apachen/htdocs/manual/misc/FAQ.html,v
retrieving revision 1.89
retrieving revision 1.90
diff -u -r1.89 -r1.90
--- FAQ.html 1997/09/18 13:00:15 1.89
+++ FAQ.html 1997/10/21 01:10:27 1.90
@@ -15,7 +15,7 @@
<!--#include virtual="header.html" -->
<H1 ALIGN="CENTER">Apache Server Frequently Asked Questions</H1>
<P>
- $Revision: 1.89 $ ($Date: 1997/09/18 13:00:15 $)
+ $Revision: 1.90 $ ($Date: 1997/10/21 01:10:27 $)
</P>
<P>
The latest version of this FAQ is always available from the main
@@ -254,6 +254,9 @@
</LI>
<LI><A HREF="#year2000">Is Apache Year 2000 compliant?</A>
</LI>
+ <LI><A HREF="#namevhost">I upgraded to Apache 1.3b2 and now my
+ virtual hosts don't work!</A>
+ </LI>
</OL>
</LI>
</UL>
@@ -2100,6 +2103,48 @@
the magic boundary to worry about is the year 2038 and not 2000.
But modern operating systems shouldn't cause any trouble
at all.
+ </P>
+ <HR>
+ </LI>
+ <LI><A NAME="namevhost">
+ <STRONG>I upgraded to Apache 1.3b2 and now my virtual hosts don't
+ work!</STRONG>
+ </A>
+ <P>
+ In versions of Apache prior to 1.3b2, there was a lot of confusion
+ regarding address-based virtual hosts and (HTTP/1.1) name-based
+ virtual hosts, and the rules concerning how the server processed
+ <SAMP><VirtualHost></SAMP> definitions were very complex and not
+ well documented.
+ </P>
+ <P>
+ Apache 1.3b2 introduced a new directive,
+ <A
+ HREF="http://www.apache.org/docs/mod/core.html#namevirtualhost";
+ ><SAMP>NameVirtualHost</SAMP></A>,
+ which simplifies the rules quite a bit. However, changing the rules
+ like this means that your existing name-based
+ <SAMP><VirtualHost></SAMP> containers probably won't work
+ correctly immediately following the upgrade.
+ </P>
+ <P>
+ To correct this problem, add the following line to the beginning of
+ your server configuration file, before defining any virtual hosts:
+ </P>
+ <DL>
+ <DD><CODE>NameVirtualHost <EM>n.n.n.n</EM></CODE>
+ </DD>
+ </DL>
+ <P>
+ Replace the "<SAMP>n.n.n.n</SAMP>" with the IP address to
+ which the name-based virtual host names resolve; if you have multiple
+ name-based hosts on multiple addresses, repeat the directive for each
+ address.
+ </P>
+ <P>
+ Make sure that your name-based <SAMP><VirtualHost></SAMP> blocks
+ contain <SAMP>ServerName</SAMP> and possibly <SAMP>ServerAlias</SAMP>
+ directives so Apache can be sure to tell them apart correctly.
</P>
<HR>
</LI>
