Gentoo Archives: gentoo-commits

From: "Marion Age (titefleur)" <titefleur@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] gentoo commit in xml/htdocs/doc/fr: apache-troubleshooting.xml
Date: Wed, 30 Jul 2008 13:04:54
Message-Id: E1KOBMH-0005XF-8q@stork.gentoo.org
1 titefleur 08/07/30 13:04:49
2
3 Modified: apache-troubleshooting.xml
4 Log:
5 Sync to 1.9 (move to its project directory)
6
7 Revision Changes Path
8 1.7 xml/htdocs/doc/fr/apache-troubleshooting.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/fr/apache-troubleshooting.xml?rev=1.7&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/fr/apache-troubleshooting.xml?rev=1.7&content-type=text/plain
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/fr/apache-troubleshooting.xml?r1=1.6&r2=1.7
13
14 Index: apache-troubleshooting.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/fr/apache-troubleshooting.xml,v
17 retrieving revision 1.6
18 retrieving revision 1.7
19 diff -u -r1.6 -r1.7
20 --- apache-troubleshooting.xml 13 Feb 2008 23:10:47 -0000 1.6
21 +++ apache-troubleshooting.xml 30 Jul 2008 13:04:48 -0000 1.7
22 @@ -1,21 +1,12 @@
23 <?xml version="1.0" encoding="UTF-8"?>
24 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/fr/apache-troubleshooting.xml,v 1.6 2008/02/13 23:10:47 cam Exp $ -->
25 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/fr/apache-troubleshooting.xml,v 1.7 2008/07/30 13:04:48 titefleur Exp $ -->
26 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
27
28 -<guide link="/doc/fr/apache-troubleshooting.xml" lang="fr">
29 +<guide redirect="/proj/fr/apache/doc/troubleshooting.xml">
30 <title>Résolution des problèmes avec Apache</title>
31
32 <author title="Auteur">
33 - <mail link="vericgar@g.o">Michael Stewart</mail>
34 -</author>
35 -<author title="Contributor">
36 - <mail link="beu@g.o">Elfyn McBratney</mail>
37 -</author>
38 -<author title="Contributor">
39 - <mail link="kloeri@g.o">Bryan Østergaard</mail>
40 -</author>
41 -<author title="Contributor">
42 - <mail link="hollow@g.o">Benedikt Böhm</mail>
43 + <mail>neysx</mail>
44 </author>
45 <author title="Traducteur">
46 <mail link="cam@g.o">Camille Huot</mail>
47 @@ -30,439 +21,16 @@
48 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
49 <license/>
50
51 -<version>1.8</version>
52 -<date>2007-11-29</date>
53 -
54 -<chapter>
55 -<title>Vérification des logs</title>
56 -<section>
57 -<body>
58 -
59 -<p>
60 -Si quelque chose cloche avec votre Apache alors que vous n'avez aucune idée de
61 -ce que ça peut être, vous trouverez certainement des indices dans les fichiers
62 -de logs (N.D.T.&nbsp;: journaux où est enregistré l'activité de l'application).
63 -</p>
64 -
65 -<p>
66 -Il y a plusieurs fichiers de logs différents, mais certains d'entre eux peuvent
67 -ne pas être présents sur votre système selon les modules que vous avez activés.
68 -En principe, ils se trouvent dans <path>/var/log/apache2/</path>.
69 -</p>
70 -
71 -</body>
72 -</section>
73 -
74 -<section>
75 -<title>access_log et ssl_access_log</title>
76 -<body>
77 -
78 -<pre caption="access_log">
79 -67.185.0.236 - - [18/Jun/2005:12:05:50 -0700] "GET / HTTP/1.0" 200 721
80 -10.0.1.80 - - [18/Jun/2005:12:11:07 -0700] "GET /~jaspenelle/__journal1.jpg HTTP/1.1" 200 19079
81 -66.239.233.163 - - [18/Jun/2005:12:15:06 -0700] "GET /~jaspenelle/avy14.gif HTTP/1.0" 200 1661
82 -67.185.60.155 - - [18/Jun/2005:12:18:48 -0700] "GET / HTTP/1.0" 200 721
83 -67.185.0.236 - - [18/Jun/2005:12:25:39 -0700] "GET / HTTP/1.0" 200 721
84 -10.0.1.80 - - [18/Jun/2005:12:28:04 -0700] "GET /~jaspenelle/avy14.gif HTTP/1.1" 200 1661
85 -10.0.1.80 - - [18/Jun/2005:12:28:46 -0700] "GET /~jaspenelle/avy7.png HTTP/1.1" 200 13066
86 -</pre>
87 -
88 -<p>
89 -Ce fichier contient simplement la liste de chaque fichier demandé à votre
90 -serveur. À moins que vous ayiez changé la configuration par défaut, les lignes
91 -sont en Common Log Format&nbsp;:
92 -</p>
93 -
94 -<pre caption="Syntaxe du Common Log Format">
95 -adresseclient rfc931 utilisateur [date] "requête" statut octets
96 -</pre>
97 -
98 -<table>
99 -<tr>
100 - <ti>adresseclient</ti>
101 - <ti>Nom d'hôte ou adresse IP du client qui a fait la requête.</ti>
102 -</tr>
103 -<tr>
104 - <ti>rfc931</ti>
105 - <ti>L'identifiant distant du client qui a fait la requête.</ti>
106 -</tr>
107 -<tr>
108 - <ti>utilisateur</ti>
109 - <ti>L'identifiant qu'a donné l'utilisateur pour s'identifier sur la page.</ti>
110 -</tr>
111 -<tr>
112 - <ti>[date]</ti>
113 - <ti>Date et heure de la requête.</ti>
114 -</tr>
115 -<tr>
116 - <ti>"requête"</ti>
117 - <ti>La requête complète telle qu'envoyée par le client.</ti>
118 -</tr>
119 -<tr>
120 - <ti>statut</ti>
121 - <ti>
122 - Le code de retour HTTP renvoyé au client pour indiquer le statut de la
123 - réponse.
124 - </ti>
125 -</tr>
126 -<tr>
127 - <ti>octets</ti>
128 - <ti>
129 - La taille du document transféré (en-tête «&nbsp;content-length&nbsp;»).
130 - </ti>
131 -</tr>
132 -</table>
133 -
134 -</body>
135 -</section>
136 -<section>
137 -<title>error_log et ssl_error_log</title>
138 -<body>
139 -
140 -<pre caption="error_log">
141 -[Mon Feb 07 23:33:18 2005] [notice] suEXEC mechanism enabled (wrapper: /usr/sbin/suexec2)
142 -[Mon Feb 07 23:33:18 2005] [notice] Digest: generating secret for digest authentication ...
143 -[Mon Feb 07 23:33:18 2005] [notice] Digest: done
144 -[Mon Feb 07 23:33:18 2005] [notice] Apache/2.0.52 (Gentoo/Linux) PHP/4.3.10 configured -- resuming normal operations
145 -[Sat Jun 18 13:01:54 2005] [error] [client 10.0.1.80] File does not exist: /var/www/localhost/htdocs/favicon.ico
146 -[Sat Jun 18 13:02:14 2005] [error] [client 10.0.1.80] File does not exist: /var/www/localhost/htdocs/favicon.ico
147 -[Sat Jun 18 13:02:18 2005] [error] [client 10.0.1.80] File does not exist: /var/www/localhost/htdocs/favicon.ico
148 -[Sat Jun 18 13:02:21 2005] [error] [client 10.0.1.80] File does not exist: /var/www/localhost/htdocs/favicon.ico
149 -[Sat Jun 18 13:02:24 2005] [error] [client 10.0.1.80] File does not exist: /var/www/localhost/htdocs/favicon.ico
150 -</pre>
151 -
152 -<p>
153 -Comme vous le voyez, ce fichier peut contenir beaucoup de choses, selon la
154 -valeur de la directive <c>ErrorLevel</c> dans votre fichier
155 -<path>httpd.conf</path>. Il vous indique si Apache a démarré correctement,
156 -quelles sont les erreurs rencontrées... C'est lui qui vous dira si quelque chose
157 -se passe mal en général. Si quelque chose ne fonctionne pas, il est le premier
158 -fichier à consulter.
159 -</p>
160 -
161 -</body>
162 -</section>
163 -<section>
164 -<title>suexec_log</title>
165 -<body>
166 -
167 -<pre caption="suexec_log">
168 -[2005-02-11 22:33:19]: uid: (1000/vericgar) gid: (1000/1000) cmd: test.cgi
169 -[2005-03-11 19:20:13]: uid: (1000/vericgar) gid: (1000/1000) cmd: test.cgi
170 -[2005-03-11 19:34:47]: uid: (1000/vericgar) gid: (1000/1000) cmd: test.cgi
171 -</pre>
172 -
173 -<p>
174 -Ce fichier contient une entrée pour chaque fois qu'un script est lancé en
175 -utilisant CGI et suexec. Si vous n'arrivez pas à faire fonctionner un script
176 -avec suexec, ce fichier est celui à consulter car il contiendra en principe une
177 -ligne indiquant pourquoi il n'a pas pu lancer le script.
178 -</p>
179 -
180 -</body>
181 -</section>
182 -</chapter>
183 -
184 -<chapter>
185 -<title>J'ai installé un module Apache, mais il ne marche pas&nbsp;!</title>
186 -<section>
187 -<body>
188 -
189 -<p>
190 -Installer le module ne suffit pas, il faut également l'activer. Nous procédons
191 -ainsi pour pouvoir facilement activer et désactiver les modules
192 -individuellement, pour les tester un par un en cas de problème afin de trouver
193 -celui qui cloche.
194 -</p>
195 -
196 -<p>
197 -Lorsque vous installez un module, il devrait y avoir un message dans ce
198 -genre&nbsp;:
199 -</p>
200 -
201 -<pre caption="Message post-installation (emerge)">
202 - *
203 - * To enable mod_layout, you need to edit your /etc/conf.d/apache2 file and
204 - * add '-D LAYOUT' to APACHE2_OPTS.
205 - *
206 - *
207 - * Configuration file installed as
208 - * /etc/apache2/modules.d/15_mod_layout.conf
209 - * You may want to edit it before turning the module on in /etc/conf.d/apache2
210 - *
211 -</pre>
212 -
213 -<p>
214 -Si vous comprenez un minimum l'anglais, il suffit de faire exactement ce qui est
215 -indiqué pour activer le module. Pour les autres, il suffit de rajouter <c>-D
216 -LAYOUT</c> à la variable <c>APACHE2_OPTS</c> qui se trouve dans le fichier
217 -<path>/etc/conf.d/apache2</path> pour activer mod_layout.
218 -</p>
219 -
220 -<p>
221 -Si vous avez loupé ce message, il existe un moyen simple de savoir ce qu'il faut
222 -ajouter à <c>APACHE2_OPTS</c> dans <path>/etc/conf.d/apache2</path>&nbsp;:
223 -ouvrez le fichier de configuration du module installé par l'ebuild et vous
224 -verrez quelle variable est testée par <c>IfDefine</c>. Il suffit alors de la
225 -déclarer dans APACHE2_OPTS. Les fichiers de configuration des modules Apache se
226 -trouvent dans <path>/etc/apache2/modules.d/</path>.
227 -</p>
228 -
229 -<pre caption="Un extrait de 15_mod_layout.conf">
230 -&lt;IfDefine LAYOUT&gt;
231 - &lt;IfModule !mod_layout.c&gt;
232 - LoadModule layout_module modules/mod_layout.so
233 - &lt;/IfModule&gt;
234 -&lt;/IfDefine&gt;
235 -</pre>
236 -
237 -<p>
238 -Ce qui se trouve dans le bloc <c>IfDefine</c> est exécuté si vous ajoutez <c>-D
239 -LAYOUT</c> au fichier <path>/etc/conf.d/apache2</path>. <c>LAYOUT</c> n'est
240 -qu'un exemple.
241 -</p>
242 -
243 -<p>
244 -La variable <c>APACHE2_OPTS</c> accepte plusieurs autres options qui sont
245 -spécifiées dans la configuration par défaut et détaillées dans
246 -<path>/etc/conf.d/apache2</path>.
247 -</p>
248 -
249 -<p>
250 -La documentation concernant tous les modules de base se trouve dans la <uri
251 -link="http://httpd.apache.org/docs/2.0/">documentation Apache 2.0</uri>.
252 -</p>
253 -
254 -</body>
255 -</section>
256 -</chapter>
257 +<version>2</version>
258 +<date>2008-03-23</date>
259
260 <chapter>
261 -<title>Apache renvoie des pages vides, Apache plante</title>
262 -<section>
263 -<body>
264 -
265 -<p>
266 -Cela arrive surtout lors des mises à jour car la compatibilité des binaires est
267 -rompue dans APR (ce qui peut arriver pour un nombre certain de raisons). Pour
268 -corriger le problème, il faut recompiler Apache et ses outils&nbsp;:
269 -</p>
270 -
271 -<pre caption="Recompiler Apache et ses outils">
272 -<comment>(Faites tout ceci dans l'ordre, c'est très important !)</comment>
273 -
274 -<comment>(D'abord, on supprime l'Apache actuel.)</comment>
275 -# <i>emerge -aCv '=www-servers/apache-2*'</i>
276 -
277 -<comment>(Ensuite, on recompile les outils.)</comment>
278 -# <i>emerge -av '=dev-libs/apr-0*' '=dev-libs/apr-util-0*'</i>
279 -
280 -<comment>(Enfin, on recompile Apache.)</comment>
281 -# <i>emerge -av '=www-servers/apache-2*'</i>
282 -
283 -<comment>(Trouvons maintenant quels paquets dépendent d'Apache.)</comment>
284 -$ <i>equery depends www-servers/apache</i>
285 -[ Searching for packages depending on www-servers/apache... ]
286 -dev-php/phpsysinfo-2.3-r2
287 -dev-php/phpsysinfo-2.1-r2
288 -dev-lang/php-5.2.4_p20070914-r2
289 -net-www/mod_layout-4.0.1a-r1
290 -www-servers/gorg-0.5
291 -
292 -<comment>(Et recompilons tous les modules que nous avions installés.)</comment>
293 -# <i>emerge -av '=dev-lang/php-5.2.4_p20070914-r2' '=net-www/mod_layout-4.0.1.a-r1'</i>
294 -</pre>
295 -
296 -</body>
297 -</section>
298 -<section>
299 -<title>Détecter un module bogué</title>
300 -<body>
301 -
302 -<p>
303 -Si vous rencontrez toujours des problèmes après avoir suivi les instructions
304 -ci-dessus, le coupable est très certainement un des modules additionnels
305 -chargé par Apache.
306 -</p>
307 -
308 -<p>
309 -Commencez par désactiver tous les modules additionnels et redémarrez Apache.
310 -</p>
311 -
312 -<pre caption="Désactiver les modules additionnels">
313 -<comment>(Dans /etc/conf.d/apache2,)</comment>
314 -
315 -<comment>(avant...)</comment>
316 -APACHE2_OPTS="-D PHP5 -D USERDIR -D SSL"
317 -
318 -<comment>(après.)</comment>
319 -APACHE2_OPTS=""
320 -</pre>
321 -
322 -<pre caption="Redémarrer Apache">
323 -# <i>/etc/init.d/apache2 stop</i>
324 -<comment>(Vérifiez qu'Apache est bien arrêté.)</comment>
325 -# <i>ps -A</i>
326 -# <i>/etc/init.d/apache2 start</i>
327 -</pre>
328 -
329 -<note>
330 -Vous devrez peut-être modifier votre configuration d'Apache si vous y avez
331 -ajouté des <c>Directive</c>s fournies par un de ces modules sans faire de test
332 -pour savoir si le module était bien chargé. D'une manière générale, il vaut
333 -mieux placer ces directives dans des blocs qui testent la présence du module en
334 -mémoire. Vous pouvez vous inspirer des fichiers .conf situés dans le répertoire
335 -<path>/etc/apache2/modules.d</path> pour des exemples.
336 -</note>
337 -
338 -<p>
339 -Si Apache arrête enfin de crasher ou de renvoyer des pages blanches, le problème
340 -venait bien de l'un des modules qui ont été désactivés. Pour trouver duquel cela
341 -provient, nous allons les réactiver un par un en redémarrant Apache à chaque
342 -fois.
343 -</p>
344 -
345 -<p>
346 -Une fois que vous avez trouvé quel module était responsable, une simple
347 -recompilation du module en question peut résoudre le problème.
348 -</p>
349 -
350 -<p>
351 -Si Apache ne fonctionne toujours pas correctement une fois que le module a été
352 -réinstallé, alors <uri link="http://bugs.gentoo.org">ouvrez un bogue</uri> en
353 -donnant les versions et révisions exactes du module et en précisant exactement
354 -ce qui ne va pas. Cherchez d'abord si le problème n'aurait pas déjà été
355 -décrit&nbsp;!
356 -</p>
357 -
358 -</body>
359 -</section>
360 -</chapter>
361 -
362 -<chapter>
363 -<title>Le serveur n'interprète pas le code PHP ou les scripts CGI et renvoie
364 -directement le source à la place</title>
365 -<section>
366 -<body>
367 -
368 -<p>
369 -Il arrive qu'Apache renvoie le code PHP ou CGI au lieu d'exécuter les scripts et
370 -de ne renvoyer que le résultat. Si cela arrive même lorsque le module est activé
371 -dans <path>/etc/conf.d/apache2</path>, il se peut que ce soit un problème de
372 -cache. Effacer le cache du navigateur web peut résoudre le problème.
373 -</p>
374 -
375 -<p>
376 -Parfois le problème n'apparaît que si l'on accède au site par son adresse IP au
377 -lieu de son nom ou vice-versa. Dans ce cas, il s'agit très certainement d'un
378 -problème de cache.
379 -</p>
380 -
381 -</body>
382 -</section>
383 -</chapter>
384 -
385 -<chapter>
386 -<title>configure: error: changes in the environment can compromise the build</title>
387 -<section>
388 -<body>
389 -
390 -<p>
391 -Si vous obtenez cette erreur, il se peut que votre variable <c>CFLAGS</c>
392 -dans <path>/etc/make.conf</path> contienne des espaces en trop. Ceci est simple
393 -à corriger&nbsp;:
394 -</p>
395 -
396 -<pre caption="Exemple de correction pour /etc/make.conf">
397 -<comment>(Avant...)</comment>
398 -CFLAGS="-O2 -mcpu=pentium3 -march=pentium3 -pipe"
399 -
400 -<comment>(après. Notez la suppression de l'espace.)</comment>
401 -CFLAGS="-O2 -mcpu=pentium3 -march=pentium3 -pipe"
402 -</pre>
403 -
404 -</body>
405 -</section>
406 -</chapter>
407 -
408 -<chapter>
409 -<title>Address already in use: make_sock: could not bind to address
410 -0.0.0.0:443</title>
411 -<section>
412 -<body>
413 -
414 -<p>
415 -Cette erreur apparaît lors du démarrage et provient du fait qu'il y a plusieurs
416 -directives <c>Listen</c> incompatibles dans la configuration du serveur. Pour
417 -résoudre ce problème, cherchez toutes les directives <c>Listen</c> et résolvez
418 -le problème.
419 -</p>
420 -
421 -<pre caption="Trouver toutes les directives Listen">
422 -<comment>(Placez-vous dans le répertoire de configuration d'Apache...)</comment>
423 -# <i>cd /etc/apache2/</i>
424 -
425 -<comment>(et listez les directives Listen.)</comment>
426 -# <i>grep Listen httpd.conf vhosts.d/*.conf modules.d/*.conf</i>
427 -</pre>
428 -
429 -<p>
430 -Il s'agit maintenant de repérer les conflits qu'il pourrait y avoir au niveau
431 -des ports ouverts par Apache. Par exemple, s'il y a une ligne <c>Listen 80</c>
432 -dans <path>httpd.conf</path> et une ligne <c>Listen 10.0.0.15:80</c> dans un
433 -autre fichier, alors Apache ne pourra pas démarrer. Dans ce cas, Apache ouvrira
434 -le port 80 sur toutes les adresses IP que le serveur possède et essaiera ensuite
435 -d'ouvrir le port 80 sur l'adresse IP 10.0.0.15, ce qui n'est pas possible
436 -puisque ce port est déjà ouvert.
437 -</p>
438 -
439 -<p>
440 -La configuration recommandée est de n'avoir qu'une seule ligne <c>Listen 80</c>
441 -(c'est la valeur par défaut de <c>httpd.conf</c>) afin d'ouvrir par défaut le
442 -port HTTP standard sur toutes les adresses IP, puis de rajouter une ligne
443 -<c>Listen</c> supplémentaire pour chaque <c>VirtualHost</c> SSL en spécifiant
444 -l'adresse IP (par exemple&nbsp;: <c>Listen 10.0.0.15:443</c>).
445 -</p>
446 -
447 -</body>
448 -</section>
449 -</chapter>
450 -
451 -<chapter>
452 -<title>Après la mise à jour vers apache-2.0.54-r13, le vhost par défaut (SSL ou
453 -non-SSL) ne fonctionne plus</title>
454 -<section>
455 -<body>
456 -
457 -<p>
458 -À partir de la version apache-2.0.54-r13, deux nouvelles directives ont été
459 -ajoutées pour fixer le <uri
460 -link="http://bugs.gentoo.org/show_bug.cgi?id=100624">bogue 100624</uri>.
461 -</p>
462 -
463 -<p>
464 -Les nouvelles directives en question sont&nbsp;: <c>-D DEFAULT_VHOST</c> pour
465 -activer le vhost par défaut et <c>-D SSL_DEFAULT_VHOST</c> pour activer le vhost
466 -SSL par défaut. Ces deux directives doivent être ajoutées à la variable
467 -<c>APACHE2_OPTS</c> du fichier <path>/etc/conf.d/apache2</path> pour être
468 -activées (ce qui rétablit l'ancien comportement d'Apache).
469 -</p>
470 -
471 -</body>
472 -</section>
473 -</chapter>
474 -
475 -<chapter id="getting-help">
476 -<title>À l'aide...</title>
477 +<title>Déplacé</title>
478 <section>
479 <body>
480
481 <p>
482 -Si aucune de ces astuces n'a pu résoudre votre problème ou si vous avez d'autres
483 -questions, passez nous voir sur IRC dans le canal <path>#gentoo-apache</path>
484 -(on y parle anglais) sur le serveur <path>irc.freenode.net</path>. Vous pouvez
485 -aussi remplir un ticket de bogue sur le <uri
486 -link="http://bugs.gentoo.org">Bugzilla de Gentoo</uri>.
487 +Voir <uri>/proj/fr/apache/doc/troubleshooting.xml</uri>.
488 </p>
489
490 </body>