source: server/major/apache.xml@ 438850e

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 438850e was 438850e, checked in by Fernando de Oliveira <fernando@…>, 9 years ago

Separated 'Changelog' entries for Lua-5.3.0 update and
required fixes for some packages.
Vim-7.4, Apache-2.4.10, VLC-2.1.5 and Nmap-6.47: format and text changes.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@15382 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 16.3 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY apache-download-http
8 "http://archive.apache.org/dist/httpd/httpd-&apache-version;.tar.bz2">
9 <!ENTITY apache-download-ftp " ">
10 <!ENTITY apache-md5sum "44543dff14a4ebc1e9e2d86780507156">
11 <!ENTITY apache-size "4.9 MB">
12 <!ENTITY apache-buildsize "94 MB">
13 <!ENTITY apache-time "0.7 SBU">
14]>
15
16<sect1 id="apache" xreflabel="Apache-&apache-version;">
17 <?dbhtml filename="apache.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>Apache-&apache-version;</title>
25
26 <indexterm zone="apache">
27 <primary sortas="a-Apache">Apache</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Apache HTTPD</title>
32
33 <para>
34 The <application>Apache HTTPD</application> package contains an open-source HTTP
35 server. It is useful for creating local intranet web sites or running huge
36 web serving operations.
37 </para>
38
39 &lfs76_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&apache-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&apache-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &apache-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &apache-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &apache-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &apache-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
76 <itemizedlist spacing="compact">
77 <listitem>
78 <para>
79 Required patch:
80 <ulink url="&patch-root;/httpd-&apache-version;-blfs_layout-1.patch"/>
81 </para>
82 </listitem>
83 </itemizedlist>
84
85 <bridgehead renderas="sect3">Apache HTTPD Dependencies</bridgehead>
86
87 <bridgehead renderas="sect4">Required</bridgehead>
88 <para role="required">
89 <xref linkend="apr-util"/> and
90 <xref linkend="pcre"/>
91 </para>
92
93 <bridgehead renderas="sect4">Recommended</bridgehead>
94 <para role="recommended">
95 <xref linkend="openssl"/>
96 </para>
97
98 <bridgehead renderas="sect4">Optional</bridgehead>
99 <para role="optional">
100 <xref linkend="db"/>,
101 <xref linkend="doxygen"/>,
102 <xref linkend="libxml2"/>,
103 <xref linkend="lynx"/> or
104 <xref linkend="Links"/> or
105 <ulink url="http://elinks.or.cz/">ELinks</ulink>,
106 <xref linkend="openldap"/> (<xref linkend="apr-util"/> needs to be
107 installed with ldap suport),
108 <xref linkend="rsync"/>,
109 <ulink url="http://www.distcache.org/">Distcache</ulink>, and
110 <xref linkend="lua"/>
111 </para>
112
113 <para condition="html" role="usernotes">
114 User Notes: <ulink url="&blfs-wiki;/apache"/>
115 </para>
116 </sect2>
117
118 <sect2 role="installation">
119 <title>Installation of Apache HTTPD</title>
120
121 <para>
122 For security reasons, running the server as an unprivileged user and group
123 is strongly encouraged. Create the following group and user using the
124 following commands as <systemitem class="username">root</systemitem>:
125 </para>
126
127<screen role="root"><userinput>groupadd -g 25 apache &amp;&amp;
128useradd -c "Apache Server" -d /srv/www -g apache \
129 -s /bin/false -u 25 apache</userinput></screen>
130
131 <para>
132 Build and install <application>Apache HTTPD</application> by running the
133 following commands:
134 </para>
135
136<screen><userinput>patch -Np1 -i ../httpd-&apache-version;-blfs_layout-1.patch &amp;&amp;
137
138sed -i 's/ldump_writer, &amp;b/&amp;, NULL/' modules/lua/mod_lua.c &amp;&amp;
139sed '/dir.*CFG_PREFIX/s@^@#@' -i support/apxs.in &amp;&amp;
140
141./configure --enable-authnz-fcgi \
142 --enable-layout=BLFS \
143 --enable-mods-shared="all cgi" \
144 --enable-mpms-shared=all \
145 --enable-suexec=shared \
146 --with-apr=/usr/bin/apr-1-config \
147 --with-apr-util=/usr/bin/apu-1-config \
148 --with-suexec-bin=/usr/lib/httpd/suexec \
149 --with-suexec-caller=apache \
150 --with-suexec-docroot=/srv/www \
151 --with-suexec-logfile=/var/log/httpd/suexec.log \
152 --with-suexec-uidmin=100 \
153 --with-suexec-userdir=public_html &amp;&amp;
154make</userinput></screen>
155
156 <para>
157 This package does not come with a test suite.
158 </para>
159
160 <para>
161 Now, as the <systemitem class="username">root</systemitem> user
162 (notice that DESTDIR does not work properly as unpriviledged user):
163 </para>
164
165<screen role="root"><userinput>make install &amp;&amp;
166
167mv -v /usr/sbin/suexec /usr/lib/httpd/suexec &amp;&amp;
168chgrp apache /usr/lib/httpd/suexec &amp;&amp;
169chmod 4754 /usr/lib/httpd/suexec &amp;&amp;
170
171chown -v -R apache:apache /srv/www</userinput></screen>
172
173 </sect2>
174
175 <sect2 role="commands">
176 <title>Command Explanations</title>
177
178 <para>
179 <command>sed -i ... modules/lua/mod_lua.c</command>: This sed fixes
180 compilation with <application>lua</application> 5.3.
181 </para>
182
183 <para>
184 <command>sed '/dir.*CFG_PREFIX/s@^@#@'...</command>: Forces the
185 <application>apxs</application> utility to use absolute pathnames for
186 modules, when instructed to do so.
187 </para>
188
189 <para>
190 <parameter>--enable-authnz-fcgi</parameter>: Build FastCGI
191 authorizer-based authentication and authorization (mod_authnz_fcgi.so
192 fast CGI module).
193 </para>
194
195 <para>
196 <parameter>--enable-mods-shared="all cgi"</parameter>: The modules should be
197 compiled and used as Dynamic Shared Objects (DSOs) so they can be included
198 and excluded from the server using the run-time configuration directives.
199 </para>
200
201 <para>
202 <parameter>--enable-mpm-shared=all</parameter>: This switch ensures that all
203 MPM (Multi Processing Modules) are built as Dynamic Shared Objects (DSOs),
204 so the user can choose which one to use at runtime.
205 </para>
206
207 <para>
208 <parameter>--enable-suexec</parameter>: This switch enables building of the
209 <application>Apache</application> suEXEC module which can be used to allow
210 users to run CGI and SSI scripts under user IDs different from the user ID
211 of the calling web server.
212 </para>
213
214 <para>
215 <parameter>--with-suexec-*</parameter>: These switches control suEXEC module
216 behavior, such as default document root, minimal UID that can be used to
217 run the script under the suEXEC. Please note that with minimal UID 100, you
218 can't run CGI or SSI scripts under suEXEC as the
219 <systemitem class="username">apache</systemitem> user.
220 </para>
221
222 <para>
223 <command>... /usr/lib/httpd/suexec</command>: These commands put
224 <command>suexec</command> wrapper into proper location, since it
225 is not meant to be run directly. They also adjust proper
226 permissions of the binary, making it setgid
227 <systemitem class="username">apache</systemitem>.
228 </para>
229
230 <para>
231 <command>chown -R apache:apache /srv/www</command>: By default, the
232 installation process installs files (documentation, error messages,
233 default icons, etc.) with the ownership of the user that extracted the
234 files from the tar file. If you want to change the ownership to another
235 user, you should do so at this point. The only requirement is that the
236 document directories need to be accessible by the <command>httpd</command>
237 process with (r-x) permissions and files need to be readable (r--) by the
238 <systemitem class="username">apache</systemitem> user.
239 </para>
240
241 </sect2>
242
243 <sect2 role="configuration">
244 <title>Configuring Apache</title>
245
246 <sect3 id="apache-config">
247 <title>Config Files</title>
248
249 <para>
250 <filename>/etc/httpd/httpd.conf</filename> and
251 <filename>/etc/httpd/extra/*</filename>
252 </para>
253
254 <indexterm zone="apache apache-config">
255 <primary sortas="e-etc-httpd-httpd.conf">/etc/httpd/httpd.conf</primary>
256 </indexterm>
257
258 <indexterm zone="apache apache-config">
259 <primary sortas="e-etc-httpd-extra-star">/etc/httpd/extra/*</primary>
260 </indexterm>
261
262 </sect3>
263
264 <sect3>
265 <title>Configuration Information</title>
266
267 <para>
268 See <ulink url="file:///usr/share/httpd/manual/configuring.html"/>
269 for detailed instructions on customising your
270 <application>Apache</application> HTTP server configuration file.
271 </para>
272
273 </sect3>
274
275 <sect3 id="httpd-init">
276 <title>Boot Script</title>
277
278 <para>
279 If you want the <application>Apache</application> server to
280 start automatically when the system is booted, install the
281 <filename>/etc/rc.d/init.d/httpd</filename> init script included
282 in the <xref linkend="bootscripts"/> package.
283 </para>
284
285 <indexterm zone="apache httpd-init">
286 <primary sortas="f-apache">apache</primary>
287 </indexterm>
288
289<screen role="root"><userinput>make install-httpd</userinput></screen>
290
291 </sect3>
292
293 </sect2>
294
295 <sect2 role="content">
296 <title>Contents</title>
297
298 <segmentedlist>
299 <segtitle>Installed Programs</segtitle>
300 <segtitle>Installed Libraries</segtitle>
301 <segtitle>Installed Directories</segtitle>
302
303 <seglistitem>
304 <seg>
305 ab, apachectl, apxs, checkgid, dbmmanage, fcgistarter,
306 htcacheclean, htdbm, htdigest, htpasswd, httpd,
307 httxt2dbm, logresolve, rotatelogs, and suexec
308 </seg>
309 <seg>
310 Several libraries under /usr/lib/httpd/modules/
311 </seg>
312 <seg>
313 /etc/httpd,
314 /srv/www,
315 /usr/include/httpd,
316 /usr/lib/httpd,
317 /usr/share/httpd,
318 /var/log/httpd, and
319 /var/run/httpd
320 </seg>
321 </seglistitem>
322 </segmentedlist>
323
324 <variablelist>
325 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
326 <?dbfo list-presentation="list"?>
327 <?dbhtml list-presentation="table"?>
328
329 <varlistentry id="ab">
330 <term><command>ab</command></term>
331 <listitem>
332 <para>
333 is a tool for benchmarking your <application>Apache</application>
334 HTTP server.
335 </para>
336 <indexterm zone="apache ab">
337 <primary sortas="b-ab">ab</primary>
338 </indexterm>
339 </listitem>
340 </varlistentry>
341
342 <varlistentry id="apachectl">
343 <term><command>apachectl</command></term>
344 <listitem>
345 <para>
346 is a front end to the <application>Apache</application> HTTP server
347 which is designed to help the administrator control the functioning
348 of the <application>Apache</application> httpd daemon.
349 </para>
350 <indexterm zone="apache apachectl">
351 <primary sortas="b-apachectl">apachectl</primary>
352 </indexterm>
353 </listitem>
354 </varlistentry>
355
356 <varlistentry id="apxs">
357 <term><command>apxs</command></term>
358 <listitem>
359 <para>
360 is a tool for building and installing extension modules for the
361 <application>Apache</application> HTTP server.
362 </para>
363 <indexterm zone="apache apxs">
364 <primary sortas="b-apxs">apxs</primary>
365 </indexterm>
366 </listitem>
367 </varlistentry>
368
369 <varlistentry id="checkgid">
370 <term><command>checkgid</command></term>
371 <listitem>
372 <para>
373 is a program that checks whether it can setgid to the group
374 specified. This is to see if it is a valid group for Apache2 to use
375 at runtime. If the user (should be run as superuser) is in that
376 group, or can setgid to it, it will return 0.
377 </para>
378 <indexterm zone="apache checkgid">
379 <primary sortas="b-checkgid">checkgid</primary>
380 </indexterm>
381 </listitem>
382 </varlistentry>
383
384 <varlistentry id="dbmmanage">
385 <term><command>dbmmanage</command></term>
386 <listitem>
387 <para>
388 is used to create and update the DBM format files used to store
389 usernames and passwords for basic authentication of HTTP users.
390 </para>
391 <indexterm zone="apache dbmmanage">
392 <primary sortas="b-dbmmanage">dbmmanage</primary>
393 </indexterm>
394 </listitem>
395 </varlistentry>
396
397 <varlistentry id="htcacheclean">
398 <term><command>htcacheclean</command></term>
399 <listitem>
400 <para>
401 is used to clean up the disk cache.
402 </para>
403 <indexterm zone="apache htcacheclean">
404 <primary sortas="b-htcacheclean">htcacheclean</primary>
405 </indexterm>
406 </listitem>
407 </varlistentry>
408
409 <varlistentry id="htdbm">
410 <term><command>htdbm</command></term>
411 <listitem>
412 <para>
413 is used to manipulate the DBM password databases.
414 </para>
415 <indexterm zone="apache htdbm">
416 <primary sortas="b-htdbm">htdbm</primary>
417 </indexterm>
418 </listitem>
419 </varlistentry>
420
421 <varlistentry id="htdigest">
422 <term><command>htdigest</command></term>
423 <listitem>
424 <para>
425 is used to create and update the flat-files used to store usernames,
426 realms and passwords for digest authentication of HTTP users.
427 </para>
428 <indexterm zone="apache htdigest">
429 <primary sortas="b-htdigest">htdigest</primary>
430 </indexterm>
431 </listitem>
432 </varlistentry>
433
434 <varlistentry id="htpasswd">
435 <term><command>htpasswd</command></term>
436 <listitem>
437 <para>
438 is used to create and update the flat-files used to store usernames
439 and passwords for basic authentication of HTTP users.
440 </para>
441 <indexterm zone="apache htpasswd">
442 <primary sortas="b-htpasswd">htpasswd</primary>
443 </indexterm>
444 </listitem>
445 </varlistentry>
446
447 <varlistentry id="httpd">
448 <term><command>httpd</command></term>
449 <listitem>
450 <para>
451 is the <application>Apache</application> HTTP server program.
452 </para>
453 <indexterm zone="apache httpd">
454 <primary sortas="b-httpd">httpd</primary>
455 </indexterm>
456 </listitem>
457 </varlistentry>
458
459 <varlistentry id="httxt2dbm">
460 <term><command>httxt2dbm</command></term>
461 <listitem>
462 <para>
463 is used to generate DBM files from text, for use in RewriteMap.
464 </para>
465 <indexterm zone="apache httxt2dbm">
466 <primary sortas="b-httxt2dbm">httxt2dbm</primary>
467 </indexterm>
468 </listitem>
469 </varlistentry>
470
471 <varlistentry id="logresolve">
472 <term><command>logresolve</command></term>
473 <listitem>
474 <para>
475 is a post-processing program to resolve IP-addresses in
476 <application>Apache</application>'s access log files.
477 </para>
478 <indexterm zone="apache logresolve">
479 <primary sortas="b-logresolve">logresolve</primary>
480 </indexterm>
481 </listitem>
482 </varlistentry>
483
484 <varlistentry id="rotatelogs">
485 <term><command>rotatelogs</command></term>
486 <listitem>
487 <para>
488 is a simple program for use in conjunction with
489 <application>Apache</application>'s piped log file feature.
490 </para>
491 <indexterm zone="apache rotatelogs">
492 <primary sortas="b-rotatelogs">rotatelogs</primary>
493 </indexterm>
494 </listitem>
495 </varlistentry>
496
497 </variablelist>
498
499 </sect2>
500
501</sect1>
Note: See TracBrowser for help on using the repository browser.