Menu

Customizing Image

CyberOrg

The image can be used as Fatclient by adding more softwares and desktop environments. To use the image for fat client add LTSP_FATCLIENT=True to /srv/tftpboot/KIWI/root.default/etc/lts.conf.

For FATCLIENT the packages have to be installed in the image via the method below. If you are looking to use the applications installed on the server on the client as FATCLIENT, try LTSP-PNP on Ubuntu.

To add more softwares to the image

In this example the profile is named i386, change the profile name as per your installation.

kiwi-ltsp --list-profiles
kiwi-ltsp --unpack-image i386
kiwi-ltsp --chroot i386
zypper sl #lists configured repositories
zypper ref
zypper install packagename (or use yast2 sw_single after 'zypper in yast2-packager')
exit

It is recommended that default profile be cloned and modifications be made in that clone, like the below example

kiwi-ltsp --clone i386 yourclone
cp /srv/kiwi-ltsp/i386.img /srv/kiwi-ltsp/yourclone.img
kiwi-ltsp --unpack-image yourclone
kiwi-ltsp --chroot yourclone
zypper ref
...and so on...
kiwi-ltsp -t #to add yourclone to boot menu

If additional repositories are needed for packages not available in pre-configured repositories then use repositories available for Tumbleweed (NOT any other openSUSE versions).

Any customization done while chrooted in the image will reflect in the client. Light weight desktops such as Xfce or LXDE would work best if you want to create a fat-client image.

If the image is already compressed btrfs skip the step below, you can reboot the client to test your changes.

Rebuild the image and restart vbladed after the following command completes

Make sure you have exited the chroot cleanly, and all the bind mounts(dev, proc, sys etc.) inside the chroot are umounted.

Once satisfied with all the changes to the chroot, run the following commands to rebuild the image:

kiwi-ltsp -l2 i386 #or kiwi-ltsp -l2 yourclone
rcklaoe restart

The image will be built as compressed btrfs, if you wish you can change it back to build squashfs by changing IMAGEFSTYPE variable in /etc/sysconfig/kiwi-ltsp before running kiwi-ltsp -l2.

Your clone will appear in boot menu, once satisfied you can simply copy your clone image over the default image:

cp /srv/kiwi-ltsp/yourclone.img /srv/kiwi-ltsp/i386.img
rcklaoe restart

Customization without image modification

Lot of customization to the client can be done without any modification to the image, both kiwi and LTSP provide ways to achieve this.

LTSP way: lts.conf

Install ltsp-docs package, "man lts.conf" to find out various parameters that can be set there. The lts.conf file is located here: /srv/tftpboot/KIWI/root.default/etc/lts.conf, it is downloaded by clients at boot time.

Kiwi way

Everything under /srv/tftpboot/KIWI/root.default folder is transferred to the client in the path created under it. Any file modification requires running of "kiwi-ltsp -t" to update /srv/tftpboot/KIWI/config.default file.


Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.