source: server/other/dhcp.xml@ ff769b8c

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

<!ENTITY dhcp-download-http "http://gd.tuwien.ac.at/infosys/servers/isc/dhcp/dhcp-&dhcp-version;.tar.gz">
<!ENTITY dhcp-download-ftp "ftp://ftp.isc.org/isc/dhcp/dhcp-&dhcp-version;.tar.gz">
<!ENTITY dhcp-md5sum "04800a111521e7442749b2ce883f962b">
<!ENTITY dhcp-size "834 KB">
<!ENTITY dhcp-buildsize "29.7 MB">
<!ENTITY dhcp-time "0.22 SBU">
]>

<sect1 id="dhcp" xreflabel="DHCP-&dhcp-version;">
<sect1info>
  <othername>$LastChangedBy$</othername>
  <date>$Date$</date>
</sect1info>
<?dbhtml filename="dhcp.html"?>
<title><acronym>DHCP</acronym>-&dhcp-version;</title>

<indexterm zone="dhcp">
  <primary sortas="a-dhcp">Dhcp</primary>
</indexterm>

<sect2>
<title>Introduction to 
<application><acronym>DHCP</acronym></application></title>

<para>The <application><acronym>DHCP</acronym></application> package contains 
both the client and server programs for <acronym>DHCP</acronym>.
<command>dhclient</command> (the client) is useful for connecting your computer 
to a network which uses <acronym>DHCP</acronym> to assign network addresses. 
<command>dhcpd</command> (the server) is useful for assigning network addresses 
on your private network.</para>

<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
  <listitem><para>Download (HTTP): <ulink url="&dhcp-download-http;"/></para></listitem>
  <listitem><para>Download (FTP): <ulink url="&dhcp-download-ftp;"/></para></listitem>
  <listitem><para>Download MD5 sum: &dhcp-md5sum;</para></listitem>
  <listitem><para>Download size: &dhcp-size;</para></listitem>
  <listitem><para>Estimated disk space required: &dhcp-buildsize;</para></listitem>
  <listitem><para>Estimated build time: &dhcp-time;</para></listitem>
</itemizedlist>
</sect3>

<sect3>
  <title><application>dhcp</application> dependencies</title>

<sect4>
  <title>Required</title>
  <para><xref linkend="net-tools"/> (you may omit <application>net-tools</application> 
         by using the following patch to utilize <application>iproute2</application>: 
         <ulink url="&patch-root;/dhcp-&dhcp-version;-iproute2-2.patch"/>)
  </para>
</sect4>
</sect3>

</sect2>

<sect2 id='dhcp-kernel'>
<title>Installation of 
<application><acronym>DHCP</acronym></application></title>

<note><para>You must have Packet Socket support (Device Drivers -&gt; 
Networking Support -&gt; Networking Options -&gt; Packet Socket) compiled into 
the kernel.</para></note>

<indexterm zone="dhcp dhcp-kernel">
  <primary sortas="d-dhcp">DHCP</primary>
</indexterm>

<para>Install <application><acronym>DHCP</acronym></application> by running 
the following commands:</para>

<screen><userinput><command>patch -Np1 -i ../dhcp-&dhcp-version;-iproute2-2.patch &amp;&amp;
./configure &amp;&amp;
make</command></userinput></screen>

<para>Now, as the root user:</para>
 
<screen><userinput role='root'><command>make LIBDIR=/usr/lib INCDIR=/usr/include install</command></userinput></screen>

</sect2>

<sect2>
<title>Command explanations</title>

<para><parameter>LIBDIR=/usr/lib INCDIR=/usr/include</parameter>: This
command installs the library and include files in 
<filename class="directory">/usr</filename> instead of 
<filename class="directory">/usr/local</filename>.</para>

</sect2>

<sect2 id='dhcp-config'>
<title>Configuring <application><acronym>DHCP</acronym></application></title>

 <indexterm zone="dhcp dhcp-config">
    <primary sortas="e-etc-dhclient.conf">/etc/dhclient.conf</primary>
 </indexterm>

 <indexterm zone="dhcp dhcp-config">
    <primary sortas="e-etc-dhcpd.conf">/etc/dhcpd.conf</primary>
 </indexterm>


<sect3>
<title>Config files</title>
<para><filename>/etc/dhclient.conf</filename></para>
</sect3>

<sect3 id='dhcp-init'>
<title>Configuration Information</title>

<para>Information on configuring the <acronym>DHCP</acronym> client can be 
found in <xref linkend="connect-dhcp"/>.</para>

<para>Note that you only need the <acronym>DHCP</acronym> server if 
you want to issue <acronym>LAN</acronym> addresses over your network.  The 
<acronym>DHCP</acronym> client doesn't need this script to be used.  Also note 
that this script is coded for the <emphasis role="strong">eth1</emphasis> 
interface, which may need to be modified for your hardware configuration.</para>

<para>Install the <filename>/etc/rc.d/init.d/dhcp</filename>
init script included in the <xref linkend="intro-important-bootscripts"/> 
package.</para>

 <indexterm zone="dhcp dhcp-init">
    <primary sortas="f-dhcp">dhcpd</primary>
 </indexterm>

<screen><userinput><command>make install-dhcp</command></userinput></screen>

<para>The lease file must exist on startup.  The following command will
satisfy that requirement:</para>

<screen><userinput><command>touch /var/state/dhcp/dhcpd.leases</command></userinput></screen>

<para>The following commands will create a base configuration file for a
<acronym>DHCP</acronym> server.  There are several options that you may want to
add (information that is passed back to the <acronym>DHCP</acronym> client) and 
those are covered in the man pages for <filename>dhcp.conf</filename>.</para>

<screen><userinput><command>cat &gt; /etc/dhcpd.conf &lt;&lt; "EOF"</command>
default-lease-time 72000;
max-lease-time 144000;
ddns-update-style ad-hoc;

subnet <replaceable>[192.168.5.0]</replaceable> netmask <replaceable>[255.255.255.0]</replaceable> {
  range <replaceable>[192.168.5.10] [192.168.5.240]</replaceable>;
  option broadcast-address <replaceable>[192.168.5.255]</replaceable>;
  option routers <replaceable>[192.168.5.1]</replaceable>;
}
<command>EOF</command></userinput></screen>

<para>All addresses should be changed to meet your circumstance.</para>

</sect3>

</sect2>

<sect2>
<title>Contents</title>

<segmentedlist>
  <segtitle>Installed Programs</segtitle>
  <segtitle>Installed Libraries</segtitle>
  <segtitle>Installed Directories</segtitle>
 
  <seglistitem>
    <seg>dhcpd, dhcrelay, dhclient, dhclient-script, omshell</seg>
    <seg>bdhcpctl.a, libomapi.a</seg>
    <seg>/var/state/dhcp, /usr/include/omapip, /usr/include/isi-dhcp</seg>
  </seglistitem>
</segmentedlist>
 
<variablelist>
  <bridgehead renderas="sect3">Short Descriptions</bridgehead>
  <?dbfo list-presentation="list"?>

<varlistentry id="dhclient">
  <term><command>dhclient</command></term>
  <listitem>
    <para>is the implementation of the <acronym>DHCP</acronym> client.</para>
    <indexterm zone="dhcp dhclient">
      <primary sortas="b-dhclient">dhclient</primary>
    </indexterm>
  </listitem>
</varlistentry>

<varlistentry id="dhcpd">
  <term><command>dhcpd</command></term>
  <listitem>
    <para>implements Dynamic Host Configuration Protocol (<acronym>DHCP</acronym>) 
          and Internet Bootstrap Protocol (<acronym>BOOTP</acronym>) requests for 
          network addresses.</para>
    <indexterm zone="dhcp dhcpd">
      <primary sortas="b-dhcpd">dhcpd</primary>
    </indexterm>
  </listitem>
</varlistentry>

<varlistentry id="dhcrelay">
  <term><command>dhcrelay</command></term>
  <listitem>
    <para>provides a means to accept <acronym>DHCP</acronym> and <acronym>BOOTP</acronym> 
          requests on a subnet without a <acronym>DHCP</acronym> server and relay them to 
          a <acronym>DHCP</acronym> server on another subnet.</para>
    <indexterm zone="dhcp dhcrelay">
      <primary sortas="b-dhcrelay">dhcrelay</primary>
    </indexterm>
  </listitem>
</varlistentry>

<varlistentry id="omshell">
  <term><command>omshell</command></term>
  <listitem>
    <para> provides an interactive way to connect to, query, and possibly change, 
           the ISC DHCP Server's state via OMAPI, the Object Management API.</para>
    <indexterm zone="dhcp omshell">
      <primary sortas="b-omshell">omshell</primary>
    </indexterm>
  </listitem>
</varlistentry>

</variablelist> 
</sect2>
</sect1>