Differences between revisions 6 and 45 (spanning 39 versions)
Revision 6 as of 2005-07-13 23:47:26
Size: 3012
Editor: client49
Comment: link to LTSPHowTo
Revision 45 as of 2008-08-06 16:14:39
Size: 59
Editor: localhost
Comment: converted to 1.6 markup
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= Thin Client How-To =

'''NOTE:''' This software is currently in a '''pre-alpha''' state. This means that you probably won't be happy with it unless you enjoy helping to track down bugs. If you're looking for something production-ready, head over to the [ LTSP] site. There is a manual on this wiki - see ["LTSPHowTo"].

== Requirements ==

You will need:

 * An Ubuntu "breezy" system to be the server (the current development branch, to be released in October 2005)
 * At least one PXE-bootable system to be a client
 * A bunch of disk space
 * A fast network connection, or a local Breezy mirror, or some patience
 * A DHCP server which is capable of supporting PXE clients, or a separate network segment where you can run a dedicated DHCP server
 * Command-line familiarity
 * A sense of adventure
 * A burning desire to send feedback to [ ubuntu-devel]

== Getting Started ==

 1. Set up the DHCP server
  * If you have an existing DHCP server which can support PXE clients:
   * Configure it to pass a boot filename of `/ltsp/pxelinux.0` and a root path of `/opt/ltsp/i386`
   * For ISC DHCPD, use the following options: {{{
filename "/ltsp/pxelinux.0";
option root-path "/opt/ltsp/i386";
   * Install `ltsp-server` on the server: {{{sudo apt-get install ltsp-server
  * If you want to run a dedicated DHCP server on the thin client server:
   1. Install `ltsp-server-standalone` on the server: {{{sudo apt-get install ltsp-server-standalone
   1. Replace `/etc/dhcp3/dhcpd.conf` with the following contents, or adapt to your needs: {{{
subnet netmask {
  option domain-name-servers;
  option subnet-mask;
  filename "/ltsp/pxelinux.0";
  option root-path "/opt/ltsp/i386";
 1. Build the thin client runtime environment: {{{sudo ltsp-build-client
  * This script is hardcoded to use a particular Ubuntu mirror, so you may wish to edit it if you have a nearby mirror
 1. Check `/opt/ltsp/i386/etc/ssh/ssh_known_hosts` and ensure that your host key is associated with your host's IP address. Depending on your `/etc/hosts` configuration, this may not always be correct automatically (yet). If it looks like this: {{{
servername ssh-rsa AAAAB3NzaC1yc2EAAAABI...
}}} then add the IP address like this: {{{
servername, ssh-rsa AAAAB3NzaC1yc2EAAAABI...
 1. Optionally, create `/opt/ltsp/i386/etc/lts.conf`. If you don't create one, reasonable defaults and auto-detected values will be used.
 1. PXE boot the client and see what happens. If all goes well, you should see a (very ugly) graphical login dialog.
 1. Log in, with any user authorized to login remotely via ssh, and see what happens. If all goes well, you should get a working desktop session on the server.
 1. Send mail to [ ubuntu-devel] with your findings

ThinClientHowto (last edited 2008-08-06 16:14:39 by localhost)