source: content/web/apache.xml@ 08254fc

10.0 10.1 11.0 11.1 6.0 6.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 08254fc was 08254fc, checked in by Bruce Dubbs <bdubbs@…>, 18 years ago

New XML - Part VII

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@2306 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 7.4 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY apache-download-http "http://www.apache.org/dist/httpd/httpd-&apache-version;.tar.gz">
8 <!ENTITY apache-download-ftp "ftp://ftp.tux.org/pub/net/apache/dist/httpd/httpd-&apache-version;.tar.gz">
9 <!ENTITY apache-size "5.7 MB">
10 <!ENTITY apache-buildsize "75 MB">
11 <!ENTITY apache-time "1.32 SBU">
12]>
13
14<sect1 id="apache" xreflabel="Apache-&apache-version;">
15<?dbhtml filename="apache.html"?>
16<title>Apache-&apache-version;</title>
17
18<sect2>
19<title>Introduction to <application>Apache</application></title>
20
21<para>The <application>Apache</application> package contains an
22open-source <acronym>HTTP</acronym> server. It is
23useful for creating local intranet web sites or running huge web serving
24operations.</para>
25
26<sect3><title>Package information</title>
27<itemizedlist spacing='compact'>
28<listitem><para>Download (HTTP): <ulink url="&apache-download-http;"/></para></listitem>
29<listitem><para>Download (FTP): <ulink url="&apache-download-ftp;"/></para></listitem>
30<listitem><para>Download size: &apache-size;</para></listitem>
31<listitem><para>Estimated Disk space required: &apache-buildsize;</para></listitem>
32<listitem><para>Estimated build time: &apache-time;</para></listitem></itemizedlist>
33</sect3>
34
35<sect3><title>Additional downloads</title>
36<itemizedlist spacing='compact'>
37<listitem><para>Required Patch: <ulink
38url="&patch-root;/httpd-&apache-version;-config.patch"/></para></listitem>
39</itemizedlist></sect3>
40
41<sect3><title><application>Apache</application> dependencies</title>
42<sect4><title>Optional</title>
43<para><xref linkend="db"/> or <xref linkend="gdbm"/>, <xref linkend="openssl"/>, <xref
44linkend="openldap"/> and <xref linkend="expat"/>
45</para></sect4>
46</sect3>
47
48</sect2>
49
50<sect2>
51<title>Installation of <application>Apache</application></title>
52
53<para>For security reasons, running the server as an unprivileged user and group is strongly encouraged.</para>
54
55<screen><userinput><command>groupadd apache &amp;&amp;
56useradd -c apache -d /dev/null -g apache -s /bin/false apache</command></userinput></screen>
57
58<para>The following patch will define the layout of destination directories
59and, among them, the build directory at
60<filename class="directory">/usr/lib/apache/build</filename>. This
61will allow the modules added to <application>Apache</application> to
62be configured without errors. Apply the patch:</para>
63
64<screen><userinput><command>patch -Np1 -i ../httpd-&apache-version;-config.patch</command></userinput></screen>
65
66<para>Build and install <application>Apache</application> by running the following commands:</para>
67
68<screen><userinput><command>./configure --enable-layout=LFS \
69 --enable-mods-shared=all &amp;&amp;
70make &amp;&amp;
71make install</command></userinput></screen>
72
73</sect2>
74
75<sect2>
76<title>Command explanations</title>
77
78<para><parameter>--with-expat=/usr</parameter>: Uses system installed
79expat. <emphasis>If you have installed expat and do not use this switch, the
80apache installation may overwrite some files from the expat installation.</emphasis></para>
81<para><parameter>--enable-mods-shared=all</parameter>: We want modules
82to be compiled and used as Dynamic Shared Objects
83(<acronym>DSO</acronym>s) so they can be included and excluded from the
84server using the run-time configuration directives.
85</para>
86
87<para><parameter>--enable-ssl</parameter>: Use this switch
88to create the <filename class="libraryfile">mod_ssl</filename>
89module and enable <acronym>SSL</acronym> support.</para>
90
91</sect2>
92
93<sect2>
94<title>Configuring <application>Apache</application></title>
95
96<sect3>
97<title>Config files</title>
98
99<para><filename>/etc/apache/*</filename></para>
100
101</sect3>
102
103<sect3><title>Configuration Information</title>
104
105<para>The main configuration file is called
106<filename>httpd.conf</filename>. Modify it to run the server as a
107dedicated user:</para>
108
109<screen><userinput><command>sed -i -e "s%User nobody%User apache%" -e "s%^Group #-1%Group apache%" /etc/apache/httpd.conf</command></userinput></screen>
110
111<para>See
112<ulink url="http://httpd.apache.org/docs-2.0/configuring.html"/> for
113detailed instructions on customizing your Apache <acronym>HTTP</acronym>
114server.</para>
115
116<para>Install the <filename>/etc/rc.d/init.d/apache</filename>
117init script included in the <xref linkend="intro-important-bootscripts"/> package.</para>
118
119<screen><userinput><command>make install-apache</command></userinput></screen>
120
121</sect3>
122
123</sect2>
124
125<sect2>
126<title>Contents</title>
127
128<para>The <application>Apache</application> package provides
129<command>ab</command>,
130<command>apachectl</command>,
131<command>apr-config</command>,
132<command>apu-config</command>,
133<command>apxs</command>,
134<command>checkgid</command>,
135<command>dbmmanage</command>,
136<command>htdbm</command>,
137<command>htdigest</command>,
138<command>htpasswd</command>,
139<command>httpd</command>,
140<command>instdso.sh</command>,
141<command>logresolve</command>,
142<command>rotatelogs</command>,
143<filename class="libraryfile">libapr</filename>,
144<filename class="libraryfile">libaprutil</filename> and
145various modules.</para>
146</sect2>
147
148<sect2><title>Description</title>
149
150<sect3><title>ab</title>
151<para><command>ab</command> is a tool for benchmarking your
152<application>Apache</application> <acronym>HTTP</acronym> server.
153</para></sect3>
154
155<sect3><title>apachectl</title>
156<para><command>apachectl</command> is a front end to the
157<application>Apache</application> <acronym>HTTP</acronym>
158server which is designed to help the administrator control the
159functioning of the <application>Apache</application> httpd daemon.</para></sect3>
160
161<sect3><title>apxs</title>
162<para><command>apxs</command>
163is a tool for building and installing extension modules for the
164<application>Apache</application> <acronym>HTTP</acronym> server.</para></sect3>
165
166<sect3><title>dbmmanage</title>
167<para><command>dbmmanage</command> is used to create and update the
168<filename>DBM</filename> format files used to store usernames and passwords
169for basic authentication of <acronym>HTTP</acronym>
170users.</para></sect3>
171
172<sect3><title>htdigest</title>
173<para><command>htdigest</command> is used to create and update the
174flat-files used to store usernames, realms and passwords for digest
175authentication of <acronym>HTTP</acronym> users.</para></sect3>
176
177<sect3><title>htpasswd</title>
178<para><command>htpasswd</command> is used to create and update the
179flat-files used to store usernames and passwords for basic authentication of
180<acronym>HTTP</acronym> users.</para></sect3>
181
182<sect3><title>httpd</title>
183<para><command>httpd</command> is the <application>Apache</application> <acronym>HTTP</acronym>
184server program.</para></sect3>
185
186<sect3><title>instdso.sh</title>
187<para><command>instdso.sh</command> is a script which installs
188<application>Apache</application> <acronym>DSO</acronym> modules.</para></sect3>
189
190<sect3><title>logresolve</title>
191<para><command>logresolve</command> is a post-processing program to
192resolve <acronym>IP</acronym>-addresses in <application>Apache</application>'s access log files.</para></sect3>
193
194<sect3><title>rotatelogs</title>
195<para><command>rotatelogs</command> is a simple program for use in
196conjunction with <application>Apache</application>'s piped log file feature.</para></sect3>
197
198</sect2>
199
200</sect1>
Note: See TracBrowser for help on using the repository browser.