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

SDB:KIWI-LTSP quick start

tagline: From openSUSE

Contents

Introduction

Welcome to openSUSE KIWI-LTSP quick start page, here you will find information that is meant to get you a working LTSP5 server on openSUSE. This guide is meant for users who would be implementing KIWI-LTSP for the first time with no prior Linux system administration knowledge.

The idea of using "prebuilt" image is that you do not require DVD media for the creation of LTSP images and no manual building of images is required.

Step One: Configure Network interface

See Network configuration for LTSP server

Step Two: Installing required packages

Note: Skip this step if you have openSUSE Edu Li-f-e DVD installed as all the required packages are already installed

Version: 11.3

Button-oci.png

or via commandline(following commands to be run in terminal as root "su -"):

 zypper ar -r http://r.opensu.se/server:ltsp.repo
 zypper in kiwi-ltsp-prebuilt

It is expected that minimum GNOME environment is installed on the server.

Step Three: Configuring the server

Note: Before doing this step, setup language and keyboard required on the server if you are not using the default(US).

Follow this link if you wish to use Easy-LTSP GUI to configure the server, otherwise continue below.

Make sure all the parameters are as per your network setup in /etc/sysconfig/kiwi-ltsp. The parameters that may need adjustment are: DHCP_RANGE, DHCP_SUBNET, DHCP_IFACE, SERVER_IP, NAME_SERVERS and GATEWAY. Run the following commands as root to configure everything using pre-built image:

kiwi-ltsp-setup -b #to backup current configuration           
kiwi-ltsp-setup -c


The above command will configure and start the following services, kiwi-ltsp-setup switch in the bracket:

  • DHCP server's /etc/dhcpd.conf (-d)
  • NFS server's /etc/exports (not really required as we are using NBD image) (-e)
  • Configures KIWI configuration in /srv/tftpboot/KIWI/config.default (-t)
  • Configures LTSP configuration in /srv/tftpboot/KIWI/lts.conf (-t)
  • Adds ssh keys of the server to client's ssh_known_hosts (-k)
  • Keeps backup of current configuration in /usr/share/kiwi/image/ltsp/suse-<version>/kiwi-backup->date>.tar.bz2 (-b)

Note: If you wish to configure each services individually, see kiwi-ltsp-setup -h. Default setup of kiwi-ltsp allows LTSP server to work seamlessly with existing dhcp server without any modifications, disabling of dhcp server is only needed if the existing dhcp server serves PXE/TFTP information too.

Advanced configuration information can be found here

Step Four: Post check

  • Read the output of kiwi-ltsp-setup -c, complete the "manual task" it suggests and fix any errors it mentions
  • Check status of all the required services, start them if they are not running already:
 rcdhcpd status
 rcsshd status
 rcxinetd status

Run kiwi-ltsp-setup -c after starting sshd for the very first time.

Step Five: PXE boot the clients

Go into the bios of the PC/laptop you wish to use as a thin client, enable onboard LAN bootrom, change boot sequence to boot from LAN first.

Boot up the client, you should now be able to log into the client with the usernames and passwords of the users created on the server. All the packages that are installed on the server would be available in the client session.

Troubleshooting

Please see KIWI-LTSP Troubleshooting

Further reading