Author: sbalneav
Date: Sun Sep  2 06:55:15 2007
New Revision: 4313

Modified:
   trunk/edubuntu/handbook/C/server.xml

Log:
added section on dhcp

Modified: trunk/edubuntu/handbook/C/server.xml
==============================================================================
--- trunk/edubuntu/handbook/C/server.xml        (original)
+++ trunk/edubuntu/handbook/C/server.xml        Sun Sep  2 06:55:15 2007
@@ -1837,6 +1837,81 @@
             the swapfiles are stored.
         </para>
     </sect1>
+
+    <!-- dhcp -->
+    <sect1>
+        <title>Managing DHCP</title>
+        <para>DHCP stands for Dynamic Host Configuration Protocol, and is the 
very first thing your
+            thin client uses to obtain an IP address from the network, in 
order to allow it to start
+            booting.  In Edubuntu, the dhcpd file is located in <filename 
class="directory">/etc/ltsp</filename>.  Any changes
+            you want to make to booting behaviour should be made there.
+        </para>
+        <para>By default, Edubuntu ships a <filename>dhcpd.conf</filename> 
that serves thin clients
+            in a dynamic range (i.e. it will hand out ip addresses to anyone 
who asks for them) from
+            192.168.0.20 to 192.168.0.250.  The default dhcpd.conf file looks 
like:
+            <screen>
+#
+# Default LTSP dhcpd.conf config file.
+#
+
+authoritative;
+
+subnet 192.168.0.0 netmask 255.255.255.0 {
+    range 192.168.0.20 192.168.0.250;
+    option domain-name "example.com";
+    option domain-name-servers 192.168.0.1;
+    option broadcast-address 192.168.0.255;
+    option routers 192.168.0.1;
+#    next-server 192.168.0.254;
+#    get-lease-hostnames true;
+    option subnet-mask 255.255.255.0;
+    option root-path "/opt/ltsp/i386";
+    if substring( option vendor-class-identifier, 0, 9 ) = "PXEClient" {
+        filename "/ltsp/i386/pxelinux.0";
+    } else {
+        filename "/ltsp/i386/nbi.img";
+    }
+}
+            </screen>
+            This <filename>dhcpd.conf</filename> should handle most situations.
+        </para>
+        <para>By default, Edubuntu will detect an unused network interface, 
and configure it to be 192.168.0.254.  
+            Edubuntu's recommended single server installation is to use a 
separate network interface for the thin
+            clients.  If, however, you're not using two network interfaces, or 
you already have an interface
+            in the 192.168.0 range, then you might have to configure the thin 
client interface differently, which
+            means you may have to adjust the <filename>dhcpd.conf</filename> 
accordingly.
+        </para>
+        <para>If the network interface that you're going to connect the thin 
clients to has, say, a TCP/IP address
+            of 10.0.20.254, you'll want to replace every occurance of 
192.168.0 with 10.0.20 in the
+            <filename>dhcpd.conf</filename> file.
+        </para>
+        <para>Always remember, you'll need to re-start the dhcp server if you 
make any changes.  You can do this
+            by issuing the command:
+            <screen>
+sudo invoke-rc.d dhcp3-server restart
+            </screen>
+            at the command prompt.
+        </para>
+        <sect2>
+            <title>Adding static entries to the dhcpd.conf</title>
+            <para>Sometimes, you may need to have a certain terminal boot with 
a guarenteed fixed TCP/IP address
+                every time.  Say, if you're connecting a printer to the 
terminal, and need to make sure the 
+                print server can find it at a fixed address.  To create a 
fixed address, use a low number
+                in the range of 2-19, or otherwise, if you change the range 
statement in the <filename>dhcpd.conf</filename>.
+            </para>
+            <para>To create a static entry, simply add the following after the 
"option root-path" line:
+                <screen>
+host hostname {
+    hardware ethernet     MA:CA:DD:RE:SS:00;
+    fixed-address         192.168.0.2;
+}
+                </screen>
+                Substitude the mac address for the mac address of the thin 
client you wish to fix the address of.  The
+                fixed-addres will be the TCP/IP address you want, and 
"hostname" is the name you wish to give the host.
+            </para>
+        </sect2>
+    </sect1>
+
     <!-- Thin Client Manager -->
     <sect1 id="ltsp-tcm" status="draft">
         <title>Edubuntu Thin Client Manager</title>

-- 
ubuntu-doc-commits mailing list
ubuntu-doc-commits@lists.ubuntu.com
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc-commits

Reply via email to