Changeset 08254fc


Ignore:
Timestamp:
06/12/2004 11:57:50 PM (17 years ago)
Author:
Bruce Dubbs <bdubbs@…>
Branches:
10.0, 10.1, 11.0, 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, nosym, perl-modules, qt5new, systemd-11177, systemd-13485, trunk, xry111/git-date, xry111/git-date-for-trunk, xry111/git-date-test
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

Files:
12 edited

Legend:

Unmodified
Added
Removed
  • content/content.xml

    rd3edf27 r08254fc  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE part 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<part id="content" xreflabel="Content Serving">
    29<?dbhtml filename="content.html" dir="content"?>
    310<title>Content Serving</title>
    411
    5 &content-databases;
    6 &content-web;
     12<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="databases/databases.xml"/>
     13<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="web/web.xml"/>
    714
    815</part>
  • content/databases/databases.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-databases">
    29<?dbhtml filename="databases.html"?>
     
    916<acronym>LFS</acronym> system is entirely possible.</para>
    1017
    11 &db;
    12 &db-3.3;
    13 &mysql;
    14 &postgresql;
     18<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="db.xml"/>   
     19<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="db-3.3.xml"/>   
     20<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mysql.xml"/>   
     21<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="postgresql.xml"/>   
    1522
    1623</chapter>
  • content/databases/db-3.3.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 db-3.3-download-http " ">
     8  <!ENTITY db-3.3-download-ftp  "ftp://ftp.pu.edu.tw/Unix/Database/BerkeleyDB/db-&db-3.3-version;.tar.gz">
     9  <!ENTITY db-3.3-size          "2.3 MB">
     10  <!ENTITY db-3.3-buildsize     "20.3 MB">
     11  <!ENTITY db-3.3-time          "0.80 SBU">
     12]>
     13
    114<sect1 id="db-3.3" xreflabel="Berkeley DB-&db-3.3-version;">
    215<?dbhtml filename="db-3.3.html"?>
    316<title>Berkeley DB-&db-3.3-version;</title>
    417
    5 &db-3.3-intro;
    6 &db-3.3-inst;
    7 &db-3.3-exp;
    8 &db-3.3-desc;
     18<sect2>
     19<title>Introduction to <application>Berkeley DB</application>-&db-3.3-version;</title>
     20
     21<para>The <application>Berkeley DB</application> package contains version
     22&db-3.3-version; of the Berkeley Database.</para>
     23
     24<sect3><title>Package information</title>
     25<itemizedlist spacing='compact'>
     26<listitem><para>Download (HTTP): <ulink
     27url="&db-3.3-download-http;"/></para></listitem>
     28<listitem><para>Download (FTP): <ulink
     29url="&db-3.3-download-ftp;"/></para></listitem>
     30<listitem><para>Download size: &db-3.3-size;</para></listitem>
     31<listitem><para>Estimated Disk space required:
     32&db-3.3-buildsize;</para></listitem>
     33<listitem><para>Estimated build time:
     34&db-3.3-time;</para></listitem></itemizedlist>
     35</sect3>
     36
     37<sect3><title>Additional downloads</title>
     38<itemizedlist spacing='compact'>
     39<listitem><para>Required Patch: <ulink
     40url="http://www.sleepycat.com/webforms/patchdl.php?src=patch.3.3.11.1"/></para></listitem>
     41<listitem><para>Recommended Patch: <ulink
     42url="http://www.sleepycat.com/webforms/patchdl.php?src=patch.3.3.11.2"/></para></listitem>
     43</itemizedlist></sect3>
     44
     45
     46</sect2>
     47
     48<sect2>
     49<title>Installation of <application>Berkeley DB</application></title>
     50
     51<para>See: <ulink url="http://www.sleepycat.com/download/patching.shtml"/>
     52for instructions on installing the patches.
     53</para>
     54
     55<para>Install <application>Berkeley DB</application> by running the following commands:
     56</para>
     57
     58<screen><userinput><command>cd build_unix &amp;&amp;
     59../dist/configure --prefix=/opt/db-3.3 --enable-compat185 &amp;&amp;
     60make &amp;&amp;
     61make docdir=/opt/db-3.3/doc/Berkeley-DB install &amp;&amp;
     62cd /opt/db-3.3/lib/ &amp;&amp;
     63rm -f libdb.so &amp;&amp;
     64for i in $(ls); do mv $i /usr/lib; ln -sf /usr/lib/$i; done &amp;&amp;
     65cd /opt/db-3.3/include/ &amp;&amp;
     66sed -i 's/^DB185/DB/' db_185.h &amp;&amp;
     67ln -nsf /opt/db-3.3/include /usr/include/db3</command></userinput></screen>
     68
     69</sect2>
     70
     71<sect2>
     72<title>Command explanations</title>
     73
     74<para><command>sed 's/^DB185/DB/' /usr/include/db_185.h > /usr/include/db_185.h.new</command>: Change the DB185 database pointer to DB.</para>
     75
     76</sect2>
     77
     78<sect2>
     79<title>Contents</title>
     80
     81<para>The <application>Berkeley DB</application> package contains
     82<command>db_archive</command>,
     83<command>db_checkpoint</command>,
     84<command>db_deadlock</command>,
     85<command>db_dump</command>,
     86<command>db_load</command>,
     87<command>db_printlog</command>,
     88<command>db_recover</command>,
     89<command>db_stat</command>,
     90<command>db_upgrade</command> and
     91<command>db_verify</command>.
     92
     93</para>
     94
     95</sect2>
     96
     97<sect2><title>Description</title>
     98
     99<sect3><title>db_archive</title>
     100<para><command>db_archive</command> prints the pathnames of log files that are
     101no longer in use.</para></sect3>
     102
     103
     104<sect3><title>db_checkpoint</title>
     105<para><command>db_checkpoint</command> is a daemon process used to monitor and
     106checkpoint database logs.</para></sect3>
     107
     108<sect3><title>db_deadlock</title>
     109<para><command>db_deadlock</command> is used to abort lock requests when
     110deadlocks are detected.</para></sect3>
     111
     112<sect3><title>db_dump</title>
     113<para><command>db_dump</command> converts database files to a flat file format
     114readable by <command>db_load</command>.</para></sect3>
     115
     116<sect3><title>db_load</title>
     117<para><command>db_load</command> is used to create database files from flat
     118files created with <command>db_dump</command>.</para></sect3>
     119
     120<sect3><title>db_printlog</title>
     121<para><command>db_printlog</command> converts database log files to human
     122readable text.</para></sect3>
     123
     124
     125<sect3><title>db_recover</title>
     126<para><command>db_recover</command> is used to restore a database to a
     127consistent state after a failure.</para></sect3>
     128
     129<sect3><title>db_stat</title>
     130<para><command>db_stat</command> displays database environment statistics.
     131</para></sect3>
     132
     133<sect3><title>db_upgrade</title>
     134<para><command>db_upgrade</command> is used to upgrade database files to a
     135newer version of <application>Berkeley DB</application>.</para></sect3>
     136
     137<sect3><title>db_verify</title>
     138<para><command>db_verify</command> is used to run consistency checks on
     139database files.</para></sect3>
     140
     141</sect2>
    9142
    10143</sect1>
  • content/databases/db.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 db-download-http "http://www.sleepycat.com/update/snapshot/db-4.2.52.tar.gz">
     8  <!ENTITY db-download-ftp  " ">
     9  <!ENTITY db-size          "4 MB">
     10  <!ENTITY db-buildsize     "43 MB">
     11  <!ENTITY db-time          "1.22 SBU">
     12]>
     13
    114<sect1 id="db" xreflabel="Berkeley DB-&db-version;">
    215<?dbhtml filename="db.html"?>
    316<title>Berkeley DB-&db-version;</title>
    417
    5 &db-intro;
    6 &db-inst;
    7 &db-exp;
    8 &db-desc;
     18<sect2>
     19<title>Introduction to <application>Berkeley DB</application></title>
     20
     21<para>The <application>Berkeley DB</application> package contains programs and
     22utilities used by many other applications for database related
     23functions.</para>
     24
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink
     28url="&db-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink
     30url="&db-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &db-size;</para></listitem>
     32<listitem><para>Estimated Disk space required:
     33&db-buildsize;</para></listitem>
     34<listitem><para>Estimated build time:
     35&db-time;</para></listitem></itemizedlist>
     36</sect3>
     37
     38<sect3><title>Additional downloads</title>
     39<itemizedlist spacing='compact'>
     40<listitem><para>Required Patch: <ulink
     41url="http://www.sleepycat.com/update/4.2.52/patch.4.2.52.1"/></para></listitem>
     42<listitem><para>Required Patch: <ulink
     43url="http://www.sleepycat.com/update/4.2.52/patch.&db-version;"/></para></listitem>
     44</itemizedlist></sect3>
     45
     46<sect3><title><application>Berkeley DB</application> dependencies</title>
     47<sect4><title>Optional</title>
     48<para><xref linkend="tcl"/> and <xref linkend="j2sdk"/>
     49</para></sect4>
     50</sect3>
     51
     52</sect2>
     53
     54<sect2>
     55<title>Installation of <application>Berkeley DB</application></title>
     56
     57<para>Install <application>Berkeley DB</application> by running the following commands:</para>
     58
     59<screen><userinput><command>patch -Np0 -i ../patch.4.2.52.1 &amp;&amp;
     60patch -Np0 -i ../patch.&db-version; &amp;&amp;
     61cd build_unix &amp;&amp;
     62../dist/configure --prefix=/usr \
     63    --enable-compat185 \
     64    --enable-cxx &amp;&amp;
     65make &amp;&amp;
     66make docdir=/usr/share/doc/db-&db-version; install</command></userinput></screen>
     67
     68<note><para>If you wish to enable <application>Java</application>
     69support in <application>Berkeley DB</application>-&db-version;, add
     70<parameter>--enable-java</parameter> to the configure options. This requires a
     71Java compiler.
     72<application>Java</application> support is needed
     73if you plan to use system installed <application>Berkeley DB</application> when
     74compiling <xref linkend="openoffice"/>.</para></note>
     75
     76</sect2>
     77
     78<sect2>
     79<title>Command explanations</title>
     80
     81<para><command>cd build_unix &amp;&amp; ../dist/configure --prefix=/usr
     82--enable-compat185</command>:
     83This replaces the normal <command>./configure</command> command, as
     84<application>Berkeley DB</application> comes with various
     85build directories for different platforms.</para>
     86
     87<para><command>make docdir=/usr/share/doc/db-&db-version;
     88install</command>: This installs the documentation in
     89the correct place.</para>
     90
     91</sect2>
     92
     93<sect2>
     94<title>Contents</title>
     95
     96<para>The <application>Berkeley DB</application> package contains
     97<command>db_archive</command>,
     98<command>db_checkpoint</command>,
     99<command>db_deadlock</command>,
     100<command>db_dump</command>,
     101<command>db_load</command>,
     102<command>db_printlog</command>,
     103<command>db_recover</command>,
     104<command>db_stat</command>,
     105<command>db_upgrade</command> and
     106<command>db_verify</command>.
     107
     108</para>
     109
     110</sect2>
     111
     112<sect2><title>Description</title>
     113
     114<sect3><title>db_archive</title>
     115<para><command>db_archive</command> prints the pathnames of log files that are
     116no longer in use.</para></sect3>
     117
     118
     119<sect3><title>db_checkpoint</title>
     120<para><command>db_checkpoint</command> is a daemon process used to monitor and
     121checkpoint database logs.</para></sect3>
     122
     123<sect3><title>db_deadlock</title>
     124<para><command>db_deadlock</command> is used to abort lock requests when
     125deadlocks are detected.</para></sect3>
     126
     127<sect3><title>db_dump</title>
     128<para><command>db_dump</command> converts database files to a flat file format
     129readable by <command>db_load</command>.</para></sect3>
     130
     131<sect3><title>db_load</title>
     132<para><command>db_load</command> is used to create database files from flat
     133files created with <command>db_dump</command>.</para></sect3>
     134
     135<sect3><title>db_printlog</title>
     136<para><command>db_printlog</command> converts database log files to human
     137readable text.</para></sect3>
     138
     139
     140<sect3><title>db_recover</title>
     141<para><command>db_recover</command> is used to restore a database to a
     142consistent state after a failure.</para></sect3>
     143
     144<sect3><title>db_stat</title>
     145<para><command>db_stat</command> displays database environment statistics.
     146</para></sect3>
     147
     148<sect3><title>db_upgrade</title>
     149<para><command>db_upgrade</command> is used to upgrade database files to a
     150newer version of <application>Berkeley DB</application>.</para></sect3>
     151
     152<sect3><title>db_verify</title>
     153<para><command>db_verify</command> is used to run consistency checks on
     154database files.</para></sect3>
     155
     156</sect2>
    9157
    10158</sect1>
  • content/databases/mysql.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 mysql-download-http "http://mysql.he.net/Downloads/MySQL-4.0/mysql-&mysql-version;.tar.gz">
     8  <!ENTITY mysql-download-ftp  "ftp://mirror.mcs.anl.gov/pub/mysql/Downloads/MySQL-4.0/mysql-&mysql-version;.tar.gz">
     9  <!ENTITY mysql-size          "13.5 MB">
     10  <!ENTITY mysql-buildsize     "98.7 MB">
     11  <!ENTITY mysql-time          "3.43 SBU">
     12]>
     13
    114<sect1 id="mysql" xreflabel="MySQL-&mysql-version;">
    215<?dbhtml filename="mysql.html"?>
    316<title>MySQL-&mysql-version;</title>
    417
    5 &mysql-intro;
    6 &mysql-inst;
     18<sect2>
     19<title>Introduction to <application>My<acronym>SQL</acronym></application></title>
     20
     21<para><application>My<acronym>SQL</acronym></application> is a widely used and fast
     22<acronym>SQL</acronym> database server. It is a client/server
     23implementation that consists of a server daemon and many different
     24client programs and libraries.</para>
     25
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink url="&mysql-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink url="&mysql-download-ftp;"/></para></listitem>
     30<listitem><para>Download size: &mysql-size;</para></listitem>
     31<listitem><para>Estimated Disk space required: &mysql-buildsize;</para></listitem>
     32<listitem><para>Estimated build time: &mysql-time;</para></listitem></itemizedlist>
     33</sect3>
     34
     35<sect3><title><application>My<acronym>SQL</acronym></application> dependencies</title>
     36<sect4><title>Optional</title>
     37<para><xref linkend="readline"/>, <xref linkend="openssl"/> and
     38<xref linkend="tcpwrappers"/>
     39</para></sect4>
     40</sect3>
     41
     42</sect2>
     43
     44<sect2>
     45<title>Installation of <application>My<acronym>SQL</acronym></application></title>
     46
     47<para>For security reasons, running the server as an unprivileged user
     48and group is strongly encouraged:</para>
     49
     50<screen><userinput><command>groupadd mysql &amp;&amp;
     51useradd -c mysql -d /dev/null -g mysql -s /bin/false mysql</command></userinput></screen>
     52
     53<para>Build and install <application>My<acronym>SQL</acronym></application> by running the following commands:</para>
     54
     55<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc \
     56    --libexecdir=/usr/sbin --localstatedir=/var/lib/mysql \
     57    --enable-thread-safe-client --enable-local-infile \
     58    --enable-assembler --without-debug --without-bench &amp;&amp;
     59make testdir=/usr/lib/mysql/mysql-test &amp;&amp;
     60make testdir=/usr/lib/mysql/mysql-test install</command></userinput></screen>
     61
     62<para>Packages that depend on <application>MySQL</application> need the shared
     63libraries available at run-time:</para>
     64
     65<screen><userinput><command>cd /usr/lib &amp;&amp;
     66ln -sf mysql/libmysqlclient{,_r}.so* .</command></userinput></screen>
     67
     68</sect2>
     69
     70<sect2>
     71<title>Configuring <application>My<acronym>SQL</acronym></application></title>
     72
     73<sect3>
     74<title>Config files</title>
     75
     76<para><filename>/etc/my.cnf</filename>, <filename>~/.my.cnf</filename></para>
     77
     78</sect3>
     79
     80<sect3>
     81<title>Configuration Information</title>
     82
     83<para>There are several default configuration files available in
     84<filename class="directory">/usr/share/mysql</filename> which you can
     85use.  Create <filename>/etc/my.cnf</filename> using the following
     86command:</para>
     87
     88<screen><userinput><command>cp /usr/share/mysql/my-medium.cnf /etc/my.cnf</command></userinput></screen>
     89
     90<para>You can now install a database and change the ownership to the
     91unprivileged user and group.</para>
     92
     93<screen><userinput><command>mysql_install_db &amp;&amp;
     94chown -R mysql:mysql /var/lib/mysql</command></userinput></screen>
     95
     96<para>Further configuration requires that the mysql server be running:</para>
     97
     98<screen><userinput><command>mysqld_safe --user=mysql 2&gt;&amp;1 &gt;/dev/null &amp;</command></userinput></screen>
     99
     100<para>A default installation does not setup a password for the
     101administrator, so use the following command to set one. Replace <replaceable>[new-password]</replaceable>
     102with your own.</para>
     103
    7104<!--
    8 &mysql-exp;
     105<screen><userinput><command>mysql -uroot mysql</command></userinput>
     106Welcome to the MySQL monitor.  Commands end with ; or \g.
     107Your MySQL connection id is 2 to server version: 3.23.51-log
     108
     109Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
     110
     111<prompt>mysql&gt;</prompt> <userinput><command>UPDATE user SET password=password('<replaceable>new-password</replaceable>') WHERE user='root';</command></userinput>
     112Query OK, 2 rows affected (0.00 sec)
     113Rows matched: 2  Changed: 2  Warnings: 0
     114
     115<prompt>mysql&gt;</prompt> <userinput><command>FLUSH PRIVILEGES;</command></userinput>
     116Query OK, 0 rows affected (0.00 sec)
     117
     118<prompt>mysql&gt;</prompt> <userinput><command>EXIT;</command></userinput>
     119bye
     120</screen>
    9121-->
    10 &mysql-config;
    11 &mysql-desc;
     122
     123<screen><userinput><command>mysqladmin -u root password <replaceable>[new-password]</replaceable></command></userinput></screen>
     124
     125<para>Configuration of the server is now finished. Shut the server down
     126using the following command:</para>
     127
     128<screen><userinput><command>mysqladmin -p shutdown</command></userinput></screen>
     129
     130<para>Install the <filename>/etc/rc.d/init.d/mysql</filename>
     131init script included in the <xref linkend="intro-important-bootscripts"/> package.</para>
     132                                                                                                               
     133<screen><userinput><command>make install-mysql</command></userinput></screen>
     134
     135</sect3>
     136
     137</sect2>
     138
     139<sect2>
     140<title>Contents</title>
     141
     142<para>The <application>My<acronym>SQL</acronym></application> package contains <command>
     143comp_err</command>, <command>
     144isamchk</command>, <command>
     145isamlog</command>, <command>
     146make_win_src_distribution</command>, <command>
     147msql2mysql</command>, <command>
     148my_print_defaults</command>, <command>
     149myisamchk</command>, <command>
     150myisamlog</command>, <command>
     151myisampack</command>, <command>
     152mysql</command>, <command>
     153mysql_config</command>, <command>
     154mysql_convert_table_format</command>, <command>
     155mysql_explain_log</command>, <command>
     156mysql_find_rows</command>, <command>
     157mysql_fix_extensions</command>, <command>
     158mysql_fix_privilege_tables</command>, <command>
     159mysql_install</command>, <command>
     160mysql_install_db</command>, <command>
     161mysql_secure_installation</command>, <command>
     162mysql_setpermission</command>, <command>
     163mysql_tableinfo</command>, <command>
     164mysql_waitpid</command>, <command>
     165mysql_zap</command>, <command>
     166mysqlacess</command>,<command>
     167mysqladmin</command>, <command>
     168mysqlbinlog</command>, <command>
     169mysqlbug</command>, <command>
     170mysqlcheck</command>, <command>
     171mysqld</command>, <command>
     172mysqld_multi</command>, <command>
     173mysqld_safe</command>, <command>
     174mysqldump</command>, <command>
     175mysqldumpslow</command>, <command>
     176mysqlhotcopy</command>, <command>
     177mysqlimport</command>, <command>
     178mysqlmanager</command>, <command>
     179mysqlmanager-pwgen</command>, <command>
     180mysqlmanagerc</command>, <command>
     181mysqlshow</command>, <command>
     182mysqltest</command>, <command>
     183pack_isam</command>, <command>
     184perror</command>, <command>
     185replace</command>, <command>
     186resolve_stack_dump</command>, <command>
     187resolveip</command>, <filename class="libraryfile">
     188libdbug</filename>, <filename class="libraryfile">
     189libheap</filename>, <filename class="libraryfile">
     190libmerge</filename>, <filename class="libraryfile">
     191libmyisam</filename>, <filename class="libraryfile">
     192libmyisammrg</filename>, <filename class="libraryfile">
     193libmysqlclient</filename>, <filename class="libraryfile">
     194libmystrings</filename>, <filename class="libraryfile">
     195libmysys</filename>, <filename class="libraryfile">
     196libnisam</filename> and <filename class="libraryfile">
     197libvio</filename>.</para>
     198
     199</sect2>
     200
     201<sect2><title>Description</title>
     202
     203<para>A package listing would be several pages long, we suggest
     204consulting the <application>My<acronym>SQL</acronym></application> documentation for full details, instead.</para>
     205
     206<para>Certain <application>My<acronym>SQL</acronym></application>
     207support programs may require the <application>Perl</application> DBI modules to be installed to function properly.</para>
     208
     209</sect2>
    12210
    13211</sect1>
  • content/databases/postgresql.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 postgresql-download-http "http://gd.tuwien.ac.at/db/postgresql/v&postgresql-version;/postgresql-&postgresql-version;.tar.bz2">
     8  <!ENTITY postgresql-download-ftp  "ftp://ftp.fr.postgresql.org/v&postgresql-version;/postgresql-&postgresql-version;.tar.bz2">
     9  <!ENTITY postgresql-size          "9.7 MB">
     10  <!ENTITY postgresql-buildsize     "80 MB">
     11  <!ENTITY postgresql-time          "1.21 SBU">
     12]>
     13
    114<sect1 id="postgresql" xreflabel="PostgreSQL-&postgresql-version;">
    215<?dbhtml filename="postgresql.html"?>
    316<title>Postgre<acronym>SQL</acronym>-&postgresql-version;</title>
    417
    5 &postgresql-intro;
    6 &postgresql-inst;
    7 &postgresql-exp;
    8 &postgresql-config;
    9 &postgresql-desc;
     18<sect2>
     19<title>Introduction to <application>Postgre<acronym>SQL</acronym></application></title>
     20
     21<para><application>Postgre<acronym>SQL</acronym></application> is an advanced object-relational
     22database management system (<acronym>ORDBMS</acronym>), derived from the
     23Berkeley Postgres database management system.</para>
     24
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink url="&postgresql-download-http;"/></para></listitem>
     28<listitem><para>Download (FTP): <ulink url="&postgresql-download-ftp;"/></para></listitem>
     29<listitem><para>Download size: &postgresql-size;</para></listitem>
     30<listitem><para>Estimated Disk space required: &postgresql-buildsize;</para></listitem>
     31<listitem><para>Estimated build time: &postgresql-time;</para></listitem></itemizedlist>
     32</sect3>
     33
     34<!--
     35<note><para>The C++ and ODBC bindings have been removed from the main
     36source distribution.  They can be found at the
     37<application>Postgre<acronym>SQL</acronym></application> Projects Web
     38Site at: <ulink url="http://gborg.postgresql.org" />.</para></note>
     39-->
     40
     41<sect3><title><application>Postgre<acronym>SQL</acronym></application> dependencies</title>
     42<sect4><title>Optional</title>
     43<para>
     44<xref linkend="readline"/>,
     45<xref linkend="Python"/>,
     46<xref linkend="tcl"/>,
     47<xref linkend="tk"/>,
     48<xref linkend="openssl"/>,
     49<xref linkend="Linux_PAM"/>,
     50<ulink url="http://www.pdc.kth.se/kth-krb/">krb4</ulink>,
     51<xref linkend="mitkrb"/> or <xref linkend="heimdal"/>,
     52<ulink url="http://ant.apache.org/">Ant</ulink> and
     53<ulink url="http://rendezvous.sourceforge.net/">Rendezvous</ulink>
     54</para></sect4>
     55</sect3>
     56
     57</sect2>
     58
     59<sect2>
     60<title>Installation of <application>Postgre<acronym>SQL</acronym></application></title>
     61
     62<para>Install <application>Postgre<acronym>SQL</acronym></application> with the following commands: </para>
     63
     64<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     65make &amp;&amp;
     66make install</command></userinput></screen>
     67
     68<note><para>If you are upgrading an existing system and are going to
     69install the new files over the old ones, then you should
     70back up your data, shut down the old server and follow the
     71instructions in <ulink
     72url="http://www.postgresql.org/docs/7.4/static/install-upgrading.html">the
     73official <application>Postgre<acronym>SQL</acronym></application>
     74documentation</ulink>.</para></note>
     75
     76<para>Initialize a database cluster with the following commands:</para>
     77
     78<screen><userinput><command>mkdir -p /var/pgsql/data &amp;&amp;
     79useradd -d /var/pgsql/data postgres &amp;&amp;
     80chown postgres /var/pgsql/data &amp;&amp;
     81su - postgres -c '/usr/bin/initdb -D /var/pgsql/data'</command></userinput></screen>
     82
     83<para>Start the database server with the following command:</para>
     84
     85<screen><userinput><command>su - postgres -c '/usr/bin/postmaster -D /var/pgsql/data > \
     86    /var/pgsql/data/logfile 2&gt;&amp;1 &amp;'</command></userinput></screen>
     87
     88<para>Create a database and verify the installation:</para>
     89
     90<screen><userinput><command>su - postgres -c '/usr/bin/createdb test' &amp;&amp;
     91echo "create table t1 ( name varchar(20), state_province varchar(20) );" \
     92    | (su - postgres -c '/usr/bin/psql test ') &amp;&amp;
     93echo "insert into t1 values ('Billy', 'NewYork');" \
     94    | (su - postgres -c '/usr/bin/psql test ') &amp;&amp;
     95echo "insert into t1 values ('Evanidus', 'Quebec');" \
     96    | (su - postgres -c '/usr/bin/psql test ') &amp;&amp;
     97echo "insert into t1 values ('Jesse', 'Ontario');" \
     98    | (su - postgres -c '/usr/bin/psql test ') &amp;&amp;
     99echo "select * from t1;" | (su - postgres -c '/usr/bin/psql test')</command></userinput></screen>
     100
     101</sect2>
     102
     103<sect2>
     104<title>Command explanations</title>
     105
     106<para><command>useradd -d /var/pgsql/data postgres</command>: Add an unprivileged user to run the database server.</para>
     107
     108<para><command>createdb test, create table t1 , insert into t1 values..., select *
     109from t1</command>: Create a database, add a table to it, insert some rows into the table
     110and select them to verify that the installation is working
     111properly.</para>
     112
     113</sect2>
     114
     115<sect2>
     116<title>Configuring <application>Postgre<acronym>SQL</acronym></application></title>
     117
     118<sect3>
     119<title>Config files</title>
     120
     121<para><filename>$PGDATA/pg_ident.con</filename>, <filename>$PGDATA/pg_hba.conf</filename>, <filename>$PGDATA/postgresql.conf</filename></para>
     122
     123<para>The <envar>PGDATA</envar> environment variable is used to distinguish database
     124clusters from one another by setting it to the value of the directory
     125which contains the cluster desired. The three configuration files
     126exist in every <filename class="directory">PGDATA/</filename> directory.
     127Details on the format of the files and the options that can be set in
     128each can be found in <ulink
     129url="file:///usr/share/doc/postgresql/html/index.html"/>.</para>
     130
     131<para>Install the <filename>/etc/rc.d/init.d/postgresql</filename>
     132init script included in the <xref linkend="intro-important-bootscripts"/> package.</para>
     133                                                                                                               
     134<screen><userinput><command>make install-postgresql</command></userinput></screen>
     135
     136</sect3>
     137
     138</sect2>
     139
     140<sect2>
     141<title>Contents</title>
     142
     143<para>The <application>Postgre<acronym>SQL</acronym></application> package contains
     144<command>clusterdb</command>,
     145<command>createdb</command>,
     146<command>createlang</command>,
     147<command>createuser</command>,
     148<command>dropdb</command>,
     149<command>droplang</command>,
     150<command>dropuser</command>,
     151<command>ecpg</command>,
     152<command>initdb</command>,
     153<command>initlocation</command>,
     154<command>ipcclean</command>,
     155<command>pg_config</command>,
     156<command>pg_controldata</command>,
     157<command>pg_ctl</command>,
     158<command>pg_dump</command>,
     159<command>pg_dumpall</command>,
     160<command>pg_encoding</command>,
     161<command>pg_id</command>,
     162<command>pg_resetxlog</command>,
     163<command>pg_restore</command>,
     164<command>pgtclsh</command>,
     165<command>pgtksh</command>,
     166<command>pltcl_delmod</command>,
     167<command>pltcl_listmod</command>,
     168<command>pltcl_loadmod</command>,
     169<command>postgres</command>,
     170<command>postmaster</command>,
     171<command>psql</command>,
     172<command>vacuumdb</command>,
     173<filename class="libraryfile">libecpg</filename>,
     174<filename class="libraryfile">libpgtcl</filename>,
     175<filename class="libraryfile">libpgtypes</filename>,
     176<filename class="libraryfile">libpq</filename> and various charset
     177modules.</para>
     178
     179</sect2>
     180
     181<sect2><title>Description</title>
     182
     183<sect3><title>clusterdb</title>
     184<para><command>clusterdb</command> is a utility for reclustering tables
     185in a <application>Postgre<acronym>SQL</acronym></application>
     186database.</para></sect3>
     187
     188<sect3><title>createdb</title>
     189<para><command>createdb</command> creates a new
     190<application>Postgre<acronym>SQL</acronym></application> database.</para></sect3>
     191
     192<sect3><title>createlang</title>
     193<para><command>createlang</command> defines a new
     194<application>Postgre<acronym>SQL</acronym></application> procedural
     195language.</para></sect3>
     196
     197<sect3><title>createuser</title>
     198<para><command>createuser</command> defines a new
     199<application>Postgre<acronym>SQL</acronym></application> user account.</para></sect3>
     200
     201<sect3><title>dropdb</title>
     202<para><command>dropdb</command> removes a
     203<application>Postgre<acronym>SQL</acronym></application> database.</para></sect3>
     204
     205<sect3><title>droplang</title>
     206<para><command>droplang</command> removes a
     207<application>Postgre<acronym>SQL</acronym></application> procedural
     208language.</para></sect3>
     209
     210<sect3><title>dropuser</title>
     211<para><command>dropuser</command> removes a
     212<application>Postgre<acronym>SQL</acronym></application> user account.</para></sect3>
     213
     214<sect3><title>ecpg</title>
     215<para><command>ecpg</command> is the embedded <acronym>SQL</acronym> preprocessor.</para></sect3>
     216
     217<sect3><title>initdb</title>
     218<para><command>initdb</command> create a new database cluster.</para></sect3>
     219
     220<sect3><title>initlocation</title>
     221<para><command>initlocation</command> creates a secondary database storage
     222area.</para></sect3>
     223
     224<sect3><title>ipcclean</title>
     225<para><command>ipcclean</command> removes shared memory and semaphores left over by an
     226aborted database server.</para></sect3>
     227
     228<sect3><title>pg_config</title>
     229<para><command>pg_config</command> retrieves
     230<application>Postgre<acronym>SQL</acronym></application> version
     231information.</para></sect3>
     232
     233<sect3><title>pg_controldata</title>
     234<para><command>pg_controldata</command> returns information initialized during
     235<command>initdb</command>, such as the catalog version and server
     236locale.</para></sect3>
     237
     238<sect3><title>pg_ctl</title>
     239<para><command>pg_ctl</command> controls stopping and starting the database
     240server.</para></sect3>
     241
     242<sect3><title>pg_dump</title>
     243<para><command>pg_dump</command> dumps database data and metadata into scripts which are
     244used to recreate the database.</para></sect3>
     245
     246<sect3><title>pg_dumpall</title>
     247<para><command>pg_dumpall</command> recursively calls
     248<command>pg_dump</command> for each database in a
     249cluster.</para></sect3>
     250
     251<sect3><title>pg_resetxlog</title>
     252<para><command>pg_resetxlog</command> clears the write-ahead log and optionally resets some
     253fields in the <filename>pg_control</filename> file.</para></sect3>
     254
     255<sect3><title>pg_restore</title>
     256<para><command>pg_restore</command> creates databases from dump files created by
     257<command>pg_dump</command>.</para></sect3>
     258
     259<sect3><title>pgtclsh</title>
     260<para><command>pgtclsh</command> is a <application>Tcl</application>
     261shell interface extended with
     262<application>Postgre<acronym>SQL</acronym></application> database access
     263functions.</para></sect3>
     264
     265<sect3><title>pgtksh</title>
     266<para><command>pgtksh</command> is a
     267<application>Tcl</application>/<application>Tk</application> shell
     268interface extended with
     269<application>Postgre<acronym>SQL</acronym></application> database access
     270functions.</para></sect3>
     271
     272<sect3><title>postgres</title>
     273<para><command>postgres</command> is a single user database server, generally used for
     274debugging.</para></sect3>
     275
     276<sect3><title>postmaster</title>
     277<para><command>postmaster</command> is the multi-user database daemon.</para></sect3>
     278
     279<sect3><title>psql</title>
     280<para><command>psql</command> is a console based database shell.</para></sect3>
     281
     282<sect3><title>vacuumdb</title>
     283<para><command>vacuumdb</command> compacts databases and generates statistics for the
     284query analyzer.</para></sect3>
     285
     286</sect2>
    10287
    11288</sect1>
  • 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>
  • general.ent

    rd3edf27 r08254fc  
    2222<!-- Part II -->
    2323<!-- Chapter 4 -->
    24 <!ENTITY cracklib-version    "2.7">   
    25 <!ENTITY Linux_PAM-version   "0.77"> 
    26 <!ENTITY shadow-version      "4.0.4.1"> 
    27 <!ENTITY iptables-version    "1.2.9">
    28 <!ENTITY gnupg-version       "1.2.4"> 
    29 <!ENTITY tripwire-version    "2.3.1-2">   
    30 <!ENTITY heimdal-version     "0.6.2">   
    31 <!ENTITY mitkrb-version      "1.3.3">
    32                            
    33                            
    34 <!-- Chapter 5 -->         
    35 <!ENTITY reiser-version      "3.6.14">
    36 <!ENTITY xfsprogs-version    "2.6.13">
    37                            
    38 <!-- Chapter 6 -->         
    39 <!ENTITY vim-version         "6.2"> 
    40 <!ENTITY emacs-version       "21.3"> 
    41 <!ENTITY nano-version        "1.2.3"> 
    42 <!ENTITY joe-version         "3.0">
    43                            
    44 <!-- Chapter 7 -->         
    45 <!ENTITY ash-version         "0.4.0">
    46 <!ENTITY tcsh-version        "6.13.00"> 
    47 <!ENTITY zsh-version         "4.2.0">       
     24<!ENTITY cracklib-version          "2.7">   
     25<!ENTITY Linux_PAM-version         "0.77"> 
     26<!ENTITY shadow-version            "4.0.4.1"> 
     27<!ENTITY iptables-version          "1.2.9">
     28<!ENTITY gnupg-version             "1.2.4"> 
     29<!ENTITY tripwire-version          "2.3.1-2">   
     30<!ENTITY heimdal-version           "0.6.2">   
     31<!ENTITY mitkrb-version            "1.3.3">
     32                                 
     33                                 
     34<!-- Chapter 5 -->               
     35<!ENTITY reiser-version            "3.6.14">
     36<!ENTITY xfsprogs-version          "2.6.13">
     37                                 
     38<!-- Chapter 6 -->               
     39<!ENTITY vim-version               "6.2"> 
     40<!ENTITY emacs-version             "21.3"> 
     41<!ENTITY nano-version              "1.2.3"> 
     42<!ENTITY joe-version               "3.0">
     43                                 
     44<!-- Chapter 7 -->               
     45<!ENTITY ash-version               "0.4.0">
     46<!ENTITY tcsh-version              "6.13.00"> 
     47<!ENTITY zsh-version               "4.2.0">       
    4848                           
    4949<!-- Part III -->           
     
    128128                           
    129129<!-- Chapter 13 -->         
    130 <!ENTITY ppp-version         "2.4.2">
    131 <!ENTITY wvdial-version      "1.53">
    132                            
    133 <!-- Chapter 14 -->         
    134 <!ENTITY dhcp-version        "3.0pl2">
    135 <!ENTITY dhcpcd-version      "1.3.22-pl4">   
    136                            
    137 <!-- Chapter 15 -->         
    138 <!ENTITY pppoe-version       "3.5">
    139                            
    140 <!-- Chapter 16 -->         
    141 <!ENTITY curl-version        "7.11.2">
    142 <!ENTITY wvstreams-version   "3.70"> 
    143 <!ENTITY gnet-version        "2.0.5">   
    144 <!ENTITY libsoup-version     "1.99.28">
    145                            
    146 <!-- Chapter 17 -->         
    147 <!ENTITY Links-version       "2.1pre14"> 
    148 <!ENTITY lynx-version        "2.8.5">
    149 <!ENTITY w3m-version         "0.4.2">
    150                            
    151 <!-- Chapter 18 -->         
    152 <!ENTITY ncftp-version       "3.1.7">
    153 <!ENTITY openssh-version     "3.8.1p1">
    154 <!ENTITY rsync-version       "2.6.2">
    155 <!ENTITY cvs-version         "1.11.16"> 
    156 <!ENTITY wget-version        "1.9.1"> 
    157 <!ENTITY tcpwrappers-version "7.6"> 
    158 <!ENTITY portmap-version     "5beta">   
    159 <!ENTITY inetutils-version   "1.4.2"> 
    160 <!ENTITY nfs-utils-version   "1.0.6">   
    161 <!ENTITY ncpfs-version       "2.2.4">
    162 <!ENTITY ntp-version         "4.2.0"> 
    163                            
    164 <!-- Chapter 19 -->         
    165 <!ENTITY traceroute-version  "1.4a12">
    166 <!ENTITY nmap-version        "3.50"> 
    167 <!ENTITY whois-version       "4.6.14">
    168 <!ENTITY bind-version        "9.2.3">
    169 
    170 <!-- Chapter 20 -->
    171 <!ENTITY nail-version        "10.7">
    172 <!ENTITY procmail-version    "3.22"> 
    173 <!ENTITY fetchmail-version   "6.2.5"> 
    174 <!ENTITY mutt-version        "1.4.2.1i">
    175 <!ENTITY pine-version        "4.60"> 
    176 <!ENTITY slrn-version        "0.9.8.0">
     130<!ENTITY ppp-version               "2.4.2">
     131<!ENTITY wvdial-version            "1.53">
     132                                 
     133<!-- Chapter 14 -->               
     134<!ENTITY dhcp-version              "3.0pl2">
     135<!ENTITY dhcpcd-version            "1.3.22-pl4">   
     136                                 
     137<!-- Chapter 15 -->               
     138<!ENTITY pppoe-version             "3.5">
     139                                 
     140<!-- Chapter 16 -->               
     141<!ENTITY curl-version              "7.11.2">
     142<!ENTITY wvstreams-version         "3.70"> 
     143<!ENTITY gnet-version              "2.0.5">   
     144<!ENTITY libsoup-version           "1.99.28">
     145                                 
     146<!-- Chapter 17 -->               
     147<!ENTITY Links-version             "2.1pre14"> 
     148<!ENTITY lynx-version              "2.8.5">
     149<!ENTITY w3m-version               "0.4.2">
     150                                 
     151<!-- Chapter 18 -->               
     152<!ENTITY ncftp-version             "3.1.7">
     153<!ENTITY openssh-version           "3.8.1p1">
     154<!ENTITY rsync-version             "2.6.2">
     155<!ENTITY cvs-version               "1.11.16"> 
     156<!ENTITY wget-version              "1.9.1"> 
     157<!ENTITY tcpwrappers-version       "7.6"> 
     158<!ENTITY portmap-version           "5beta">   
     159<!ENTITY inetutils-version         "1.4.2"> 
     160<!ENTITY nfs-utils-version         "1.0.6">   
     161<!ENTITY ncpfs-version             "2.2.4">
     162<!ENTITY ntp-version               "4.2.0"> 
     163                                 
     164<!-- Chapter 19 -->               
     165<!ENTITY traceroute-version        "1.4a12">
     166<!ENTITY nmap-version              "3.50"> 
     167<!ENTITY whois-version             "4.6.14">
     168<!ENTITY bind-version              "9.2.3">
     169                                 
     170<!-- Chapter 20 -->               
     171<!ENTITY nail-version              "10.7">
     172<!ENTITY procmail-version          "3.22"> 
     173<!ENTITY fetchmail-version         "6.2.5"> 
     174<!ENTITY mutt-version              "1.4.2.1i">
     175<!ENTITY pine-version              "4.60"> 
     176<!ENTITY slrn-version              "0.9.8.0">
     177                                 
     178<!-- Part VI -->           
     179<!-- Chapter 21 -->
     180
     181
     182<!-- Chapter 22 -->
     183
     184
     185
     186<!-- Part VII -->           
     187<!-- Chapter 23 -->
     188<!ENTITY db-version                "4.2.52.2"> 
     189<!ENTITY db-3.3-version            "3.3.11"> 
     190<!ENTITY mysql-version             "4.0.20">   
     191<!ENTITY postgresql-version        "7.4.2">
     192
     193<!-- Chapter 24 -->
     194<!ENTITY apache-version            "2.0.49"> 
     195<!ENTITY php-version               "4.3.6"> 
     196<!ENTITY proftpd-version           "1.2.9"> 
     197
     198<!--   Part VIII -->           
     199<!-- Chapter 25 -->
     200<!-- Chapter 26 -->
     201
     202
     203
    177204
    178205
  • index.xml

    rd3edf27 r08254fc  
    3434%basicnet; -->
    3535%server;
    36 %content;
     36<!-- %content; -->
    3737%x;
    3838%kde;
     
    6060<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="basicnet/basicnet.xml"/>
    6161&server;
    62 &content;
     62<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="content/content.xml"/>
    6363&x;
    6464&kde;
Note: See TracChangeset for help on using the changeset viewer.