`
`FAQ - Hltpd Wiki
`
`Frequently Asked Questions
`
`These are questions that have been asked over the years, on IRC, mailing lists, and
`various other less official channels.
`
`Contents
`
`1. Background
`1.
`What is Apache?
`2.
`How and why was Apache HTTP Server
`created?
`
`9°?‘-1.°"."'P.“
`
`9.
`10.
`
`11.
`
`Why the name "Apache"?
`How does Apache httpd performance compare
`to other servers?
`
`How thoroughly tested is Apache httpcl?
`What are the fiJture plans for Apache httpd?
`Whom do I contact for support?
`Is there any more information available on
`Apache httpd?
`Where can I get Apache httpd?
`Why isn't there a current binary for my
`platfonn?
`May I use the Apache logo on my product or
`Web site?
`
`2. General Technical Questions
`I.
`"Why can't I ...? Why won't work?" What to
`do in case of problems
`How do I submit a patch to Apache httpd?
`Why has Apache stolen my favourite site's
`Internet address?
`
`2.
`3.
`
`4.
`
`Why am I getting spam mail from the Apache
`site?
`
`May I include the Apache software on a CD or
`other package I'm distributing?
`‘What's the best hardwarefoperating system!
`How do I get the most out of my Apache Web
`server?
`
`7.
`3. Buil
`l.
`
`What are "regular expressions"?
`ding Apache httpd
`Why do I get an error about an undefined
`reference to "_inet___ntoa" or other_inet_*
`symbols?
`I get an error about "configure failed for
`srclib.r’apr"
`. Why won't Apache compile with my system's
`cc?
`
`4.
`
`5.
`
`Why do I get complaints about redefinition of
`"struct iovec" when compiling under Linux?
`I'm using gcc and I get some compilation
`errors. what is wrong?
`4. Error Log Messages and Problems Starting Apache
`1.
`Why do I get "setgid: Invalid argument" at
`startup?
`Why am I getting "httpd: could not set socket
`option TC P_NODELAY" in my error log?
`Why am I getting "connection reset by peer"
`
`2.
`
`3.
`
`htIp:f!\Niki.apache.org)httpdi'FAQ
`
`Columbia Ex 2045-1
`
`Symantec v Columbia
`IPR201 5-00375
`
`
`
`10!7f2015
`
`FAQ - Httpd Wild
`
`in my error log‘!
`The errorlog says Apache dumped core, but
`where's the dump file?
`When I run it under Linux I get "shmget:
`function not found", what should I do?
`Server hangs, or fails to start, andfor en'or log
`fills with "fcntl: F_SETLl(W: No record
`locks available" or similar messages
`. When] try to start Apache from a DOS
`window, I get a message like "Cannot
`determine host name. Use ServerName
`
`directive to set it manually." What does this
`mean?
`
`When I try to stan Apache on Windows, I get
`a message like "System error 1067 has
`occurred. The process terminated
`unexpectedly." What does this mean?
`On a SuSE Linux system. I try and configure
`access control using basic authentication.
`Although I follow the example exactly,
`authentication fails, and an error message
`"admin: not a valid FDN: ...." is logged.
`“Why am I getting server restart messages
`periodically, when I did not restart the server?
`Why am I getting "module module-name is
`not compatible with this version ofApache"
`messages in my error log?
`I've downloaded a module from a source I
`
`trust, but my LoadModule line is a syntax
`error?
`
`I0.
`
`11.
`
`12.
`
`4.
`U1
`
`9°
`
`10.
`
`5. Configuration Questions
`I.
`Why can't I rim more than <n> virtual hosts?
`2.
`Why doesn't my ErrorDocument 401 work?
`3.
`Why does Apache send a cookie on every
`response?
`Why don't my cookies work?
`. How do I add browsers and refeners to my
`logs?
`Why does accessing directories only work
`when I include the trailing "I" (e.g.,
`http:i’i’foo.domain.com{~usen’) but not when I
`omit it (e.g., http:X/foo.domain.eomf~user)?
`Why doesn't mod__info list any directives?
`My .litaccess files are being ignored.
`Why do I get :1 "Forbidden" message whenever
`I try to access a particular directory?
`Why do my files appear correctly in Internet
`Explorer, but show up as source or trigger a
`save window with Netscape; or, Why doesn't
`Internet Explorer render my textlplain
`document correctly?
`My site is accessible under many different
`hostnames; how do I redirect clients so that
`
`ll.
`
`they see only a single name?
`1. Use mod_rewrite as described in the
`"Canonical Hostnames" section of the
`
`URL Rewriting Guide.
`2. Use name-based virtual hosting:
`Why can I access my website from the server
`or from my local network, but I can't access it
`from elsewhere on the Internet?
`II---. .1- I 4...... ..-.¢.......4:.. .i2......a....._. l2...n.2......... ....
`
`12.
`
`I’?
`
`htlp:l?\Niki.epache.orgfl'1ttpd'FAQ
`
`Columbia Ex 2045-2
`
`Symantec v Columbia
`IPR201 5-00375
`
`
`
`10!7J'2015
`
`FAQ - Httpd Wiki
`1.1. UUW LIU 1 lL'|1Tl flLllUIllal.1C U1l'CClUI'}‘llSlll'lgS UH
`or off?
`
`14. Why do my Options directives not have the
`desired effect?
`
`15. How can I change the information that
`Apache returns about itselfin the headers?
`16. Why do I see requests for other sites appearing
`in my log files?
`6. Dynamic Content (CGI and S81)
`1. How do I enable CGI execution in directories
`
`other than the ScriptAlias?
`2. What does it mean when my CGIs fail with
`"Premature end of scri pt headers"?
`3. Why do I keep getting "Method Not Allowed"
`for form POST requests?
`4. How do I enable SSI (parsed HTML)?
`5. Why don't my parsed files get cached?
`6. How can I have my script output parsed?
`7. SSIs don't work for VirtualHosts andfor user
`home directories.
`
`8. Why is the environment variable
`REMOTE__USER not set?
`9. How do I allow each ofmy user directories to
`have a cgi-bin directory?
`?. Authentication and Access Restrictions
`
`1. Why isn't restricting access by host or domain
`name working correctly?
`2. How do I set up Apache to require a username
`and password to access certain documents?
`3. How do I set up Apache to allow access to
`certain documents only ifa site is either a
`local site or the user supplies a password and
`username?
`
`4. Why does my authentication give me a server
`error?
`
`5. Do I have to keep the (SQL) authentication
`information on the same machine?
`
`6. Can I use my Ietcfpasswd file for Web page
`authentication?
`
`7. Why does Apache ask for my password twice
`before serving a file?
`8. How can I prevent people fiom "stealing" the
`images from my web site?
`8. URL Rewriting
`1. Where can I find 1nod_rewrite rulesets which
`already solve particular URL-related
`problems?
`2. Where can I find any published infomiati on
`about URL-manipulations and mod_rewrite?
`3. Why is mod_rewrite so difficult to learn and
`seems so complicated?
`4. What can I do if my RewriteRules don't work
`as expected‘?
`5. Why don't some ofmy URLs get prefixed with
`DocumentRoot when using m0d_rewrite?
`6. How can I make all my URLs case-
`insensitive with mod_rewrite?
`7". Why are RewriteRules in my Virtuall-Iost
`parts ignored?
`8. How can I use strings with whitespaces in
`RewriteRule‘s ENV flag?
`o 1:99;...-as
`
`htlp:#\Niki.apache.orgfl'1ttpd!FAQ
`
`Columbia Ex 2045-3
`
`Symantec v Columbia
`IPR201 5-00375
`
`
`
`10!7f2015
`
`2.
`
`I
`
`|.rflI.l.I.lL-D
`
`FAQ - Httpd Wiki
`
`1. Does or will Apache act as a Proxy server?
`2. What are "multiviews"?
`
`3. Why can't I publish to my Apache server using
`PUT on Netscape Gold and other programs?
`4. How can I attach a footer to my documents
`without using SS1’?
`Does Apache include a search engine?
`9”!”
`How can I rotate my log files?
`7. How do I keep certain requests from appearing
`in my logs?
`8. Does Apache support any sort of database
`integration?
`9. Can I use Active Server Pages (ASP) with
`Apache?
`10. Does Apache come with Java support?
`
`Background
`
`What is Apache?
`
`The Apache HTTP Server
`
`0
`
`is a p0W6l'fUl, flexible, HTTP/1.1 compliant web server
`implements the latest protocols, including HTTP/1.1 (RFC2616)
`is highly configurable and extensible with third-party modules
`- can be customised by writing ‘modules’ using the Apache module AP]
`- provides full source code and comes with an unrestrictive license
`- runs on Windows 2000, Netware 5.x and above, OS/2, and most versions of Unix,
`as well as several other operating systems
`is actively being developed
`0
`I encourages user feedback through new ideas, bug reports and patches
`-
`implements many frequently requested features, including:
`0 DBM databases as well, as relational databases and LDAP for authentication
`0 allows you to easily set up password-protected pages with enormous numbers
`of authorized users, without bogging down the server.
`0 Customized responses to errors and problems
`0 Allows you to set up files, or even CGI scripts, which are returned by the
`server in response to errors and problems, e. g. setup a script to intercept 500
`Server Errors and perform on-the-fly diagnostics for both users and yourself.
`
`0 Multiple Directorylndex directives - Allows you to say Directorylndex
`indexhtml indeX.cgi, which instructs the server to either send back
`index.html or run index.cgi when a directory URL is requested, whichever it
`finds in the directory.
`
`0 Unlimited flexible URL rewriting and aliasing - Apache has no fixed limit on
`the numbers of Aliases and Redirects which may be declared in the config
`files. In addition, a powerful rewriting engine can be used to solve most URL
`manipulation problems.
`0 Content negotiation - i.e. the ability to automatically serve clients of varying
`sophistication and HTML level compliance, with documents which offer the
`Columbia Ex 2045-4
`
`hnp:a~iké.apache.orgmupct'FAo
`
`Symantec v Columbia
`IPR201 5-00375
`
`
`
`10!7f2015
`
`FAQ - Httpd Wiki
`
`best representation of information that the client is capable of accepting.
`0 Virtual Hosts - Allows the server to distinguish between requests made to
`different IP addresses or names (mapped to the same machine). Apache also
`offers dynamically configurable mass-virtual hosting.
`0 Configurable Reliable Piped Logs - You can configure Apache to generate
`logs in the fonnat that you want. In addition, on most Unix architectures,
`Apache can send log files to a pipe, allowing for log rotation, hit filtering,
`real-time splitting of multiple vhosts into separate logs, and asynchronous
`DNS resolving on the fly.
`
`How and Why was Apache HTTP Server created?
`
`The ® About Apache document explains how the Apache project evolved from its
`beginnings as an outgrowth of the NCSA httpd project to its current status as one of the
`fastest, most efficient, and most functional web servers in existence.
`
`Why the name "Apache"?
`
`The name ‘Apache’ was chosen from respect for the Native American Indian tribe of
`Apache (Indé), well-known for their superior skills in warfare strategy and their
`inexhaustible endurance. For more information on the Apache Nation, we suggest
`searching Google, or AllTheWeb.
`
`Secondarily, and more popularly (though incorrectly) accepted, it's a considered cute
`name which stuck. Apache is "A PAtCHy server". It was based on some existing code and
`a series of "patch files“.
`
`These days Apache as such means much more. It's first and foremost the Apache Software
`Foundation, under which there are dozens of projects.
`
`How does Apache httpd performance compare to other
`servers?
`
`Benchmarks tend to be a measure of configuration competance, rather than of server
`quality. That is, if you're an expert in IIS, you can probably get it to run faster than you
`can get Apache to run. You can therefore find comparisions of various HTTP servers that
`prove that each is faster than all the others. We tend to take server performance
`benchmarks with a grain of salt.
`
`How thoroughly tested is Apache httpd?
`
`Apache is run on over 120 million Internet servers (as of April 2010) (Source, ®
`Netcraft). It has been tested thoroughly by both developers and users. The Apache HTTP
`Server Project Management Committee maintains rigorous standards before releasing new
`versions of their server, and our server runs without a hitch on over one half of all ‘WWW
`
`servers available on the Internet. When bugs do show up, we release patches and new
`versions as soon as they are available.
`
`_
`Columbia Ex 2045-5
`
`hr:p:m~iké.apache.org»hupdrFAo
`
`Symantec v Columbia
`IPR201 5-00375
`
`
`
`10!7f2D15
`
`FAQ - Hnpd Wiki
`
`What are the future plans for Apache httpd?
`
`to continue to be an “open source" no-charge-for-use HTTP server,
`I
`to keep up with advances in HTTP protocol and web developments in general,
`I
`- to collect suggestions for fixes/improvements from its users,
`- to respond to needs of large volume providers as well as occasional users.
`
`Whom do I contact for support?
`
`See ® http://httpd.apache.org/supporthtml.
`
`Is there any more information available on Apache
`httpd?
`
`Indeed there is. See the © main Apache web server site. There are also many books
`about the Apache HTTP Server available.
`
`Where can I get Apache httpd?
`
`You can find out how to download the source for Apache at the ® main Apache web
`server site.
`
`Why isn't there a current binary for my platform?
`
`The occasional availability of binaries for one platform or another at Q
`http://httpd.apache.org/dist/httpd/binaries/ has been a source of confusion for the user
`community, particularly the large subset which uses the Windows platform and is not able
`to build httpd and prerequisites themselves.
`
`Producing binaries for general use is not part of the httpd release process. By policy the
`group does not formally release binaries and is in no position to ensure their consistent
`availability. (No mechanisms exist to review, test, and approve them -- we can only
`fonnally release source).
`
`If you are unable to build a binary for your platform, consult the Users mailing list for
`recommendations.
`
`Some sources for Windows binaries are documented at ® Using Apache HTTP Server on
`Microsoft Windows.
`
`May I use the Apache logo on my product or Web site?
`
`You may NOT use any original artwork from the Apache Software Foundation, nor make
`or use modified versions of such artwork, except under the conditions in the © Apache
`Trademark Policy document.
`
`hup:r~viké.apache.orgrnupdrFAo
`
`Columbia Ex 2045-6
`
`Symantec v Cdambia
`lPR201 5-00375
`
`
`
`10!7J'2015
`
`FAQ - Hltpd Wikl
`
`General Technical Questions
`
`"Why can't I ...? Why won't work?" What to do in
`case of problems
`
`If you are having trouble with your Apache server software, you should take the following
`steps:
`
`Check the errorlog!
`
`Apache tries to be helpful when it encounters a problem. In many cases, it will
`provide some details by writing one or messages to the server error log. Sometimes
`this is enough for you to diagnose & 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 directive in your config files
`for the location on your server.
`
`Check the FAQ!
`You're already here.
`
`Check the Apache bug database
`Most problems that get reported to The Apache Group are recorded in the 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 a "me, too"
`report. If the original report isn't closed yet, we suggest that you check it
`periodically. You might also consider contacting the original submitter, because
`there may be an email exchange going on about the issue that isn't getting recorded
`in the database.
`
`Ask in a user support group
`
`A lot of common problems never make it to the bug database because there's
`already high Q&A traffic about them in the Users mailing list or
`comp.infosystems.www.serversunix and related newsgroups. These newsgroups
`are also available via Google. Many Apache users, and some of the developers, can
`be found roaming their virtual halls, so it is suggested that you seek wisdom there.
`The chances are good that you'll get a faster answer there than from the bug
`database, even if you don't see your question already posted.
`
`If all else fails, report the problem in the bug database
`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.
`
`If your problem involves the server crashing and generating a core dump, please include a
`backtrace (if possible). As an example,
`
`# Cd ServerRo0t
`
`# dbx httpd core
`(dbx) where
`
`(Substitute the appropriate locations for your ServerRoot and your httpd and core filescolumbia Ex 20454
`
`hnp:m~iké.apache.orgmupd'FAo
`
`Symantec v Columbia
`IPR201 5-00375
`
`
`
`1017:2015
`
`FAQ- Hnpd Wiki
`
`You may have to use gdb instead of dbx.)
`
`How do I submit a patch to Apache httpd?
`
`Detailed information for submitting bug reports and patches may be found in the Q
`Apache HTTP Server developer documentation.
`
`Why has Apache stolen my favourite site's Internet
`address?
`
`The simple answer is: “It hasn't." This misconception is usually caused by the site in
`question having migrated to the Apache Web server software, but not having migrated the
`site's content yet. When Apache is installed, the default page that gets installed tells the
`Webmaster the installation was successful. The expectation is that this default page will
`be replaced with the site's real content. If it doesn't, complain to the Webmaster, not to the
`Apache project -—- we just make the software and aren't responsible for what people do (or
`don't do) with it.
`
`Why am I getting spam mail from the Apache site?
`
`The short answer is: "You aren't." Usually when someone thinks the Apache site is
`originating spam, it's because they've traced the spam to a Web site, and the Web site says
`it's using Apache. See the previous FAQ entry for more details on this phenomenon.
`
`No marketing spam originates from the Apache site. The only mail that comes from the
`site goes only to addresses that have been requested to receive the mail.
`
`May I include the Apache software on a CD or other
`package I'm distributing?
`
`The detailed answer to this question can be found in the Apache license, which is included
`in the Apache distribution in the file LICENSE. You can also find it on the Web at Q
`httpzi’/www.apache.org/licenses/.
`
`What's the best hardware/operating system/... How do I
`get the most out of my Apache Web server?
`
`Check out the ® performance tuning page.
`
`What are "regular expressions"?
`
`Regular expressions are a way of describing a pattern - for example, "all the words that
`begin with the letter A" or "every I0-di git phone number" or even "Every sentence with
`two commas in it, and no capital letter Q". Regular expressions (aka "regex"s) are useful
`Columbia Ex 2045-8
`
`ht:p:r~viké.apache.orgrnupdrFAo
`
`Symantec v Columbia
`IPRZO1 5-00375
`
`
`
`10!7f2D15
`
`FAQ- Httpd Wiki
`
`in Apache because they let you apply certain attributes against collections of files or
`resources in very flexible ways - for example, all .gif and .jpg files under any "images"
`directory could be written as /images/ . * ( j pg I git‘) $. Note that httpd doesn't need the
`delimiting / / so as to avoid "toothpicks" when matching URls or paths, like:
`/\/foo\/bar\/?/
`
`The best overview around is probably the © one which comes with Perl. Apache's
`regular expressions use ® PCRE - Perl Compatible Regular Expressions.
`
`Building Apache httpd
`
`Why do I get an error about an undefined reference to
`"_inet__ntoa" or other _inet__* symbols?
`
`If you have installed BIND-8 then this is normally due to a conflict between your include
`files and your libraries. BIND-8 installs its include files and libraries /usr/local/include/
`and /usr/localflib/, while the resolver that comes with your system is probably installed in
`!usr/include/ and /usrflib/. If your system uses the header files in :’usrflocal/include/ before
`those in fusrfincludel but you do not use the new resolver library, then the two versions
`will conflict.
`
`To resolve this, you can either make sure you use the include files and libraries that came
`with your system or make sure to use the new include files and libraries. Adding -lbind to
`the EXTRA_LDFLAGS line in your Configuration file, then re-running Configure,
`should resolve the problem. (Apache versions 1.2.* and earlier use EXTRA_LFLAGS
`instead.)
`
`Note:As of BIND 8.1.1, the hind libraries and files are installed under /usr/local/bind by
`default, so you should not run into this problem. Should you want to use the bind
`resolvers you'll have to add the following to the respective lines:
`
`EXTRA_CFLAG S=~I/usr/local/bind/include EXTRA_LDFLAG S=~L/usr/loealfbindllib
`EXTRA_LIBS=-lbind
`
`I get an error about "configure failed for srclib/apr"
`
`This only applies to Apache 2.4 and later‘
`
`If you are building with the --with-included-apr option, you also need to download the *-
`deps tarball that matches the main release that you are trying to build, and extract it into
`the same directory.
`
`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 of the following
`causes:
`
`htlp:f!vviki.apache.org!httpdJ'FAQ
`
`Columbia Ex 2045-9
`
`Symantec v Columbia
`IPRZO1 5-00375
`
`
`
`10!7f2015
`
`FAQ - Httpd Wiki
`
`The Configure script doesn't recognize your system environment.
`This might be either because it's completely unknown or because the specific
`environment (include files, OS version, et cetera) isn't explicitly handled. If this
`happens, you may need to port the server to your OS yourself.
`
`Your system's C compiler is garbage.
`Some operating systems include a default C compiler that is either not ANSI C-
`compliant or suffers from other deficiencies. The usual recommendation in cases
`like this is to acquire, install, and use gcc.
`
`Your include files may be confused.
`In some cases, we have found that a compiler installation or system upgrade has left
`the C header files in an inconsistent state. Make sure that your include directory tree
`is in sync with the compiler and the operating system.
`
`Your operating system or compiler may be out of revision.
`Software vendors (including those that develop operating systems) issue new
`releases for a reason; sometimes to add functionality, but more often to fix bugs that
`have been discovered. Try upgrading your compiler andfor your operating system.
`
`The Apache Group tests the ability to build the server on many different platforms.
`Unfortunately, we can't test all of the OS 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. Be sure to include complete details, such as the compiler
`& OS versions and exact error messages.
`
`Why do I get complaints about redefinition of "struct
`iovec" when compiling under Linux?
`
`This is a conflict between your C library includes and your kernel includes. You need to
`make sure that the versions of both are matched properly. There are two workarounds,
`either one will solve the problem:
`
`Remove the definition of struct iovec from your C library includes. It is located in
`fusrfinclude/sys/uio.h. Or, Add -DNO_WRITEV to the EXTRA_CFLAGS line in your
`Configuration and reconfigure/rebuild. This hurts performance and should only be used as
`a last resort.
`
`I'm using gcc and I get some compilation errors, what is
`wrong?
`
`GCC parses your system header files and produces a modified subset which it uses for
`compiling. This behavior ties GCC tightly to the version of your operating system. So, for
`example, if you were running IRIX 5.3 when you built GCC and then upgrade to IRIX 6.2
`later, you will have to rebuild GCC. Similarly for Solaris 2.4, 2.5, or 2.5.1 when you
`upgrade to 2.6. Sometimes you can type "gcc -V" and it will tell you the version of the
`operating system it was built against.
`
`If you fail to do this, then it is very likely that Apache will fail to build. One of the most
`common errors is with readv, writev, or uio.h. This is not a bug with Apache. You wigolumbia Ex 2045 10
`hflp‘-MNiki-fipache-0f9’hllDdfFAQ
`Symantec v Columbia
`IPR201 5-00375
`
`
`
`1017:2015
`
`FAQ - Httpd was
`
`need to re-install GCC.
`
`Error Log Messages and Problems
`Starting Apache
`
`Why do I get "setgid: Invalid argument" at startup?
`
`Your Group directive (probably in conf/httpdconf) needs to name a group that actually
`exists in the /etc/group file (or your system's equivalent). This problem is also frequently
`seen when a negative number is used in the Group directive (e.g., “Group #-1"). Using a
`group name -- not group number -- found in your system's group database should solve
`this problem in all cases.
`
`Why am I getting "httpd: could not set socket option
`TCP_NODELAY" in my error log?
`
`This message almost always indicates that the client disconnected before Apache reached
`the point of calling setsockopt() for the connection. It shouldn't occur for more than about
`1% of the requests your server handles, and it's advisory only in any case.
`
`Why am I getting "connection reset by peer" in my
`error log?
`
`This is a normal message and nothing about which to be alarmed. It simply means that the
`client canceled the connection before it had been completely set up - such as by the end-
`user pressing the ”Stop" button. People's patience being what it is, sites with response-
`time problems or slow network links may experience this more than high capacity ones or
`those with large pipes to the network.
`
`The errorlog says Apache dumped core, but where's the
`dump file?
`
`The error log message about dumped core includes the directory where the dump file
`should be located. However, many Unixes do not allow a process that has called setuid()
`to dump core for security reasons (‘Is this still a problem'?'); the typical Apache setup has
`the server started as root to bind to port 80, after which it uses setuid() to change UlDs to
`a non-privileged user to serve requests.
`
`Dealing with this is extremely operating system-specific, and may require rebuilding your
`system kernel. Consult your operating system documentation or vendor for more
`information about whether your system does this and how to bypass it. If there is a
`documented way of bypassing it, it is recommended that you bypass it only for the httpd
`server process if possible.
`
`ht:p:r~viki.apache.orgtnupdrFAo
`
`Columbia Ex 2045-11
`
`Symantec v Columbia
`IPR201 5-00375
`
`
`
`10!7f2D15
`
`FAQ - Hltpd Wiki
`
`The canonical location for Apache's core-dump files is the ServerRoot directory. 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 is started as).
`
`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 rebuild the kernel
`with that support enabled (it's under the "General Setup" submenu). Documentation for
`kernel building is beyond the scope of this FAQ; you should consult the Kernel HOWTO,
`or the documentation provided with your distribution, or a Linux newsgroup/mailing list.
`As a last~resort workaround, you can comment out the #define
`USE_SHMGET SCOREBOARD definition in the LINUX section of src/conf.h and
`rebuild the server (prior to 1.3134, simply removing #define HAVE_SHMGET would have
`sufficed). This will produce a server which is slower and less reliable.
`
`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 file locking problem, which usually means that the server is
`trying to use a synchronization file on an NFS filesystem.
`
`Because of its parallel-operation model, the Apache Web server needs to provide some
`form of synchronization when accessing certain resources. One of these synchronization
`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-look
`
`The directory should not be generally writable (e.g., don't use /varftmp). See the LockFile
`documentation for more information.
`
`When I try to start Apache from a DOS window, I get a
`message like "Cannot determine host name. Use
`ServerName directive to set it manually." What does
`this mean?
`
`It means what it says; the Apache software can't determine the hostname of your system.
`Edit your conf\httpd.conf file, look for the string "Se1'verName", and make sure thereéoaéimbia Ex 20454 2
`hflpiffvviki-fipache-0f9’?1liDdfFAQ
`Symantec v Columbia
`IPR201 5-00375
`
`
`
`10!7f2D15
`
`FAQ - Hnpd Wiki
`
`uncommented directive such as
`
`ServerName localhost or
`
`ServerName www.foo.com in the file. Correct it if there one there with wrong
`information, or add one if you don't already have one.
`
`Also, make sure that your Windows system has DNS enabled. See the TCP/IP setup
`component of the Networking or Internet Options control panel.
`
`After verifying that DNS is enabled and that you have a valid hostnarne in your
`ServerName directive, try to start the server again.
`
`When I try to start Apache on Windows, I get a message
`like "System error 1067 has occurred. The process
`terminated unexpectedly." What does this mean?
`
`This message means that the Web server was unable to start correctly for one reason or
`another. To find out why, execute the following commands in a DOS window:
`
`c: cd "\Program Files\Apache Group\Apache" apache
`
`(If you don't get the prompt back, hit Control-C to cause Apache to exit.)
`
`The error you see will probably be one of those preceding this question in the FAQ.
`
`First check the Windows NT Event Log for Application errors using the Windows
`NT/2000 Event Viewer program. Any errors that occur prior to opening the Apache error
`log will be stored here, if Apache is run as a Service on NT or 2000. As with any error,
`also check your Apache error log.
`
`On a SuSE Linux system, I try and configure access
`control using basic authentication. Although I follow the
`example exactly, authentication fails, and an error
`message "admin: not a valid FDN: ...." is logged.
`
`In the SuSE distribution, additional 3rd party authentication modules have been added and
`activated by default. These modules interfere with the Apache standard modules and
`cause Basic authentication to fail. Our recommendation is to comment all those modules
`
`in /etc/httpdfsuse_addmodu1e.conf and /etc/httpd/suse_loadmodule.conf which are not
`actually required for running your server.
`
`Why am I getting server restart messages periodically,
`when I did not restart the server?
`
`Problem: You are noticing restart messages in your error log, periodically, when you
`
`ht:p:r~viki.apache.orgrnupdrFAo
`
`Columbia Ex 2045-13
`
`Symantec v Columbia
`IPR201 5-00375
`
`
`
`1017:2015
`
`FAQ- Httpd Wiki
`
`know you did not restart the server yourself:
`
`[Thu Jun
`restart
`
`6 04:02:01 2002]
`
`[notice] SIGHUP received. Attempting to
`
`6 04:02:02 2002]
`[Thu Jun
`normal operations
`
`[noticej Apache configured -- resuming
`
`Check your cron jobs to see when/if your server logs are being rotated. Compare the time
`of rotation to the error message time. If they are the same, you can somewhat safely
`assume that the restart is due to your server logs being rotated.
`
`Why am I getting "module module-name is not
`compatible with this version of Apache" messages in my
`error log?
`
`Module Magic Number (MMN) is a constant defined in Apache source that is associated
`with binary compatibility of modules. It is changed when internal Apache structures,
`function calls and other significant parts of AP] change in such a way that binary
`compatibility cannot be guaranteed any more. On MMN change, all third party modules
`have to be at least recompiled, sometimes even slightly changed in order to work with the
`new version of Apache.
`
`If you're getting the above error messages, Contact the vendor of the module for the new
`binary, or compile it if you have access to the source code.
`
`I've downloaded a module from a source I trust, but my
`LoadM0dule line is a syntax error?
`
`Have you checked for simple errors like a typo, or an incorrect path to the module‘?
`
`Another reason you may be unable to load a module is if it relies on libraries (Unix-family
`.so or Windows .dll) that are not loaded into the server. Such libraries can be loaded using
`the LoadFile directive, which must appear before your LoadI\/Iodule line in the
`configuration. The module's provider should document any such dependencies.
`
`There's a particular Gotcha on Windows:
`
`httpd: Syntax error on line nn of C:/IBM/HTTP/conf/httpd.conf:
`
`load C:/IBM/HTTP/modules/mod_foo.so into server: The
`Cannot
`specified module could not be found.
`
`
`Googling the error message tells us there's a missing library, but there doesn't appear to
`be, and the identical configuration works on one computer but fails with this message on
`another. What gives?
`
`This error may happen because you need to install the Windows C Runtime Libraries on
`the target machine. Note that this doesn't mean you need to load them explicitly into
`
`hnp:m~iI<mpache.org:hupurFAo
`
`Columbia Ex 2045-14
`
`Symantec v Columbia
`IPRZO1 5-00375
`
`
`