Gentoo Archives: gentoo-commits

From: "Damian Kuras (shadow)" <shadow@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] gentoo commit in xml/htdocs/doc/pl: apache-troubleshooting.xml
Date: Mon, 31 Mar 2008 19:41:51
Message-Id: E1JgPt5-0000yL-Uq@stork.gentoo.org
1 shadow 08/03/31 19:41:47
2
3 Modified: apache-troubleshooting.xml
4 Log:
5 sync to 1.9
6
7 Revision Changes Path
8 1.12 xml/htdocs/doc/pl/apache-troubleshooting.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/pl/apache-troubleshooting.xml?rev=1.12&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/pl/apache-troubleshooting.xml?rev=1.12&content-type=text/plain
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/pl/apache-troubleshooting.xml?r1=1.11&r2=1.12
13
14 Index: apache-troubleshooting.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/pl/apache-troubleshooting.xml,v
17 retrieving revision 1.11
18 retrieving revision 1.12
19 diff -u -r1.11 -r1.12
20 --- apache-troubleshooting.xml 6 Mar 2008 01:26:50 -0000 1.11
21 +++ apache-troubleshooting.xml 31 Mar 2008 19:41:47 -0000 1.12
22 @@ -1,24 +1,12 @@
23 <?xml version='1.0' encoding="UTF-8"?>
24 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
25 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/pl/apache-troubleshooting.xml,v 1.11 2008/03/06 01:26:50 rane Exp $ -->
26 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/pl/apache-troubleshooting.xml,v 1.12 2008/03/31 19:41:47 shadow Exp $ -->
27
28 -<guide link="/doc/pl/apache-troubleshooting.xml" lang="pl">
29 +<guide redirect="/proj/pl/apache/doc/troubleshooting.xml" lang="pl">
30 <title>Rozwiązywanie problemów z Apache</title>
31
32 <author title="Author">
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 -</author>
44 -<author title="Tłumaczenie">
45 - Aleksander Kamil Modzelewski
46 + <mail>neysx</mail>
47 </author>
48
49 <abstract>
50 @@ -30,426 +18,16 @@
51 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
52 <license/>
53
54 -<version>1.8</version>
55 -<date>2007-11-29</date>
56 -
57 -<chapter>
58 -<title>Przeszukiwanie dziennika</title>
59 -<section>
60 -<body>
61 -
62 -<p>
63 -Jeżeli wiadomo, że instalacja Apache jest uszkodzona, ale nie wiadomo w jaki
64 -sposób, to szukanie błędów należy rozpocząć od przeglądania plików dziennika
65 -(logów).
66 -</p>
67 -
68 -<p>
69 -Apache zazwyczaj zakłada kilka takich plików i wszystkie znajdują się wewnątrz
70 -katalogu <path>/var/log/apache2/</path>. Niektóre z nich mogą na danym systemie
71 -nie istnieć - zależy to od zainstalowanych modułów.
72 -</p>
73 -
74 -</body>
75 -</section>
76 -
77 -<section>
78 -<title>access_log i ssl_access_log</title>
79 -<body>
80 -
81 -<pre caption="access_log">
82 -67.185.0.236 - - [18/Jun/2005:12:05:50 -0700] "GET / HTTP/1.0" 200 721
83 -10.0.1.80 - - [18/Jun/2005:12:11:07 -0700] "GET /~jaspenelle/__journal1.jpg HTTP/1.1" 200 19079
84 -66.239.233.163 - - [18/Jun/2005:12:15:06 -0700] "GET /~jaspenelle/avy14.gif HTTP/1.0" 200 1661
85 -67.185.60.155 - - [18/Jun/2005:12:18:48 -0700] "GET / HTTP/1.0" 200 721
86 -67.185.0.236 - - [18/Jun/2005:12:25:39 -0700] "GET / HTTP/1.0" 200 721
87 -10.0.1.80 - - [18/Jun/2005:12:28:04 -0700] "GET /~jaspenelle/avy14.gif HTTP/1.1" 200 1661
88 -10.0.1.80 - - [18/Jun/2005:12:28:46 -0700] "GET /~jaspenelle/avy7.png HTTP/1.1" 200 13066
89 -</pre>
90 -
91 -<p>
92 -Zawartość tego pliku to lista wszystkich zapytań jakie otrzymał dany serwer. O
93 -ile domyślna konfiguracja nie została zmieniona, to będzie on zapisany w
94 -ogólnym formacie dziennika.
95 -</p>
96 -
97 -<pre caption="Składnia ogólnego formatu dziennika">
98 -remotehost rfc931 authuser [date] "request" status bytes
99 -</pre>
100 -
101 -<table>
102 -<tr>
103 - <ti>remotehost</ti>
104 - <ti>Nazwa zdalnego komputera lub jego numer IP</ti>
105 -</tr>
106 -<tr>
107 - <ti>rfc931</ti>
108 - <ti>Login użytkownika na zdalnym komputerze</ti>
109 -</tr>
110 -<tr>
111 - <ti>authuser</ti>
112 - <ti>Login jako który użytkownik się autoryzował</ti>
113 -</tr>
114 -<tr>
115 - <ti>[date]</ti>
116 - <ti>Data oraz czas zapytania</ti>
117 -</tr>
118 -<tr>
119 - <ti>"request"</ti>
120 - <ti>
121 - Wiersz zapytania w dokładnie takiej formie, w jakiej przyszedł od
122 - klienta
123 - </ti>
124 -</tr>
125 -<tr>
126 - <ti>status</ti>
127 - <ti>Wartość statusu HTTP zwrócona do klienta</ti>
128 -</tr>
129 -<tr>
130 - <ti>bytes</ti>
131 - <ti>Długość przekazanego dokumentu</ti>
132 -</tr>
133 -</table>
134 -
135 -</body>
136 -</section>
137 -<section>
138 -<title>error_log i ssl_error_log</title>
139 -<body>
140 -
141 -<pre caption="error_log">
142 -[Mon Feb 07 23:33:18 2005] [notice] suEXEC mechanism enabled (wrapper: /usr/sbin/suexec2)
143 -[Mon Feb 07 23:33:18 2005] [notice] Digest: generating secret for digest authentication ...
144 -[Mon Feb 07 23:33:18 2005] [notice] Digest: done
145 -[Mon Feb 07 23:33:18 2005] [notice] Apache/2.0.52 (Gentoo/Linux) PHP/4.3.10 configured -- resuming normal operations
146 -[Sat Jun 18 13:01:54 2005] [error] [client 10.0.1.80] File does not exist: /var/www/localhost/htdocs/favicon.ico
147 -[Sat Jun 18 13:02:14 2005] [error] [client 10.0.1.80] File does not exist: /var/www/localhost/htdocs/favicon.ico
148 -[Sat Jun 18 13:02:18 2005] [error] [client 10.0.1.80] File does not exist: /var/www/localhost/htdocs/favicon.ico
149 -[Sat Jun 18 13:02:21 2005] [error] [client 10.0.1.80] File does not exist: /var/www/localhost/htdocs/favicon.ico
150 -[Sat Jun 18 13:02:24 2005] [error] [client 10.0.1.80] File does not exist: /var/www/localhost/htdocs/favicon.ico
151 -</pre>
152 -
153 -<p>
154 -Jak widać, ten plik może zawierać bardzo wiele wpisów, zależnie od dyrektywy
155 -<c>ErrorLevel</c> w <path>httpd.conf</path>. Jest w nim zapisane czy Apache
156 -poprawnie wystartował, jakie wystąpiły błędy i tak dalej. W uproszczeniu
157 -zapisuje on wszystkie nietypowe sytuacje. Jeżeli coś nie działa to właśnie ten
158 -plik powinno się sprawdzić najpierw.
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 -Ten plik zawiera wpis dla każdego wykonania skryptu przy pomocy CGI oraz suexec.
175 -Jeżeli jakiś skrypt nie współpracuje z suexec to właśnie ten plik powinno się
176 -sprawdzić najpierw, gdyż zazwyczaj będzie on zawierał wiersz z wypisaną
177 -przyczyną, dla której odmówiono współpracy.
178 -</p>
179 -
180 -</body>
181 -</section>
182 -</chapter>
183 -
184 -<chapter>
185 -<title>Zainstalowany moduł nie działa!</title>
186 -<section>
187 -<body>
188 -
189 -<p>
190 -Samo zainstalowanie modułu nie wystarcza - musi on zostać wyraźnie włączony.
191 -Jest tak, aby łatwiej było włączać i wyłączać moduły, dzięki czemu łatwiej jest
192 -znaleźć te, które sprawiają problemy oraz łatwiej jest je testować oraz
193 -wyłączać.
194 -</p>
195 -
196 -<p>
197 -Kiedy moduł zostanie zainstalowany, powinien pojawić się komunikat podobny do
198 -tego:
199 -</p>
200 -
201 -<pre caption="Wiadomość po zainstalowaniu modułu">
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 -Opis ten mówi wprost co należy zrobić, aby uruchomić dany moduł.
215 -</p>
216 -
217 -<p>
218 -W razie braku wiadomości jest jeszcze inny sposób sprawdzenia, co należy dodać
219 -do <c>APACHE2_OPTS</c> w <path>/etc/conf.d/apache2</path>: sprawdzenie pliku
220 -konfiguracyjnego zainstalowanego przez moduł. Powinien on się znajdować w
221 -<path>/etc/apache2/modules.d/</path>. Należy w nim odnaleźć wiersz w którym
222 -znajduje się <c>IfDefine</c>:
223 -</p>
224 -
225 -<pre caption="Wyciąg z 15_mod_layout.conf">
226 -&lt;IfDefine LAYOUT&gt;
227 - &lt;IfModule !mod_layout.c&gt;
228 - LoadModule layout_module modules/mod_layout.so
229 - &lt;/IfModule&gt;
230 -&lt;/IfDefine&gt;
231 -</pre>
232 -
233 -<p>
234 -Blok <c>IfDefine</c> jest wykonywany kiedy doda się <c>-D LAYOUT</c> do
235 -<path>/etc/conf.d/apache2</path>. <c>LAYOUT</c> jest tylko przykładem.
236 -</p>
237 -
238 -<p>
239 -Kilka opcji które można dodać do <c>APACHE2_OPTS</c> jest zdefiniowanych w
240 -domyślnej konfiguracji. Ich szczegółowy opis można znaleźć w pliku
241 -<path>/etc/conf.d/apache2</path>.
242 -</p>
243 -
244 -<p>
245 -Dokumentacja wszystkich wbudowanych modułów znajduje się w <uri
246 -link="http://httpd.apache.org/docs/2.0/">dokumentacji Apache 2.0</uri>.
247 -</p>
248 -
249 -</body>
250 -</section>
251 -</chapter>
252 +<version>2</version>
253 +<date>2008-03-23</date>
254
255 <chapter>
256 -<title>Apache zwraca tylko puste strony lub zwraca błąd "naruszenie ochrony pamięci" (segfault)</title>
257 -<section>
258 -<body>
259 -
260 -<p>
261 -Najczęściej dzieje się tak po aktualizacji, gdy złamana została binarna
262 -kompatybilnośćw APR (co może zdarzyć się z wielu przyczyn). Aby to naprawić
263 -konieczne będzie przebudowanie stosu narzędzi Apache:
264 -</p>
265 -
266 -<pre caption="Przebudowywanie stosu narzędzie Apache">
267 -<comment>(Koniecznie należy wykonać to w tej kolejności, to naprawdę ważne!)</comment>
268 -
269 -<comment>(Najpierw usuwamy istniejącego Apache)</comment>
270 -# <i>emerge -aCv '=www-servers/apache-2*'</i>
271 -
272 -<comment>(Następnie przebudowujemy stos narzędzi)</comment>
273 -# <i>emerge -av '=dev-libs/apr-0*' '=dev-libs/apr-util-0*'</i>
274 -
275 -<comment>(Następnie ponownie instalujemy Apache)</comment>
276 -# <i>emerge -av '=www-servers/apache-2*'</i>
277 -
278 -<comment>(Ustalamy, które pakiety polegają na 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>(Następnie budujemy ponownie te, które są zainstalowane)</comment>
288 -# <i>emerge -av '=dev-lang/php-5.2.4_p20070914-r2' '=net-www/mod_layout-4.0.1.a-r1'</i>
289 -</pre>
290 -
291 -</body>
292 -</section>
293 -<section>
294 -<title>Lokaliwozanie uszkodzonego modułu</title>
295 -<body>
296 -
297 -<p>
298 -Jeśli po wykonaniu powyższych instrukcji problem nadal występuje, to winowajcą
299 -jest prawdopodobnie jeden z zainstalowanych modułów dodatkowych.
300 -</p>
301 -
302 -<p>
303 -Najpierw wyłączamy wszystkie moduły i restartujemy Apache.
304 -</p>
305 -
306 -<pre caption="Wyłączanie dodatkowych modułów">
307 -<comment>(Modyfikujemy /etc/conf.d/apache2)</comment>
308 -
309 -<comment>(Przed zmianą)</comment>
310 -APACHE2_OPTS="-D PHP5 -D USERDIR -D SSL"
311 -
312 -<comment>(Po zmianie)</comment>
313 -APACHE2_OPTS=""
314 -</pre>
315 -
316 -<pre caption="Restartowanie Apache">
317 -# <i>/etc/init.d/apache2 stop</i>
318 -<comment>(Należy się upewnić, że Apache jest całkowicie zatrzymane)</comment>
319 -# <i>ps -A</i>
320 -# <i>/etc/init.d/apache2 start</i>
321 -</pre>
322 -
323 -<note>
324 -Być może konieczne będzie dokonanie drobnych zmian w konfiguracji jeśli
325 -wykorzystane były dyrektywy które te moduły zapewniają w miejscach, które nie
326 -testują czy dany moduł jest załadowany. Zaleca się, aby umieszczać je zawsze w
327 -kontenerach testowych. Przykłady można znaleźć w plikach .conf w
328 -<path>/etc/apache2/modules.d</path>.
329 -</note>
330 -
331 -<p>
332 -Jeżeli Apache przestaje segfaultować oraz wysyłać puste strony to można być
333 -pewnym, że problemem był jeden z modułów dodatkowych. Aby sprawdzić który z
334 -nich, dodajemy je z powrotem, po jednym, za każdym razem całkowicie restartując
335 -Apache.
336 -</p>
337 -
338 -<p>
339 -Jeżeli Apache przestanie działać po dodaniu konkretnego modułu, to wiadomo, że
340 -to właśnie on sprawiał problemy. Czasem zwyczajne przebudowanie modułu rozwiąże
341 -kłopoty.
342 -</p>
343 -
344 -<p>
345 -Jeżeli po przebudowaniu modułu i zrestartowaniu Apache nadal występują te same
346 -problemy, to należy <uri link="http://bugs.gentoo.org">zgłosić błąd</uri>
347 -wymieniający konkretną wersję i aktualizację modułu oraz wspomnieć o tym, czy
348 -segfaultuje. Najpierw należy poszukać już zgłoszonych błędów!
349 -</p>
350 -
351 -</body>
352 -</section>
353 -</chapter>
354 -
355 -<chapter>
356 -<title>Serwer nie przetwarza skryptów PHP lub CGI, zamiast tego wyświetla ich kod </title>
357 -<section>
358 -<body>
359 -
360 -<p>
361 -W większości przypadków sytuacja, kiedy apache wyświetla kod skryptu zamiast go
362 -uruchomić, mimo włączenia odpowiednich modułów w pliku
363 -<path>/etc/conf.d/apache2</path>, jest spowodowana problemem ze starym cache po
364 -stronie przeglądarki.
365 -</p>
366 -
367 -<p>
368 -Często problem pojawia się, gdy łączymy się z serwerem poprzez jego nazwę DNS,
369 -a znika, gdy wybierzemy jego numer IP. W takim wypadku niemal na pewno jest to
370 -problem z cache.
371 -</p>
372 -
373 -<p>
374 -Ten problem można rozwiązać czyszcząc cache przeglądarki.
375 -</p>
376 -
377 -</body>
378 -</section>
379 -</chapter>
380 -
381 -<chapter>
382 -<title>configure: error: changes in the environment can compromise the build</title>
383 -<section>
384 -<body>
385 -
386 -<p>
387 -Jeśli zdarza się taki błąd, to prawdopodobnie w <c>CFLAGS</c> w
388 -<path>/etc/make.conf</path> znajdują się zbędne spacje. Poprawka jest prosta -
389 -należy usunąć dodatkowe spacje:
390 -</p>
391 -
392 -<pre caption="Przykładowe zmiany w /etc/make.conf">
393 -<comment>(Przed zmianą)</comment>
394 -CFLAGS="-O2 -mcpu=pentium3 -march=pentium3 -pipe"
395 -
396 -<comment>(Po zmianie)</comment>
397 -CFLAGS="-O2 -mcpu=pentium3 -march=pentium3 -pipe"
398 -</pre>
399 -
400 -</body>
401 -</section>
402 -</chapter>
403 -
404 -<chapter>
405 -<title>Address already in use: make_sock: could not bind to address 0.0.0.0:443</title>
406 -<section>
407 -<body>
408 -
409 -<p>
410 -Taki błąd zdarza się podczas startu i jest wywołany przez istnienie w
411 -konfiguracji kilku wzajemnie niekompatybilnych dyrektyw <c>Listen</c>.
412 -Rozwiązaniem tego problemu powinno być wyszukanie w konfiguracji
413 -<c>Listen</c> oraz naprawienie każdego wystąpienia.
414 -</p>
415 -
416 -<pre caption="Znajdowanie wszystkich dyrektyw Listen">
417 -<comment>(Upewnienie się, że znajduje sięw katalogu konfiguracji)</comment>
418 -# <i>cd /etc/apache2/</i>
419 -
420 -<comment>(Wyszukanie wszystkich dyrektyw Listen)</comment>
421 -# <i>grep Listen httpd.conf vhosts.d/*.conf modules.d/*.conf</i>
422 -</pre>
423 -
424 -<p>
425 -Poszukujemy konfliktów między tym, do czego próbuje dowiązać się Apache. Na
426 -przykład, jeżeli w <path>httpd.conf</path> znajduje się wpis <c>Listen 80</c>, a
427 -w innym pliku można znaleźć <c>Listen 10.0.0.15:80</c>, to serwer nie będzie w
428 -stanie wystartować. Dzieje się tak ponieważ Apache najpierw dowiązuje się do
429 -portu 80 na wszystkich adresach IP dostępnych na komputerze, a następnie do
430 -portu 80 na adresie 10.0.0.15, co nie udaje się, gdyż jest on już wykorzystany.
431 -</p>
432 -
433 -<p>
434 -Zalecaną konfiguracją jest umieszczenie pojedynczej dyrektywy <c>Listen 80</c>
435 -(tak jest w domyślnym <path>httpd.conf</path>) tak, aby dowiązać się na
436 -wszystkich adresach do standardowego portu HTTP, a następnie dla każdego
437 -<c>VirtualHost</c> z SSL stworzyć oddzielną bezwzględną dyrektywę <c>Listen</c>
438 -(na przykład <c>Listen 10.0.0.15:443</c>).
439 -</p>
440 -
441 -</body>
442 -</section>
443 -</chapter>
444 -
445 -<chapter>
446 -<title>Po aktualizacji do apache-2.0.54-r13 domyślne vhosty (SSL i nie-SSL) już nie działają</title>
447 -<section>
448 -<body>
449 -
450 -<p>
451 -W aktualizacji do apache-2.0.54-r13 dodano dwie nowe dyrektywy aby poprawić <uri
452 -link="http://bugs.gentoo.org/show_bug.cgi?id=100624">błąd 100624</uri>.
453 -</p>
454 -
455 -<p>
456 -Nowe dyrektywy to <c>-D DEFAULT_VHOST</c> dla aktywacji domyślnego vhosta oraz
457 -<c>-D SSL_DEFAULT_VHOST</c> dla aktywacji wersji z SSL. Obydwie muszą zostać
458 -dodane do <c>APACHE2_OPTS</c> w <path>/etc/conf.d/apache2</path> jeżeli Apache
459 -ma się zachowywać tak, jak dawniej.
460 -</p>
461 -
462 -</body>
463 -</section>
464 -</chapter>
465 -
466 -<chapter id="getting-help">
467 -<title>Szukanie wsparcia</title>
468 +<title>Przeniesiono</title>
469 <section>
470 <body>
471
472 <p>
473 -Jeżeli żadna z powyższych rad nie pomogła w rozwiązaniu problemu lub jeśli
474 -występuje potrzeba zadania innych pytań, zawsze można skorzystać z kanału
475 -<path>#gentoo-apache</path> na <path>irc.freenode.net</path>. Można też zgłosić
476 -błąd na <uri link="http://bugs.gentoo.org">Bugzilli Gentoo</uri>.
477 +Przeniesiono do <uri>/proj/pl/apache/doc/troubleshooting.xml</uri>.
478 </p>
479
480 </body>
481
482
483
484 --
485 gentoo-commits@l.g.o mailing list