Problem:UCS Upgrade blocked due to Opsi

Knowledge Base Community
, , , , ,
1

UCS Upgrade blocked due to Opsi Application Component

Problem:

When attempting to upgrade a UCS 5.0-10 system to the next minor release (e.g., UCS 5.2), the upgrade may be blocked if the Opsi application is installed. The system may report that the upgrade is not available due to a required component being marked as incompatible or missing meta information.

Environment

  • UCS Version: 5.0-10 errata1300

  • Installed Applications:

    • opsi=4.3.0.50-ucs5
    • Additional apps: cups, dhcp-server, radius, samba4, squid, ucsschool, ucsschool-veyon-proxy

  • Upgrade Path: UCS 5.0-10 → UCS 5.1 → UCS 5.2

  • Error Triggered During:

    univention-upgrade --ignoressh --ignoreterm --check

Issue Description

When checking for available UCS release upgrades, the system returns:

Checking for release updates: The update to UCS 5.1-0 is blocked because the component 'opsi_20250604391845' is marked as required.
No update available.

This indicates that the installed Opsi component is blocking the upgrade due to missing or outdated meta information for the next UCS version.

The pre-update check for UCS 5.2 passes without any issues, confirming that the system itself is otherwise prepared for the upgrade.

Root Cause

The upgrade was blocked due to:

As a result, Univention’s upgrade process halts to prevent system inconsistency or potential incompatibility.

Solution

Opsi has updated the app and fixed the issue.

:warning: Note: The required versions:
5.0-x → 4.3.0.51-ucs5
5.1 → 4.3.0.51-ucs51
5.2-x → 4.3.0.51-ucs52

To resolve the issue and proceed with the UCS upgrade:

Step 1: Update the App Center Metadata

Ensure the system has the latest metadata from the App Center:

univention-app update

Step 2: Upgrade the Opsi Application

Upgrade the Opsi app to the latest available version compatible with UCS 5.1:

univention-app upgrade opsi

Step 3: Upgrade UCS to the next Version

Once the Opsi app has been successfully upgraded, proceed with the UCS system upgrade:

univention-upgrade --ignoressh --ignoreterm