Tagged dhcp.xml

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@4357 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Manuel Canales Esparcia 2005-05-18 19:16:15 +00:00
parent 59bfedf5e4
commit 6ad98e1299

View File

@ -4,148 +4,161 @@
<!ENTITY % general-entities SYSTEM "../../general.ent"> <!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities; %general-entities;
<!ENTITY dhcp-download-http "http://gd.tuwien.ac.at/infosys/servers/isc/dhcp/dhcp-&dhcp-version;.tar.gz"> <!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-download-ftp "ftp://ftp.isc.org/isc/dhcp/dhcp-&dhcp-version;.tar.gz">
<!ENTITY dhcp-md5sum "04800a111521e7442749b2ce883f962b"> <!ENTITY dhcp-md5sum "04800a111521e7442749b2ce883f962b">
<!ENTITY dhcp-size "834 KB"> <!ENTITY dhcp-size "834 KB">
<!ENTITY dhcp-buildsize "29.7 MB"> <!ENTITY dhcp-buildsize "29.7 MB">
<!ENTITY dhcp-time "0.22 SBU"> <!ENTITY dhcp-time "0.22 SBU">
]> ]>
<sect1 id="dhcp" xreflabel="DHCP-&dhcp-version;"> <sect1 id="dhcp" xreflabel="DHCP-&dhcp-version;">
<sect1info> <?dbhtml filename="dhcp.html"?>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="dhcp.html"?>
<title><acronym>DHCP</acronym>-&dhcp-version;</title>
<indexterm zone="dhcp"> <sect1info>
<primary sortas="a-dhcp">Dhcp</primary> <othername>$LastChangedBy$</othername>
</indexterm> <date>$Date$</date>
</sect1info>
<sect2> <title>DHCP-&dhcp-version;</title>
<title>Introduction to
<application><acronym>DHCP</acronym></application></title>
<para>The <application><acronym>DHCP</acronym></application> package contains <indexterm zone="dhcp">
both the client and server programs for <acronym>DHCP</acronym>. <primary sortas="a-dhcp">Dhcp</primary>
<command>dhclient</command> (the client) is useful for connecting your computer </indexterm>
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> <sect2 role="package">
<itemizedlist spacing='compact'> <title>Introduction to DHCP</title>
<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> <para>The <application>DHCP</application> package contains both the client
<title><application>dhcp</application> dependencies</title> and server programs for DHCP. <command>dhclient</command> (the client) is
useful for connecting your computer to a network which uses DHCP to assign
network addresses. <command>dhcpd</command> (the server) is useful for
assigning network addresses on your private network.</para>
<sect4> <bridgehead renderas="sect3">Package Information</bridgehead>
<title>Required</title> <itemizedlist spacing="compact">
<para><xref linkend="net-tools"/> (you may omit <application>net-tools</application> <listitem>
by using the following patch to utilize <application>iproute2</application>: <para>Download (HTTP): <ulink url="&dhcp-download-http;"/></para>
<ulink url="&patch-root;/dhcp-&dhcp-version;-iproute2-2.patch"/>) </listitem>
</para> <listitem>
</sect4> <para>Download (FTP): <ulink url="&dhcp-download-ftp;"/></para>
</sect3> </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>
</sect2> <bridgehead renderas="sect3">DHCP Dependencies</bridgehead>
<sect2 id='dhcp-kernel'> <bridgehead renderas="sect4">Required</bridgehead>
<title>Installation of <para><xref linkend="net-tools"/> (you may omit
<application><acronym>DHCP</acronym></application></title> <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>
<note><para>You must have Packet Socket support (Device Drivers -&gt; </sect2>
Networking Support -&gt; Networking Options -&gt; Packet Socket) compiled into
the kernel.</para></note>
<indexterm zone="dhcp dhcp-kernel"> <sect2 role="kernel" id='dhcp-kernel'>
<primary sortas="d-dhcp">DHCP</primary> <title>Kernel Configuration</title>
</indexterm>
<para>Install <application><acronym>DHCP</acronym></application> by running <para>You must have Packet Socket support (Device Drivers -&gt; Networking
the following commands:</para> Support -&gt; Networking Options -&gt; Packet Socket) compiled into
the kernel.</para>
<screen><userinput><command>patch -Np1 -i ../dhcp-&dhcp-version;-iproute2-2.patch &amp;&amp; <indexterm zone="dhcp dhcp-kernel">
<primary sortas="d-dhcp">DHCP</primary>
</indexterm>
</sect2>
<sect2 role="installation">
<title>Installation of DHCP</title>
<para>Install <application>DHCP</application> by running
the following commands:</para>
<screen><userinput>patch -Np1 -i ../dhcp-&dhcp-version;-iproute2-2.patch &amp;&amp;
./configure &amp;&amp; ./configure &amp;&amp;
make</command></userinput></screen> make</userinput></screen>
<para>Now, as the root user:</para> <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen><userinput role='root'><command>make LIBDIR=/usr/lib INCDIR=/usr/include install</command></userinput></screen> <screen role="root"><userinput>make LIBDIR=/usr/lib INCDIR=/usr/include install</userinput></screen>
</sect2> </sect2>
<sect2> <sect2 role="commands">
<title>Command explanations</title> <title>Command Explanations</title>
<para><parameter>LIBDIR=/usr/lib INCDIR=/usr/include</parameter>: This <para><parameter>LIBDIR=/usr/lib INCDIR=/usr/include</parameter>: This
command installs the library and include files in command installs the library and include files in
<filename class="directory">/usr</filename> instead of <filename class="directory">/usr</filename> instead of
<filename class="directory">/usr/local</filename>.</para> <filename class="directory">/usr/local</filename>.</para>
</sect2> </sect2>
<sect2 id='dhcp-config'> <sect2 role="configuration">
<title>Configuring <application><acronym>DHCP</acronym></application></title> <title>Configuring DHCP</title>
<indexterm zone="dhcp dhcp-config"> <sect3 id='dhcp-config'>
<primary sortas="e-etc-dhclient.conf">/etc/dhclient.conf</primary> <title>Config Files</title>
</indexterm>
<indexterm zone="dhcp dhcp-config"> <para><filename>/etc/dhclient.conf</filename> and
<primary sortas="e-etc-dhcpd.conf">/etc/dhcpd.conf</primary> <filename>/etc/dhcpd.conf</filename></para>
</indexterm>
<indexterm zone="dhcp dhcp-config">
<primary sortas="e-etc-dhclient.conf">/etc/dhclient.conf</primary>
</indexterm>
<sect3> <indexterm zone="dhcp dhcp-config">
<title>Config files</title> <primary sortas="e-etc-dhcpd.conf">/etc/dhcpd.conf</primary>
<para><filename>/etc/dhclient.conf</filename></para> </indexterm>
</sect3>
<sect3 id='dhcp-init'> </sect3>
<title>Configuration Information</title>
<para>Information on configuring the <acronym>DHCP</acronym> client can be <sect3 id='dhcp-init'>
found in <xref linkend="connect-dhcp"/>.</para> <title>Configuration Information</title>
<para>Note that you only need the <acronym>DHCP</acronym> server if <para>Information on configuring the DHCP client can be
you want to issue <acronym>LAN</acronym> addresses over your network. The found in <xref linkend="connect-dhcp"/>.</para>
<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> <para>Note that you only need the DHCP server if you want to issue
init script included in the <xref linkend="intro-important-bootscripts"/> LAN addresses over your network. The DHCP client doesn't need this
package.</para> 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>
<indexterm zone="dhcp dhcp-init"> <para>Install the <filename>/etc/rc.d/init.d/dhcp</filename>
<primary sortas="f-dhcp">dhcpd</primary> init script included in the <xref linkend="intro-important-bootscripts"/>
</indexterm> package.</para>
<screen><userinput><command>make install-dhcp</command></userinput></screen> <indexterm zone="dhcp dhcp-init">
<primary sortas="f-dhcp">dhcpd</primary>
</indexterm>
<para>The lease file must exist on startup. The following command will <screen role="root"><userinput>make install-dhcp</userinput></screen>
satisfy that requirement:</para>
<screen><userinput><command>touch /var/state/dhcp/dhcpd.leases</command></userinput></screen> <para>The lease file must exist on startup. The following command will
satisfy that requirement:</para>
<para>The following commands will create a base configuration file for a <screen role="root"><userinput>touch /var/state/dhcp/dhcpd.leases</userinput></screen>
<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> <para>The following commands will create a base configuration file
default-lease-time 72000; for a DHCP server. There are several options that you may want to
add (information that is passed back to the DHCP client) and those
are covered in the man pages for <filename>dhcp.conf</filename>.</para>
<screen role="root"><userinput>cat &gt; /etc/dhcpd.conf &lt;&lt; "EOF"
<literal>default-lease-time 72000;
max-lease-time 144000; max-lease-time 144000;
ddns-update-style ad-hoc; ddns-update-style ad-hoc;
@ -153,80 +166,83 @@ subnet <replaceable>[192.168.5.0]</replaceable> netmask <replaceable>[255.255.25
range <replaceable>[192.168.5.10] [192.168.5.240]</replaceable>; range <replaceable>[192.168.5.10] [192.168.5.240]</replaceable>;
option broadcast-address <replaceable>[192.168.5.255]</replaceable>; option broadcast-address <replaceable>[192.168.5.255]</replaceable>;
option routers <replaceable>[192.168.5.1]</replaceable>; option routers <replaceable>[192.168.5.1]</replaceable>;
} }</literal>
<command>EOF</command></userinput></screen> EOF</userinput></screen>
<para>All addresses should be changed to meet your circumstance.</para> <para>All addresses should be changed to meet your circumstance.</para>
</sect3> </sect3>
</sect2> </sect2>
<sect2> <sect2 role="content">
<title>Contents</title> <title>Contents</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed Programs</segtitle> <segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle> <segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle> <segtitle>Installed Directories</segtitle>
<seglistitem> <seglistitem>
<seg>dhcpd, dhcrelay, dhclient, dhclient-script, omshell</seg> <seg>dhcpd, dhcrelay, dhclient, dhclient-script, and omshell</seg>
<seg>bdhcpctl.a, libomapi.a</seg> <seg>bdhcpctl.a, libomapi.a</seg>
<seg>/var/state/dhcp, /usr/include/omapip, /usr/include/isi-dhcp</seg> <seg>/var/state/dhcp, /usr/include/omapip, and /usr/include/isi-dhcp</seg>
</seglistitem> </seglistitem>
</segmentedlist> </segmentedlist>
<variablelist> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead> <bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="dhclient"> <varlistentry id="dhclient">
<term><command>dhclient</command></term> <term><command>dhclient</command></term>
<listitem> <listitem>
<para>is the implementation of the <acronym>DHCP</acronym> client.</para> <para>is the implementation of the DHCP client.</para>
<indexterm zone="dhcp dhclient"> <indexterm zone="dhcp dhclient">
<primary sortas="b-dhclient">dhclient</primary> <primary sortas="b-dhclient">dhclient</primary>
</indexterm> </indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="dhcpd"> <varlistentry id="dhcpd">
<term><command>dhcpd</command></term> <term><command>dhcpd</command></term>
<listitem> <listitem>
<para>implements Dynamic Host Configuration Protocol (<acronym>DHCP</acronym>) <para>implements Dynamic Host Configuration Protocol (DHCP) and
and Internet Bootstrap Protocol (<acronym>BOOTP</acronym>) requests for Internet Bootstrap Protocol (BOOTP) requests for network
network addresses.</para> addresses.</para>
<indexterm zone="dhcp dhcpd"> <indexterm zone="dhcp dhcpd">
<primary sortas="b-dhcpd">dhcpd</primary> <primary sortas="b-dhcpd">dhcpd</primary>
</indexterm> </indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="dhcrelay"> <varlistentry id="dhcrelay">
<term><command>dhcrelay</command></term> <term><command>dhcrelay</command></term>
<listitem> <listitem>
<para>provides a means to accept <acronym>DHCP</acronym> and <acronym>BOOTP</acronym> <para>provides a means to accept DHCP and BOOTP requests on a subnet
requests on a subnet without a <acronym>DHCP</acronym> server and relay them to without a DHCP server and relay them to a DHCP server on another
a <acronym>DHCP</acronym> server on another subnet.</para> subnet.</para>
<indexterm zone="dhcp dhcrelay"> <indexterm zone="dhcp dhcrelay">
<primary sortas="b-dhcrelay">dhcrelay</primary> <primary sortas="b-dhcrelay">dhcrelay</primary>
</indexterm> </indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="omshell"> <varlistentry id="omshell">
<term><command>omshell</command></term> <term><command>omshell</command></term>
<listitem> <listitem>
<para> provides an interactive way to connect to, query, and possibly change, <para> provides an interactive way to connect to, query, and
the ISC DHCP Server's state via OMAPI, the Object Management API.</para> possibly change, the ISC DHCP Server's state via OMAPI, the
<indexterm zone="dhcp omshell"> Object Management API.</para>
<primary sortas="b-omshell">omshell</primary> <indexterm zone="dhcp omshell">
</indexterm> <primary sortas="b-omshell">omshell</primary>
</listitem> </indexterm>
</varlistentry> </listitem>
</varlistentry>
</variablelist>
</sect2>
</variablelist>
</sect2>
</sect1> </sect1>