Cool Solution - Gather UCC Status information

From Univention Wiki

Revision as of 09:43, 7 April 2014 by Smidt (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-ucc-status allows to gather information about deployed UCC clients and be able to view them in the Univention Management Console. There is also the possibility to reuse the information in self-written scripts. An example for using univention-ucc-status is when UCC clients receive their IP Address from an external DHCP server, so their current IP Address is not visible in the Univention Management Console.

The following information is submitted by UCC clients:

  • Their current IP Address
  • The current image that is present on the local hard drive
  • The last time the local image has been updated
  • The last time a policy prompted the UCC client to update its software
  • The last time an UCC client reported its status to the server

The status information for an UCC client can be viewed on the 'Status' tab after selecting the client in the 'Computers' module.


On the UCC client the package univention-ucc-status has to be installed.

apt-get install univention-ucc-status

On the UCS server the package univention-ucc-status-integration has to be installed from the UCS Cool Solutions Repository

univention-install univention-ucc-status-integration

UCR configuration

An UCR variable can be set on UCC Clients via a policy to control to which URL the information should be reported to:

  • ucc/status/url URL the script univention-ucc-send-status uses to transmit information (default: http://[ldapmaster]/univention-ucc-status/

UCR variables can be set on the UCS System which control the cronjob that regularly updates the status information sent by UCC clients.

  • ucc/status/cron/update Activate the cronjob to update ucc status information (default: true)
  • ucc/status/cron Cronjob execution schedule (default every 30 minutes: */30 * * * *)

Technical background

The UCS package univention-ucc-status-integration installs a python-cgi script on the local webserver that is reachable at http://[hostname]/univention-ucc-status/ This script writes the transmitted information to a logfile. A cronjob checks the logfile and updates the LDAP with current values. The helper script univention-ucc-status-log-parser can be used to write scripts that want to use the logfile information for other tasks.

On an UCC client an upstart job gathers the client status information and sends them on each boot.

Known issues

Personal tools