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

Veröffentlichungsdatum von UCS 5.0-6: 2023-12-12

Release-Highlights#

Mit Univention Corporate Server 5.0-6 steht das sechste 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:

  • Das Univention Management Console Diagnose-Modul wurde an mehreren Stellen verbessert.

  • Univention Corporate Server wurde an mehreren Stellen auf das Update auf Univention Corporate Server 5.2 vorbereitet.

  • Der Mechanismus für das Sichern von Dateien von Samba ist verbessert worden.

  • UCS 5.0-6 integriert diverse Security Updates, zum Beispiel für PostgreSQL, OpenJDK-11, GRUB2 und Python3.7.

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 wird nur noch für 64-Bit-Architekturen bereitgestellt. Vorhandene 32-Bit UCS Systeme können nicht auf UCS 5 aktualisieren.

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 für Umgebungen mit einem lokalen Repository relevant. Die installierte (Major-)Version von UCS bestimmt, welche Pakete ein lokales Repository bereitstellt. Ein Repository, das auf einem UCS Server in Version 4.x betrieben wird, stellt nur Pakete bis zur Version UCS 4.x bereit. Ein Repository auf einem UCS 5 Server stellt nur Pakete für UCS 5 und neuere Versionen bereit.

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#

Bevor Sie aktualisieren, prüfen Sie manuell erstellten Python-Programmcode auf Kompatibilität mit Python 3.7 und passen Sie ihn entsprechend an. Das betrifft auch Univention Configuration Registry Templates, die Python-Code enthalten. Angepasste Univention AD Connector Mapping Templates sind ein Beispiel. In der Univention Developer Reference [3] finden sich weitere Hinweise.

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-6{.gpg,}

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

...

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-5 finden Sie in Changelog for Univention Corporate Server (UCS) 5.0-6.

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.