Changeset 6ad98e12 for server/other
- Timestamp:
- 05/18/2005 07:16:15 PM (19 years ago)
- Branches:
- 10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 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, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
- Children:
- be2a00b
- Parents:
- 59bfedf5
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
server/other/dhcp.xml
r59bfedf5 r6ad98e12 5 5 %general-entities; 6 6 7 <!ENTITY dhcp-download-http "http://gd.tuwien.ac.at/infosys/servers/isc/dhcp/dhcp-&dhcp-version;.tar.gz">8 <!ENTITY dhcp-download-ftp "ftp://ftp.isc.org/isc/dhcp/dhcp-&dhcp-version;.tar.gz">9 <!ENTITY dhcp-md5sum "04800a111521e7442749b2ce883f962b">10 <!ENTITY dhcp-size "834 KB">11 <!ENTITY dhcp-buildsize "29.7 MB">12 <!ENTITY dhcp-time "0.22 SBU">7 <!ENTITY dhcp-download-http "http://gd.tuwien.ac.at/infosys/servers/isc/dhcp/dhcp-&dhcp-version;.tar.gz"> 8 <!ENTITY dhcp-download-ftp "ftp://ftp.isc.org/isc/dhcp/dhcp-&dhcp-version;.tar.gz"> 9 <!ENTITY dhcp-md5sum "04800a111521e7442749b2ce883f962b"> 10 <!ENTITY dhcp-size "834 KB"> 11 <!ENTITY dhcp-buildsize "29.7 MB"> 12 <!ENTITY dhcp-time "0.22 SBU"> 13 13 ]> 14 14 15 15 <sect1 id="dhcp" xreflabel="DHCP-&dhcp-version;"> 16 <sect1info> 17 <othername>$LastChangedBy$</othername> 18 <date>$Date$</date> 19 </sect1info> 20 <?dbhtml filename="dhcp.html"?> 21 <title><acronym>DHCP</acronym>-&dhcp-version;</title> 22 23 <indexterm zone="dhcp"> 24 <primary sortas="a-dhcp">Dhcp</primary> 25 </indexterm> 26 27 <sect2> 28 <title>Introduction to 29 <application><acronym>DHCP</acronym></application></title> 30 31 <para>The <application><acronym>DHCP</acronym></application> package contains 32 both the client and server programs for <acronym>DHCP</acronym>. 33 <command>dhclient</command> (the client) is useful for connecting your computer 34 to a network which uses <acronym>DHCP</acronym> to assign network addresses. 35 <command>dhcpd</command> (the server) is useful for assigning network addresses 36 on your private network.</para> 37 38 <sect3><title>Package information</title> 39 <itemizedlist spacing='compact'> 40 <listitem><para>Download (HTTP): <ulink url="&dhcp-download-http;"/></para></listitem> 41 <listitem><para>Download (FTP): <ulink url="&dhcp-download-ftp;"/></para></listitem> 42 <listitem><para>Download MD5 sum: &dhcp-md5sum;</para></listitem> 43 <listitem><para>Download size: &dhcp-size;</para></listitem> 44 <listitem><para>Estimated disk space required: &dhcp-buildsize;</para></listitem> 45 <listitem><para>Estimated build time: &dhcp-time;</para></listitem> 46 </itemizedlist> 47 </sect3> 48 49 <sect3> 50 <title><application>dhcp</application> dependencies</title> 51 52 <sect4> 53 <title>Required</title> 54 <para><xref linkend="net-tools"/> (you may omit <application>net-tools</application> 55 by using the following patch to utilize <application>iproute2</application>: 56 <ulink url="&patch-root;/dhcp-&dhcp-version;-iproute2-2.patch"/>) 57 </para> 58 </sect4> 59 </sect3> 60 61 </sect2> 62 63 <sect2 id='dhcp-kernel'> 64 <title>Installation of 65 <application><acronym>DHCP</acronym></application></title> 66 67 <note><para>You must have Packet Socket support (Device Drivers -> 68 Networking Support -> Networking Options -> Packet Socket) compiled into 69 the kernel.</para></note> 70 71 <indexterm zone="dhcp dhcp-kernel"> 72 <primary sortas="d-dhcp">DHCP</primary> 73 </indexterm> 74 75 <para>Install <application><acronym>DHCP</acronym></application> by running 76 the following commands:</para> 77 78 <screen><userinput><command>patch -Np1 -i ../dhcp-&dhcp-version;-iproute2-2.patch && 16 <?dbhtml filename="dhcp.html"?> 17 18 <sect1info> 19 <othername>$LastChangedBy$</othername> 20 <date>$Date$</date> 21 </sect1info> 22 23 <title>DHCP-&dhcp-version;</title> 24 25 <indexterm zone="dhcp"> 26 <primary sortas="a-dhcp">Dhcp</primary> 27 </indexterm> 28 29 <sect2 role="package"> 30 <title>Introduction to DHCP</title> 31 32 <para>The <application>DHCP</application> package contains both the client 33 and server programs for DHCP. <command>dhclient</command> (the client) is 34 useful for connecting your computer to a network which uses DHCP to assign 35 network addresses. <command>dhcpd</command> (the server) is useful for 36 assigning network addresses on your private network.</para> 37 38 <bridgehead renderas="sect3">Package Information</bridgehead> 39 <itemizedlist spacing="compact"> 40 <listitem> 41 <para>Download (HTTP): <ulink url="&dhcp-download-http;"/></para> 42 </listitem> 43 <listitem> 44 <para>Download (FTP): <ulink url="&dhcp-download-ftp;"/></para> 45 </listitem> 46 <listitem> 47 <para>Download MD5 sum: &dhcp-md5sum;</para> 48 </listitem> 49 <listitem> 50 <para>Download size: &dhcp-size;</para> 51 </listitem> 52 <listitem> 53 <para>Estimated disk space required: &dhcp-buildsize;</para> 54 </listitem> 55 <listitem> 56 <para>Estimated build time: &dhcp-time;</para> 57 </listitem> 58 </itemizedlist> 59 60 <bridgehead renderas="sect3">DHCP Dependencies</bridgehead> 61 62 <bridgehead renderas="sect4">Required</bridgehead> 63 <para><xref linkend="net-tools"/> (you may omit 64 <application>net-tools</application> by using the following patch 65 to utilize <application>iproute2</application>: 66 <ulink url="&patch-root;/dhcp-&dhcp-version;-iproute2-2.patch"/>)</para> 67 68 </sect2> 69 70 <sect2 role="kernel" id='dhcp-kernel'> 71 <title>Kernel Configuration</title> 72 73 <para>You must have Packet Socket support (Device Drivers -> Networking 74 Support -> Networking Options -> Packet Socket) compiled into 75 the kernel.</para> 76 77 <indexterm zone="dhcp dhcp-kernel"> 78 <primary sortas="d-dhcp">DHCP</primary> 79 </indexterm> 80 81 </sect2> 82 83 <sect2 role="installation"> 84 <title>Installation of DHCP</title> 85 86 <para>Install <application>DHCP</application> by running 87 the following commands:</para> 88 89 <screen><userinput>patch -Np1 -i ../dhcp-&dhcp-version;-iproute2-2.patch && 79 90 ./configure && 80 make</command></userinput></screen> 81 82 <para>Now, as the root user:</para> 83 84 <screen><userinput role='root'><command>make LIBDIR=/usr/lib INCDIR=/usr/include install</command></userinput></screen> 85 86 </sect2> 87 88 <sect2> 89 <title>Command explanations</title> 90 91 <para><parameter>LIBDIR=/usr/lib INCDIR=/usr/include</parameter>: This 92 command installs the library and include files in 93 <filename class="directory">/usr</filename> instead of 94 <filename class="directory">/usr/local</filename>.</para> 95 96 </sect2> 97 98 <sect2 id='dhcp-config'> 99 <title>Configuring <application><acronym>DHCP</acronym></application></title> 100 101 <indexterm zone="dhcp dhcp-config"> 102 <primary sortas="e-etc-dhclient.conf">/etc/dhclient.conf</primary> 103 </indexterm> 104 105 <indexterm zone="dhcp dhcp-config"> 106 <primary sortas="e-etc-dhcpd.conf">/etc/dhcpd.conf</primary> 107 </indexterm> 108 109 110 <sect3> 111 <title>Config files</title> 112 <para><filename>/etc/dhclient.conf</filename></para> 113 </sect3> 114 115 <sect3 id='dhcp-init'> 116 <title>Configuration Information</title> 117 118 <para>Information on configuring the <acronym>DHCP</acronym> client can be 119 found in <xref linkend="connect-dhcp"/>.</para> 120 121 <para>Note that you only need the <acronym>DHCP</acronym> server if 122 you want to issue <acronym>LAN</acronym> addresses over your network. The 123 <acronym>DHCP</acronym> client doesn't need this script to be used. Also note 124 that this script is coded for the <emphasis role="strong">eth1</emphasis> 125 interface, which may need to be modified for your hardware configuration.</para> 126 127 <para>Install the <filename>/etc/rc.d/init.d/dhcp</filename> 128 init script included in the <xref linkend="intro-important-bootscripts"/> 129 package.</para> 130 131 <indexterm zone="dhcp dhcp-init"> 132 <primary sortas="f-dhcp">dhcpd</primary> 133 </indexterm> 134 135 <screen><userinput><command>make install-dhcp</command></userinput></screen> 136 137 <para>The lease file must exist on startup. The following command will 138 satisfy that requirement:</para> 139 140 <screen><userinput><command>touch /var/state/dhcp/dhcpd.leases</command></userinput></screen> 141 142 <para>The following commands will create a base configuration file for a 143 <acronym>DHCP</acronym> server. There are several options that you may want to 144 add (information that is passed back to the <acronym>DHCP</acronym> client) and 145 those are covered in the man pages for <filename>dhcp.conf</filename>.</para> 146 147 <screen><userinput><command>cat > /etc/dhcpd.conf << "EOF"</command> 148 default-lease-time 72000; 91 make</userinput></screen> 92 93 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 94 95 <screen role="root"><userinput>make LIBDIR=/usr/lib INCDIR=/usr/include install</userinput></screen> 96 97 </sect2> 98 99 <sect2 role="commands"> 100 <title>Command Explanations</title> 101 102 <para><parameter>LIBDIR=/usr/lib INCDIR=/usr/include</parameter>: This 103 command installs the library and include files in 104 <filename class="directory">/usr</filename> instead of 105 <filename class="directory">/usr/local</filename>.</para> 106 107 </sect2> 108 109 <sect2 role="configuration"> 110 <title>Configuring DHCP</title> 111 112 <sect3 id='dhcp-config'> 113 <title>Config Files</title> 114 115 <para><filename>/etc/dhclient.conf</filename> and 116 <filename>/etc/dhcpd.conf</filename></para> 117 118 <indexterm zone="dhcp dhcp-config"> 119 <primary sortas="e-etc-dhclient.conf">/etc/dhclient.conf</primary> 120 </indexterm> 121 122 <indexterm zone="dhcp dhcp-config"> 123 <primary sortas="e-etc-dhcpd.conf">/etc/dhcpd.conf</primary> 124 </indexterm> 125 126 </sect3> 127 128 <sect3 id='dhcp-init'> 129 <title>Configuration Information</title> 130 131 <para>Information on configuring the DHCP client can be 132 found in <xref linkend="connect-dhcp"/>.</para> 133 134 <para>Note that you only need the DHCP server if you want to issue 135 LAN addresses over your network. The DHCP client doesn't need this 136 script to be used. Also note that this script is coded for the 137 <emphasis role="strong">eth1</emphasis> interface, which may need 138 to be modified for your hardware configuration.</para> 139 140 <para>Install the <filename>/etc/rc.d/init.d/dhcp</filename> 141 init script included in the <xref linkend="intro-important-bootscripts"/> 142 package.</para> 143 144 <indexterm zone="dhcp dhcp-init"> 145 <primary sortas="f-dhcp">dhcpd</primary> 146 </indexterm> 147 148 <screen role="root"><userinput>make install-dhcp</userinput></screen> 149 150 <para>The lease file must exist on startup. The following command will 151 satisfy that requirement:</para> 152 153 <screen role="root"><userinput>touch /var/state/dhcp/dhcpd.leases</userinput></screen> 154 155 <para>The following commands will create a base configuration file 156 for a DHCP server. There are several options that you may want to 157 add (information that is passed back to the DHCP client) and those 158 are covered in the man pages for <filename>dhcp.conf</filename>.</para> 159 160 <screen role="root"><userinput>cat > /etc/dhcpd.conf << "EOF" 161 <literal>default-lease-time 72000; 149 162 max-lease-time 144000; 150 163 ddns-update-style ad-hoc; … … 154 167 option broadcast-address <replaceable>[192.168.5.255]</replaceable>; 155 168 option routers <replaceable>[192.168.5.1]</replaceable>; 156 } 157 <command>EOF</command></userinput></screen> 158 159 <para>All addresses should be changed to meet your circumstance.</para> 160 161 </sect3> 162 163 </sect2> 164 165 <sect2> 166 <title>Contents</title> 167 168 <segmentedlist> 169 <segtitle>Installed Programs</segtitle> 170 <segtitle>Installed Libraries</segtitle> 171 <segtitle>Installed Directories</segtitle> 172 173 <seglistitem> 174 <seg>dhcpd, dhcrelay, dhclient, dhclient-script, omshell</seg> 175 <seg>bdhcpctl.a, libomapi.a</seg> 176 <seg>/var/state/dhcp, /usr/include/omapip, /usr/include/isi-dhcp</seg> 177 </seglistitem> 178 </segmentedlist> 179 180 <variablelist> 181 <bridgehead renderas="sect3">Short Descriptions</bridgehead> 182 <?dbfo list-presentation="list"?> 183 184 <varlistentry id="dhclient"> 185 <term><command>dhclient</command></term> 186 <listitem> 187 <para>is the implementation of the <acronym>DHCP</acronym> client.</para> 188 <indexterm zone="dhcp dhclient"> 189 <primary sortas="b-dhclient">dhclient</primary> 190 </indexterm> 191 </listitem> 192 </varlistentry> 193 194 <varlistentry id="dhcpd"> 195 <term><command>dhcpd</command></term> 196 <listitem> 197 <para>implements Dynamic Host Configuration Protocol (<acronym>DHCP</acronym>) 198 and Internet Bootstrap Protocol (<acronym>BOOTP</acronym>) requests for 199 network addresses.</para> 200 <indexterm zone="dhcp dhcpd"> 201 <primary sortas="b-dhcpd">dhcpd</primary> 202 </indexterm> 203 </listitem> 204 </varlistentry> 205 206 <varlistentry id="dhcrelay"> 207 <term><command>dhcrelay</command></term> 208 <listitem> 209 <para>provides a means to accept <acronym>DHCP</acronym> and <acronym>BOOTP</acronym> 210 requests on a subnet without a <acronym>DHCP</acronym> server and relay them to 211 a <acronym>DHCP</acronym> server on another subnet.</para> 212 <indexterm zone="dhcp dhcrelay"> 213 <primary sortas="b-dhcrelay">dhcrelay</primary> 214 </indexterm> 215 </listitem> 216 </varlistentry> 217 218 <varlistentry id="omshell"> 219 <term><command>omshell</command></term> 220 <listitem> 221 <para> provides an interactive way to connect to, query, and possibly change, 222 the ISC DHCP Server's state via OMAPI, the Object Management API.</para> 223 <indexterm zone="dhcp omshell"> 224 <primary sortas="b-omshell">omshell</primary> 225 </indexterm> 226 </listitem> 227 </varlistentry> 228 229 </variablelist> 230 </sect2> 169 }</literal> 170 EOF</userinput></screen> 171 172 <para>All addresses should be changed to meet your circumstance.</para> 173 174 </sect3> 175 176 </sect2> 177 178 <sect2 role="content"> 179 <title>Contents</title> 180 181 <segmentedlist> 182 <segtitle>Installed Programs</segtitle> 183 <segtitle>Installed Libraries</segtitle> 184 <segtitle>Installed Directories</segtitle> 185 186 <seglistitem> 187 <seg>dhcpd, dhcrelay, dhclient, dhclient-script, and omshell</seg> 188 <seg>bdhcpctl.a, libomapi.a</seg> 189 <seg>/var/state/dhcp, /usr/include/omapip, and /usr/include/isi-dhcp</seg> 190 </seglistitem> 191 </segmentedlist> 192 193 <variablelist> 194 <bridgehead renderas="sect3">Short Descriptions</bridgehead> 195 <?dbfo list-presentation="list"?> 196 <?dbhtml list-presentation="table"?> 197 198 <varlistentry id="dhclient"> 199 <term><command>dhclient</command></term> 200 <listitem> 201 <para>is the implementation of the DHCP client.</para> 202 <indexterm zone="dhcp dhclient"> 203 <primary sortas="b-dhclient">dhclient</primary> 204 </indexterm> 205 </listitem> 206 </varlistentry> 207 208 <varlistentry id="dhcpd"> 209 <term><command>dhcpd</command></term> 210 <listitem> 211 <para>implements Dynamic Host Configuration Protocol (DHCP) and 212 Internet Bootstrap Protocol (BOOTP) requests for network 213 addresses.</para> 214 <indexterm zone="dhcp dhcpd"> 215 <primary sortas="b-dhcpd">dhcpd</primary> 216 </indexterm> 217 </listitem> 218 </varlistentry> 219 220 <varlistentry id="dhcrelay"> 221 <term><command>dhcrelay</command></term> 222 <listitem> 223 <para>provides a means to accept DHCP and BOOTP requests on a subnet 224 without a DHCP server and relay them to a DHCP server on another 225 subnet.</para> 226 <indexterm zone="dhcp dhcrelay"> 227 <primary sortas="b-dhcrelay">dhcrelay</primary> 228 </indexterm> 229 </listitem> 230 </varlistentry> 231 232 <varlistentry id="omshell"> 233 <term><command>omshell</command></term> 234 <listitem> 235 <para> provides an interactive way to connect to, query, and 236 possibly change, the ISC DHCP Server's state via OMAPI, the 237 Object Management API.</para> 238 <indexterm zone="dhcp omshell"> 239 <primary sortas="b-omshell">omshell</primary> 240 </indexterm> 241 </listitem> 242 </varlistentry> 243 244 </variablelist> 245 246 </sect2> 247 231 248 </sect1> 232
Note:
See TracChangeset
for help on using the changeset viewer.