ThinClientHowto

Differences between revisions 17 and 45 (spanning 28 versions)
Revision 17 as of 2005-10-17 06:21:46
Size: 3671
Editor: 82-44-187-227
Comment:
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 =

== Requirements ==

You will need:

 * An Ubuntu 5.10 system to be the server
 * 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 [mailto:ubuntu-devel@lists.debian.org ubuntu-devel]

== Getting Started ==

'''NOTE:''' If you plan to use the server as gateway/nat/firewall machine, it is strongly suggested to configure all the network interfaces before proceeding with the following steps.

 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. If necessary, customize `/etc/ltsp/dhcpd.conf` (by default it's configured for a server at 192.168.0.1 serving PXE clients)
   1. If you are running a firewall on the server, you'll need to open TFTP and NFS (and DHCP if you're running the standalone server). Also, make sure portmap isn't limited to the loopback interface in /etc/default/portmap (comment out the line with "-i 127.0.0.1". You also may want to edit `/etc/hosts.allow' and limit access for ''portmap'', ''rpc.mountd'', ''rpc.statd'', and ''in.tftpd'' to the local network: {{{portmap: 192.168.0.0/24
rpc.mountd: 192.168.0.0/24
rpc.statd: 192.168.0.0/24
in.tftpd: 192.168.0.0/24}}}
   1. Restart the nfs subsystem: {{{sudo invoke-rc.d nfs-kernel-server restart
sudo invoke-rc.d nfs-common restart
sudo invoke-rc.d portmap restart}}}
 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
  * If you changed your aptitude dependency-settings not to select recommended packages automatically, not all required packages will be downloaded and installed by this script. Then no login with sdm is possible for example because some parts of the x-server are missing
 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,192.168.0.1 ssh-rsa AAAAB3NzaC1yc2EAAAABI...
}}}
 AND file a bug in [http://bugzilla.ubuntu.com/ Bugzilla]. THIS SHOULD NOT HAPPEN.
 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 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 [mailto:ubuntu-devel@lists.ubuntu.com ubuntu-devel] with your findings

=== Extras ===

 1. ["ThinClientHowtoNAT"]
#REFRESH 0 http://help.ubuntu.com/community/ThinClientHowto

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