Release notes for the installation and update of Univention Corporate Server (UCS) 5.2-5

Release notes for the installation and update of Univention Corporate Server (UCS) 5.2-5#

Publication date of UCS 5.2-5: 2026-03-10

Release highlights#

With Univention Corporate Server 5.2-5, the fourth patch level release for Univention Corporate Server 5.2 is available. It provides several feature improvements and extensions, properties, as well as bug fixes. Here is an overview of the most important changes:

  • The new Provisioning API is now available on Univention Corporate Server, offering a REST API to receive information about changes to users, groups, and other Nubus objects. Integrations implemented to work with Nubus on Kubernetes can now use the same API to integrate with Nubus on Univention Corporate Server.

  • The Recycle Bin feature provides various improvements and now integrates with the Active Directory-compatible Domain Controller and Active Directory Connection. A restore in Univention Directory Manager, Active Directory-compatible Domain Controller, or Active Directory Connection now correctly restores the object in the other directory service implementations.

Notes about the update#

Before updating, test the update in a separate test environment that’s identical to your production environment. Run the update in a maintenance window, because some services in the domain may be unavailable temporarily.

The update can take anywhere from 30 minutes to several hours, depending on system performance, network connection, and installed software. For large environments, consult UCS performance guide [1].

Updating multiple UCS systems#

In environments with multiple UCS systems, follow the update sequence described below.

Simultaneous operation of UCS and Debian on UEFI systems#

Simultaneous operation of UCS and Debian GNU/Linux on UEFI systems isn’t supported in UCS 5.0 and later.

The GRUB boot loader of Univention Corporate Server uses the same configuration files as Debian. If Debian is already installed, UCS can’t boot after you install or update to UCS 5.0. Conversely, installing Debian after UCS 5.0 prevents UCS from booting.

For more information, refer to KB 17768.

Prepare for update#

This section covers important considerations before you update.

Sufficient disk space#

Ensure you have sufficient disk space available for the update. A standard installation requires a minimum of 6-10 GB. The update process requires an additional 1-2 GB to download and install packages, depending on your existing installation size.

Console usage for update#

Sign in to the system’s local console as root and run the update. Alternatively, you can run the update using Univention Management Console.

If you run the update over a network connection, take steps to ensure it continues if the connection is interrupted. Network interruptions can cancel the update, which severely affects the system.

Use tools like tmux, screen, or at to keep the update running through network interruptions. All UCS system roles have these tools installed by default.

Script to check for known update issues#

Univention provides a script that checks for problems that could prevent a successful update. You can download the script before the update and run it on the UCS system.

# download
$ curl -OOf https://updates.software-univention.de/download/univention-update-checks/pre-update-checks-5.2-5{.gpg,}

# verify and run script
$ apt-key verify pre-update-checks-5.2-5{.gpg,} && bash pre-update-checks-5.2-5

...

Starting pre-update checks ...

Checking app_appliance ...                        OK
Checking block_update_of_NT_DC ...                OK
Checking cyrus_integration ...                    OK
Checking disk_space ...                           OK
Checking hold_packages ...                        OK
Checking ldap_connection ...                      OK
Checking ldap_schema ...                          OK
...

Post processing of the update#

After the update, run new or updated join scripts. Use either the UMC module Domain join or run univention-run-join-scripts as root.

Then restart the UCS system.

Notes on selected packages#

The following sections cover selected packages for this update.

Collection of usage statistics#

When using UCS Core Edition, UCS collects anonymous usage statistics for Univention Management Console. The system logs which modules you open to a Matomo instance. These statistics help Univention improve Univention Management Console development based on customer needs.

You can verify the license status through the menu entry License ‣ License information in the user menu in the upper right corner of Univention Management Console. If the License information lists UCS Core Edition under License type, your UCS system is using UCS Core Edition.

UCS doesn’t collect usage statistics if you use an Enterprise Subscription license such as UCS Base Subscription or UCS Standard Subscription.

To deactivate usage statistics collection, set the Univention Configuration Registry Variable umc/web/piwik to false.

Changelog#

You find the changes since UCS 5.2-5 in General.

Bibliography#

[1]

UCS performance guide. Univention GmbH, 2021. URL: https://docs.software-univention.de/ext-performance/5.2/en/.

On this page