From 785afc46d9cac26471223d6d1c12f16722995d50 Mon Sep 17 00:00:00 2001 From: Ken Coar Date: Tue, 24 Mar 1998 02:58:49 +0000 Subject: [PATCH] Time for some FAQ revamp work. Mostly cosmetic, but the LockFile issue has been added because it has certainly become a FAQ! git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@80639 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/misc/FAQ.html | 803 +++++++++++++++++++------------------- 1 file changed, 405 insertions(+), 398 deletions(-) diff --git a/docs/manual/misc/FAQ.html b/docs/manual/misc/FAQ.html index 5b44ad3c8b..34860716c5 100644 --- a/docs/manual/misc/FAQ.html +++ b/docs/manual/misc/FAQ.html @@ -15,7 +15,7 @@

Apache Server Frequently Asked Questions

- $Revision: 1.108 $ ($Date: 1998/02/18 21:07:25 $) + $Revision: 1.109 $ ($Date: 1998/03/24 02:58:49 $)

The latest version of this FAQ is always available from the main @@ -109,7 +109,7 @@ work?" What to do in case of problems

  • How compatible is Apache with my existing - NCSA 1.3 setup? + NCSA 1.3 setup?
  • How do I enable CGI execution in directories other than the ScriptAlias? @@ -129,149 +129,155 @@
  • What are "multiviews"?
  • Why can't I run more than <n> - virtual hosts? + virtual hosts?
    • -
  • Can I increase FD_SETSIZE on FreeBSD? +
  • Can I increase FD_SETSIZE + on FreeBSD?
  • Why do I keep getting "access denied" for - form POST requests? + form POST requests?
  • Can I use my /etc/passwd file - for Web page authentication? + for Web page authentication?
  • Why doesn't my ErrorDocument - 401 work? + 401 work?
  • How can I use ErrorDocument - and SSI to simplify customized error messages? + and SSI to simplify customized error messages?
  • Why do I get "setgid: Invalid - argument" at startup? + argument" at startup?
  • Why does Apache send a cookie on every response?
  • Why don't my cookies work, I even compiled in - mod_cookies? + mod_cookies?
  • Why do my Java app[let]s give me plain text - when I request an URL from an Apache server? + when I request an URL from an Apache server?
  • Why can't I publish to my Apache server - using PUT on Netscape Gold and other programs? + using PUT on Netscape Gold and other programs?
  • Why isn't FastCGI included with Apache any - more? + more?
  • Why am I getting "httpd: could not - set socket option TCP_NODELAY" in my error log? + set socket option TCP_NODELAY" in my error log?
  • Why am I getting "connection - reset by peer" in my error log? + reset by peer" in my error log?
  • How can I get my script's output without - Apache buffering it? Why doesn't my server push work? + Apache buffering it? Why doesn't my server push work?
  • Why do I get complaints about redefinition - of "struct iovec" when compiling under Linux? + of "struct iovec" when compiling under Linux?
  • The errorlog says Apache dumped core, - but where's the dump file? + but where's the dump file?
  • Why isn't restricting access by host or domain name - working correctly? + working correctly?
  • Why doesn't Apache include SSL?
  • Why do I get core dumps under HPUX using - HP's ANSI C compiler? + HP's ANSI C compiler?
  • How do I get Apache to send a MIDI file so the - browser can play it? + browser can play it?
  • Why won't Apache compile with my - system's cc? + system's cc?
    • -
  • How do I add browsers and referrers to my - logs? +
  • How do I add browsers and referrers to my logs?
  • Why do I get an error about an undefined - reference to "__inet_ntoa" or other - __inet_* symbols? + reference to "__inet_ntoa" or other + __inet_* symbols?
  • Why does accessing directories only work - when I include the trailing "/" - (e.g., http://foo.domain.com/~user/) but - not when I omit it - (e.g., http://foo.domain.com/~user)? + when I include the trailing "/" + (e.g., http://foo.domain.com/~user/) but + not when I omit it + (e.g., http://foo.domain.com/~user)?
  • How do I set up Apache to require - a username and password to access certain documents? + a username and password to access certain documents?
  • Why is the environment variable - REMOTE_USER not set? + REMOTE_USER not set?
  • How do I set up Apache to allow access - to certain documents only if a site is either a local site - or the user supplies a password and username? + to certain documents only if a site is either a local site + or the user supplies a password and username?
  • Why doesn't mod_info list any - directives? -
  • When I run it under Linux I get "shmget: - function not found", what should I do? + directives? +
    • +
  • When I run it under Linux I get "shmget: + function not found", what should I do?
  • Why does my authentication give - me a server error? + me a server error? +
  • Do I have to keep the (mSQL) - authentication information on the same machine? + authentication information on the same machine?
  • Why is my mSQL authentication terribly slow?
  • Where can I find mod_rewrite rulesets - which already solve particular URL-related problems? + which already solve particular URL-related problems?
    • -
  • Where can I find any published information about - URL-manipulations and mod_rewrite? +
  • Where can I find any published information + about URL-manipulations and mod_rewrite?
  • Why is mod_rewrite so difficult to learn - and seems so complicated? + and seems so complicated?
  • What can I do if my RewriteRules don't work - as expected? + as expected?
  • Why don't some of my URLs get - prefixed with DocumentRoot when using mod_rewrite? + prefixed with DocumentRoot when using mod_rewrite?
  • How can I make all my URLs case-insensitive - with mod_rewrite? + with mod_rewrite?
  • Why are RewriteRules in my VirtualHost - parts ignored? + parts ignored?
  • How can I use strings with whitespaces - in RewriteRule's ENV flag? + in RewriteRule's ENV flag?
  • Where can I find the "CGI - specification"? + specification"?
  • Is Apache Year 2000 compliant?
  • I upgraded to Apache 1.3b and now my - virtual hosts don't work! + virtual hosts don't work!
  • I'm using RedHat Linux and I have problems with httpd - dying randomly or not restarting properly -
    • -
  • I upgraded from an Apache version earlier - than 1.2.0 and suddenly I have problems with Apache dying randomly - or not restarting properly -
    • -
  • I'm using RedHat Linux and my .htm files are showing - up as html source rather than being formatted! -
    • -
  • I'm using RedHat Linux 5.0, or some other glibc - based Linux system, and I get errors with the crypt function when - I attempt to build Apache 1.2. -
    • + dying randomly or not restarting properly + +
  • I upgraded from an Apache version earlier + than 1.2.0 and suddenly I have problems with Apache dying randomly + or not restarting properly +
    • +
  • I'm using RedHat Linux and my .htm files are + showing up as HTML source rather than being formatted! +
    • +
  • I'm using RedHat Linux 5.0, or some other + glibc-based Linux system, and I get errors with the + crypt function when I attempt to build Apache 1.2. +
    • +
  • Server hangs, or fails to start, and/or error log + fills with "fcntl: F_SETLKW: No record locks + available" or similar messages +
    • @@ -297,12 +303,11 @@ Since it began, it has been completely rewritten, and includes many new features. Apache is, as of January 1997, the most popular WWW server on the Internet, according to the - Netcraft Survey. + Netcraft Survey.

    +
  • Why was Apache created? @@ -314,6 +319,7 @@

    • +
  • How does The Apache Group's work relate to other server efforts, such as NCSA's? @@ -326,6 +332,7 @@

    • +
  • Why the name "Apache"? @@ -336,14 +343,13 @@

    • +
  • OK, so how does Apache compare to other servers?

    For an independent assessment, see - Web Compare's + Web Compare's comparison chart.

    @@ -358,6 +364,7 @@

    • +
  • How thoroughly tested is Apache? @@ -371,12 +378,12 @@

    The Apache project's web site includes a page with a partial list of - sites running Apache. + sites running + Apache.

    • +
  • What are the future plans for Apache? @@ -396,6 +403,7 @@

    • +
  • Whom do I contact for support? @@ -403,12 +411,9 @@ There is no official support for Apache. None of the developers want to be swamped by a flood of trivial questions that can be resolved elsewhere. Bug reports and suggestions should be sent via - the bug report page. + the bug report page. Other questions should be directed to the - comp.infosystems.www.servers.unix newsgroup, where some of the Apache team lurk, in the company of many other httpd gurus who should be able @@ -420,44 +425,36 @@

    • +
  • Is there any more information available on Apache?

    Indeed there is. See the main - Apache web site. + Apache web site. There is also a regular electronic publication called - Apache Week + Apache Week available. Links to relevant Apache Week articles are included below where appropriate. There are also some - Apache-specific books available.

    • +
  • Where can I get Apache?

    You can find out how to download the source for Apache at the project's - main web page. + main web page.

    • -

    - Technical Questions -

    +

    Technical Questions

    1. "Why can't I ...? Why won't ... work?" What to @@ -476,16 +473,12 @@ & fix the problem yourself (such as file permissions or the like). The default location of the error log is /usr/local/apache/logs/error_log, but see the - ErrorLog + ErrorLog directive in your config files for the location on your server.

    2. Check the - FAQ! + FAQ!

      The latest version of the Apache Frequently-Asked Questions list can always be found at the main Apache web site. @@ -495,9 +488,7 @@

      Most problems that get reported to The Apache Group are recorded in the - bug database. + bug database. Please check the existing reports, open and closed, before adding one. If you find that your issue has already been reported, please don't add @@ -513,8 +504,7 @@

      A lot of common problems never make it to the bug database because there's already high Q&A traffic about them in the - comp.infosystems.www.servers.unix newsgroup. Many Apache users, and some of the developers, can be found roaming its virtual halls, so it is suggested that you seek @@ -529,9 +519,7 @@ If you've gone through those steps above that are appropriate and have obtained no relief, then please do let The Apache Group know about the problem by - logging a bug report. + logging a bug report.

      If your problem involves the server crashing and generating a core @@ -555,6 +543,7 @@

    +
  • How compatible is Apache with my existing NCSA 1.3 setup? @@ -577,15 +566,14 @@

    • +
  • How do I enable CGI execution in directories other than the ScriptAlias?

    Apache recognizes all files in a directory named as a - ScriptAlias + ScriptAlias as being eligible for execution rather than processing as normal documents. This applies regardless of the file name, so scripts in a ScriptAlias directory don't need to be named @@ -598,9 +586,7 @@ directories where normal documents may also live, you must tell it how to recognize them - and also that it's okay to execute them. For this, you need to use something like the - AddHandler + AddHandler directive.

    @@ -620,9 +606,7 @@

  • Make sure that the directory location is covered by an - Options + Options declaration that includes the ExecCGI option.
    • @@ -632,16 +616,13 @@ allow all files named "*.cgi" to be executable. Perhaps all you want is to enable a particular file in a normal directory to be executable. This can be alternatively accomplished - via - mod_rewrite + via mod_rewrite and the following steps:

    1. Locally add to the corresponding .htaccess file a ruleset - similar to this one: + similar to this one:

      RewriteEngine on @@ -654,16 +635,15 @@

    2. Make sure that the directory location is covered by an - Options - declaration that includes the ExecCGI and - FollowSymLinks option. + Options + declaration that includes the ExecCGI and + FollowSymLinks option.

    +
  • What does it mean when my CGIs fail with "Premature end of script headers"? @@ -720,6 +700,7 @@

    • +
  • How do I enable SSI (parsed HTML)? @@ -738,34 +719,25 @@ resource-consumptive, and is not enabled by default. It can also interfere with the cachability of your documents, which can put a further load on your server. (see the - next question - for more information about this.) + next question for more information about this.)

    To enable SSI processing, you need to

    • Build your server with the - mod_include + mod_include module. This is normally compiled in by default.
    • Make sure your server configuration files have an - Options + Options directive which permits Includes.
    • Make sure that the directory where you want the SSI documents to live is covered by the "server-parsed" content handler, either explicitly or in some ancestral location. That can be done with the following - AddHandler + AddHandler directive:

      @@ -773,22 +745,22 @@

      +

      This indicates that all files ending in ".shtml" in that location (or its descendants) should be parsed. Note that using ".html" will cause all normal HTML files to be parsed, which may put an inordinate load on your server. +

    - For additional information, see the Apache Week article - on - Apache Week article on + Using Server Side Includes.

    • +
  • Why don't my parsed files get cached? @@ -808,14 +780,9 @@

    You can work around this in some cases by causing an Expires header to be generated. (See the - mod_expires + mod_expires documentation for more details.) Another possibility is to use the - XBitHack Full mechanism, which tells Apache to send (under certain circumstances detailed in the XBitHack directive description) a @@ -827,6 +794,7 @@

    • +
  • How can I have my script output parsed? @@ -845,19 +813,18 @@

    • +
  • Does or will Apache act as a Proxy server?

    Apache version 1.1 and above comes with a - proxy module. - If compiled - in, this will make Apache act as a caching-proxy server. + proxy module. + If compiled in, this will make Apache act as a caching-proxy server.

    • +
  • What are "multiviews"? @@ -865,19 +832,15 @@ "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 - content negotiation + content negotiation description page. In addition, Apache Week carried an article on this subject entitled - "Content Negotiation Explained".

    • +
  • Why can't I run more than <n> virtual hosts? @@ -896,9 +859,7 @@ Each log file requires a file descriptor, which means that if you are using separate access and error logs for each virtual host, each virtual host needs two file descriptors. Each - Listen + Listen directive also needs a file descriptor.

    @@ -915,39 +876,31 @@

    1. Reduce the number of - Listen - directives. If there are no other servers running on the machine - on the same port then you normally don't - need any Listen directives at all. By default Apache listens to - all addresses on port 80. + Listen + directives. If there are no other servers running on the machine + on the same port then you normally don't + need any Listen directives at all. By default Apache listens to + all addresses on port 80.
    2. Reduce the number of log files. You can use - mod_log_config - to log all requests to a single log file while including the name - of the virtual host in the log file. You can then write a - script to split the logfile into separate files later if - necessary. + mod_log_config + to log all requests to a single log file while including the name + of the virtual host in the log file. You can then write a + script to split the logfile into separate files later if + necessary. Such a script is provided with the Apache 1.3 distribution + in the src/support/split-logfile file.
    3. Increase the number of file descriptors available to the server - (see your system's documentation on the limit or - ulimit commands). For some systems, information on - how to do this is available in the - performance hints - page. There is a specific note for - FreeBSD below. + (see your system's documentation on the limit or + ulimit commands). For some systems, information on + how to do this is available in the + performance hints page. There is a specific + note for FreeBSD below.
    4. "Don't do that" - try to run with fewer virtual hosts
    5. Spread your operation across multiple server processes (using - Listen + Listen for example, but see the first point) and/or ports.
    @@ -971,9 +924,10 @@ defaults to 256. This means that you will have trouble usefully using more than 256 file descriptors in Apache. This can be increased, but doing so can be tricky. - +

    +

    If you are using a version prior to 2.2, you need to recompile your - kernel with a larger FD_SETSIZE. This can be done by adding a + kernel with a larger FD_SETSIZE. This can be done by adding a line such as:

    @@ -981,18 +935,19 @@

    - To your kernel config file. Starting at version 2.2, this is no + to your kernel config file. Starting at version 2.2, this is no longer necessary.

    If you are using a version of 2.1-stable from after 1997/03/10 or 2.2 or 3.0-current from before 1997/06/28, there is a limit in the resolver library that prevents it from using more file descriptors - than what FD_SETSIZE is set to when libc is compiled. To increase - this, you have to recompile libc with a higher FD_SETSIZE. + than what FD_SETSIZE is set to when libc is compiled. To + increase this, you have to recompile libc with a higher + FD_SETSIZE.

    - In FreeBSD 3.0, the default FD_SETSIZE has been increased to + In FreeBSD 3.0, the default FD_SETSIZE has been increased to 1024 and the above limitation in the resolver library has been removed.

    @@ -1034,6 +989,7 @@

    • +
  • Can I use my /etc/passwd file for Web page authentication? @@ -1088,6 +1044,7 @@

    • +
  • Why doesn't my ErrorDocument 401 work? @@ -1095,16 +1052,15 @@ You need to use it with a URL in the form "/foo/bar" and not one with a method and hostname such as "http://host/foo/bar". See the - ErrorDocument + ErrorDocument documentation for details. This was incorrectly documented in the past.

    • +
  • How can I use ErrorDocument - and SSI to simplify customized error messages? + and SSI to simplify customized error messages?

    Have a look at this document. @@ -1115,48 +1071,44 @@

    • +
  • Why do I get "setgid: Invalid argument" at startup?

    Your - Group + Group directive (probably in conf/httpd.conf) needs to name a group that actually exists in the /etc/group file (or your system's equivalent).

    • +
  • Why does Apache send a cookie on every response?

    Apache does not send automatically send a cookie on every response, unless you have re-compiled it with the - mod_cookies + mod_cookies module. This module was distributed with Apache prior to 1.2. This module may help track users, and uses cookies to do this. If you are not using the data generated by mod_cookies, do not compile it into Apache. Note that in 1.2 this module was renamed to the more correct name - mod_usertrack, + mod_usertrack, and cookies have to be specifically enabled with the - CookieTracking directive.

    • +
  • Why don't my cookies work, I even compiled in mod_cookies? @@ -1165,9 +1117,7 @@

    Firstly, you do not need to compile in mod_cookies in order for your scripts to work (see the - previous question + previous question for more about mod_cookies). Apache passes on your Set-Cookie header fine, with or without this module. If cookies do not work it will be because your script does not work @@ -1176,7 +1126,8 @@

    • -
  • + +
  • Why do my Java app[let]s give me plain text when I request an URL from an Apache server? @@ -1221,13 +1172,13 @@

    More information about this issue can be found in the - Java and HTTP/1.1 page at the Apache web site.

    • +
  • Why can't I publish to my Apache server using PUT on Netscape Gold and other programs? @@ -1238,12 +1189,12 @@ 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 Apache Week article - Publishing Pages with PUT.

    • +
  • Why isn't FastCGI included with Apache any more? @@ -1251,8 +1202,7 @@ The simple answer is that it was becoming too difficult to keep the version being included with Apache synchronized with the master copy at the - FastCGI web site. When a new version of Apache was released, the version of the FastCGI module included with it would soon be out of date.

    @@ -1262,6 +1212,7 @@

    • +
  • Why am I getting "httpd: could not set socket option TCP_NODELAY" in my error log? @@ -1274,6 +1225,7 @@

    • +
  • Why am I getting "connection reset by peer" in my error log? @@ -1288,6 +1240,7 @@

    • +
  • How can I get my script's output without Apache buffering it? Why doesn't my server push work? @@ -1350,6 +1303,7 @@

    • +
  • Why do I get complaints about redefinition of "struct iovec" when @@ -1374,6 +1328,7 @@

    • +
  • The errorlog says Apache dumped core, but where's the dump file? @@ -1400,8 +1355,7 @@ ServerRoot directory. As of Apache version 1.3, the location can be set via the - CoreDumpDirectory directive to a different directory. Make sure that this directory is writable by the user the server runs as (as opposed to the user the server @@ -1409,6 +1363,7 @@

    • +
  • Why isn't restricting access by host or domain name working correctly? @@ -1455,6 +1410,7 @@
    • +
  • Why doesn't Apache include SSL? @@ -1470,24 +1426,22 @@

    Some SSL implementations of Apache are available, however; see the - "related projects" page at the main Apache web site.

    You can find out more about this topic in the Apache Week article about - Apache and Secure Transactions.

    • +
  • Why do I get core dumps under HPUX using HP's ANSI - C compiler? + C compiler?

    We have had numerous reports of Apache dumping core when compiled @@ -1496,6 +1450,7 @@

    • +
  • How do I get Apache to send a MIDI file so the browser can play it? @@ -1531,9 +1486,10 @@
    • +
  • - Why won't Apache compile with my system's - cc? + Why won't Apache compile with my system's + cc?

    If the server won't compile on your system, it is probably due to one @@ -1577,27 +1533,22 @@ platforms there are. If you have verified that none of the above issues is the cause of your problem, and it hasn't been reported before, please submit a - problem report. + problem report. Be sure to include complete details, such as the compiler & OS versions and exact error messages.

    • +
  • How do I add browsers and referrers to my logs?

    Apache provides a couple of different ways of doing this. The recommended method is to compile the - mod_log_config + mod_log_config module into your configuration and use the - CustomLog + CustomLog directive.

    @@ -1619,14 +1570,13 @@

    You may want to check out the Apache Week article entitled: - "Gathering Visitor Information: Customising Your Logfiles".

    • +
  • Why do I get an error about an undefined reference to "__inet_ntoa" or other @@ -1670,15 +1620,16 @@

    • +
  • Why does accessing directories only work when I include - the trailing "/" + the trailing "/" (e.g., http://foo.domain.com/~user/) but not when I omit it (e.g., http://foo.domain.com/~user)?

    - When you access a directory without a trailing "/", Apache needs + When you access a directory without a trailing "/", Apache needs to send what is called a redirect to the client to tell it to add the trailing slash. If it did not do so, relative URLs would not work properly. When it sends the redirect, it needs to know @@ -1694,6 +1645,7 @@

    • +
  • How do I set up Apache to require a username and password to access certain documents? @@ -1706,39 +1658,32 @@

    For an explanation on how to implement these restrictions, see - Apache Week's + Apache Week's articles on - Using User Authentication or - DBM User Authentication.

    • +
  • - Why is the environment variable - REMOTE_USER not set? - + Why is the environment variable + REMOTE_USER not set? +

    This variable is set and thus available in SSI or CGI scripts if and only if the requested document was protected by access authentication. For an explanation on how to implement these restrictions, see - Apache Week's + Apache Week's articles on - Using User Authentication or - DBM User Authentication.

    @@ -1750,6 +1695,7 @@

    • +
  • How do I set up Apache to allow access to certain documents only if a site is either a local site or @@ -1789,14 +1735,12 @@

    • +
  • Why doesn't mod_info list any directives?

    - The - mod_info + The mod_info module allows you to use a Web browser to see how your server is configured. Among the information it displays is the list modules and their configuration directives. The "current" values for @@ -1806,18 +1750,17 @@ reloaded, the display will will not match the values actively in use. If the files and the path to the files are not readable by the user as which the server is running (see the - User + User directive), then mod_info cannot read them in order to list their values. An entry will be made in the error log in this event, however.

    • +
  • - When I run it under Linux I get "shmget: - function not found", what should I do? + When I run it under Linux I get "shmget: + function not found", what should I do?

    Your kernel has been built without SysV IPC support. You will have to @@ -1840,6 +1783,7 @@

    • +
  • Why does my authentication give me a server error? @@ -1896,6 +1840,7 @@

    • +
  • Do I have to keep the (mSQL) authentication information on the same machine? @@ -1916,6 +1861,7 @@

    • +
  • Why is my mSQL authentication terribly slow? @@ -1930,66 +1876,60 @@

    • +
  • - Where can I find mod_rewrite rulesets which already solve - particular URL-related problems? + Where can I find mod_rewrite rulesets which already solve + particular URL-related problems?

    There is a collection of - Practical Solutions for URL-Manipulation where you can find all typical solutions the author of - mod_rewrite + mod_rewrite currently knows of. If you have more interesting rulesets which solve particular problems not currently covered in this document, send it to - Ralf S. Engelschall + Ralf S. Engelschall for inclusion. The other webmasters will thank you for avoiding the reinvention of the wheel.

    • +
  • - Where can I find any published information about URL-manipulations and - mod_rewrite? + Where can I find any published information about + URL-manipulations and mod_rewrite?

    There is an article from - Ralf S. Engelschall about URL-manipulations based on - mod_rewrite + mod_rewrite in the "iX Multiuser Multitasking Magazin" issue #12/96. The german (original) version can be read online at - http://www.heise.de/ix/artikel/9612149/, + <http://www.heise.de/ix/artikel/9612149/>, the English (translated) version can be found at - http://www.heise.de/ix/artikel/E/9612149/. + <http://www.heise.de/ix/artikel/E/9612149/>.

    • +
  • - Why is mod_rewrite so difficult to learn and seems so - complicated? + Why is mod_rewrite so difficult to learn and seems so + complicated?

    Hmmm... there are a lot of reasons. First, mod_rewrite itself is a powerful - module which can help you in really all aspects of URL rewriting, so - it can be no trivial module per definition. To accomplish its hard job it - uses software leverage and makes use of a powerful regular expression + module which can help you in really all aspects of URL + rewriting, so it can be no trivial module per definition. To accomplish + its hard job it uses software leverage and makes use of a powerful regular + expression library by Henry Spencer which is an integral part of Apache since its version 1.2. And regular expressions itself can be difficult to newbies, while providing the most flexible power to the advanced hacker. @@ -2007,9 +1947,10 @@

    • +
  • - What can I do if my RewriteRules don't work as expected? - + What can I do if my RewriteRules don't work as expected? +

    Use "RewriteLog somefile" and @@ -2019,6 +1960,7 @@

    • +
  • Why don't some of my URLs get prefixed with DocumentRoot when using mod_rewrite? @@ -2033,9 +1975,10 @@

    • +
  • - How can I make all my URLs case-insensitive with mod_rewrite? - + How can I make all my URLs case-insensitive with mod_rewrite? +

    You can't! The reason is: First, case translations for arbitrary length URLs @@ -2055,9 +1998,9 @@

    • +
  • - Why are RewriteRules in my VirtualHost parts ignored? - + Why are RewriteRules in my VirtualHost parts ignored?

    Because you have to enable the engine for every virtual host explicitly due @@ -2066,9 +2009,10 @@

    • +
  • - How can I use strings with whitespaces in RewriteRule's ENV - flag? + How can I use strings with whitespaces in RewriteRule's ENV + flag?

    There is only one ugly solution: You have to surround the complete flag @@ -2079,8 +2023,10 @@

    • -
  • Where can I find the "CGI - specification"? + +
  • + Where can I find the "CGI specification"? +

    The Common Gateway Interface (CGI) specification can be found at the original NCSA site @@ -2089,8 +2035,15 @@ This version hasn't been updated since 1995, and there have been some efforts to update it.

    +

    + A new draft is being worked on with the intent of making it an informational + RFC; you can find out more about this project at + <http://web.golux.com/coar/cgi/>. +

    • +
  • Is Apache Year 2000 compliant? @@ -2112,12 +2065,9 @@

    Some aspects of Apache's output may use two-digit years, such as the automatic listing of directory contents provided by - mod_autoindex + mod_autoindex with the - FancyIndexing option enabled, but it is improper to depend upon such displays for specific syntax. And even that issue is being addressed by the @@ -2136,6 +2086,7 @@

    • +
  • I upgraded to Apache 1.3b and now my virtual hosts don't work! @@ -2149,8 +2100,7 @@

    Apache 1.3b2 introduced a new directive, - NameVirtualHost, which simplifies the rules quite a bit. However, changing the rules like this means that your existing name-based @@ -2184,91 +2134,148 @@

    • -
  • I'm using RedHat Linux and I have problems with httpd - dying randomly or not restarting properly - -

    RedHat Linux versions 4.x (and possibly earlier) rpms contain - various nasty scripts which do not stop or restart Apache properly. - These can affect you even if you're not running the RedHat supplied - rpms. - -

    If you're using the default install then you're probably running - Apache 1.1.3, which is outdated. From RedHat's ftp site you can - pick up a more recent RPM for Apache 1.2.x. This will solve one of - the problems. - -

    If you're using a custom built Apache rather than the RedHat rpms - then you should rpm -e apache. In particular you want - the mildly broken /etc/logrotate.d/apache script to be - removed, and you want the broken /etc/rc.d/init.d/httpd - (or httpd.init) script to be removed. The latter is - actually fixed by the apache-1.2.5 rpms but if you're building your - own Apache then you probably don't want the RedHat files. - -

    We can't stress enough how important it is for folks, especially - vendors to follow the stopping Apache - directions given in our documentation. In RedHat's defense, - the broken scripts were necessary with Apache 1.1.x because the - Linux support in 1.1.x was very poor, and there were various race - conditions on all platforms. None of this should be necessary with - Apache 1.2 and later. -

    -
    -
    • - -
  • I upgraded from an Apache version earlier - than 1.2.0 and suddenly I have problems with Apache dying randomly - or not restarting properly - -

    You should read the previous note about - problems with RedHat installations. It is entirely likely that your - installation has start/stop/restart scripts which were built for - an earlier version of Apache. Versions earlier than 1.2.0 had - various race conditions that made it necessary to use - kill -9 at times to take out all the httpd servers. - But that should not be necessary any longer. You should follow - the directions on how to stop - and restart Apache. - -

    As of Apache 1.3 there is a script - src/support/apachectl which, after a bit of - customization, is suitable for starting, stopping, and restarting - your server. -

    -
    - -
    • - -
  • I'm using RedHat Linux and my .htm files are showing - up as html source rather than being formatted! - -

    RedHat messed up and forgot to put a content type for .htm - files into /etc/mime.types. Edit /etc/mime.types, - find the line containing html and add htm to it. - Then restart your httpd server: - 

    -	kill -HUP `cat /var/run/httpd.pid`
-
    - Then clear your browsers' caches. (Many browsers won't re-examine - the content type after they've reloaded a page.) -

    -
    - -
  • I'm using RedHat Linux 5.0, or some other glibc - based Linux system, and I get errors with the crypt function when - I attempt to build Apache 1.2. - -

    glibc puts the crypt function into a separate library. Edit your - src/Configuration file and set this: - 

    -	EXTRA_LIBS=-lcrypt
-
    -

    -
    +
  • + I'm using RedHat Linux and I have problems with httpd + dying randomly or not restarting properly + +

    + RedHat Linux versions 4.x (and possibly earlier) rpms contain + various nasty scripts which do not stop or restart Apache properly. + These can affect you even if you're not running the RedHat supplied + rpms. +

    +

    + If you're using the default install then you're probably running + Apache 1.1.3, which is outdated. From RedHat's ftp site you can + pick up a more recent RPM for Apache 1.2.x. This will solve one of + the problems. +

    +

    + If you're using a custom built Apache rather than the RedHat rpms + then you should rpm -e apache. In particular you want + the mildly broken /etc/logrotate.d/apache script to be + removed, and you want the broken /etc/rc.d/init.d/httpd + (or httpd.init) script to be removed. The latter is + actually fixed by the apache-1.2.5 rpms but if you're building your + own Apache then you probably don't want the RedHat files. +

    +

    + We can't stress enough how important it is for folks, especially + vendors to follow the stopping Apache + directions given in our documentation. In RedHat's defense, + the broken scripts were necessary with Apache 1.1.x because the + Linux support in 1.1.x was very poor, and there were various race + conditions on all platforms. None of this should be necessary with + Apache 1.2 and later. +

    +
    +
    • + +
  • + I upgraded from an Apache version earlier + than 1.2.0 and suddenly I have problems with Apache dying randomly + or not restarting properly + + +

    + You should read the previous note about + problems with RedHat installations. It is entirely likely that your + installation has start/stop/restart scripts which were built for + an earlier version of Apache. Versions earlier than 1.2.0 had + various race conditions that made it necessary to use + kill -9 at times to take out all the httpd servers. + But that should not be necessary any longer. You should follow + the directions on how to stop + and restart Apache. +

    +

    As of Apache 1.3 there is a script + src/support/apachectl which, after a bit of + customization, is suitable for starting, stopping, and restarting + your server. +

    +
    +
    • + +
  • + I'm using RedHat Linux and my .htm files are showing + up as HTML source rather than being formatted! + + +

    + RedHat messed up and forgot to put a content type for .htm + files into /etc/mime.types. Edit /etc/mime.types, + find the line containing html and add htm to it. + Then restart your httpd server: +

    +
    +
    kill -HUP `cat /var/run/httpd.pid` +
    +
    +

    + Then clear your browsers' caches. (Many browsers won't + re-examine the content type after they've reloaded a page.) +

    +
    +
    • + +
  • + I'm using RedHat Linux 5.0, or some other + glibc-based Linux system, and I get errors with the + crypt function when I attempt to build Apache 1.2. + + +

    + glibc puts the crypt function into a separate + library. Edit your src/Configuration file and set this: +

    +
    +
    EXTRA_LIBS=-lcrypt +
    +
    +

    + Then re-run src/Configure and re-execute the make. +

    +
    +
    • + +
  • + Server hangs, or fails to start, and/or error log + fills with "fcntl: F_SETLKW: No record locks + available" or similar messages + + +

    + These are symptoms of a fine locking problem, which usually means that + the server is trying to use a synchronisation file on an NFS filesystem. +

    +

    + Because of its parallel-operation model, the Apache Web server needs to + provide some form of synchronisation when accessing certain resources. + One of these synchronisation methods involves taking out locks on a file, + which means that the filesystem whereon the lockfile resides must support + locking. In many cases this means it can't be kept on an + NFS-mounted filesystem. +

    +

    + To cause the Web server to work around the NFS locking limitations, include + a line such as the following in your server configuration files: +

    +
    +
    LockFile /var/run/apache-lock +
    +
    +

    + The directory should not be generally writable (e.g., don't use + /var/tmp). + See the LockFile + documentation for more information. +

    +
    +
    • - + -- 2.50.1