8.7. Thin Client Setup

Each thin client has a wide range of options that can be changed on an individual thin client basis.

All these options are specified in the file /opt/ltsp/i386/etc/lts.conf, but you need to assign each thin client a static IP address. You do this by adding the MAC address of the network card in your thin client, all done in the file /etc/dhcp3/dhcpd-skolelinux.conf[1]There is also a Webmin module for this operation, https://tjener.intern:10000/dhcpd3/index.cgi

8.7.1. Assigning a Machine a Static IP address

Warning

After you have made any changes to /etc/dhcp3/dhcpd-skolelinux.conf, either by editing the file directly, or via Webmin, you need to restart the DHCP3-server for the changes to take affect. This is either done from the command line with

/etc/init.d/dhcp3-server restart

or in Webmin by pressing the button labeled 'Apply Changes'.

All servers in Skolelinux/Debian-edu, mainserver and thinclientserver, run DHCP-servers. This means that any machine, workstation, thinclient and other machines (laptops, Windows, Mac machines) will get a dynamic IP address, that is, the IP address given to the individual machine is likely to be different every time that machine connects.

In order to make your life easier, you should make these machines have a static IP address. Add their MAC addresses to the right group in the DHCP-setup.

8.7.2. Creating Etherboot ROM Images for Ordinary (non-PXE) network cards.[id=matic]

I strongly advise you to use PXE cards, which eliminate the need for the use of failure-prone media such as floppy disks. But if you have to use floppy disks to boot your thin clients, then there are some small tricks to learn. The floppy disks you need, are ready and available for download at rom-o-matic.com. The latest stable version that is known to work well with Skolelinux/Debian-edu is 5.0.11, which is the recommended one.

There are two things you need to do::

8.7.3. Special Floppy Disk with Support for 30 network cards[id=universalboot]

This floppy disk image contains the ROM for the 30 most popular and widely-used network cards, which means that there is a big chance that you don't need to fiddle around trying to figure out what kind of network card you have.

This floppy disk is a part of the project Thinstation, from there you download "Universal boot floppy". The file you have downloaded should be BootDisk522b.zip. In Windows you use a zip program to unpack it. In Skolelinux/Debian-edu you unpack it with unzip BootDisk522b.zip, (you may need to install unzip, apt-get install unzip). While unzipping the file you should see something like this:


klaus@tjener:$ unzip BootDisk522b.zip
Archive:  BootDisk522b.zip
  inflating: rawrite2.exe
  inflating: ebnet522.dsk
  inflating: Readme.txt
	  
In the file Readme.txtyou will find detailed information about how the universal boot floppy is made, together with how you can make one yourself. As root, you can make one with the command cp ebnet522.dsk /dev/fd0

8.7.4. Using the MAC Address to Assign a Fixed IP Number to a Thin Client

In order to be able to specially customise your various thin clients, you have to be able to identify each of them separately. You can do this with the help of each thin client's network card and its unique MAC address (which every network card has).

Most (but not all) network cards have their respective MAC addresses printed on them somewhere. It often looks something like 0000864A585A, or 00-00-86-4A-58-5A, eller 00:00:86:4A:58:5A, which are numbers given in the hexidecimal system. If you don't see anything like that printed on the card, then you can have a look at the file /var/log/syslog, where the thin client's MAC address is registered when it tries to start up. To see what is being logged at the time the thin client starts up, use the command

tail -f /var/log/syslog

then you will see something like

Jan  4 19:04:44 tjener dhcpd-2.2.x: DHCPDISCOVER from 00:00:86:4a:58:5a via eth1
Jan  4 19:04:44 tjener dhcpd-2.2.x: DHCPOFFER on 192.168.0.201 to 00:00:86:4a:58:5a via eth1
Jan  4 19:04:45 tjener dhcpd-2.2.x: DHCPREQUEST for 192.168.0.201 from 00:00:86:4a:58:5a via eth1
Jan  4 19:04:45 tjener dhcpd-2.2.x: DHCPACK on 192.168.0.201 to 00:00:86:4a:58:5a via eth1
Here you can see the MAC address, together with the IP number given to each thin client.

Now that you know the MAC address, you can type it in the file /etc/dhcp3/dhcpd-skolelinux.conf, for example

host ltsp010 {
        hardware ethernet     00:00:86:4a:58:5a;
        fixed-address         192.168.0.10;
	#filename              "/tftpboot/lts/vmlinuz-2.4.19-ltsp-1";
        filename              "/tftpboot/lts/pxelinux.0";
        #option option-128     e4:45:74:68:00:00;
        #option option-129     "NIC=3c509";
    }

After you have typed in the MAC address, then you must restart the DHCP server, which is done with the command

/etc/init.d/dhcp3-server restart

[2] In this case I have decided that the thin client with the MAC address 00:00:86:4a:58:5a should be named ltsp010 and be given the IP number 192.168.0.10. The names ltspXXX cannot be changed to something else, for example room203. It won't work.

Remember that a hash-mark ( # ) before a line in a file /etc/dhcp3/dhcpd-skolelinux.conf is used as a comment symbol, which means that this line is just a comment. In this case I have put a comment symbol at the start of the line

#filename              "/tftpboot/lts/vmlinuz-2.4.19-ltsp-1";
while at the start of the line
filename              "/tftpboot/lts/pxelinux.0";
there is no comment symbol. This means that this thin client has a network card of the type PXE, so it must have an image when it starts up pxelinux.0. If it didn't have a PXE-network card, but instead a normal card that needs an Etherboot floppy, see Section 2.4, then it would need the start up image vmlinuz-2.4.19-ltsp-1

Another choice you can make for each single thin client in this file is to activate (that is, remove the comment symbol) at the beginning of


option option-128     e4:45:74:68:00:00;
option option-129     "NIC=3c509";
	  
if and only if you have a 3com509 ISA network card in your thin client.

8.7.5. Customising Thin Clients

In the file /opt/ltsp/i386/etc/lts.conf you have the possibility to specially customise each individual thin client. You can also make adaptations that cover all of the clients at once.

Here I want you to note that there is already a large document which describes how to set up thin clients ltsp.org Look in the documentation menu.

I have only mentioned the most important changes you can make in /opt/ltsp/i386/etc/lts.conf. I recommend that everyone should read the documentation that is found at http://www.ltsp.org

Notes

[1]

In earlier versions of Skolelinux/Debian-edu, before pr47, an older version of DHCP was used where the configuration files were placed under /etc/dhcpd-skolelinux.conf

[2]

In earlier versions of Skolelinux/Debian-edu, prior to pr47, an older version of DHCP was used. Then this script was found under /etc/init.d/dhcp restart