SDB:KIWI-LTSP quick start
tagline: From openSUSE
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
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
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.
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.
Please see KIWI-LTSP Troubleshooting