1 |
nightmorph 07/11/29 08:40:48 |
2 |
|
3 |
Modified: apache-upgrading.xml apache-troubleshooting.xml |
4 |
Log: |
5 |
massive update from bug 200617, with cleanups by yours truly. thanks to hollow for the original patch |
6 |
|
7 |
Revision Changes Path |
8 |
1.9 xml/htdocs/doc/en/apache-upgrading.xml |
9 |
|
10 |
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/apache-upgrading.xml?rev=1.9&view=markup |
11 |
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/apache-upgrading.xml?rev=1.9&content-type=text/plain |
12 |
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/apache-upgrading.xml?r1=1.8&r2=1.9 |
13 |
|
14 |
Index: apache-upgrading.xml |
15 |
=================================================================== |
16 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/apache-upgrading.xml,v |
17 |
retrieving revision 1.8 |
18 |
retrieving revision 1.9 |
19 |
diff -u -r1.8 -r1.9 |
20 |
--- apache-upgrading.xml 30 Jul 2007 18:06:35 -0000 1.8 |
21 |
+++ apache-upgrading.xml 29 Nov 2007 08:40:48 -0000 1.9 |
22 |
@@ -1,6 +1,6 @@ |
23 |
<?xml version='1.0' encoding="UTF-8"?> |
24 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
25 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/apache-upgrading.xml,v 1.8 2007/07/30 18:06:35 nightmorph Exp $ --> |
26 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/apache-upgrading.xml,v 1.9 2007/11/29 08:40:48 nightmorph Exp $ --> |
27 |
|
28 |
<guide link="/doc/en/apache-upgrading.xml" lang="en"> |
29 |
<title>Upgrading Apache</title> |
30 |
@@ -8,6 +8,12 @@ |
31 |
<author title="Author"> |
32 |
<mail link="vericgar@g.o">Michael Stewart</mail> |
33 |
</author> |
34 |
+<author title="Editor"> |
35 |
+ <mail link="hollow"/> |
36 |
+</author> |
37 |
+<author title="Editor"> |
38 |
+ <mail link="nightmorph"/> |
39 |
+</author> |
40 |
|
41 |
<abstract> |
42 |
This document describes the procedure end-users should follow to safely |
43 |
@@ -18,12 +24,80 @@ |
44 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
45 |
<license/> |
46 |
|
47 |
-<version>2.5</version> |
48 |
-<date>2007-07-30</date> |
49 |
+<version>2.6</version> |
50 |
+<date>2007-11-29</date> |
51 |
|
52 |
-<chapter> |
53 |
-<title>Introduction</title> |
54 |
+<chapter id="upgrade-2.2.6-r4"> |
55 |
+<title>Upgrading from <2.2.6-r4</title> |
56 |
+<section> |
57 |
+<body> |
58 |
+ |
59 |
+<p> |
60 |
+The Apache ebuilds have used <path>/etc/apache2/apache2-builtin-mods</path> for |
61 |
+a very long time to select the built-in modules during compile time. However, |
62 |
+this behavior has several disadvantages: |
63 |
+</p> |
64 |
+ |
65 |
+<ul> |
66 |
+ <li> |
67 |
+ Selecting built-in modules during the initial merge is not possible |
68 |
+ </li> |
69 |
+ <li> |
70 |
+ Portage does not know which modules have been installed. This is especially |
71 |
+ annoying for binary packages. |
72 |
+ </li> |
73 |
+ <li> |
74 |
+ Portage will try to overwrite <path>apache2-builtin-mods</path> on every |
75 |
+ upgrade |
76 |
+ </li> |
77 |
+</ul> |
78 |
+ |
79 |
+<p> |
80 |
+To rectify this situation <path>/etc/apache2/apache2-builtin-mods</path> has |
81 |
+been deprecated and migrated to the new <c>APACHE2_MODULES</c> <c>USE_EXPAND</c> |
82 |
+variable. To convert your custom module selection to the new format use the |
83 |
+following command: |
84 |
+</p> |
85 |
+ |
86 |
+<pre caption="Convert apache2-builtin-mods to APACHE2_MODULES"> |
87 |
+$ <i>echo APACHE2_MODULES=\"$(sed '/^mod_/s/mod_\(.*\)\s\+\(shared\|static\)/\1/;t n;d;:n' /etc/apache2/apache2-builtin-mods)\" >> /etc/make.conf</i> |
88 |
+# <i>rm /etc/apache2/apache2-builtin-mods</i> |
89 |
+ |
90 |
+<comment>(You can now safely upgrade apache:)</comment> |
91 |
+# <i>emerge -uva '>=www-servers/apache-2.2.6-r4'</i> |
92 |
+</pre> |
93 |
+ |
94 |
+<p> |
95 |
+Additionally to the new <c>APACHE2_MODULES</c> the local USE flags have been |
96 |
+cleaned up: |
97 |
+</p> |
98 |
+ |
99 |
+<ul> |
100 |
+ <li> |
101 |
+ All MPM USE flags have been moved to the <c>APACHE2_MPMS</c> |
102 |
+ <c>USE_EXPAND</c> variable |
103 |
+ </li> |
104 |
+ <li> |
105 |
+ <c>no-suexec</c> is now <c>suexec</c> |
106 |
+ </li> |
107 |
+ <li> |
108 |
+ <c>static-modules</c> is now <c>static</c> |
109 |
+ </li> |
110 |
+</ul> |
111 |
+ |
112 |
+<p> |
113 |
+For a detailed description of old and corresponding new USE flags see <uri |
114 |
+link="#use-2.2.6-r4">below</uri>. |
115 |
+</p> |
116 |
+ |
117 |
+</body> |
118 |
+</section> |
119 |
+</chapter> |
120 |
+ |
121 |
+<chapter id="upgrade-2.0.52-r3"> |
122 |
+<title>Upgrading from <2.0.52-r3</title> |
123 |
<section> |
124 |
+<title>Introduction</title> |
125 |
<body> |
126 |
|
127 |
<p> |
128 |
@@ -57,29 +131,20 @@ |
129 |
</ul> |
130 |
|
131 |
<p> |
132 |
-The solution? The Apache herd was expanded, adding several new members, who |
133 |
-worked together to create an eclass, update all the modules and fix a number |
134 |
-of bugs. |
135 |
-</p> |
136 |
- |
137 |
-<p> |
138 |
This document details how to upgrade without breaking your system. If you are |
139 |
-a developer or would like to know what we changed, or how ebuilds need to be |
140 |
+a developer or would like to know what we changed, or how ebuilds need to be |
141 |
modified to take advantage of our eclass, then check the <uri |
142 |
link="apache-developer.xml">Apache Developer Reference</uri>. |
143 |
</p> |
144 |
|
145 |
</body> |
146 |
</section> |
147 |
-</chapter> |
148 |
- |
149 |
-<chapter id="upgrade"> |
150 |
-<title>Upgrade Instructions</title> |
151 |
<section> |
152 |
+<title>Upgrading</title> |
153 |
<body> |
154 |
|
155 |
<p> |
156 |
-We have made many changes to how Apache works within Gentoo. Every package |
157 |
+There have been many changes to how Apache works within Gentoo. Every package |
158 |
that is directly related to Apache needs to be updated and some things that |
159 |
worked previously will no longer work. |
160 |
</p> |
161 |
@@ -125,13 +190,13 @@ |
162 |
</p> |
163 |
|
164 |
<p> |
165 |
-As we have added some new USE-flags, you may want to review them and add |
166 |
+As we have added some new USE flags, you may want to review them and add |
167 |
appropriate lines to <path>/etc/portage/package.use</path>. See <uri |
168 |
-link="#use">Apache supported USE-flags</uri> for more details. |
169 |
+link="#use">Apache supported USE flags</uri> for more details. |
170 |
</p> |
171 |
|
172 |
<pre caption="Checking USE flag settings and rebuild"> |
173 |
-<comment>(Check the USE-flags and needed updates)</comment> |
174 |
+<comment>(Check the USE flags and needed updates)</comment> |
175 |
# <i>emerge --pretend --verbose --update --newuse --deep apache subversion \ |
176 |
mod_php mod_bandwidth mod_layout mod_ldap_userdir mod_loopback mod_mp3 \ |
177 |
mod_random mod_throttle mod_watch</i> |
178 |
@@ -191,7 +256,7 @@ |
179 |
link="/doc/en/apache-troubleshooting.xml">Apache Troubleshooting Guide</uri> |
180 |
and if that doesn't solve the issue, please report it on <uri |
181 |
link="http://bugs.gentoo.org">Gentoo Bugzilla</uri>. Be sure to include the |
182 |
-modules you have enabled and (if you are using Apache 2) what MPM USE-flag you |
183 |
+modules you have enabled and (if you are using Apache 2) what MPM USE flag you |
184 |
compiled with (if any). You may also join <path>#gentoo-apache</path> on |
185 |
<path>irc.freenode.net</path> for support. |
186 |
</p> |
187 |
@@ -200,57 +265,79 @@ |
188 |
</section> |
189 |
</chapter> |
190 |
|
191 |
-<chapter id="use"> |
192 |
-<title>Apache supported USE-flags</title> |
193 |
+<chapter id="use-pre-2.2.6-r4"> |
194 |
+<title>Supported USE flags in <2.2.6-r4</title> |
195 |
<section> |
196 |
<body> |
197 |
|
198 |
|
199 |
<p> |
200 |
-There are USE-flags that are local to apache and its modules. Apache |
201 |
-supports several other more generic USE-flags such as <c>ssl</c>, but the |
202 |
+There are USE flags that are local to apache and its modules. Apache |
203 |
+supports several other more generic USE flags such as <c>ssl</c>, but the |
204 |
effect they have on apache doesn't differ much from the effect is has elsewhere, |
205 |
so it's not included in this list. Run a <c>emerge --verbose --pretend |
206 |
-apache</c> to see the full listing of supported USE-flags. |
207 |
+apache</c> to see the full listing of supported USE flags. |
208 |
</p> |
209 |
|
210 |
<table> |
211 |
<tr> |
212 |
- <th>USE-flag</th> |
213 |
- <th>Packages</th> |
214 |
+ <th>USE flag</th> |
215 |
<th>Description</th> |
216 |
</tr> |
217 |
<tr> |
218 |
<ti>apache2</ti> |
219 |
- <ti>depend.apache eclass (all modules)</ti> |
220 |
<ti> |
221 |
Should always be set if using the Apache-2.0 line, should not be set if |
222 |
- using the Apache-1.3 line. The eclass uses this to determine what version |
223 |
- of apache to depend on.</ti> |
224 |
+ using the Apache-1.3 line. The eclass uses this to determine what version of |
225 |
+ apache to depend on. |
226 |
+ </ti> |
227 |
</tr> |
228 |
<tr> |
229 |
- <ti>mpm-leader</ti> |
230 |
- <ti>apache-2*</ti> |
231 |
+ <ti>debug</ti> |
232 |
<ti> |
233 |
- Builds the <uri |
234 |
- link="http://httpd.apache.org/docs/2.0/mod/leader.html">leader</uri> |
235 |
- MPM</ti> |
236 |
+ Enables a hook that allows external modules to plug in and do something |
237 |
+ after a child crashed. There are already two modules, |
238 |
+ <c>mod_whatkilledus</c> and <c>mod_backtrace</c> that make use of this |
239 |
+ hook. |
240 |
+ </ti> |
241 |
</tr> |
242 |
<tr> |
243 |
- <ti>mpm-metux</ti> |
244 |
- <ti>apache-2*</ti> |
245 |
- <ti>Builds the <uri link="http://www.metux.de/mpm/">metux</uri> MPM</ti> |
246 |
+ <ti>doc</ti> |
247 |
+ <ti> |
248 |
+ Install the Apache manual and configuration. |
249 |
+ </ti> |
250 |
+</tr> |
251 |
+<tr> |
252 |
+ <ti>ldap</ti> |
253 |
+ <ti> |
254 |
+ Install <c>mod_ldap</c> and <c>mod_auth_ldap</c>/<c>mod_authnz_ldap</c>. |
255 |
+ </ti> |
256 |
+</tr> |
257 |
+<tr> |
258 |
+ <ti>ssl</ti> |
259 |
+ <ti> |
260 |
+ Installs <c>mod_ssl</c>. |
261 |
+ </ti> |
262 |
+</tr> |
263 |
+<tr> |
264 |
+ <ti>mpm-itk</ti> |
265 |
+ <ti>Builds the <uri link="http://mpm-itk.sesse.net/">itk</uri> MPM</ti> |
266 |
+</tr> |
267 |
+<tr> |
268 |
+ <ti>mpm-leader</ti> |
269 |
+ <ti> |
270 |
+ Builds the <uri |
271 |
+ link="http://httpd.apache.org/docs/2.0/mod/leader.html">leader</uri> MPM |
272 |
+ </ti> |
273 |
</tr> |
274 |
<tr> |
275 |
<ti>mpm-peruser</ti> |
276 |
- <ti>apache-2*</ti> |
277 |
<ti> |
278 |
Builds the <uri link="http://www.telana.com/peruser.php">peruser</uri> MPM |
279 |
</ti> |
280 |
</tr> |
281 |
<tr> |
282 |
<ti>mpm-prefork</ti> |
283 |
- <ti>apache-2*</ti> |
284 |
<ti> |
285 |
Builds the <uri |
286 |
link="http://httpd.apache.org/docs/2.0/mod/prefork.html">prefork</uri> |
287 |
@@ -258,66 +345,441 @@ |
288 |
</tr> |
289 |
<tr> |
290 |
<ti>mpm-threadpool</ti> |
291 |
- <ti>apache-2*</ti> |
292 |
<ti> |
293 |
Builds the <uri |
294 |
link="http://httpd.apache.org/docs/2.0/mod/threadpool.html">threadpool</uri> |
295 |
- MPM</ti> |
296 |
+ MPM |
297 |
+ </ti> |
298 |
</tr> |
299 |
<tr> |
300 |
<ti>mpm-worker</ti> |
301 |
- <ti>apache-2*</ti> |
302 |
- <ti> |
303 |
- Builds the <uri |
304 |
- link="http://httpd.apache.org/docs/2.0/mod/worker.html">worker</uri> |
305 |
- MPM</ti> |
306 |
-</tr> |
307 |
-<tr> |
308 |
- <ti>no-suexec</ti> |
309 |
- <ti>apache</ti> |
310 |
<ti> |
311 |
- Disables building of the suexec module (for those that don't want a |
312 |
- potentially unsafe suid binary on their system) |
313 |
+ Builds the <uri |
314 |
+ link="http://httpd.apache.org/docs/2.0/mod/worker.html">worker</uri> MPM |
315 |
</ti> |
316 |
</tr> |
317 |
<tr> |
318 |
<ti>static-modules</ti> |
319 |
- <ti>apache</ti> |
320 |
<ti> |
321 |
Statically links the modules into the apache binary, so that a |
322 |
LoadModule isn't required for loading the base modules into |
323 |
Apache. |
324 |
</ti> |
325 |
</tr> |
326 |
+</table> |
327 |
+ |
328 |
+<note> |
329 |
+While there are many <c>mpm-*</c> USE flags, they are mutually exclusive. You |
330 |
+should enable one and only one of the <c>mpm-*</c> USE flags. (If you do not |
331 |
+enable one, <c>mpm-prefork</c> or <c>mpm-worker</c> will be used, depending on |
332 |
+if the threads USE flag is set.) |
333 |
+</note> |
334 |
+ |
335 |
+</body> |
336 |
+</section> |
337 |
+</chapter> |
338 |
+ |
339 |
+<chapter id="use-2.2.6-r4"> |
340 |
+<title>Supported USE flags in 2.2.6-r4 and above</title> |
341 |
+<section> |
342 |
+<body> |
343 |
+ |
344 |
+<p> |
345 |
+With the advent of <c>APACHE2_MODULES</c> a general cleanup of USE flags was |
346 |
+necessary. The following table lists supported USE flags for |
347 |
+<c>apache-2.2.6-r4</c> and above as well as their equivalent in previous |
348 |
+versions. |
349 |
+</p> |
350 |
+ |
351 |
+<table> |
352 |
+<tr> |
353 |
+ <th>USE flag</th> |
354 |
+ <th>Old USE flag</th> |
355 |
+ <th>Description</th> |
356 |
+</tr> |
357 |
<tr> |
358 |
- <ti>lingerd</ti> |
359 |
- <ti>apache-1*</ti> |
360 |
+ <ti>debug</ti> |
361 |
+ <ti>debug</ti> |
362 |
<ti> |
363 |
- Adds support for <uri |
364 |
- link="http://www.iagora.com/about/software/lingerd/">lingerd</uri> |
365 |
+ Enables a hook that allows external modules to plug in and do something |
366 |
+ after a child crashed. There are already two modules, |
367 |
+ <c>mod_whatkilledus</c> and <c>mod_backtrace</c>, that make use of this |
368 |
+ hook. |
369 |
</ti> |
370 |
</tr> |
371 |
<tr> |
372 |
- <ti>no-htdocs</ti> |
373 |
- <ti>gentoo-webroot-default</ti> |
374 |
+ <ti>doc</ti> |
375 |
+ <ti>doc</ti> |
376 |
+ <ti>Install the Apache manual and configuration.</ti> |
377 |
+</tr> |
378 |
+<tr> |
379 |
+ <ti>ldap</ti> |
380 |
+ <ti>ldap</ti> |
381 |
+ <ti>Install <c>mod_ldap</c> and <c>mod_authnz_ldap</c></ti> |
382 |
+</tr> |
383 |
+<tr> |
384 |
+ <ti>ssl</ti> |
385 |
+ <ti>ssl</ti> |
386 |
+ <ti>Installs <c>mod_ssl</c></ti> |
387 |
+</tr> |
388 |
+<tr> |
389 |
+ <ti>static</ti> |
390 |
+ <ti>static-modules</ti> |
391 |
<ti> |
392 |
- Disables installing the default webroot into |
393 |
- <path>/var/www/localhost</path> so that custom files there are not |
394 |
- overwritten. Instead the webroot is installed into |
395 |
- <path>/usr/share/doc/gentoo-webroot-default-*/webroot/</path>. |
396 |
+ Statically links the modules into the apache binary, so that a LoadModule |
397 |
+ isn't required for loading the base modules into Apache |
398 |
</ti> |
399 |
</tr> |
400 |
+<tr> |
401 |
+ <ti>suexec</ti> |
402 |
+ <ti>no-suexec</ti> |
403 |
+ <ti>Install <c>mod_suexec</c> and the <c>suexec</c> helper binary</ti> |
404 |
+</tr> |
405 |
+<tr> |
406 |
+ <ti>threads</ti> |
407 |
+ <ti>threads</ti> |
408 |
+ <ti>Selects the default MPM if none is set in APACHE2_MPMS</ti> |
409 |
+</tr> |
410 |
</table> |
411 |
|
412 |
-<note> |
413 |
-While there are many mpm-* USE-flags, they are mutually exclusive. You should |
414 |
-enable one and only one of the mpm-* USE-flags. (If you do not enable one, |
415 |
-mpm-prefork or mpm-worker will be used, depending on if the threads USE-flag is |
416 |
-set.) |
417 |
-</note> |
418 |
+<p> |
419 |
+The following table lists supported <c>APACHE2_MPMS</c> as of |
420 |
+<c>apache-2.2.6-r4</c> and their corresponding previous local USE flag. |
421 |
+</p> |
422 |
+ |
423 |
+<table> |
424 |
+<tr> |
425 |
+ <th>Flag</th> |
426 |
+ <th>Old USE flag</th> |
427 |
+ <th>Description</th> |
428 |
+</tr> |
429 |
+<tr> |
430 |
+ <ti>event</ti> |
431 |
+ <ti>mpm-event</ti> |
432 |
+ <ti>An experimental variant of the standard worker MPM</ti> |
433 |
+</tr> |
434 |
+<tr> |
435 |
+ <ti>itk</ti> |
436 |
+ <ti>mpm-itk</ti> |
437 |
+ <ti>Allows to run each virtual host under a separate uid and gid</ti> |
438 |
+</tr> |
439 |
+<tr> |
440 |
+ <ti>peruser</ti> |
441 |
+ <ti>mpm-peruser</ti> |
442 |
+ <ti> |
443 |
+ Peruser is a working implementation of the perchild MPM allowing to run each |
444 |
+ apache child process as its own user and group, each handling its own set of |
445 |
+ virtual hosts |
446 |
+ </ti> |
447 |
+</tr> |
448 |
+<tr> |
449 |
+ <ti>prefork</ti> |
450 |
+ <ti>mpm-prefork</ti> |
451 |
+ <ti>Implements a non-threaded, pre-forking web server</ti> |
452 |
+</tr> |
453 |
+<tr> |
454 |
+ <ti>worker</ti> |
455 |
+ <ti>mpm-worker</ti> |
456 |
+ <ti> |
457 |
+ Multi-Processing Module implementing a hybrid multi-threaded multi-process |
458 |
+ web server |
459 |
+ </ti> |
460 |
+</tr> |
461 |
+</table> |
462 |
+ |
463 |
+<p> |
464 |
+The following table lists supported <c>APACHE2_MODULES</c> as of |
465 |
+<c>apache-2.2.6-r4</c>. |
466 |
+</p> |
467 |
+ |
468 |
+<table> |
469 |
+<tr> |
470 |
+ <th>Flag</th> |
471 |
+ <th>Description</th> |
472 |
+</tr> |
473 |
+<tr> |
474 |
+ <ti>actions</ti> |
475 |
+ <ti> |
476 |
+ Provides for executing CGI scripts based on media type or request method |
477 |
+ </ti> |
478 |
+</tr> |
479 |
+<tr> |
480 |
+ <ti>alias</ti> |
481 |
+ <ti> |
482 |
+ Provides for mapping different parts of the host filesystem in the |
483 |
+ document tree and for URL redirection |
484 |
+ </ti> |
485 |
+</tr> |
486 |
+<tr> |
487 |
+ <ti>asis</ti> |
488 |
+ <ti>Sends files that contain their own HTTP headers</ti> |
489 |
+</tr> |
490 |
+<tr> |
491 |
+ <ti>auth_basic</ti> |
492 |
+ <ti>Basic authentication</ti> |
493 |
+</tr> |
494 |
+<tr> |
495 |
+ <ti>auth_digest</ti> |
496 |
+ <ti>User authentication using MD5 Digest Authentication</ti> |
497 |
+</tr> |
498 |
+<tr> |
499 |
+ <ti>authn_alias</ti> |
500 |
+ <ti> |
501 |
+ Provides the ability to create extended authentication providers based on |
502 |
+ actual providers |
503 |
+ </ti> |
504 |
+</tr> |
505 |
+<tr> |
506 |
+ <ti>authn_anon</ti> |
507 |
+ <ti>Allows "anonymous" user access to authenticated areas</ti> |
508 |
+</tr> |
509 |
+<tr> |
510 |
+ <ti>authn_dbd</ti> |
511 |
+ <ti>User authentication using an SQL database</ti> |
512 |
+</tr> |
513 |
+<tr> |
514 |
+ <ti>authn_dbm</ti> |
515 |
+ <ti>User authentication using DBM files</ti> |
516 |
+</tr> |
517 |
+<tr> |
518 |
+ <ti>authn_default</ti> |
519 |
+ <ti>Authentication fallback module</ti> |
520 |
+</tr> |
521 |
+<tr> |
522 |
+ <ti>authn_file</ti> |
523 |
+ <ti>User authentication using text files</ti> |
524 |
+</tr> |
525 |
+<tr> |
526 |
+ <ti>authz_dbm</ti> |
527 |
+ <ti>Group authorization using DBM files</ti> |
528 |
+</tr> |
529 |
+<tr> |
530 |
+ <ti>authz_default</ti> |
531 |
+ <ti>Authorization fallback module</ti> |
532 |
+</tr> |
533 |
+<tr> |
534 |
+ <ti>authz_groupfile</ti> |
535 |
+ <ti>Group authorization using plaintext files</ti> |
536 |
+</tr> |
537 |
+<tr> |
538 |
+ <ti>authz_host</ti> |
539 |
+ <ti>Group authorizations based on host (name or IP address)</ti> |
540 |
+</tr> |
541 |
+<tr> |
542 |
+ <ti>authz_owner</ti> |
543 |
+ <ti>Authorization based on file ownership</ti> |
544 |
+</tr> |
545 |
+<tr> |
546 |
+ <ti>authz_user</ti> |
547 |
+ <ti>User Authorization</ti> |
548 |
+</tr> |
549 |
+<tr> |
550 |
+ <ti>autoindex</ti> |
551 |
+ <ti> |
552 |
+ Generates directory indexes automatically, similar to the Unix <c>ls</c> |
553 |
+ command |
554 |
+ </ti> |
555 |
+</tr> |
556 |
+<tr> |
557 |
+ <ti>cache</ti> |
558 |
+ <ti>Content cache keyed to URIs</ti> |
559 |
+</tr> |
560 |
+<tr> |
561 |
+ <ti>cern_meta</ti> |
562 |
+ <ti>CERN httpd metafile semantics</ti> |
563 |
+</tr> |
564 |
+<tr> |
565 |
+ <ti>charset_lite</ti> |
566 |
+ <ti>Specify character set translation or recoding</ti> |
567 |
+</tr> |
568 |
+<tr> |
569 |
+ <ti>dav</ti> |
570 |
+ <ti>Distributed Authoring and Versioning (WebDAV) functionality</ti> |
571 |
+</tr> |
572 |
+<tr> |
573 |
+ <ti>dav_fs</ti> |
574 |
+ <ti>filesystem provider for mod_dav</ti> |
575 |
+</tr> |
576 |
+<tr> |
577 |
+ <ti>dav_lock</ti> |
578 |
+ <ti>generic locking module for mod_dav</ti> |
579 |
+</tr> |
580 |
+<tr> |
581 |
+ <ti>dbd</ti> |
582 |
+ <ti>Manages SQL database connections</ti> |
583 |
+</tr> |
584 |
+<tr> |
585 |
+ <ti>deflate</ti> |
586 |
+ <ti>Compress content before it is delivered to the client</ti> |
587 |
+</tr> |
588 |
+<tr> |
589 |
+ <ti>dir</ti> |
590 |
+ <ti> |
591 |
+ Provides for "trailing slash" redirects and serving directory index files |
592 |
+ </ti> |
593 |
+</tr> |
594 |
+<tr> |
595 |
+ <ti>disk_cache</ti> |
596 |
+ <ti>Content cache storage manager keyed to URIs</ti> |
597 |
+</tr> |
598 |
+<tr> |
599 |
+ <ti>dumpio</ti> |
600 |
+ <ti>Dumps all I/O to error log as desired</ti> |
601 |
+</tr> |
602 |
+<tr> |
603 |
+ <ti>env</ti> |
604 |
+ <ti>Modifies the environment which is passed to CGI scripts and SSI pages</ti> |
605 |
+</tr> |
606 |
+<tr> |
607 |
+ <ti>expires</ti> |
608 |
+ <ti> |
609 |
+ Generation of Expires and Cache-Control HTTP headers according to |
610 |
+ user-specified criteria |
611 |
+ </ti> |
612 |
+</tr> |
613 |
+<tr> |
614 |
+ <ti>ext_filter</ti> |
615 |
+ <ti> |
616 |
+ Pass the response body through an external program before delivery to the |
617 |
+ client |
618 |
+ </ti> |
619 |
+</tr> |
620 |
+<tr> |
621 |
+ <ti>file_cache</ti> |
622 |
+ <ti>Caches a static list of files in memory</ti> |
623 |
+</tr> |
624 |
+<tr> |
625 |
+ <ti>filter</ti> |
626 |
+ <ti>Context-sensitive smart filter configuration module</ti> |
627 |
+</tr> |
628 |
+<tr> |
629 |
+ <ti>headers</ti> |
630 |
+ <ti>Customization of HTTP request and response headers</ti> |
631 |
+</tr> |
632 |
+<tr> |
633 |
+ <ti>ident</ti> |
634 |
+ <ti>RFC 1413 ident lookups</ti> |
635 |
+</tr> |
636 |
+<tr> |
637 |
+ <ti>imagemap</ti> |
638 |
+ <ti>Server-side imagemap processing</ti> |
639 |
+</tr> |
640 |
+<tr> |
641 |
+ <ti>include</ti> |
642 |
+ <ti>Server-parsed html documents (Server Side Includes)</ti> |
643 |
+</tr> |
644 |
+<tr> |
645 |
+ <ti>info</ti> |
646 |
+ <ti>Provides a comprehensive overview of the server configuration</ti> |
647 |
+</tr> |
648 |
+<tr> |
649 |
+ <ti>log_config</ti> |
650 |
+ <ti>Logging of the requests made to the server</ti> |
651 |
+</tr> |
652 |
+<tr> |
653 |
+ <ti>log_forensic</ti> |
654 |
+ <ti>Forensic Logging of the requests made to the server</ti> |
655 |
+</tr> |
656 |
+<tr> |
657 |
+ <ti>logio</ti> |
658 |
+ <ti>Logging of input and output bytes per request</ti> |
659 |
+</tr> |
660 |
+<tr> |
661 |
+ <ti>mem_cache</ti> |
662 |
+ <ti>Content cache keyed to URIs</ti> |
663 |
+</tr> |
664 |
+<tr> |
665 |
+ <ti>mime</ti> |
666 |
+ <ti> |
667 |
+ Associates the requested filename's extensions with the file's behavior |
668 |
+ (handlers and filters) and content (mime-type, language, character set and |
669 |
+ encoding) |
670 |
+ </ti> |
671 |
+</tr> |
672 |
+<tr> |
673 |
+ <ti>mime_magic</ti> |
674 |
+ <ti> |
675 |
+ Determines the MIME type of a file by looking at a few bytes of its |
676 |
+ contents |
677 |
+ </ti> |
678 |
+</tr> |
679 |
+<tr> |
680 |
+ <ti>negotiation</ti> |
681 |
+ <ti>Provides for content negotiation</ti> |
682 |
+</tr> |
683 |
+<tr> |
684 |
+ <ti>proxy</ti> |
685 |
+ <ti>HTTP/1.1 proxy/gateway server</ti> |
686 |
+</tr> |
687 |
+<tr> |
688 |
+ <ti>proxy_ajp</ti> |
689 |
+ <ti>AJP support module for mod_proxy</ti> |
690 |
+</tr> |
691 |
+<tr> |
692 |
+ <ti>proxy_balancer</ti> |
693 |
+ <ti>mod_proxy extension for load balancing</ti> |
694 |
+</tr> |
695 |
+<tr> |
696 |
+ <ti>proxy_connect</ti> |
697 |
+ <ti>mod_proxy extension for CONNECT request handling</ti> |
698 |
+</tr> |
699 |
+<tr> |
700 |
+ <ti>proxy_ftp</ti> |
701 |
+ <ti>FTP support module for mod_proxy</ti> |
702 |
+</tr> |
703 |
+<tr> |
704 |
+ <ti>proxy_http</ti> |
705 |
+ <ti>HTTP support module for mod_proxy</ti> |
706 |
+</tr> |
707 |
+<tr> |
708 |
+ <ti>rewrite</ti> |
709 |
+ <ti> |
710 |
+ Provides a rule-based rewriting engine to rewrite requested URLs on the fly |
711 |
+ </ti> |
712 |
+</tr> |
713 |
+<tr> |
714 |
+ <ti>setenvif</ti> |
715 |
+ <ti> |
716 |
+ Allows the setting of environment variables based on characteristics of the |
717 |
+ request |
718 |
+ </ti> |
719 |
+</tr> |
720 |
+<tr> |
721 |
+ <ti>speling</ti> |
722 |
+ <ti> |
723 |
+ Attempts to correct mistaken URLs that users might have entered by |
724 |
+ ignoring capitalization and by allowing up to one misspelling |
725 |
+ </ti> |
726 |
+</tr> |
727 |
+<tr> |
728 |
+ <ti>status</ti> |
729 |
+ <ti>Provides information on server activity and performance</ti> |
730 |
+</tr> |
731 |
+<tr> |
732 |
+ <ti>unique_id</ti> |
733 |
+ <ti> |
734 |
+ Provides an environment variable with a unique identifier for each request |
735 |
+ </ti> |
736 |
+</tr> |
737 |
+<tr> |
738 |
+ <ti>userdir</ti> |
739 |
+ <ti>User-specific directories</ti> |
740 |
+</tr> |
741 |
+<tr> |
742 |
+ <ti>usertrack</ti> |
743 |
+ <ti>Clickstream logging of user activity on a site</ti> |
744 |
+</tr> |
745 |
+<tr> |
746 |
+ <ti>version</ti> |
747 |
+ <ti>Version dependent configuration</ti> |
748 |
+</tr> |
749 |
+<tr> |
750 |
+ <ti>vhost_alias</ti> |
751 |
+ <ti>Provides for dynamically configured mass virtual hosting</ti> |
752 |
+</tr> |
753 |
+</table> |
754 |
|
755 |
</body> |
756 |
</section> |
757 |
</chapter> |
758 |
- |
759 |
</guide> |
760 |
|
761 |
|
762 |
|
763 |
1.6 xml/htdocs/doc/en/apache-troubleshooting.xml |
764 |
|
765 |
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/apache-troubleshooting.xml?rev=1.6&view=markup |
766 |
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/apache-troubleshooting.xml?rev=1.6&content-type=text/plain |
767 |
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/apache-troubleshooting.xml?r1=1.5&r2=1.6 |
768 |
|
769 |
Index: apache-troubleshooting.xml |
770 |
=================================================================== |
771 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/apache-troubleshooting.xml,v |
772 |
retrieving revision 1.5 |
773 |
retrieving revision 1.6 |
774 |
diff -u -r1.5 -r1.6 |
775 |
--- apache-troubleshooting.xml 11 Oct 2007 20:20:53 -0000 1.5 |
776 |
+++ apache-troubleshooting.xml 29 Nov 2007 08:40:48 -0000 1.6 |
777 |
@@ -1,5 +1,5 @@ |
778 |
<?xml version='1.0' encoding="UTF-8"?> |
779 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/apache-troubleshooting.xml,v 1.5 2007/10/11 20:20:53 nightmorph Exp $ --> |
780 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/apache-troubleshooting.xml,v 1.6 2007/11/29 08:40:48 nightmorph Exp $ --> |
781 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
782 |
|
783 |
<guide link="/doc/en/apache-troubleshooting.xml" lang="en"> |
784 |
@@ -14,6 +14,9 @@ |
785 |
<author title="Contributor"> |
786 |
<mail link="kloeri@g.o">Bryan Østergaard</mail> |
787 |
</author> |
788 |
+<author title="Contributor"> |
789 |
+ <mail link="hollow@g.o">Benedikt Böhm</mail> |
790 |
+</author> |
791 |
|
792 |
<abstract> |
793 |
This document covers a number of ways to figure out how to fix your Apache |
794 |
@@ -24,8 +27,8 @@ |
795 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
796 |
<license/> |
797 |
|
798 |
-<version>1.7</version> |
799 |
-<date>2007-10-11</date> |
800 |
+<version>1.8</version> |
801 |
+<date>2007-11-29</date> |
802 |
|
803 |
<chapter> |
804 |
<title>Checking the Logs</title> |
805 |
@@ -47,7 +50,7 @@ |
806 |
</section> |
807 |
|
808 |
<section> |
809 |
-<title>access_log</title> |
810 |
+<title>access_log and ssl_access_log</title> |
811 |
<body> |
812 |
|
813 |
<pre caption="access_log"> |
814 |
@@ -103,7 +106,7 @@ |
815 |
</body> |
816 |
</section> |
817 |
<section> |
818 |
-<title>error_log</title> |
819 |
+<title>error_log and ssl_error_log</title> |
820 |
<body> |
821 |
|
822 |
<pre caption="error_log"> |
823 |
@@ -203,60 +206,11 @@ |
824 |
</p> |
825 |
|
826 |
<p> |
827 |
-There are several options you can add to <c>APACHE2_OPTS</c> that are |
828 |
-specified in the default configuration: |
829 |
+There are several options you can add to <c>APACHE2_OPTS</c> that are specified |
830 |
+in the default configuration and well explained in |
831 |
+<path>/etc/conf.d/apache2</path>. |
832 |
</p> |
833 |
|
834 |
-<table> |
835 |
-<tr> |
836 |
- <th>Option</th> |
837 |
- <th>Result</th> |
838 |
-</tr> |
839 |
-<tr> |
840 |
- <ti>USERDIR</ti> |
841 |
- <ti> |
842 |
- Enables user public_html folders to be accessible by http://server/~username |
843 |
- </ti> |
844 |
-</tr> |
845 |
-<tr> |
846 |
- <ti>INFO</ti> |
847 |
- <ti> |
848 |
- Enables the mod_info module, which displays information about the running |
849 |
- server's configuration at http://localhost/server-info |
850 |
- </ti> |
851 |
-</tr> |
852 |
-<tr> |
853 |
- <ti>PROXY</ti> |
854 |
- <ti>Enables mod_proxy</ti> |
855 |
-</tr> |
856 |
-<tr> |
857 |
- <ti>SSL</ti> |
858 |
- <ti> |
859 |
- Enables SSL/HTTPS support. (Apache must have been compiled with the ssl |
860 |
- USE-flag) |
861 |
- </ti> |
862 |
-</tr> |
863 |
-<tr> |
864 |
- <ti>DAV</ti> |
865 |
- <ti>Enables mod_dav, the built-in WebDav module</ti> |
866 |
-</tr> |
867 |
-<tr> |
868 |
- <ti>DAV_FS</ti> |
869 |
- <ti>Enables mod_dav_fs, support for file systems in WebDav</ti> |
870 |
-</tr> |
871 |
-<tr> |
872 |
- <ti>LDAP</ti> |
873 |
- <ti> |
874 |
- Enables mod_ldap, which allows Apache to connect to LDAP resources. |
875 |
- (Requires the ldap USE-flag to be enabled) |
876 |
- </ti> |
877 |
-</tr> |
878 |
-<tr> |
879 |
- <ti>AUTH_LDAP</ti> |
880 |
- <ti>Enables authentication to resources via a LDAP resource.</ti> |
881 |
-</tr> |
882 |
-</table> |
883 |
- |
884 |
<p> |
885 |
Documentation for all of the built-in modules can be found in the <uri |
886 |
link="http://httpd.apache.org/docs/2.0/">Apache 2.0 documentation</uri>. |
887 |
|
888 |
|
889 |
|
890 |
-- |
891 |
gentoo-doc-cvs@g.o mailing list |