Cool Solution - Building UCC images

From Univention Wiki

Revision as of 14:13, 5 September 2016 by Hpeter (talk | contribs)
Jump to: navigation, search
Produktlogo UCS Version 3.2
Produktlogo UCC Version 1.0

Note: Cool Solutions are articles documenting additional functionality based on Univention products. Packages provided by a Cool Solutions Repository are built by Univention, but will not be maintained. Not all of the shown steps in the article are covered by Univention Support. For questions about your support coverage contact your contact person at Univention before you want to implement one of the shown steps.

Also regard the legal notes at Terms of Service.


Univention Corporate Client (UCC) is a solution for the operation and administration of PCs, Notebooks and Thin Clients. A client, whether it is a normal desktop or a thin client, is typically deployed via images, that are generated with the image-toolkit utility, part of the UCC system.

Univention provides two preconfigured images: a small image for thin clients and a larger image for native desktop installations. Both images are described in the next section.

If space requirements are important, then the creation of a custom image is needed. The ucc-image-toolkit package provides the utilities for image generation.

See also UCC Manual - Chapter 8.

Description of default images

The two configuration files used to generate the official UCC images are located in:

  • Desktop image: /usr/share/doc/ucc-image-toolkit/example/ucc-desktop.cfg
  • Thin client image: /usr/share/doc/ucc-image-toolkit/example/ucc-thinclient.cfg

(Available if ucc-image-toolkit is installed)

- See UCC Manual for a description of main parameters

Desktop image

The desktop client image offers a KDE Plasma desktop and support for terminal sessions on Windows and UCC terminal servers (support for Citrix XenApp can be subsequently installed).

Desktops and laptops are assumed to have enough disk space. Compared with the image of thin clients, the default desktop image is large (15 GB, in version 1.0-Rev2).

Besides the packages for the base system, the following tools and programs are installed by default in the UCC desktop image.

Important packages

In this list, sizes for certain group of packages are shown (bear in mind that such sizes could change if the order of installation is changed and dependencies were met before by another package).

Integration with the UCC domain, always required:

univention-ucc-theme
univention-corporate-client (~20MB)

Desktop package groups:

kubuntu-full -lirc (~3.3GB)
univention-lightdm (~176MB)
language packs-* (en/de/fr/es/nl) (around 10MB/each)

Remote connection:

openssh-server (~4MB)
freerdp-x11 (<1MB)
univention-ucc-session-ucc (<1MB)
univention-ucc-session-firefox (53MB)
univention-ucc-session-rdp (4MB)

Java RE:

default-jre (~40MB)

Adobe Flash support:

adobe-flashplugin (~7MB)
gstreamer0.10-ffmpeg (~21MB)
gstreamer0.10-fluendo-mp3(<1MB)

Partition Scheme

Basically, the configuration file creates three partitions with filesystem system:

/boot - 500 MB
/root - 1800 MB
/home - expand

A swap partition with 512MB is created, as well as a small EFI bios partition of 50 MB.

Thin client image

The thin client image offers a minimal LXDE desktop and support for terminal sessions on Windows and UCC terminal servers. Thin clients which are to be operated with this image must be equipped with at least 2 GB of local disk space (e.g., CompactFlash or SSD).

The default thin client image uses a smaller amount of storage (1.2 GB in version 1.0-rev2).

Only base-system software is installed with the required dependencies, the rest of the packages are installed with the option --no-install-recommends.

Important packages

Integration with the UCC domain, always required:

univention-ucc-theme
univention-corporate-client (~17MB)

Input devices

xserver-xorg-input-mouse (~7MB)
xserver-xorg-input-kbd (<1MB)
xserver-xorg-input-synaptics (<1MB)

Desktop Environment

network-manager-gnome (~10MB)
univention-lightdm (~100MB)
univention-ucc-lxde (~28MB)


Audio and video servers

pulseaudio (~8MB)
xserver-xorg (<1MB)
xserver-xorg-video-* (each driver <1MB, xserver-xorg-video-all ~4MB, *-vmware ~22MB)
gnome-icon-theme (~32MB)

Remote connection and other specific tools

freerdp-x11 (~1MB)
openssh-server (~4MB)
language-pack-de (~11MB)
univention-ucc-session-firefox (~53MB incl. firefox)
univention-ucc-session-rdp (~4MB)
remmina-plugin-rdp (<1MB)
univention-ucc-session-ucc-remote (<1MB)
xterm (~2MB)
firefox-locale-de (<1MB)

Partition scheme

For the thin client system two file system partitions are created:

/boot - 100MB 
/root - expand

A small EFI partition of 10MB is still created. No swap partition is considered.

How to reduce image size?

The configuration file for the thinclient image already installs most of the packages under the packages_no_recommends (apt-get -no-install-recommends) option. But there are other ways that can save you some extra space:


  • Not installing a desktop environment
  • If you know the video card of your device, you can install only the driver for that family of videocards (For example, you can especify only xserver-xorg-video-openchrome for VIA cards)
  • /boot can be reduced to ~45MB, (that's usually enough for one kernel). If this is done, kernel updates should be performed manually every time from then on (by generating the image every time).
  • If no especial requirements, 2MB should also be enough for the GPT partition
  • xserver-xorg-input-synaptics is not needed if your device doesn't have a touchpad
  • You can take out any additional language package and use English



See also

Personal tools