Cool Solution - Default pxe-rollout for unknown clients

From Univention Wiki

Jump to: navigation, search
Produktlogo UCC Version 1.0

Note: Cool Solutions are articles documenting additional functionality based on Univention products. 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.


The default way to initially rollout new clients in UCC is to register them in UMC with an IP address that is statically given by DHCP. The PXE configuration for the UCC is afterwards connected to this IP. All unknown clients (which means: clients which UCS doesn't know the IP or their IP is not related to an UCC object) will fall back to the default PXE configuration. In UCS, the default is to boot from a local device.

In some scenarios one might want to boot unknown clients also by PXE:

  • The DHCP services is no connected to UCS
  • DHCP is configured to give IP addresses from a given range

A typical goal is a "mass rollout" of clients in a defined "deploy subnet".

Recommended procedure

The default configuration for clients is stored in the file /var/lib/univention-client-boot/pxelinux.cfg/default. It's recommended to make a backup of this file, the default configuration is documented in #Examples.

To generate a new configuration the recommended way is to configure an example UCC object in UCC and copy the configuration file. The individual configuration files are generated also under "/var/lib/univention-client-boot/pxelinux.cfg/", using the "Hex" representation of their IP addresses. For example, the file for a client with IP "" will be named with its equivalent Hexadecimal value: "0ACA2316".

Within the PXE configuration file, UCC retrieves many initial settings which will be used during the rollout, like:

  • IP Address of the needed Servers (all per default set to the local UCS system)
    • Image-Server (NFS)
    • DNS Server
    • syslog Server
  • Name of the Image
  • further parameters given in UDM (like "force partitioning")

To use this configuration as default it only needs to be copiied, for example:

cp /var/lib/univention-client-boot/pxelinux.cfg/0ACA2316 \


default: boot from local harddisk

LABEL local

Rollout default UCC Thin Client image

The given Rollout Server in this example is "".


#Make sure this is all the same line:
APPEND root=/dev/nfs nfsroot= DNSSERVER= vga=788 initrd=ucc-1.0-rev2-thinclient-image.img.initrd keyboard=us locale=de_DE.UTF-8:UTF-8 timezone=Europe/Berlin syslog=y syslogserver= loglevel=0 splash boot=ucc ucc=rollout image=ucc-1.0-rev2-thinclient-image.img repartition=y force_partition_timeout=2 

     KERNEL ucc-1.0-rev2-thinclient-image.img.kernel
Personal tools