Child pages
  • LTSP - server setup and image administration
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 78 Next »

Most of the following commands request root permissions. Use the sudo command or become root to run them.

A great source of help:

Set the server


Configure the sources to use the cache of the server

#create /etc/apt/apt.conf if it does not exist and add following line

Acquire::http { Proxy ""; }
apt-get update

Change the hostname


/etc/hosts localhost server.bluelight.av server



/etc/init.d/hostname restart

hostname -f

#if not successful reboot...

Install and configure LTSP  

Install ltsp-server-standalone

 apt-get install ltsp-server-standalone

Edit the installation option of ltsp-build-client


# The chroot architecture. 
# Space separated list of programs to install. 
# The java plugin installation contained in ubuntu-restricted-extras 
# needs some special care, so let's use it as an example. 
# This is needed to answer "yes" to the Java EULA. 
# We'll create that file in the next step. 
# This uses the server apt cache to speed up downloading. 
# This locks the servers dpkg, so you can't use apt on 
# the server while building the chroot. 

Create and edit the following file for the unattented Java and msttcorefonts installation


# Do you agree with the DLJ license terms?
sun-java6-bin shared/accepted-sun-dlj-v1-1 boolean true
sun-java6-jre shared/accepted-sun-dlj-v1-1 boolean true
# In order to install this package, you must accept the license terms, the
# "TrueType core fonts for the Web EULA ". Not accepting will cancel the
# installation. Do you accept the EULA license terms?
ttf-mscorefonts-installer msttcorefonts/accepted-mscorefonts-eula boolean true

Build the client


#Various options can be set for the Fat Client. They can be set in the /var/lib/tftpboot/ltsp/i386/lts.conf file.

#Here is a list of the options that can be used:

#You don't need to build the client or update the image after changing an option

#You can use the fat chroot also to run thin clients, not only fat ones. This way you can have a mix of powerful and not powerful clients, that they will become "fat" or "thin" based upon their RAM (consider fat chroot a "superset" of a thin one, so thin boot uses only a small but common part of it).  The parameter that affects the RAM threshold is:


that defaults to 300 (MB).  So if you want your client boot as FAT ones only if they have more than 800MB edit lts.conf and put:


Another interesting feature is have a server's directory available to all the fat clients.  For instance, to have the fat clients mount as their own /srv the /srv of the server add this parameter:


Some other options can be set (example of lts.conf file in Deepanam School)

LDM_SESSION="gnome-session --session=ubuntu-2d"


Install and configure DHCP

Configure the interface

# Local-loop
auto lo
iface lo inet loopback
# Local interface
auto eth0
iface eth0 inet static

# Internet interface
auto eth1
iface eth1 inet static

Set up DHCP

cp /etc/ltsp/dhcpd.conf{,-origin}

# Default LTSP dhcpd.conf config file.
subnet netmask {
 option domain-name "bluelight.av";
 option domain-name-servers;
 option broadcast-address;
 option routers;
# next-server;
# get-lease-hostnames true;
 option subnet-mask;
 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";

sudo /etc/init.d/networking restart

sudo /etc/init.d/isc-dhcp-server restart


#If problems kill NetworkManager or even uninstall it as it interferes with the dhcp config.

killall NetworkManager


Install and configure LDAP

Follow the server installation from this guide: 


Install and configure NFS3

apt-get install nfs-kernel-server

#edit and add the following


#edit & set:  

 NEED_SVCGSSD=no # no is default

#edit & set:

 NEED_GSSD=no # no is default


Verbosity = 0
Pipefs-Directory = /var/lib/nfs/rpc_pipefs
Domain = bluelight.av
Nobody-User = nobody
Nobody-Group = nogroup

Finish the configuration by changing some permissions

#edit & add the following at the end of the file



nss_group=group: files ldap
nss_passwd=passwd: files ldap
nss_shadow=shadow: files ldap
nss_netgroup=netgroup: nis
pam_account=account sufficient
 account required
pam_auth=auth sufficient
 auth required nullok_secure use_first_pass
pam_password=password sufficient
 password required nullok obscure min=4 max=8 md5
pam_session=session required
 session required skel=/etc/skel/
 session optional
 session optional

auth-client-config -S > /etc/auth-client-config/profile.d/original

auth-client-config -p bl-ldap -a

#edit & add before "@include common-auth":

auth optional


The Basic Installation is done (smile)

Update the client

#The Fat Client doesn't need to be configured for ldap and NFS as it uses the parameters of the server for logging and nscd ot mount the associated folder.

Chroot in the system (from the server)

ltsp-chroot -c -p

Make the changes you need

#Like adding software, removing some, changing some configs...

Finalise the client

  • Exit the chroot


  • Update the kernel if needed


  • Update the image



Other useful things

Change password of a user

The changing of the password in Unity ( is not available on the Fat Client.

Autologin on specific clients

Edit /var/lib/tftpboot/ltsp/i386/lts.conf and add the following replacing the mac, password and username according to your needs. You can replace the mac address by the IP.


Recreate the i386 folder from the .img

Extract the valid image with:

mkdir /mnt/img
mount -o loop /opt/ltsp/images/i386.img /mnt/img/
mv /opt/ltsp/i386{,-old}
mkdir /opt/ltsp/i386
rsync -avz /mnt/img/* /opt/ltsp/i386/ 

Personalize the LDM theme

The LDM themes images are located in /opt/ltsp/i386/usr/share/ldm/themes/

  • Copy the original theme you want to modify or place one you downloaded
  • Modify as necessary
  • Create a link from default to the themes folder (or /etc/alternatives/ldm-theme, it is the default option but you will have to copy the contain of your theme folder there) or or use the following option in lts.conf:
    LDM_THEME = newthemedirectoryname (no need of the full path)


  • update the image (ltsp-update-image)

Alternate way to setup a Fat Client system



The client freeze when halting

This is due to a bug in LTSP

ltsp-chroot -m
update-rc.d -f halt remove
update-rc.d halt stop 90 0 .
  • No labels