swift 05/08/01 14:49:01 Modified: xml/htdocs/doc/en metadoc.xml Added: xml/htdocs/doc/en apache-troubleshooting.xml Log: #99539 - Apache troubleshooting guide, language improvements and migrating to /doc/en
Revision Changes Path 1.90 +6 -1 xml/htdocs/doc/en/metadoc.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/metadoc.xml?rev=1.90&content-type=text/x-cvsweb-markup&cvsroot=gentoo plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/metadoc.xml?rev=1.90&content-type=text/plain&cvsroot=gentoo diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/metadoc.xml.diff?r1=1.89&r2=1.90&cvsroot=gentoo Index: metadoc.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v retrieving revision 1.89 retrieving revision 1.90 diff -u -r1.89 -r1.90 --- metadoc.xml 1 Aug 2005 13:06:48 -0000 1.89 +++ metadoc.xml 1 Aug 2005 14:49:01 -0000 1.90 @@ -1,5 +1,5 @@ <?xml version='1.0' encoding="UTF-8"?> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v 1.89 2005/08/01 13:06:48 swift Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v 1.90 2005/08/01 14:49:01 swift Exp $ --> <!DOCTYPE metadoc SYSTEM "/dtd/metadoc.dtd"> <metadoc lang="en"> @@ -359,6 +359,7 @@ <file id="shb-services">/doc/en/security/shb-services.xml</file> <file id="shb-tight">/doc/en/security/shb-tight.xml</file> <file id="shb-uptodate">/doc/en/security/shb-uptodate.xml</file> + <file id="apache-troubleshooting">/doc/en/apache-troubleshooting.xml</file> </files> <docs> <doc id="name-logo"> @@ -979,5 +980,9 @@ <memberof>install_other</memberof> <fileid>usb-guide</fileid> </doc> + <doc id="apache-troubleshooting"> + <memberof>sysadmin_specific</memberof> + <fileid>apache-troubleshooting</fileid> + </doc> </docs> </metadoc> 1.1 xml/htdocs/doc/en/apache-troubleshooting.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/apache-troubleshooting.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/apache-troubleshooting.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo Index: apache-troubleshooting.xml =================================================================== <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> <guide link="apache-troubleshooting.xml" lang="en"> <title>Troubleshooting Apache</title> <author title="Author"> <mail link="[EMAIL PROTECTED]">Michael Stewart</mail> </author> <author title="Contributor"> <mail link="[EMAIL PROTECTED]">Elfyn McBratney</mail> </author> <author title="Contributor"> <mail link="[EMAIL PROTECTED]">Bryan Ãstergaard</mail> </author> <abstract> This document covers a number of ways to figure out how to fix your Apache installation when things are not working correctly. </abstract> <!-- The content of this document is licensed under the CC-BY-SA license --> <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> <license/> <version>1.4</version> <date>2005-08-01</date> <chapter> <title>Checking the Logs</title> <section> <body> <p> If there is something wrong with your Apache, but you have no idea how to figure out what's wrong, your first clues will be in the log files. </p> <p> There are a few log files around. All of them are located inside <path>/var/log/apache2/</path>. Not all of the following log files will be on your system: this depends on what modules you have enabled. </p> </body> </section> <section> <title>access_log</title> <body> <pre caption="access_log"> 67.185.0.236 - - [18/Jun/2005:12:05:50 -0700] "GET / HTTP/1.0" 200 721 10.0.1.80 - - [18/Jun/2005:12:11:07 -0700] "GET /~jaspenelle/__journal1.jpg HTTP/1.1" 200 19079 66.239.233.163 - - [18/Jun/2005:12:15:06 -0700] "GET /~jaspenelle/avy14.gif HTTP/1.0" 200 1661 67.185.60.155 - - [18/Jun/2005:12:18:48 -0700] "GET / HTTP/1.0" 200 721 67.185.0.236 - - [18/Jun/2005:12:25:39 -0700] "GET / HTTP/1.0" 200 721 10.0.1.80 - - [18/Jun/2005:12:28:04 -0700] "GET /~jaspenelle/avy14.gif HTTP/1.1" 200 1661 10.0.1.80 - - [18/Jun/2005:12:28:46 -0700] "GET /~jaspenelle/avy7.png HTTP/1.1" 200 13066 </pre> <p> This file is simply a listing of every file requested from your server. Unless you have changed the default configuration, it will be in Common Log Format: </p> <pre caption="Common Log Format syntax"> remotehost rfc931 authuser [date] "request" status bytes </pre> <table> <tr> <ti>remotehost</ti> <ti>Remote host name or IP address</ti> </tr> <tr> <ti>rfc931</ti> <ti>The remote log name of the user.</ti> </tr> <tr> <ti>authuser</ti> <ti>The user name as which the user has authenticated himself.</ti> </tr> <tr> <ti>[date]</ti> <ti>Date and time of the request.</ti> </tr> <tr> <ti>"request"</ti> <ti>The request line exactly as it came from the client.</ti> </tr> <tr> <ti>status</ti> <ti>The HTTP status code returned to the client.</ti> </tr> <tr> <ti>bytes</ti> <ti>The content-length of the document transferred.</ti> </tr> </table> </body> </section> <section> <title>error_log</title> <body> <pre caption="error_log"> [Mon Feb 07 23:33:18 2005] [notice] suEXEC mechanism enabled (wrapper: /usr/sbin/suexec2) [Mon Feb 07 23:33:18 2005] [notice] Digest: generating secret for digest authentication ... [Mon Feb 07 23:33:18 2005] [notice] Digest: done [Mon Feb 07 23:33:18 2005] [notice] Apache/2.0.52 (Gentoo/Linux) PHP/4.3.10 configured -- resuming normal operations [Sat Jun 18 13:01:54 2005] [error] [client 10.0.1.80] File does not exist: /var/www/localhost/htdocs/favicon.ico [Sat Jun 18 13:02:14 2005] [error] [client 10.0.1.80] File does not exist: /var/www/localhost/htdocs/favicon.ico [Sat Jun 18 13:02:18 2005] [error] [client 10.0.1.80] File does not exist: /var/www/localhost/htdocs/favicon.ico [Sat Jun 18 13:02:21 2005] [error] [client 10.0.1.80] File does not exist: /var/www/localhost/htdocs/favicon.ico [Sat Jun 18 13:02:24 2005] [error] [client 10.0.1.80] File does not exist: /var/www/localhost/htdocs/favicon.ico </pre> <p> As you can see, this file can contain a lot of stuff, depending on the <c>ErrorLevel</c> directive in your <path>httpd.conf</path> file. It tells you if apache started up correctly, what errors it has run into, ... In general it will tell you what went wrong. If something isn't working right, this should be the first file you check for more information. </p> </body> </section> <section> <title>suexec_log</title> <body> <pre caption="suexec_log"> [2005-02-11 22:33:19]: uid: (1000/vericgar) gid: (1000/1000) cmd: test.cgi [2005-03-11 19:20:13]: uid: (1000/vericgar) gid: (1000/1000) cmd: test.cgi [2005-03-11 19:34:47]: uid: (1000/vericgar) gid: (1000/1000) cmd: test.cgi </pre> <p> This file contains a log entry for every time a script is ran using CGI and suexec. If you can't get a script to work with suexec, this log is the one to check as it will generally have a line listing why it wouldn't run a script. </p> </body> </section> </chapter> <chapter> <title>I installed a module, but it's not working!!!</title> <section> <body> <p> Just installing a module is not enough - you have to explicitly turn it on. We do this so that it's easy to turn on and off individual modules, which makes it easy to find which module is causing problems and let's you test modules and disable them easily. </p> <p> When you install a module, it should display a message similar to this: </p> <pre caption="Post-installation message from emerge"> * * To enable mod_layout, you need to edit your /etc/conf.d/apache2 file and * add '-D LAYOUT' to APACHE2_OPTS. * * * Configuration file installed as * /etc/apache2/modules.d/15_mod_layout.conf * You may want to edit it before turning the module on in /etc/conf.d/apache2 * </pre> <p> This is pretty straightforward. It tells you exactly what you need to do to enable this module. </p> <p> If you missed this message, there is another way to find out what you need to add to <c>APACHE2_OPTS</c> in <path>/etc/conf.d/apache2</path>: simply check the configuration file the module installed. The module's configuration file should be added to <path>/etc/apache2/modules.d/</path>. Look for it there and find a line that has <c>IfDefine</c>: </p> <pre caption="An excerpt from 15_mod_layout.conf"> <IfDefine LAYOUT> <IfModule !mod_layout.c> LoadModule layout_module modules/mod_layout.so </IfModule> </IfDefine> </pre> <p> The <c>IfDefine</c> block is ran when you add <c>-D LAYOUT</c> to -- [email protected] mailing list
