Gentoo Archives: gentoo-commits

From: "Davide Cendron (scen)" <scen@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] gentoo commit in xml/htdocs/doc/it: apache-troubleshooting.xml
Date: Tue, 25 Mar 2008 20:08:08
Message-Id: E1JeFRE-0005Q9-Qu@stork.gentoo.org
1 scen 08/03/25 20:08:04
2
3 Modified: apache-troubleshooting.xml
4 Log:
5 Version 2, revision 1.9 of EN CVS
6
7 Revision Changes Path
8 1.8 xml/htdocs/doc/it/apache-troubleshooting.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/it/apache-troubleshooting.xml?rev=1.8&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/it/apache-troubleshooting.xml?rev=1.8&content-type=text/plain
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/it/apache-troubleshooting.xml?r1=1.7&r2=1.8
13
14 Index: apache-troubleshooting.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/it/apache-troubleshooting.xml,v
17 retrieving revision 1.7
18 retrieving revision 1.8
19 diff -u -r1.7 -r1.8
20 --- apache-troubleshooting.xml 29 Nov 2007 19:17:51 -0000 1.7
21 +++ apache-troubleshooting.xml 25 Mar 2008 20:08:04 -0000 1.8
22 @@ -1,24 +1,15 @@
23 <?xml version='1.0' encoding="UTF-8"?>
24 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
25 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/it/apache-troubleshooting.xml,v 1.7 2007/11/29 19:17:51 scen Exp $ -->
26 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/it/apache-troubleshooting.xml,v 1.8 2008/03/25 20:08:04 scen Exp $ -->
27
28 -<guide link="/doc/it/apache-troubleshooting.xml" lang="it">
29 +<guide redirect="/proj/it/apache/doc/troubleshooting.xml" lang="it">
30 <title>Risoluzione dei problemi in Apache</title>
31
32 <author title="Autore">
33 - <mail link="vericgar@g.o">Michael Stewart</mail>
34 + <mail>neysx</mail>
35 </author>
36 -<author title="Collaboratore">
37 - <mail link="beu@g.o">Elfyn McBratney</mail>
38 -</author>
39 -<author title="Collaboratore">
40 - <mail link="kloeri@g.o">Bryan Østergaard</mail>
41 -</author>
42 -<author title="Collaboratore">
43 - <mail link="hollow@g.o">Benedikt Böhm</mail>
44 - </author>
45 <author title="Traduzione">
46 - <mail link="scen@g.o">Davide Cendron</mail>
47 + <mail>scen</mail>
48 </author>
49
50 <abstract>
51 @@ -30,441 +21,19 @@
52 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
53 <license/>
54
55 -<version>1.8</version>
56 -<date>2007-11-29</date>
57 -
58 -<chapter>
59 -<title>Controllare i log</title>
60 -<section>
61 -<body>
62 -
63 -<p>
64 -Se Apache non funziona in modo corretto, ma non si ha idea di come individuare
65 -la causa del problema, il primo indizio potrebbe trovarsi nei file di log.
66 -</p>
67 -
68 -<p>
69 -Nel sistema si troverà un certo numero di log, tutti collocati in
70 -<path>/var/log/apache2/</path>. E' probabile che non si riscontreranno nel
71 -proprio sistema tutti i file di log elencati di seguito: la loro presenza
72 -dipende dai moduli che sono stati abilitati.
73 -</p>
74 -
75 -</body>
76 -</section>
77 -
78 -<section>
79 -<title>access_log e ssl_access_log</title>
80 -<body>
81 -
82 -<pre caption="access_log">
83 -67.185.0.236 - - [18/Jun/2005:12:05:50 -0700] "GET / HTTP/1.0" 200 721
84 -10.0.1.80 - - [18/Jun/2005:12:11:07 -0700] "GET /~jaspenelle/__journal1.jpg HTTP/1.1" 200 19079
85 -66.239.233.163 - - [18/Jun/2005:12:15:06 -0700] "GET /~jaspenelle/avy14.gif HTTP/1.0" 200 1661
86 -67.185.60.155 - - [18/Jun/2005:12:18:48 -0700] "GET / HTTP/1.0" 200 721
87 -67.185.0.236 - - [18/Jun/2005:12:25:39 -0700] "GET / HTTP/1.0" 200 721
88 -10.0.1.80 - - [18/Jun/2005:12:28:04 -0700] "GET /~jaspenelle/avy14.gif HTTP/1.1" 200 1661
89 -10.0.1.80 - - [18/Jun/2005:12:28:46 -0700] "GET /~jaspenelle/avy7.png HTTP/1.1" 200 13066
90 -</pre>
91 -
92 -<p>
93 -Questo file è un semplice elenco di tutti i file richiesti al server. A meno
94 -che non sia stata variata la configurazione predefinita, esso sarà nel formato
95 -CLF (Common Log Format):
96 -</p>
97 -
98 -<pre caption="Sintassi Common Log Format">
99 -remotehost rfc931 authuser [date] "request" status bytes
100 -</pre>
101 -
102 -<table>
103 -<tr>
104 - <ti>remotehost</ti>
105 - <ti>Nome host remoto o indirizzo IP.</ti>
106 -</tr>
107 -<tr>
108 - <ti>rfc931</ti>
109 - <ti>Il nome di login remoto dell'utente.</ti>
110 -</tr>
111 -<tr>
112 - <ti>authuser</ti>
113 - <ti>Il nome utente con il quale l'utente si è autenticato.</ti>
114 -</tr>
115 -<tr>
116 - <ti>[date]</ti>
117 - <ti>Data e ora della richiesta..</ti>
118 -</tr>
119 -<tr>
120 - <ti>"request"</ti>
121 - <ti>La riga di richiesta esattamente come è arrivata dal client.</ti>
122 -</tr>
123 -<tr>
124 - <ti>status</ti>
125 - <ti>Il codice di stato HTTP rispedito al client.</ti>
126 -</tr>
127 -<tr>
128 - <ti>bytes</ti>
129 - <ti>La lunghezza del contenuto del documento trasferito.</ti>
130 -</tr>
131 -</table>
132 -
133 -</body>
134 -</section>
135 -<section>
136 -<title>error_log e ssl_error_log</title>
137 -<body>
138 -
139 -<pre caption="error_log">
140 -[Mon Feb 07 23:33:18 2005] [notice] suEXEC mechanism enabled (wrapper: /usr/sbin/suexec2)
141 -[Mon Feb 07 23:33:18 2005] [notice] Digest: generating secret for digest authentication ...
142 -[Mon Feb 07 23:33:18 2005] [notice] Digest: done
143 -[Mon Feb 07 23:33:18 2005] [notice] Apache/2.0.52 (Gentoo/Linux) PHP/4.3.10 configured -- resuming normal operations
144 -[Sat Jun 18 13:01:54 2005] [error] [client 10.0.1.80] File does not exist: /var/www/localhost/htdocs/favicon.ico
145 -[Sat Jun 18 13:02:14 2005] [error] [client 10.0.1.80] File does not exist: /var/www/localhost/htdocs/favicon.ico
146 -[Sat Jun 18 13:02:18 2005] [error] [client 10.0.1.80] File does not exist: /var/www/localhost/htdocs/favicon.ico
147 -[Sat Jun 18 13:02:21 2005] [error] [client 10.0.1.80] File does not exist: /var/www/localhost/htdocs/favicon.ico
148 -[Sat Jun 18 13:02:24 2005] [error] [client 10.0.1.80] File does not exist: /var/www/localhost/htdocs/favicon.ico
149 -</pre>
150 -
151 -<p>
152 -Come si può vedere, questo file contiene molte informazioni, la cui quantità
153 -dipende dalla direttiva <c>ErrorLevel</c> contenuta nel file
154 -<path>httpd.conf</path>. Questo log dice se apache si è avviato correttamente,
155 -in quali errori è incorso, ... Generalmente viene elencata ogni situazione di
156 -errore. Se qualcosa non funziona correttamente, dovrebbe essere il primo file da
157 -controllare per ulteriori informazioni.
158 -</p>
159 -
160 -</body>
161 -</section>
162 -<section>
163 -<title>suexec_log</title>
164 -<body>
165 -
166 -<pre caption="suexec_log">
167 -[2005-02-11 22:33:19]: uid: (1000/vericgar) gid: (1000/1000) cmd: test.cgi
168 -[2005-03-11 19:20:13]: uid: (1000/vericgar) gid: (1000/1000) cmd: test.cgi
169 -[2005-03-11 19:34:47]: uid: (1000/vericgar) gid: (1000/1000) cmd: test.cgi
170 -</pre>
171 -
172 -<p>
173 -In questo file viene inserita una voce di log ogni qualvolta uno script viene
174 -eseguito tramite CGI o suexec. Se non si riesce a far funzionare degli script
175 -tramite suexec, questo è il log da controllare poiché le righe ivi contenute
176 -il più delle volte elencheranno i motivi della loro mancata esecuzione.
177 -</p>
178 -
179 -</body>
180 -</section>
181 -</chapter>
182 -
183 -<chapter>
184 -<title>Ho installato un modulo, ma non funziona!!!</title>
185 -<section>
186 -<body>
187 -
188 -<p>
189 -La sola installazione del modulo non basta, bisogna attivarlo esplicitamente. Si
190 -usa questa modalità per rendere più facile l'attivazione e la disattivazione dei
191 -singoli moduli, a sua volta si semplifica l'individuazione di quelli che creano
192 -problemi, permettendo di testarli e disabilitarli facilmente.
193 -</p>
194 -
195 -<p>
196 -Quando si installa un modulo, dovrebbe venire visualizzato un messaggio simile a
197 -questo:
198 -</p>
199 -
200 -<pre caption="Messaggio post-installazione da emerge">
201 - *
202 - * To enable mod_layout, you need to edit your /etc/conf.d/apache2 file and
203 - * add '-D LAYOUT' to APACHE2_OPTS.
204 - *
205 - *
206 - * Configuration file installed as
207 - * /etc/apache2/modules.d/15_mod_layout.conf
208 - * You may want to edit it before turning the module on in /etc/conf.d/apache2
209 - *
210 -</pre>
211 -
212 -<p>
213 -Il messaggio è piuttosto chiaro. Dice esattamente cosa fare per abilitare questo
214 -modulo.
215 -</p>
216 -
217 -<p>
218 -Se questo messaggio è andato perso, c'è un altro modo per scoprire cosa
219 -aggiungere a <c>APACHE2_OPTS</c> in <path>/etc/conf.d/apache2</path>: bisogna
220 -semplicemente controllare il file di configurazione installato dal modulo. Il
221 -file di configurazione del modulo dovrebbe trovarsi in
222 -<path>/etc/apache2/modules.d/</path>. Aprirlo e cercare una linea contenente la
223 -voce <c>IfDefine</c>:
224 -</p>
225 -
226 -<pre caption="Un estratto da 15_mod_layout.conf">
227 -&lt;IfDefine LAYOUT&gt;
228 - &lt;IfModule !mod_layout.c&gt;
229 - LoadModule layout_module modules/mod_layout.so
230 - &lt;/IfModule&gt;
231 -&lt;/IfDefine&gt;
232 -</pre>
233 -
234 -<p>
235 -Il blocco <c>IfDefine</c> viene eseguito dopo aver aggiunto <c>-D LAYOUT</c> a
236 -<path>/etc/conf.d/apache2</path>. <c>LAYOUT</c> è solamente un esempio.
237 -</p>
238 -
239 -<p>
240 -Ci sono diverse opzioni, specificate nella configurazione predefinita e spiegate
241 -in modo dettagliato in <path>/etc/conf.d/apache2</path>, che si possono
242 -aggiungere ad <c>APACHE2_OPTS</c>.
243 -</p>
244 -
245 -<p>
246 -È possibile trovate tutta la documentazione per i moduli incorporati nella
247 -<uri link="http://httpd.apache.org/docs/2.0/">Documentazione di Apache
248 -2.0</uri>.
249 -</p>
250 -
251 -</body>
252 -</section>
253 -</chapter>
254 -
255 -<chapter>
256 -<title>Apache restituisce pagine di lunghezza nulla o va in segfault</title>
257 -<section>
258 -<body>
259 -
260 -<p>
261 -Questo succede il più delle volte dopo un aggiornamento che guasta la
262 -compatibilità binaria nel pacchetto APR (e ciò può avvenire per vari motivi).
263 -Per correggere il problema, si deve ricompilare il tool stack di Apache:
264 -</p>
265 -
266 -<pre caption="Ricompilare il tool stack">
267 -<comment>(assicurarsi di eseguire le operazioni in quest'ordine, è molto importante!)</comment>
268 -
269 -<comment>(per prima cosa, si deve rimuovere la versione correntemente installata di apache)</comment>
270 -# <i>emerge -aCv '=www-servers/apache-2*'</i>
271 -
272 -<comment>(poi bisogna ricompilare il tool stack)</comment>
273 -# <i>emerge -av '=dev-libs/apr-0*' '=dev-libs/apr-util-0*'</i>
274 -
275 -<comment>(Quindi si reinstalla apache)</comment>
276 -# <i>emerge -av '=www-servers/apache-2*'</i>
277 -
278 -<comment>(si controllano i pacchetti dipendenti da apache)</comment>
279 -$ <i>equery depends www-servers/apache</i>
280 -[ Searching for packages depending on www-servers/apache... ]
281 -dev-php/phpsysinfo-2.3-r2
282 -dev-php/phpsysinfo-2.1-r2
283 -dev-lang/php-5.2.4_p20070914-r2
284 -net-www/mod_layout-4.0.1a-r1
285 -www-servers/gorg-0.5
286 -
287 -<comment>(infine si ricompilano gli eventuali moduli installati)</comment>
288 -# <i>emerge -av '=dev-lang/php-5.2.4_p20070914-r2'
289 -'=net-www/mod_layout-4.0.1.a-r1'</i>
290 -</pre>
291 -
292 -</body>
293 -</section>
294 -<section>
295 -<title>Determinare se un modulo aggiuntivo è bacato</title>
296 -<body>
297 -
298 -<p>
299 -Se si continua ad avere problemi anche dopo aver seguito le istruzioni
300 -precedenti, il colpevole è molto probabilmente uno dei moduli aggiuntivi
301 -installati.
302 -</p>
303 -
304 -<p>
305 -Come prima cosa disabilitare tutti i moduli aggiuntivi, quindi riavviare Apache.
306 -</p>
307 -
308 -<pre caption="Disabilitare i moduli aggiuntivi">
309 -<comment>(modificare /etc/conf.d/apache2)</comment>
310 -
311 -<comment>(prima della modifica)</comment>
312 -APACHE2_OPTS="-D PHP5 -D USERDIR -D SSL"
313 -
314 -<comment>(dopo la modifica)</comment>
315 -APACHE2_OPTS=""
316 -</pre>
317 -
318 -<pre caption="Riavviare Apache">
319 -# <i>/etc/init.d/apache2 stop</i>
320 -<comment>(assicurarsi che apache sia completamente arrestato)</comment>
321 -# <i>ps -A</i>
322 -# <i>/etc/init.d/apache2 start</i>
323 -</pre>
324 -
325 -<note>
326 -Potrebbe essere necessario apportare delle piccole modifiche in qualche parte
327 -della propria configurazione se sono state aggiunte <c>Directive</c> fornite da
328 -questi moduli in posizioni che non si accertano se i moduli sono caricati. E'
329 -raccomandabile che le <c>Directive</c> come queste vengano posizionate in
330 -contenitori di test. Guardare uno qualsiasi dei file .conf in
331 -<path>/etc/apache2/modules.d</path> come esempio.
332 -</note>
333 -
334 -<p>
335 -Se Apache smette di andare in segfault e restituire pagine vuote, allora si avrà
336 -la certezza che la causa è uno dei moduli aggiuntivi. Per scoprire quale, basta
337 -attivarne uno alla volta, riavviando completamente apache ogni volta.
338 -</p>
339 -
340 -<p>
341 -Quando Apache smetterà di funzionare dopo aver aggiunto un modulo, si saprà che
342 -quel modulo è quello che crea problemi. Di solito, la sua ricompilazione
343 -risolverà il problema.
344 -</p>
345 -
346 -<p>
347 -Se dopo la ricompilazione del modulo e il riavvio di apache, esso va in
348 -segfault o restituisce pagine vuote, è consigliabile <uri
349 -link="http://bugs.gentoo.org">aprire un bug report</uri> elencando la versione
350 -specifica e la revisione del modulo, menzionando che va in segfault. Assicurarsi
351 -prima, però, di cercare bug già aperti a riguardo!
352 -</p>
353 -
354 -</body>
355 -</section>
356 -</chapter>
357 +<version>2</version>
358 +<date>2008-03-23</date>
359
360 <chapter>
361 -<title>Il server Web non interpreta gli script PHP o CGI, restituendo invece il
362 -loro codice</title>
363 +<title>Il documento è stato spostato</title>
364 <section>
365 <body>
366
367 <p>
368 -Certe volte Apache sembra restituire il codice degli script PHP o CGI, invece
369 -di eseguirli e restituire il loro output. Se ciò succede anche con il modulo
370 -abilitato in <path>/etc/conf.d/apache2</path> il problema può essere dovuto
371 -alla cache del browser, che andrà svuotata per risolvere questo inconveniente.
372 -</p>
373 -
374 -<p>
375 -Questo problema qualche volta può anche essere notato solo quando si accede al
376 -server web usando il suo nome DNS ma non accedendoci usando il suo indirizzo IP.
377 -È un chiaro segnale che il problema è relativo alla cache.
378 -</p>
379 -
380 -<p>
381 -Il problema può essere corretto pulendo la cache del browser web e di ogni
382 -eventuale proxy web, come squid o wwwoffle.
383 +Vedere <uri>/proj/it/apache/doc/troubleshooting.xml</uri>.
384 </p>
385
386 </body>
387 </section>
388 </chapter>
389 -
390 -<chapter>
391 -<title>configure: error: changes in the environment can compromise the
392 -build</title>
393 -<section>
394 -<body>
395 -
396 -<p>
397 -Se si ottiene questo errore, probabilmente è stato inserito qualche spazio di
398 -troppo nella variabile <c>CFLAGS</c> in <path>/etc/make.conf</path>. La
399 -correzione è semplice, basta rimuovere gli spazi in più:
400 -</p>
401 -
402 -<pre caption="Esempio di modifica a /etc/make.conf">
403 -<comment>(prima della modifica)</comment>
404 -CFLAGS="-O2 -mcpu=pentium3 -march=pentium3 -pipe"
405 -
406 -<comment>(dopo la modifica. notare la rimozione dello spazio)</comment>
407 -CFLAGS="-O2 -mcpu=pentium3 -march=pentium3 -pipe"
408 -</pre>
409 -
410 -</body>
411 -</section>
412 -</chapter>
413 -
414 -<chapter>
415 -<title>Address already in use: make_sock: could not bind to address
416 -0.0.0.0:443</title>
417 -<section>
418 -<body>
419 -
420 -<p>
421 -Questo errore si presenta durante la fase di avvio ed è causata dalla presenza
422 -di direttive <c>Listen</c> multiple nella propria configurazione incompatibili
423 -tra di loro. Per risolvere questo problema, bisogna individuare, nel file di
424 -configurazione, le occorrenze di <c>Listen</c> e correggerle una ad una.
425 -</p>
426 -
427 -<pre caption="Trovare tutte le direttive Listen">
428 -<comment>(Assicurarsi di essere nella directory di configurazione)</comment>
429 -# <i>cd /etc/apache2/</i>
430 -
431 -<comment>(Elencare tutte le direttive)</comment>
432 -# <i>grep Listen httpd.conf vhosts.d/*.conf modules.d/*.conf</i>
433 -</pre>
434 -
435 -<p>
436 -Bisogna individuare quali di queste creano dei conflitti all'interno di Apache.
437 -Per esempio, se c'è un <c>Listen 80</c> in <path>httpd.conf</path> e c'è un
438 -<c>Listen 10.0.0.15:80</c> in un altro file, Apache non riuscirà ad avviarsi.
439 -Questo perché Apache prima si associa alla porta 80 su tutti gli indirizzi IP
440 -della macchina, poi tenta di associarsi alla porta 80 dell'indirizzo IP
441 -10.0.0.15 e fallisce, poiché la porta è già in uso.
442 -</p>
443 -
444 -<p>
445 -Nella configurazione raccomandata deve esserci un singola direttiva <c>Listen
446 -80</c> (e si trova in modo predefinito in <path>httpd.conf</path>, così da
447 -legare apache alla porta standard HTTP su tutti gli indirizzi, poi per ogni
448 -<c>VirtualHost</c> SSL si avvierò una direttiva <c>Listen</c> assoluta separata
449 -(per esempio <c>Listen 10.0.0.15:443</c>).
450 -</p>
451 -
452 -</body>
453 -</section>
454 -</chapter>
455 -
456 -<chapter>
457 -<title>dopo l'aggiornamento ad apache-2.0.54-r13 il vhost predefinito (SSL
458 -and non-SSL) non funziona più</title>
459 -<section>
460 -<body>
461 -
462 -<p>
463 -Con l'aggiornamento ad apache-2.0.54-r13, gli sono state aggiunte due nuove
464 -direttive per correggere il <uri
465 -link="http://bugs.gentoo.org/show_bug.cgi?id=100624">bug 100624</uri>.
466 -</p>
467 -
468 -<p>
469 -Le nuove direttive sono <c>-D DEFAULT_VHOST</c> per attivare l'host virtuale
470 -predefinito e <c>-D SSL_DEFAULT_VHOST</c> per attivare l'host virtuale SSL.
471 -Entrambe devono essere aggiunte alla variabile <c>APACHE2_OPTS</c> in
472 -<path>/etc/conf.d/apache2</path> per permettere ad Apache di funzionare come
473 -prima.
474 -</p>
475 -
476 -</body>
477 -</section>
478 -</chapter>
479 -
480 -<chapter id="getting-help">
481 -<title>Ottenere un aiuto</title>
482 -<section>
483 -<body>
484 -
485 -<p>
486 -Se nessuno dei precedenti consigli è servito, o se si hanno altre domande da
487 -porre, entrare nel canale IRC degli sviluppatori Apache di Gentoo,
488 -<path>#gentoo-apache</path> su <path>irc.freenode.net</path>. Oppure aprire un
489 -bug report sul <uri link="http://bugs.gentoo.org">Bugzilla di Gentoo</uri>.
490 -</p>
491 -
492 -</body>
493 -</section>
494 -</chapter>
495 -
496 </guide>
497 \ No newline at end of file
498
499
500
501 --
502 gentoo-commits@l.g.o mailing list