Release Notes für die Inbetriebnahme und Aktualisierung von Univention Corporate Server (UCS) 5.2-5

Release Notes für die Inbetriebnahme und Aktualisierung von Univention Corporate Server (UCS) 5.2-5#

Veröffentlichungsdatum von UCS 5.2-5: 2026-03-10

Release-Highlights#

Mit Univention Corporate Server 5.2-5 steht das fünfte Patchlevel-Update für Univention Corporate Server 5.2 zur Verfügung. Es umfasst Funktionserweiterungen und Verbesserungen, neue Eigenschaften sowie diverse Detailverbesserungen und Fehlerkorrekturen. Die wichtigsten Änderungen im Überblick:

  • Die neue Provisioning API ist nun auf Univention Corporate Server verfügbar und bietet eine REST API, um über Änderungen an Benutzern, Gruppen und anderen Nubus-Objekten informiert zu werden. Bereits für Nubus auf Kubernetes entwickelte Integrationen können nun dieselbe API verwenden, um sich mit Nubus auf Univention Corporate Server zu integrieren.

  • Das Recycle Bin-Feature bietet verschiedene Verbesserungen und ist nun in die Active Directory-compatible Domain Controller und Active Directory Connection integriert. Eine Wiederherstellung in Univention Directory Manager, Active Directory-compatible Domain Controller oder Active Directory Connection stellt das Objekt nun korrekt in den anderen Verzeichnisdienst-Implementierungen wieder her.

Hinweise zum Update#

Testen Sie das Update vor der eigentlichen Aktualisierung in einer separaten Testumgebung, die mit Ihrer Produktionsumgebung identisch ist. Führen Sie das Update in einem Wartungsfenster durch, da einige Dienste in der Domäne möglicherweise vorübergehend nicht verfügbar sind.

Je nach Systemleistung, Netzwerkverbindung und installierter Software kann die Aktualisierung zwischen 30 Minuten und mehreren Stunden dauern. Für große Umgebungen konsultieren Sie bitte den UCS performance guide [1].

Aktualisierung mehrerer UCS-Systeme#

Beachten Sie in Umgebungen mit mehr als einem UCS-System die Update-Reihenfolge der UCS-Systeme.

Gleichzeitiger Betrieb von UCS und Debian auf UEFI Systemen#

Der gleichzeitige Betrieb von UCS und Debian GNU/Linux auf UEFI-Systemen wird seit UCS 5.0 nicht mehr unterstützt.

Ursache hierfür ist der Bootloader GRUB von Univention Corporate Server, der teilweise die gleichen Konfigurationsdateien wie Debian verwendet. Ein bereits installiertes Debian führt dazu, dass UCS nach der Installation von bzw. einem Update auf UCS 5.0 nicht (mehr) startet. Eine nachträgliche Installation von Debian wird ebenfalls dazu führen, dass UCS 5.0 nicht mehr startet. Mehr Informationen finden Sie unter KB 17768.

Weitere Informationen finden Sie in KB 17768.

Vorbereitung des Updates#

In diesem Abschnitt finden Sie wichtige Überlegungen vor dem Update.

Ausreichender Festplattenplatz#

Stellen Sie sicher, dass ausreichend Festplattenplatz verfügbar ist. Eine Standard-Installation benötigt mindestens 6-10 GB. Das Update benötigt zusätzlich 1-2 GB zum Herunterladen und Installieren von Paketen, je nach Größe Ihrer vorhandenen Installation.

Nutzung der Konsole für das Update#

Melden Sie sich für das Update auf der lokalen Konsole des Systems mit dem Benutzer root an und starten Sie das Update dort. Alternativ können Sie das Update über Univention Management Console durchführen.

Wenn Sie das Update über eine Netzwerkverbindung durchführen, ergreifen Sie Maßnahmen, um sicherzustellen, dass es bei einer Unterbrechung der Verbindung weiterläuft. Netzwerkunterbrechungen können das Update abbrechen, was das System erheblich beeinträchtigt.

Verwenden Sie Tools wie tmux, screen oder at, um das Update auch bei Netzwerkunterbrechungen durchführen zu lassen. Alle UCS-Systemrollen haben diese Tools standardmäßig installiert.

Skript zur Prüfung auf bekannte Update-Probleme#

Univention bietet ein Skript an, mit dem Probleme, die das Update des UCS Systems verhindern würden, schon vor dem Update erkannt werden können. Sie können das Skript vor dem Update manuell auf das System herunterladen und ausführen:

# 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
...

Nachbereitung des Updates#

Nach dem Update müssen Sie die neuen oder aktualisierten Join-Skripte ausführen. Sie können dafür entweder das UMC-Modul Domänenbeitritt verwenden oder durch Befehl univention-run-join-scripts als Benutzer root aufrufen.

Anschließend müssen Sie das UCS-System neu starten.

Hinweise zum Einsatz einzelner Pakete#

Die folgenden Abschnitte informieren über ausgewählte Pakete dieses Updates.

Erfassung von Nutzungsstatistiken#

Bei Verwendung der UCS Core Edition erfasst UCS anonyme Nutzungsstatistiken für Univention Management Console. Das System protokolliert, welche Module Sie öffnen, in einer Matomo-Instanz. Diese Statistiken helfen Univention, die Entwicklung von Univention Management Console basierend auf Kundenanforderungen zu verbessern.

Sie können den Lizenzstatus über den Menüeintrag Lizenz ‣ Lizenzinformationen im Benutzermenü in der oberen rechten Ecke von Univention Management Console überprüfen. Wenn die Lizenzinformationen unter Lizenztyp UCS Core Edition aufführen, nutzt Ihr UCS-System die UCS Core Edition.

UCS sammelt keine Nutzungsstatistiken, wenn Sie eine Enterprise Subscription-Lizenz wie UCS Base Subscription oder UCS Standard Subscription nutzen.

Unabhängig von Ihrer Lizenz können Sie die Erfassung von Nutzungsstatistiken deaktivieren, indem Sie die Univention Configuration Registry Variable umc/web/piwik auf false setzen.

Changelog#

Die Änderungen seit UCS 5.2-5 finden Sie in General.

Literaturverzeichnis#

[1] (1,2,3)

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

Auf dieser Seite