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

Veröffentlichungsdatum von UCS 5.0-8: 2024-06-11

Release-Highlights#

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

  • Mit dem Release von Univention Nubus erhält UCS Updates für Icons und Logos für Univention Produkte. Die entsprechenden Komponenten innerhalb von Univention Corporate Server erhalten ein visuelles Update, das ihre Zugehörigkeit zu Univention Nubus Identity and Access Management deutlich macht.

  • In Vorbereitung auf UCS 5.2 erhält das Repository einen eigenen Schlüssel für die Signatur.

  • Apps, die über den Univention Directory Listener Mechanismus bereitgestellt werden, verarbeiten eingehende Änderungen über eine dateibasierte Warteschlange. Mit dem Update auf 5.0-8 ist es nun möglich, den aktuellen Status der Warteschlange zu überwachen, um mögliche Verarbeitungsfehler durch Systemdiagnosen zu identifizieren und zu diagnostizieren.

  • Der RADIUS Server unterstützt jetzt verschiedene MAC-Adressformate für die Funktion MAB (MAC Authentication Bypass).

  • Verbesserte Stabilität und Performance in UMC beim Verarbeiten simultaner Anmeldungen.

  • UCS 5.0-8 integriert diverse Security Updates, zum Beispiel für BIND9, docker, OpenJDK-11, PHP und den Linux Kernel.

Hinweise zum Update#

Führen Sie das Update in einem Wartungsfenster durch, da einige Dienste in der Domäne möglicherweise vorübergehend nicht verfügbar sind. Es wird empfohlen, die Aktualisierung in einer separaten Testumgebung zu testen, bevor Sie die eigentliche Aktualisierung durchführen. Die Testumgebung muss mit der Produktionsumgebung identisch sein.

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

UCS nur noch als 64-Bit-Variante#

UCS 5 ist nur für die x86 64 Bit Architektur amd64 verfügbar. Bestehende 32-Bit UCS-Systeme können nicht auf UCS 5 aktualisiert werden.

Gleichzeitiger Betrieb von UCS und Debian auf UEFI Systemen#

Beginnend mit UCS 5.0 wird ein gleichzeitiger Betrieb von UCS und Debian GNU/Linux auf einem UEFI System nicht 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.

Lokales Paket Repository#

Dieser Abschnitt ist relevant für Umgebungen mit einem local repository. Die installierte Hauptversion von UCS bestimmt, welche Pakete ein lokales Repository bereitstellt. Ein Repository, das auf einem UCS-Server mit Version 4.x läuft, stellt nur Pakete bis UCS 4.x zur Verfügung, ein Repository-Server, der auf UCS 5 läuft, nur Pakete für UCS 5 und höher.

Um in einer Umgebung mit lokalem Repository Systeme auf UCS 5 zu aktualisieren, bestehen unter anderem die folgenden Möglichkeiten. Zunächst muss ein lokaler UCS 5 Repository Server aufgesetzt werden.

  • Installieren Sie ein neues UCS 5 System als Primary Directory Node von der DVD oder aus einem virtualisierten Basisimage. Anschließend richten Sie auf diesem System ein lokales Repository ein, wie in UCS Handbuch [2] beschrieben.

  • Installieren Sie ein neues UCS 5 System in der Systemrolle Backup Directory Node, Replica Directory Node oder Managed Node von der DVD oder aus einem virtualisierten Basisimage. Wählen Sie im System-Setup aus, dass das System keiner Domäne beitritt. Richten Sie anschließend auf diesem System ein lokales Repository ein, wie in UCS Handbuch [2] beschrieben. Nachdem Sie den Primary Directory Node auf UCS 5 aktualisiert haben, der in der Domäne verwendet wird, kann der UCS 5 Repository Server der Domäne über univention-join beitreten.

Um ein System in der Domäne auf UCS 5 zu aktualisieren, aktualisieren Sie es zuerst auf den aktuellsten Paketstand unter UCS 4.x. Setzen Sie anschließend den vom System verwendeten Repository Server durch das Ändern der Univention Configuration Registry Variable repository/online/server auf das lokale UCS 5 Repository. Das System kann nun über die Univention Management Console oder über die Kommandozeile auf UCS 5 aktualisiert werden.

Vorbereitung des Updates#

In diesem Abschnitt finden Sie weitere Informationen, die Sie vor der Aktualisierung beachten müssen.

Python 3.7 Kompatibilität#

Überprüfen Sie vor der Aktualisierung manuell erstellten Python-Code auf Kompatibilität mit Python 3.7 und passen Sie ihn entsprechend an. Dies gilt auch für Univention Configuration Registry Vorlagen, die Python-Code enthalten. Angepasste AD-Connector Mapping Vorlagen sind ein Beispiel dafür. Für Ratschläge, siehe auch die Univention Developer Reference [3].

AD Connector Mapping#

Wenn Sie mehrere Instanzen des AD Connector betreiben, wie in Synchronization of several Active Directory domains with one UCS directory service beschrieben, müssen Sie die Mapping-Konfiguration anpassen. Außerdem müssen Sie die Kompatibilität mit Python 3.7 vor dem Update sicher stellen. KB 17754 beschreibt die Schritte.

Ausreichender Festplattenplatz#

Prüfen Sie auch, ob ausreichend Festplattenplatz verfügbar ist. Eine Standard-Installation benötigt mindestens 6-10 GB Speicherplatz. Das Update benötigt je nach Umfang der vorhandenen Installation ungefähr 1-2 GB zusätzlichen Speicherplatz zum Herunterladen und Installieren der Pakete.

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 möchten oder müssen, stellen Sie sicher, dass das Update im Fall einer Unterbrechung der Netzwerkverbindung weiterläuft. Unterbrechungen der Netzwerkverbindung können den Aktualisierungsvorgang abbrechen, den Sie über eine entfernte Verbindung ausgelöst haben. Ein unterbrochener Aktualisierungsvorgang kann Ihr System ernsthaft beeinträchtigen. Damit das Update auch bei einer unterbrochenen Netzwerkverbindung weiterläuft, verwenden Sie beispielsweise Werkzeuge wie tmux, screen oder at einsetzen. Sie sind auf allen UCS Systemrollen 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.0-8{.gpg,}

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

...

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 einige ausgewählte Pakete im Zusammenhang mit dem Update.

Erfassung von Nutzungsstatistiken#

Mit der UCS Core Edition werden anonyme Nutzungsstatistiken zur Verwendung von Univention Management Console erzeugt. Die aufgerufenen Module werden dabei von einer Instanz des Web-Traffic-Analyse-Tools Matomo protokolliert. Nutzungsstatistiken ermögliche es Univention die Entwicklung von Univention Management Console besser auf das Kundeninteresse zuzuschneiden und Usability-Verbesserungen vorzunehmen.

Sie können den Lizenzstatus über den Menüeintrag Lizenz ‣ Lizenzinformationen des Benutzermenüs in der oberen rechten Ecke von Univention Management Console überprüfen. Ihr UCS-System ist ein UCS Core Edition-System, wenn unter Lizenzinformationen unter Lizenztyp UCS Core Edition aufgeführt ist.

UCS sammelt keine Nutzungsstatistiken, wenn Sie eine Enterprise Subskription wie UCS Base Subscription oder UCS Standard Subscription verwenden.

Unabhängig von der verwendeten Lizenz, können Sie die Sammlung von Nutzungsstatistiken durch Setzen der Univention Configuration Registry Variable umc/web/piwik auf false deaktivieren.

Changelog#

Die Änderungen seit UCS 5.0-7 finden Sie in Changelog for Univention Corporate Server (UCS) 5.0-8.

Literaturverzeichnis#

[1] (1,2,3)

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

[2] (1,2,3,4,5,6)

UCS Handbuch. Univention GmbH, 2021. URL: https://docs.software-univention.de/manual/5.0/de/.

[3] (1,2,3)

Univention Developer Reference. Univention GmbH, 2021. URL: https://docs.software-univention.de/developer-reference/5.0/en/index.html.