1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
"http://www.w3.org/TR/REC-html40/loose.dtd">
<HTML>
<HEAD>
<TITLE>Apache HTTP Server: Notes about Compatibility with NCSA's Server</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" -->
<blockquote><strong>Warning:</strong>
This document has not been updated to take into account changes
made in the 2.0 version of the Apache HTTP Server. Some of the
information may still be relevant, but please use it
with care.
</blockquote>
<H1 ALIGN="CENTER">Compatibility Notes with NCSA's Server</H1>
<HR>
While Apache is for the most part a drop-in replacement for NCSA's
httpd, there are a couple gotcha's to watch out for. These are mostly
due to the fact that the parser for config and access control files
was rewritten from scratch, so certain liberties the earlier servers
took may not be available here. These are all easily fixable. If you
know of other problems that belong here, <A
HREF="http://www.apache.org/bug_report.html">let us know.</A>
<P>Please also check the <A HREF="known_client_problems.html">known
client problems</A> page.
<OL>
<LI>As of Apache 1.3.1, methods named in a
<A HREF="../mod/core.html#limit"><SAMP><Limit></SAMP></A>
section <EM>must</EM> be listed in upper-case. Lower- or mixed-case
method names will result in a configuration error.
<P>
</P>
</LI>
<LI>The basic mod_auth <CODE>AuthGroupFile</CODE>-specified group file
format allows commas between user names - Apache does not.
<P>
<LI>If you follow the NCSA guidelines for setting up access
restrictions based on client domain, you may well have added
entries for <CODE>AuthType, AuthName, AuthUserFile</CODE> or
<CODE>AuthGroupFile</CODE>. <STRONG>None</STRONG> of these are
needed (or appropriate) for restricting access based on client
domain. When Apache sees <CODE>AuthType</CODE> it (reasonably)
assumes you are using some authorization type based on username
and password. Please remove <CODE>AuthType</CODE>, it's
unnecessary even for NCSA.
<P>
<LI><CODE>OldScriptAlias</CODE> is no longer supported.
<P>
<LI><CODE>exec cgi=""</CODE> produces reasonable <STRONG>malformed
header</STRONG> responses when used to invoke non-CGI scripts.<BR>
The NCSA code ignores the missing header (bad idea).
<BR>Solution: write CGI to the CGI spec and use
<CODE>include virtual</CODE>, or use <CODE>exec cmd=""</CODE> instead.
<P>
<LI>Icons for FancyIndexing broken - well, no, they're not broken,
we've just upgraded the icons from flat .xbm files to pretty and
much smaller .gif files, courtesy of <A
HREF="mailto:kevinh@eit.com">Kevin Hughes</A> at <A
HREF="http://www.eit.com/">EIT</A>. If you are using the same
srm.conf from an old distribution, make sure you add the new <A
HREF="../mod/mod_autoindex.html#addicon">AddIcon</A>, <A
HREF="../mod/mod_autoindex.html#addiconbytype">AddIconByType</A>,
and <A
HREF="../mod/mod_autoindex.html#defaulticon">DefaultIcon</A>
directives.
<P>
<LI>Apache versions before 1.2b1 will ignore the last line of configuration
files if the last line does not have a trailing newline. This affects
configuration files (httpd.conf, access.conf and srm.conf), and
htpasswd and htgroup files.
<P>
<LI>Apache does not permit commas delimiting the methods in <Limit>.
<P>
<LI>Apache's <CODE><VirtualHost></CODE> treats all addresses as
"optional" (<EM>i.e.</EM>, the server should continue booting if it can't
resolve the address). Whereas in NCSA the default is to fail
booting unless an added <CODE>optional</CODE> keyword is included.
<P>
<LI>Apache does not implement <CODE>OnDeny</CODE>; use
<A HREF="../mod/core.html#errordocument"><CODE>ErrorDocument</CODE></A>
instead.
<P>
<LI>Apache (as of 1.3) always performs the equivalent of
<CODE>HostnameLookups minimal</CODE>. <CODE>minimal</CODE> is not an
option to <A HREF="../mod/core.html#hostnamelookups"><CODE>
HostnameLookups</CODE></A>.
<P>
<LI>To embed spaces in directive arguments NCSA used a backslash
before the space. Apache treats backslashes as normal characters. To
embed spaces surround the argument with double-quotes instead.
<P>
<LI>Apache does not implement the NCSA <CODE>referer</CODE>
directive. See <A HREF="http://bugs.apache.org/index/full/968">
PR#968</A> for a few brief suggestions on alternative ways to
implement the same thing under Apache.
<P>
<LI>Apache does not allow ServerRoot settings inside a VirtualHost
container. There is only one global ServerRoot in Apache; any desired
changes in paths for virtual hosts need to be made with the explicit
directives, <em>e.g.</em>, DocumentRoot, TransferLog, <EM>etc.</EM>
</OL>
More to come when we notice them....
<!--#include virtual="footer.html" -->
</BODY>
</HTML>
|
