Changeset 08254fc for content/web


Ignore:
Timestamp:
06/12/2004 11:57:50 PM (18 years ago)
Author:
Bruce Dubbs <bdubbs@…>
Branches:
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
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

Location:
content/web
Files:
4 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>
  • content/web/php.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 php-download-http "http://us2.php.net/distributions/php-&php-version;.tar.bz2">
     8  <!ENTITY php-download-ftp  "ftp://ftp.isu.edu.tw/pub/Unix/Web/PHP/distributions/php-&php-version;.tar.bz2">
     9  <!ENTITY php-size          "3.8 MB">
     10  <!ENTITY php-buildsize     "57 MB">
     11  <!ENTITY php-time          "0.90 SBU">
     12]>
     13
    114<sect1 id="php" xreflabel="PHP-&php-version;">
    215<?dbhtml filename="php.html"?>
    316<title><acronym>PHP</acronym>-&php-version;</title>
    417
    5 &php-intro;
    6 &php-inst;
    7 &php-config;
    8 &php-desc;
     18<sect2>
     19<title>Introduction to <application><acronym>PHP</acronym></application></title>
     20
     21<para><application><acronym>PHP</acronym></application> is the PHP
     22Hypertext Preprocessor. Primarily used in dynamic web sites, it allows for
     23programming code to be directly embedded into the
     24<acronym>HTML</acronym> markup.</para>
     25
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink url="&php-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink url="&php-download-ftp;"/></para></listitem>
     30<listitem><para>Download size: &php-size;</para></listitem>
     31<listitem><para>Estimated Disk space required: &php-buildsize;</para></listitem>
     32<listitem><para>Estimated build time: &php-time;</para></listitem></itemizedlist>
     33</sect3>
     34
     35<sect3><title><application><acronym>PHP</acronym></application> dependencies</title>
     36<sect4><title>Required</title>
     37<para>
     38<xref linkend="apache"/> and
     39<xref linkend="mysql"/>
     40</para></sect4>
     41<sect4><title>Optional</title>
     42<para>
     43<xref linkend="openssl"/>,
     44<xref linkend="bc"/>,
     45<xref linkend="curl"/>,
     46<xref linkend="db"/>,
     47<xref linkend="libjpeg"/>,
     48<xref linkend="libpng"/>,
     49<xref linkend="freetype2"/>,
     50<xref linkend="gdbm"/>,
     51<ulink url="../server/mail.html">MTA</ulink>,
     52<xref linkend="pcre"/>,
     53<xref linkend="postgresql"/>,
     54<xref linkend="readline"/>,
     55<xref linkend="libtiff"/>,
     56<xref linkend="expat"/> and
     57<xref linkend="gmp"/>
     58</para></sect4>
     59</sect3>
     60
     61</sect2>
     62
     63<sect2>
     64<title>Installation of <application><acronym>PHP</acronym></application></title>
     65
     66<para>Install <application><acronym>PHP</acronym></application> by
     67running the following commands:</para>
     68
     69<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc \
     70    --with-apxs2 --with-config-file-path=/etc \
     71    --with-zlib --with-bz2 --enable-ftp --with-gettext \
     72    --with-iconv --with-mysql=/usr --with-ncurses &amp;&amp;
     73make &amp;&amp;
     74make install &amp;&amp;
     75cp php.ini-recommended /etc/php.ini</command></userinput></screen>
     76
     77<note><para><acronym>PHP</acronym> has many more configure options that
     78will enable support for certain things. You can use
     79<command>./configure --help</command> to see a full list of the
     80available options. Also, use of the
     81<ulink url="http://www.php.net/"><acronym>PHP</acronym> web site</ulink>
     82is highly recommended, as their online docs are very good.</para></note>
     83
     84</sect2>
     85
     86<sect2>
     87<title>Configuring <application><acronym>PHP</acronym></application></title>
     88
     89<sect3><title>Config files</title>
     90<para><filename>/etc/php.ini</filename>,
     91<filename>/etc/pear.conf</filename></para>
     92</sect3>
     93
     94<sect3><title>Configuration Information</title>
     95
     96<para>To enable <acronym>PHP</acronym> support in the
     97<application>Apache</application> web server,
     98a new AddType directive must be added to the
     99<filename>httpd.conf</filename> file:</para>
     100
     101<screen><userinput>AddType application/x-httpd-php .php</userinput></screen>
     102
     103<para>Also, it can be useful to add an entry for index.php to the
     104DirectoryIndex directive of the <filename>httpd.conf</filename>
     105file.</para>
     106
     107</sect3>
     108
     109</sect2>
     110
     111<sect2>
     112<title>Contents</title>
     113
     114<para>The <application><acronym>PHP</acronym></application> package contains
     115<command>pear</command>,
     116<command>php</command>,
     117<command>php-config</command>,
     118<command>phpextdist</command> and
     119<command>phpize</command>.
     120</para>
     121
     122</sect2>
     123
     124<sect2><title>Description</title>
     125
     126<sect3><title>php</title>
     127<para><command>php</command> is a command line interface that enables
     128you to parse and execute <acronym>PHP</acronym> code.</para></sect3>
     129
     130</sect2>
    9131
    10132</sect1>
  • content/web/proftpd.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 proftpd-download-http "http://ftp.proftpd.org/distrib/source/proftpd-&proftpd-version;.tar.bz2">
     8  <!ENTITY proftpd-download-ftp  "ftp://ftp.proftpd.org/distrib/source/proftpd-&proftpd-version;.tar.bz2">
     9  <!ENTITY proftpd-size          "761 KB">
     10  <!ENTITY proftpd-buildsize     "6.4 MB">
     11  <!ENTITY proftpd-time          "0.27 SBU">
     12]>
     13
    114<sect1 id="proftpd" xreflabel="ProFTPD-&proftpd-version;">
    215<?dbhtml filename="proftpd.html"?>
    316<title>ProFTPD-&proftpd-version;</title>
    417
    5 &proftpd-intro;
    6 &proftpd-inst;
    7 &proftpd-exp;
    8 &proftpd-config;
    9 &proftpd-desc;
     18<sect2>
     19<title>Introduction to ProFTPD</title>
     20
     21<para>The <application>ProFTPD</application> package contains a secure and
     22highly configurable FTP daemon. This is useful for serving large file archives
     23over a network.</para>
     24
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP):<ulink url="&proftpd-download-http;"/></para></listitem>
     28<listitem><para>Download (FTP): <ulink url="&proftpd-download-ftp;"/></para></listitem>
     29<listitem><para>Download size: &proftpd-size;</para></listitem>
     30<listitem><para>Estimated Disk space required: &proftpd-buildsize;</para></listitem>
     31<listitem><para>Estimated build time: &proftpd-time;</para></listitem></itemizedlist>
     32</sect3>
     33
     34<sect3><title><application>ProFTPD</application> dependencies</title>
     35<sect4><title>Optional</title>
     36<para><xref linkend="Linux_PAM"/></para></sect4>
     37</sect3>
     38
     39</sect2>
     40
     41<sect2>
     42<title>Installation of <application>ProFTPD</application></title>
     43
     44<para>For security reasons, running <application>ProFTPD</application>
     45as an unprivileged user and group is encouraged.</para>
     46
     47<screen><userinput><command>groupadd proftpd &amp;&amp;
     48useradd -c proftpd -d /home/ftp -g proftpd -s /bin/false proftpd</command>
     49</userinput></screen>
     50
     51<para>Install <application>ProFTPD</application> by running the following commands:</para>
     52
     53<screen><userinput><command>install_user=proftpd install_group=proftpd \
     54&nbsp;&nbsp;&nbsp;./configure --prefix=/usr --sysconfdir=/etc \
     55&nbsp;&nbsp;&nbsp;--localstatedir=/var/run &amp;&amp;
     56make &amp;&amp;
     57make install </command></userinput></screen>
     58
     59</sect2>
     60
     61<sect2>
     62<title>Command explanations</title>
     63
     64<para><parameter>install_user=proftpd install_group=proftpd</parameter>:
     65Specify the user and group identity for ProFTPD.</para>
     66
     67<para><parameter>--sysconfdir=/etc</parameter>:
     68This prevents the configuration files from going to
     69<filename class="directory">/usr/etc</filename>.</para>
     70
     71<para><parameter>--localstatedir=/var/run</parameter>:
     72This uses <filename class="directory">/var/run</filename> instead of
     73<filename class="directory">/usr/var</filename> for lock files.</para>
     74
     75</sect2>
     76
     77<sect2>
     78<title>Configuring <application>ProFTPD</application></title>
     79
     80<sect3><title>proftpd init.d script</title>
     81<para>Install the <filename>/etc/rc.d/init.d/proftpd</filename>
     82init script included in the <xref linkend="intro-important-bootscripts"/> package.</para>
     83                                                                                                               
     84<screen><userinput><command>make install-proftpd</command></userinput></screen>
     85
     86</sect3>
     87
     88<sect3><title>Config files</title>
     89
     90<para><filename>/etc/proftpd.conf</filename></para>
     91<para>This is a simple, download-only sample configuration. See the ProFTPD
     92documentation in <filename class="directory">/usr/share/doc/proftpd</filename>
     93and consult the website at <ulink url="http://www.proftpd.org/"/>
     94 for example configurations.</para>
     95
     96<screen><userinput><command>cat &gt; /etc/proftpd.conf &lt;&lt; "EOF"</command>
     97# This is a basic ProFTPD configuration file
     98# It establishes a single server and a single anonymous login.
     99
     100ServerName                      "ProFTPD Default Installation"
     101ServerType                      standalone
     102DefaultServer                   on
     103
     104# Port 21 is the standard FTP port.
     105Port                            21
     106# Umask 022 is a good standard umask to prevent new dirs and files
     107# from being group and world writable.
     108Umask                           022
     109
     110# To prevent DoS attacks, set the maximum number of child processes
     111# to 30.  If you need to allow more than 30 concurrent connections
     112# at once, simply increase this value.  Note that this ONLY works
     113# in standalone mode, in inetd mode you should use an inetd server
     114# that allows you to limit maximum number of processes per service
     115# (such as xinetd)
     116MaxInstances                    30
     117
     118# Set the user and group that the server normally runs at.
     119User                            proftpd
     120Group                           proftpd
     121
     122# Normally, we want files to be overwritable.
     123&lt;Directory /*&gt;
     124  AllowOverwrite                on
     125&lt;/Directory&gt;
     126
     127# A basic anonymous configuration, no upload directories.
     128&lt;Anonymous ~proftpd&gt;
     129  User                          proftpd
     130  Group                         proftpd
     131  # We want clients to be able to login with "anonymous" as well as "proftpd"
     132  UserAlias                     anonymous proftpd
     133
     134  # Limit the maximum number of anonymous logins
     135  MaxClients                    10
     136
     137  # We want 'welcome.msg' displayed at login, and '.message' displayed
     138  # in each newly chdired directory.
     139  DisplayLogin                  welcome.msg
     140  DisplayFirstChdir             .message
     141
     142  # Limit WRITE everywhere in the anonymous chroot
     143  &lt;Limit WRITE&gt;
     144    DenyAll
     145  &lt;/Limit&gt;
     146&lt;/Anonymous&gt;
     147<command>EOF</command></userinput></screen></sect3>
     148
     149</sect2>
     150
     151<sect2>
     152<title>Contents</title>
     153
     154<para>The <application>ProFTPD</application> package contains
     155<command>ftpcount</command>, <command>ftpshut</command>,
     156<command>ftptop</command>, <command>ftpwho</command> and
     157<command>proftpd</command>.</para>
     158
     159</sect2>
     160
     161<sect2><title>Description</title>
     162
     163<sect3><title>ftpcount</title>
     164<para><command>ftpcount</command> shows the current number of connections.</para></sect3>
     165
     166<sect3><title>ftpshut</title>
     167<para><command>ftpshut</command> shuts down all proftpd servers at a
     168given time.</para></sect3>
     169
     170<sect3><title>ftptop</title>
     171<para><command>ftptop</command> displays running status on connections.</para></sect3>
     172
     173<sect3><title>ftpwho</title>
     174<para><command>ftpwho</command> shows current process information for
     175each session.</para></sect3>
     176
     177<sect3><title>proftpd</title>
     178<para><command>proftpd</command> is the daemon itself.</para></sect3>
     179
     180</sect2>
    10181
    11182</sect1>
  • content/web/web.xml

    rd3edf27 r08254fc  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE chapter 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
    18<chapter id="content-web">
    29<?dbhtml filename="web.html"?>
     
    815requests.</para>
    916
    10 &apache;
    11 &php;
    12 &proftpd;
     17<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="apache.xml"/>
     18<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="php.xml"/>
     19<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="proftpd.xml"/>
    1320
    1421</chapter>
Note: See TracChangeset for help on using the changeset viewer.