Home Wiki > SDB:KIWI-LTSP quick start
Sign up | Login

SDB:KIWI-LTSP quick start

tagline: From openSUSE

Tested on openSUSE Recommended articles Related articles

Icon-manual.png Icon-help.png
Here are the steps to get LTSP (Linux Terminal Server Project) running on openSUSE Edu Li-f-e distribution based on openSUSE 13.1 and 13.2.

Follow these simple steps to get LTSP running.

Minimum Useful Specs:

Pentium processor running at 2+ ghz, 32/64 bit 512MB+200MB RAM per client RAM on the server 2 NICS if internet sharing is required


Download openSUSE Edu Li-f-e, create live USB stick or DVD. Install it and create users for the terminals using YaST, one user per terminal is required.

On standard openSUSE distribution(not Li-f-e), install kiwi-ltsp-prebuilt package via 1-click installation.

Configure Network

Please configure network according to the instructions in the linked article about KIWI-LTSP network configuration.

Warning: DO NOT do the next step without doing the network setup as described.

Set up boot images

The image name since openSUSE 13.2 has been changed, so these steps are required to ensure proper booting of the clients if the symlink to the actual images are missing. Run the following commands in terminal as root.

  cd /srv/kiwi-ltsp
  ln -snf kiwi-ltsp-FULL-NAME.img i386.img
  cd /srv/tftpboot/boot/
  ln -snf initrd-kiwi-ltsp-FULL-NAME initrd-ltsp
  ln -snf initrd-netboot-FULL-NAME.kernel.* linux-ltsp

Replace image names with the actual name of the images in /srv/kiwi-ltsp and /srv/tftpboot/boot/ folders, for example

  cd /srv/kiwi-ltsp/
  ln -snf kiwi-ltsp-factory-i686-Build2.2.img i386.img
  cd /srv/tftpboot/boot/
  ln -snf initrd-kiwi-ltsp-factory-i686-Build2.2 initrd-ltsp
  ln -snf initrd-netboot-suse-13.2.i686-2.1.1.kernel.3.16.6-2-default linux-ltsp

Configure everything script

Run the following command in terminal as root to configure all services according to the network setup done previously.

kiwi-ltsp -c

Finally, disable booting in FATCLIENT mode.

 echo "LTSP_FATCLIENT=False" >> /srv/tftpboot/KIWI/root.default/etc/lts.conf

PXE booting PCs on the network should now get LTSP session from the server.

Disable LTSP server

To stop serving LTSP environment to the network disabling dhcpd is enough:

insserv -r dhcpd && rcdhcpd stop

Thin client configuration

Edit /srv/tftpboot/KIWI/root.default/etc/lts.conf as per your requirement. See man lts.conf after installing ltsp-docs package for variables that can be used.

Performance of thinclients can be improved by turning off encryption of X data, use the following variable to do that.

 echo "LDM_DIRECTX=True" >> /srv/tftpboot/KIWI/root.default/etc/lts.conf

See also