granicus.if.org Git - apache/blob - docs/manual/faq/index.xml

   1 <?xml version='1.0' encoding='UTF-8' ?>
   2 <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
   4 <!-- $LastChangedRevision$ -->
   5
   6 <!--
   7  Licensed to the Apache Software Foundation (ASF) under one or more
   8  contributor license agreements.  See the NOTICE file distributed with
   9  this work for additional information regarding copyright ownership.
  10  The ASF licenses this file to You under the Apache License, Version 2.0
  11  (the "License"); you may not use this file except in compliance with
  12  the License.  You may obtain a copy of the License at
  13
  14      http://www.apache.org/licenses/LICENSE-2.0
  15
  16  Unless required by applicable law or agreed to in writing, software
  17  distributed under the License is distributed on an "AS IS" BASIS,
  18  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  19  See the License for the specific language governing permissions and
  20  limitations under the License.
  21 -->
  22
  23 <manualpage metafile="index.xml.meta">
  24 <parentdocument href="../"/>
  25
  26 <title>Frequently Asked Questions</title>
  27
  28 <summary>
  29
  30     <p>This document is not a traditional FAQ, but rather a quick
  31     guide showing you what to do when you run into problems with the
  32     Apache HTTP Server.</p>
  33
  34     <p>A more traditional but quite outdated document is the <a
  35     href="http://httpd.apache.org/docs/misc/FAQ.html">Apache 1.3
  36     FAQ</a>.</p>
  37 </summary>
  38
  39     <section id="support.what2do">
  40     <title>"Why can't I ...? Why won't ... work?" What to do in case of
  41     problems</title>
  42
  43       <p>If you are having trouble with your Apache server software, you should
  44       take the following steps:</p>
  45
  46       <dl>
  47       <dt>Check the ErrorLog!</dt>
  48       <dd>Apache tries to be helpful when it encounters a problem. In many
  49       cases, it will provide some details by writing one or more messages to the
  50       server error log. Sometimes this is enough for you to diagnose and fix
  51       the problem yourself (such as file permissions or the like). The default
  52       location of the error log is
  53       <code>/usr/local/apache2/logs/error_log</code>, but see the <directive
  54       module="core">ErrorLog</directive> directive in your config files for the
  55       location on your server.</dd>
  56
  57       <dt>Consult the wiki</dt>
  58       <dd>The <a href="http://wiki.apache.org/httpd/">Apache HTTP
  59       Server Wiki</a> contains guides to solving many common
  60       problems.</dd>
  61
  62       <dt>Check the Apache bug database</dt> <dd>Most problems that
  63       get reported to The Apache Group are recorded in the <a
  64       href="http://httpd.apache.org/bug_report.html">bug database</a>.
  65       <strong>Do not</strong> submit a new bug report until you have
  66       checked existing reports (open <em>and</em> closed) and asked
  67       about your problem in a user-support forum (see below). If you
  68       find that your issue has already been reported, please
  69       <em>don't</em> add a "me, too" report.</dd>
  70
  71       <dt><a id="support.what2do.user-support"
  72       name="support.what2do.user-support">Ask in a user support forum</a></dt>
  73       <dd><p>Apache has an active community of users who are willing to share
  74       their knowledge. Participating in this community is usually the best and
  75       fastest way to get answers to your questions and problems.</p>
  76
  77       <p><a href="http://httpd.apache.org/userslist.html">Users
  78       mailing list</a></p>
  79
  80       <p><a href="irc://irc.freenode.net/#apache">#apache</a> on
  81       <a href="http://freenode.net">Freenode IRC</a> is also available for
  82       user support issues.</p>
  83       </dd>
  84
  85       <dt>Please use the bug database for bugs!</dt>
  86       <dd><p>If you've gone through those steps above that are appropriate and
  87       have obtained no relief, then please <em>do</em> let the httpd developers
  88       know about the problem by <a
  89       href="http://httpd.apache.org/bug_report.html">logging a bug
  90       report</a>.</p>
  91
  92       <p>If your problem involves the server crashing and generating a core
  93       dump, please <a href="http://httpd.apache.org/dev/debugging.html">
  94       include a backtrace</a> (if possible).</p>
  95       </dd>
  96       </dl>
  97     </section>
  98
  99     <section id="support.support"><title>Whom do I contact for support?</title>
 100       <p>With millions of users and fewer than sixty volunteer developers,
 101       we cannot provide personal support for Apache. For free support, we
 102       suggest participating in a user forum (see above).</p>
 103
 104       <p>Professional, commercial support for Apache is available from
 105       a number of companies.</p>
 106     </section>
 107
 108 </manualpage>