Changeset 697cb83f


Ignore:
Timestamp:
08/14/2012 10:00:47 PM (11 years ago)
Author:
Krejzi <krejzi@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 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, ken/inkscape-core-mods, krejzi/svn, lazarus, nosym, perl-modules, plabs/python-mods, qt5new, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/soup3, xry111/test-20220226
Children:
e3fec8f
Parents:
17ef733
Message:

ISC DHCP 4.2.4-P1 with bootscript and network service updates. Merged dhcp client configuration into dhcp page.

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

Files:
5 edited
1 moved

Legend:

Unmodified
Added
Removed

  • archive/dhcp-client.xml

    r17ef733 r697cb83f  
    3636    <title>Configuring DHCP Client</title>
    3737
    38       <para id="dhclient-service">To configure <command>dhclient</command>,
     38      <para id="dhclient-service1010">To configure <command>dhclient</command>,
    3939      you need to first install the network service script,
    4040      <filename>/lib/services/dhclient</filename>
    … …  
    4242      (as <systemitem class="username">root</systemitem>):</para>
    4343
    44       <indexterm zone="dhcp-client dhclient-service">
     44      <indexterm zone="dhcp-client dhclient-service1010">
    4545        <primary sortas="f-dhclient">dhclient (service script)</primary>
    4646      </indexterm>

  • general.ent

    r17ef733 r697cb83f  
    548548<!ENTITY ppp-version                  "2.4.5">
    549549<!ENTITY dhcpcd-version               "5.6.1">
    550 <!ENTITY dhcp-version                 "4.2.3-P2">
     550<!ENTITY dhcp-version                 "4.2.4-P1">
    551551
    552552<!-- Obsolete

  • introduction/welcome/changelog.xml

    r17ef733 r697cb83f  
    5656        </listitem>
    5757        <listitem>
     58          <para>[krejzi] - Changed dhclient network script to be compatible
     59          with the latest book instructions.</para>
     60        </listitem>
     61        <listitem>
    5862          <para>[krejzi] - Added mtdev 1.1.2, a required dependency
    5963          of the Xorg Synaptics Driver.</para>
    … …  
    6266          <para>[krejzi] - Added patch for Iptables to fix
    6367          compiling with Linux Kernel 3.5.</para>
     68        </listitem>
     69        <listitem>
     70          <para>[krejzi] - Merged dhcp client configuration into
     71          dhcp page.</para>
    6472        </listitem>
    6573        <listitem>
    … …  
    7482        </listitem>
    7583        <listitem>
     84          <para>[krejzi] - Renamed dhcp bootscript to dhcpd and
     85          made it configurable through /etc/sysconfig/dhcpd.</para>
     86        </listitem>
     87        <listitem>
    7688          <para>[krejzi] - Renamed kerberos bootscript to krb5 and
    7789          made it start kpropd, too. </para>
    … …  
    8294        <listitem>
    8395          <para>[krejzi] - Bumped bootscripts to 20120814.</para>
     96        </listitem>
     97        <listitem>
     98          <para>[krejzi] - DHCP 4.2.4-P1.</para>
    8499        </listitem>
    85100        <listitem>

  • networking/connect/connect.xml

    r17ef733 r697cb83f  
    3535  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dhcpcd.xml"/>
    3636  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dhcp.xml"/>
    37   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dhcp-client.xml"/>
    3837
    3938</chapter>

  • networking/connect/dhcp.xml

    r17ef733 r697cb83f  
    44  <!ENTITY % general-entities SYSTEM "../../general.ent">
    55  %general-entities;
    6   <!-- isc have a weird way of offering the tarballs and without dots in version!
    7     FIXME - change hardcoded 423s in http url and version in ftp when upgrading -->
     6
    87  <!ENTITY dhcp-download-http " ">
    9   <!ENTITY dhcp-download-ftp "ftp://ftp.isc.org/isc/dhcp/&dhcp-version;/dhcp-&dhcp-version;.tar.gz">
    10   <!ENTITY dhcp-md5sum "14f57fd580d01633d0fad4809007a801">
    11   <!ENTITY dhcp-size "9.1 MB">
    12   <!ENTITY dhcp-buildsize "192 MB (client and server), 140MB client only, 172MB server only">
    13   <!ENTITY dhcp-time "0.7 SBU (client and server, or server), 0.6 SBU client only ">
     8  <!ENTITY dhcp-download-ftp  "ftp://ftp.isc.org/isc/dhcp/&dhcp-version;/dhcp-&dhcp-version;.tar.gz">
     9  <!ENTITY dhcp-md5sum        "0ca7181024651f6323951d5498c8020b">
     10  <!ENTITY dhcp-size          "7.9 MB">
     11  <!ENTITY dhcp-buildsize     "150 MB">
     12  <!ENTITY dhcp-time          "1.2 SBU">
    1413]>
    1514
    … …  
    2524
    2625  <indexterm zone="dhcp">
    27     <primary sortas="a-dhcp">Dhcp</primary>
     26    <primary sortas="a-DHCP">DHCP</primary>
    2827  </indexterm>
    2928
    3029  <sect2 role="package">
    31     <title>Introduction to DHCP</title>
    32 
    33     <para>The <application>DHCP</application> package contains both the client
    34     and server programs for DHCP. <command>dhclient</command> (the client) is
    35     useful for connecting your computer to a network which uses DHCP to assign
    36     network addresses. <command>dhcpd</command> (the server) is useful for
    37     assigning network addresses on your private network.</para>
    38 
    39     &lfs70_checked;
     30    <title>Introduction to ISC DHCP</title>
     31
     32    <para>
     33      The <application>ISC DHCP</application> package contains both the client and
     34      server programs for DHCP. <command>dhclient</command> (the client) is
     35      used for connecting to a network which uses DHCP to assign network
     36      addresses. <command>dhcpd</command> (the server) is used for assigning
     37      network addresses on private networks.
     38    </para>
     39
     40    &lfs71_checked;
    4041
    4142    <bridgehead renderas="sect3">Package Information</bridgehead>
    4243    <itemizedlist spacing="compact">
    4344      <listitem>
    44         <para>Download (HTTP): <ulink url="&dhcp-download-http;"/></para>
    45       </listitem>
    46       <listitem>
    47         <para>Download (FTP): <ulink url="&dhcp-download-ftp;"/></para>
    48       </listitem>
    49       <listitem>
    50         <para>Download MD5 sum: &dhcp-md5sum;</para>
    51       </listitem>
    52       <listitem>
    53         <para>Download size: &dhcp-size;</para>
    54       </listitem>
    55       <listitem>
    56         <para>Estimated disk space required: &dhcp-buildsize;</para>
    57       </listitem>
    58       <listitem>
    59         <para>Estimated build time: &dhcp-time;</para>
     45        <para>
     46          Download (HTTP): <ulink url="&dhcp-download-http;"/>
     47        </para>
     48      </listitem>
     49      <listitem>
     50        <para>
     51          Download (FTP): <ulink url="&dhcp-download-ftp;"/>
     52        </para>
     53      </listitem>
     54      <listitem>
     55        <para>
     56          Download MD5 sum: &dhcp-md5sum;
     57        </para>
     58      </listitem>
     59      <listitem>
     60        <para>
     61          Download size: &dhcp-size;
     62        </para>
     63      </listitem>
     64      <listitem>
     65        <para>
     66          Estimated disk space required: &dhcp-buildsize;
     67        </para>
     68      </listitem>
     69      <listitem>
     70        <para>
     71          Estimated build time: &dhcp-time;
     72        </para>
    6073      </listitem>
    6174    </itemizedlist>
    6275
    6376    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    64     <itemizedlist spacing='compact'>
    65       <listitem>
    66         <para>Recommended Patch (for client):
    67         <ulink url="&patch-root;/dhcp-&dhcp-version;-iproute2-1.patch"/></para>
    68       </listitem>
    69       <listitem>
    70         <para>Optional Patch:
    71         <ulink url="&patch-root;/dhcp-&dhcp-version;-missing_ipv6-1.patch"/></para>
     77    <itemizedlist spacing="compact">
     78      <listitem>
     79        <para>
     80          Required Patch:
     81          <ulink url="&patch-root;/dhcp-&dhcp-version;-client-script-1.patch"/>
     82        </para>
     83      </listitem>
     84      <listitem>
     85        <para>
     86          Optional Patch:
     87          <ulink url="&patch-root;/dhcp-&dhcp-version;-missing_ipv6-1.patch"/>
     88        </para>
    7289      </listitem>
    7390    </itemizedlist>
    7491
    75     <bridgehead renderas="sect3">DHCP Dependencies</bridgehead>
    76 
    77     <bridgehead renderas="sect4">Required</bridgehead>
    78     <para role="required"><xref linkend="net-tools"/> is required at runtime
    79     by <command>dhclient</command> if you do not use the iproute2 patch.</para>
    80 
    8192    <para condition="html" role="usernotes">User Notes:
    82     <ulink url="&blfs-wiki;/dhcp"/></para>
    83 
     93      <ulink url="&blfs-wiki;/dhcp"/>
     94    </para>
    8495  </sect2>
    8596
    86   <sect2 role="kernel" id='dhcp-kernel'>
     97  <sect2 role="kernel" id="dhcp-kernel">
    8798    <title>Kernel Configuration</title>
    8899
    89     <para>You must have Packet Socket support (Networking
    90     Support &rArr; Networking Options &rArr; Packet Socket) compiled into
    91     the kernel.  If you do not have IPv6 support (Networking Support &rArr;
    92     Networking Options &rArr; The IPv6 Protocol) compiled in, then you
    93     must use the missing_ipv6 patch.</para>
     100    <para>
     101      You must have Packet Socket support (Networking Support &rArr;
     102      Networking Options &rArr; Packet Socket) compiled into the kernel.
     103      If you do not have IPv6 support (Networking Support &rArr;
     104      Networking Options &rArr; The IPv6 Protocol) compiled in, then you
     105      must use the missing_ipv6 patch.
     106    </para>
    94107
    95108    <indexterm zone="dhcp dhcp-kernel">
    96       <primary sortas="d-dhcp">DHCP</primary>
     109      <primary sortas="d-DHCP">DHCP</primary>
    97110    </indexterm>
    98111
    … …  
    100113
    101114  <sect2 role="installation">
    102     <title>Installation of DHCP</title>
    103 
    104     <para>If you have not compiled IPv6 support into the kernel, apply the
    105     missing_ipv6 patch</para>
     115    <title>Installation of ISC DHCP</title>
     116
     117    <para>
     118      If you have not compiled IPv6 support into the kernel, apply the
     119      missing_ipv6 patch:
     120    </para>
    106121
    107122<screen><userinput>patch -Np1 -i ../dhcp-&dhcp-version;-missing_ipv6-1.patch</userinput></screen>
    108123
    109     <para>If you are installing the client, apply the iproute2 patch unless you
    110     will have installed <application>net-tools</application> by the time you wish
    111     to use the client:</para>
    112 
    113 <screen><userinput>patch -Np1 -i ../dhcp-&dhcp-version;-iproute2-1.patch</userinput></screen>
    114 
    115     <para>Install <application>DHCP</application> by running
     124    <para>Install <application>ISC DHCP</application> by running
    116125    the following commands:</para>
    117126
    118 <screen><userinput>sed -i 's%\(^sbindir =\).*%\1 @prefix@@sbindir@%' server/Makefile.in &amp;&amp;
    119 ./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var \
    120             --sbindir=/sbin                                      \
    121             --with-srv-lease-file=/var/state/dhcp/dhcpd.leases   \
    122             --with-srv6-lease-file=/var/state/dhcp/dhcpd6.leases \
    123             --with-cli-lease-file=/var/state/dhclient.leases     \
    124             --with-cli6-lease-file=/var/state/dhclient6.leases   &amp;&amp;
    125 sed -i 's/-Werror//' {client,common,dst,omapip,relay,server,tests}/Makefile</userinput></screen>
    126 
    127     <para>If you only wish to build the server, enter:</para>
    128 <screen><userinput>sed -i 's/ client//' Makefile</userinput></screen>
    129 
    130     <para>If you only wish to build the client, enter:</para>
    131 <screen><userinput>sed -i 's/ dhcpctl relay server//' Makefile</userinput></screen>
    132 
    133     <para>Build your chosen variant(s) with:</para>
    134 <screen><userinput>make</userinput></screen>
    135 
    136     <para>To test the results, issue: <command>make check</command></para>
    137 
    138     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
    139 
    140 <screen role="root"><userinput>make install &amp;&amp;
     127<screen><userinput>patch -Np1 -i ../dhcp-&dhcp-version;-client-script-1.patch &amp;&amp;
     128CFLAGS="-D_PATH_DHCLIENT_SCRIPT='\"/sbin/dhclient-script\"'         \
     129        -D_PATH_DHCPD_CONF='\"/etc/dhcp/dhcpd.conf\"'               \
     130        -D_PATH_DHCLIENT_CONF='\"/etc/dhcp/dhclient.conf\"'"        \
     131./configure --prefix=/usr                                           \
     132            --sysconfdir=/etc/dhcp                                  \
     133            --localstatedir=/var                                    \
     134            --with-srv-lease-file=/var/lib/dhcpd/dhcpd.leases       \
     135            --with-srv6-lease-file=/var/lib/dhcpd/dhcpd6.leases     \
     136            --with-cli-lease-file=/var/lib/dhclient/dhclient.leases \
     137            --with-cli6-lease-file=/var/lib/dhclient/dhclient6.leases &amp;&amp;
     138make</userinput></screen>
     139
     140    <para>
     141      To test the results, issue: <command>make check</command>
     142    </para>
     143
     144    <para>
     145      If you only want to install the <application>ISC DHCP</application> client,
     146      issue the following commands as the
     147      <systemitem class="username">root</systemitem> user:
     148    </para>
     149
     150<screen role="root"><userinput>make -C client install         &amp;&amp;
     151mv -v /usr/sbin/dhclient /sbin &amp;&amp;
    141152install -v -m755 client/scripts/linux /sbin/dhclient-script</userinput></screen>
    142153
    143     <para>The supplied <filename>/etc/dhcpd.conf</filename> (server) and
    144     <filename>/etc/dhclient.conf</filename> (client) are examples for a
    145     specific <literal>BSD</literal> system. They are unlikely to be appropriate
    146     to your needs, but you may wish to read them for ideas before deleting them
    147     or moving them to a different location.</para>
    148 
    149     <para>Now create any needed directories for the leases.</para>
    150 
    151     <para>For the server:</para>
    152 
    153 <screen role="root"><userinput>mkdir -pv /var/state/dhcp</userinput></screen>
    154 
    155     <para>For the client:</para>
    156 <screen role="root"><userinput>mkdir -pv /var/state</userinput></screen>
     154    <para>
     155      Skip to <xref linkend="dhclient-config"/> in order to configure the client
     156    </para>
     157
     158    <para>
     159      If you only want to install the <application>ISC DHCP</application> server,
     160      issue the following command as the
     161      <systemitem class="username">root</systemitem> user:
     162    </para>
     163
     164<screen role="root"><userinput>make -C server install</userinput></screen>
     165
     166    <para>
     167      Skip to <xref linkend="dhcpd-config"/> in order to configure the server.
     168    </para>
     169
     170    <para>
     171      Alternatively, you can install whole package which includes the client,
     172      server, relay, static libraries and development headers by running the
     173      following commands as the
     174      <systemitem class="username">root</systemitem> user:
     175    </para>
     176
     177<screen role="root"><userinput>make install                   &amp;&amp;
     178mv -v /usr/sbin/dhclient /sbin &amp;&amp;
     179install -v -m755 client/scripts/linux /sbin/dhclient-script</userinput></screen>
    157180
    158181  </sect2>
    159182
    160   <sect2 role="commands">
    161     <title>Command Explanations</title>
    162 
    163     <para><command>sed -i 's%\(^sbindir =\).*%\1 @prefix@@sbindir@%' server/Makefile.in</command>
    164     This command moves the <command>dhcp</command> program to
    165     <filename class='directory'>/usr/sbin</filename> instead of
    166     <filename class='directory'>/sbin</filename> because it is not needed
    167     while the server is booting.</para>
    168 
    169     <para><command>--sbindir=/sbin</command> The <command>dhclient</command>
    170     program is moved to <filename class='directory'>/sbin</filename> instead of
    171     <filename class='directory'>/usr/sbin</filename> so that it is available
    172     during boot, e.g. if <filename class='directory'>/usr</filename> is to be
    173     an <literal>nfs</literal> mount.</para>
    174 
    175     <para><command>--with-*-lease-files=...</command> By default, lease files
    176     are placed in <filename class='directory'>/var/db</filename> which is an
    177     anachronism.</para>
    178 
    179     <para><command>sed -i 's/-Werror//' {client,common,...}/Makefile</command> -
    180     the Makefiles in this package add <literal>-Werror</literal> to the
    181     <literal>CFLAGS</literal>.  On recent versions of <application>gcc</application>
    182     more things, particularly unused variables, create warnings.  The
    183     <literal>-Werror</literal> flag causes warnings to break the build, so we
    184     remove it where necessary.</para>
    185 
    186     <para><command>sed -i 's/ something//' Makefile</command> - this stops the
    187     build from entering the director(y,ies) named here.</para>
    188 
    189     <para><option>rm -v /usr/lib/lib{dhcpctl,dst,omapi}.a</option> - there is
    190     no easy way to prevent these static libraries being installed, but they are
    191     only needed during the build of this package. <filename>libdhcpctl.a</filename>
    192     is only installed if you build the server.</para>
    193 
    194   </sect2>
    195 
    196183  <sect2 role="configuration">
    197     <title>Configuring DHCP</title>
    198 
    199     <sect3 id='dhcp-config'>
     184    <title>Configuring ISC DHCP</title>
     185
     186    <sect3 id="dhcp-config">
    200187      <title>Config Files</title>
    201188
    202       <para><filename>/etc/dhclient.conf</filename> and
    203       <filename>/etc/dhcpd.conf</filename></para>
     189      <para>
     190        <filename>/etc/dhcp/dhclient.conf</filename> and
     191        <filename>/etc/dhcp/dhcpd.conf</filename>
     192      </para>
    204193
    205194      <indexterm zone="dhcp dhcp-config">
    206         <primary sortas="e-etc-dhclient.conf">/etc/dhclient.conf</primary>
     195        <primary sortas="e-etc-dhcp-dhclient.conf">/etc/dhcp/dhclient.conf</primary>
    207196      </indexterm>
    208197
    209198      <indexterm zone="dhcp dhcp-config">
    210         <primary sortas="e-etc-dhcpd.conf">/etc/dhcpd.conf</primary>
     199        <primary sortas="e-etc-dhcp-dhcpd.conf">/etc/dhcp/dhcpd.conf</primary>
    211200      </indexterm>
    212201
    213202    </sect3>
    214203
    215     <sect3 id='dhcp-init'>
    216       <title>Configuration Information</title>
    217 
    218       <para>Information on configuring the DHCP client can be
    219       found in <xref linkend="basicnet-connect"/>.</para>
    220 
    221       <para>Note that you only need the DHCP server if you want to issue
    222       LAN addresses over your network. The DHCP client doesn't need this
    223       script to be used.  Also note that this script is coded for the
    224       <emphasis role="strong">eth1</emphasis> interface, which may need
    225       to be modified for your hardware configuration.</para>
    226 
    227       <para>Install the <filename>/etc/rc.d/init.d/dhcp</filename>
    228       init script included in the <xref linkend="bootscripts"/>
    229       package.</para>
    230 
    231       <indexterm zone="dhcp dhcp-init">
    232         <primary sortas="f-dhcp">dhcpd</primary>
     204    <sect3 id="dhclient-config">
     205      <title>Client Configuration</title>
     206
     207      <para>
     208        Create basic <filename>/etc/dhcp/dhclient.conf</filename>
     209        by running the following command as the
     210        <systemitem class="username">root</systemitem> user:
     211      </para>
     212
     213<screen role="root"><userinput>cat &gt; /etc/dhcp/dhclient.conf &lt;&lt; "EOF"
     214<literal># Begin /etc/dhcp/dhclient.conf
     215#
     216# Basic dhclient.conf(5)
     217
     218#prepend domain-name-servers 127.0.0.1;
     219request subnet-mask, broadcast-address, time-offset, routers,
     220        domain-name, domain-name-servers, domain-search, host-name,
     221        netbios-name-servers, netbios-scope, interface-mtu,
     222        ntp-servers;
     223require subnet-mask, domain-name-servers;
     224#timeout 60;
     225#retry 60;
     226#reboot 10;
     227#select-timeout 5;
     228#initial-interval 2;
     229
     230# End /etc/dhcp/dhclient.conf</literal>
     231EOF</userinput></screen>
     232
     233      <para>
     234        See <command>man 5 dhclient.conf</command> for additional options.
     235      </para>
     236
     237      <para>
     238        Now create the <filename class="directory">/var/lib/dhclient</filename>
     239        directory which will contain DHCP Client leases by running the following
     240        command as the <systemitem class="username">root</systemitem> user:
     241      </para>
     242
     243<screen role="root"><userinput>install -v -dm 755 /var/lib/dhclient</userinput></screen>
     244
     245      <para>
     246        At this point you can test if <command>dhclient</command> is
     247        behaving as expected by running the following command as the
     248        <systemitem class="username">root</systemitem> user:
     249      </para>
     250
     251<screen role="root"><userinput>dhclient <replaceable>&lt;eth0&gt;</replaceable></userinput></screen>
     252
     253      <para>
     254        Replace <replaceable>&lt;eth0&gt;</replaceable> with your
     255        desired interface. If you want more verbose output, add the
     256        <command>-v</command> parameter to the command above.
     257      </para>
     258
     259      <para id="dhclient-service">
     260        If you want to configure network interfaces at boot using
     261        <command>dhclient</command>, you need to install the
     262        <filename>/lib/services/dhclient</filename> script
     263        included in <xref linkend="bootscripts"/> package:
     264      </para>
     265
     266<screen role="root"><userinput>make install-service-dhclient</userinput></screen>
     267
     268      <indexterm zone="dhcp dhclient-service">
     269        <primary sortas="f-dhclient">dhclient (service script)</primary>
    233270      </indexterm>
    234271
    235 <screen role="root"><userinput>make install-dhcp</userinput></screen>
    236 
    237       <para>The lease file must exist on startup. The following command will
    238       satisfy that requirement:</para>
    239 
    240 <screen role="root"><userinput>touch /var/state/dhcp/dhcpd.leases</userinput></screen>
    241 
    242       <para>The following commands will create a base configuration file
    243       for a DHCP server.  There are several options that you may want to
    244       add (information that is passed back to the DHCP client) and those
    245       are covered in the man pages for <filename>dhcp.conf</filename>.</para>
    246 
    247 <screen role="root"><userinput>cat &gt; /etc/dhcpd.conf &lt;&lt; "EOF"
    248 <literal>default-lease-time 72000;
    249 max-lease-time 144000;
    250 
    251 subnet <replaceable>&lt;192.168.5.0&gt;</replaceable> netmask <replaceable>&lt;255.255.255.0&gt;</replaceable> {
    252   range <replaceable>&lt;192.168.5.10&gt; &lt;192.168.5.240&gt;</replaceable>;
    253   option broadcast-address <replaceable>&lt;192.168.5.255&gt;</replaceable>;
    254   option routers <replaceable>&lt;192.168.5.1&gt;</replaceable>;
    255 }</literal>
     272      <para id="dhclient-ifconfig">
     273        Next, create the <filename>/etc/sysconfig/ifconfig.eth0</filename>
     274        configuration file with the following commands as the
     275        <systemitem class="username">root</systemitem> user:
     276      </para>
     277
     278<screen role="root"><userinput>cat &gt; /etc/sysconfig/ifconfig.eth0 &lt;&lt; "EOF"
     279<literal>ONBOOT="yes"
     280IFACE="eth0"
     281SERVICE="dhclient"
     282DHCP_START=""
     283DHCP_STOP=""
     284
     285# Set PRINTIP="yes" to have the script print
     286# the DHCP assigned IP address
     287PRINTIP="no"
     288
     289# Set PRINTALL="yes" to print the DHCP assigned values for
     290# IP, SM, DG, and 1st NS. This requires PRINTIP="yes".
     291PRINTALL="no"</literal>
    256292EOF</userinput></screen>
    257293
    258       <para>All addresses should be changed to meet your circumstance.</para>
     294      <indexterm zone="dhcp dhclient-ifconfig">
     295        <primary sortas="e-etc-sysconfig-...-dhclient">/etc/sysconfig/ifconfig.eth0</primary>
     296      </indexterm>
     297
     298      <para>
     299        Adjust the file to suit your needs.
     300      </para>
     301
     302      <para>
     303        For more information on the appropriate <envar>DHCP_START</envar>
     304        and <envar>DHCP_STOP</envar> values see
     305        <command>man 8 dhclient</command>.
     306      </para>
     307
     308    </sect3>
     309
     310    <sect3 id="dhcpd-config">
     311      <title>Server Configuration</title>
     312
     313      <para>
     314        Note that you only need the DHCP server if you want to issue
     315        LAN addresses over your network. The DHCP client doesn't need
     316        the server in order to function properly.
     317      </para>
     318
     319      <para>
     320        Start with creating <filename>/etc/dhcp/dhcpd.conf</filename>
     321        by running the following command as the
     322        <systemitem class="username">root</systemitem> user:
     323      </para>
     324
     325<screen role="root"><userinput>cat &gt; /etc/dhcp/dhcpd.conf &lt;&lt; "EOF"
     326<literal># Begin /etc/dhcp/dhcpd.conf
     327#
     328# Example dhcpd.conf(5)
     329
     330# Use this to enble / disable dynamic dns updates globally.
     331ddns-update-style none;
     332
     333# option definitions common to all supported networks...
     334option domain-name "example.org";
     335option domain-name-servers ns1.example.org, ns2.example.org;
     336
     337default-lease-time 600;
     338max-lease-time 7200;
     339
     340# This is a very basic subnet declaration.
     341subnet 10.254.239.0 netmask 255.255.255.224 {
     342  range 10.254.239.10 10.254.239.20;
     343  option routers rtr-239-0-1.example.org, rtr-239-0-2.example.org;
     344}
     345
     346# End /etc/dhcp/dhcpd.conf</literal>
     347EOF</userinput></screen>
     348
     349      <para>
     350        Adjust the file to suit your needs. See
     351        <command>man 5 dhcpd.conf</command> for additional options.
     352      </para>
     353
     354      <para>
     355        Now create the <filename class="directory">/var/lib/dhcpd</filename>
     356        directory which will contain DHCP Server leases by running the following
     357        command as the <systemitem class="username">root</systemitem> user:
     358      </para>
     359
     360<screen role="root"><userinput>install -v -dm 755 /var/lib/dhcpd</userinput></screen>
     361
     362       <para>
     363        If you want to start the DHCP Server at boot, install
     364        the <filename>/etc/rc.d/init.d/dhcpd</filename>
     365        init script included in the <xref linkend="bootscripts"/>
     366        package:
     367      </para>
     368
     369<screen role="root"><userinput>make install-dhcpd</userinput></screen>
     370
     371      <indexterm zone="dhcp dhcpd-config">
     372        <primary sortas="f-dhcpd">dhcpd</primary>
     373      </indexterm>
     374
     375      <para>
     376        You will need to edit the
     377        <filename>/etc/sysconfig/dhcpd</filename> in order
     378        to set the interface on which <command>dhcpd</command>
     379        will serve the DHCP requests.
     380      </para>
    259381
    260382    </sect3>
    … …  
    271393
    272394      <seglistitem>
    273         <seg>dhcpd, dhcrelay, dhclient, dhclient-script, and omshell</seg>
    274         <seg>libbdhcpctl.a, libdst.a, libomapi.a</seg>
    275         <seg>/var/state/dhcp, /usr/include/omapip, and /usr/include/isi-dhcp</seg>
     395        <seg>
     396          dhclient, dhclient-script, dhcpd, dhcrelay and omshell
     397        </seg>
     398        <seg>
     399          libdhcpctl.a, libdst.a and libomapi.a
     400        </seg>
     401        <seg>
     402          /usr/include/dhcpctl,
     403          /usr/include/isc-dhcp,
     404          /usr/include/omapip,
     405          /var/lib/dhclient and
     406          /var/lib/dhcpd
     407        </seg>
    276408      </seglistitem>
    277409    </segmentedlist>
    … …  
    285417        <term><command>dhclient</command></term>
    286418        <listitem>
    287           <para>is the implementation of the DHCP client.</para>
     419          <para>
     420            is the implementation of the DHCP client.
     421          </para>
    288422          <indexterm zone="dhcp dhclient">
    289423            <primary sortas="b-dhclient">dhclient</primary>
    … …  
    295429        <term><command>dhclient-script</command></term>
    296430        <listitem>
    297           <para>is used by dhclient to (re)configure interfaces. It can make
    298           extra changes by invoking custom dhclient-{entry,exit}-hooks.</para>
     431          <para>
     432            is used by dhclient to (re)configure interfaces. It can make
     433            extra changes by invoking custom dhclient-{entry,exit}-hooks.
     434          </para>
    299435          <indexterm zone="dhcp dhclient-script">
    300436            <primary sortas="b-dhclient-script">dhclient-script</primary>
    … …  
    306442        <term><command>dhcpd</command></term>
    307443        <listitem>
    308           <para>implements Dynamic Host Configuration Protocol (DHCP) and
    309           Internet Bootstrap Protocol (BOOTP) requests for network
    310           addresses.</para>
     444          <para>
     445            implements Dynamic Host Configuration Protocol (DHCP) and
     446            Internet Bootstrap Protocol (BOOTP) requests for network
     447            addresses.
     448          </para>
    311449          <indexterm zone="dhcp dhcpd">
    312450            <primary sortas="b-dhcpd">dhcpd</primary>
    … …  
    318456        <term><command>dhcrelay</command></term>
    319457        <listitem>
    320           <para>provides a means to accept DHCP and BOOTP requests on a subnet
    321           without a DHCP server and relay them to a DHCP server on another
    322           subnet.</para>
     458          <para>
     459            provides a means to accept DHCP and BOOTP requests on a subnet
     460            without a DHCP server and relay them to a DHCP server on another
     461            subnet.
     462          </para>
    323463          <indexterm zone="dhcp dhcrelay">
    324464            <primary sortas="b-dhcrelay">dhcrelay</primary>
    … …  
    330470        <term><command>omshell</command></term>
    331471        <listitem>
    332           <para> provides an interactive way to connect to, query, and
    333           possibly change, the ISC DHCP Server's state via OMAPI, the
    334           Object Management API.</para>
     472          <para>
     473            provides an interactive way to connect to, query and
     474            possibly change the ISC DHCP Server's state via OMAPI, the
     475            Object Management API.
     476          </para>
    335477          <indexterm zone="dhcp omshell">
    336478            <primary sortas="b-omshell">omshell</primary>

  • networking/netutils/networkmanager.xml

    r17ef733 r697cb83f  
    9191      <xref linkend="consolekit"/>,
    9292      <xref linkend="dhcpcd"/> or
    93       <xref linkend="dhcp-client"/>,
     93      <xref linkend="dhcp"/> (client only),
    9494      <xref linkend="gobject-introspection"/>,
    9595      <xref linkend="iptables"/>,
Note: See TracChangeset for help on using the changeset viewer.