Ignore:
Timestamp:
06/12/2004 11:57:50 PM (20 years ago)
Author:
Bruce Dubbs <bdubbs@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.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, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
0931098
Parents:
d3edf27
Message:

New XML - Part VII

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • content/web/apache.xml

    rd3edf27 r08254fc  
     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
    114<sect1 id="apache" xreflabel="Apache-&apache-version;">
    215<?dbhtml filename="apache.html"?>
    316<title>Apache-&apache-version;</title>
    417
    5 &apache-intro;
    6 &apache-inst;
    7 &apache-exp;
    8 &apache-config;
    9 &apache-desc;
     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>
    10199
    11200</sect1>
Note: See TracChangeset for help on using the changeset viewer.