Vorbereitungen

Zuletzt geändert von Michael Salm am 2026/10/13 08:31

Hinweis

Erfolg

Es ist sinnvoll, alle veränderten Systeme - insbesondere Server und opsi-Server - vorher zu sichern: Anleitung zum Backup und Restore

Warnung

Wenn Sie die Gruppenrichtlinien-Aktualisierung für Windows 11 25H2 noch nicht durchgeführt haben, müssen Sie vor dem Upgrade diese Aktualisierung durchführen. Eine Anleitung ist unter Update Clients auf Windows 11 25H2 | Gruppenrichtlinien aktualisieren zu finden.

VM Firewall pfSense

Warnung

Bitte beachten Sie, dass eine Neuinstallation der pfSense in Frage kommen kann, insbesondere falls eine Version älter als 2.5.0 installiert ist.

Warnung

Die pfSense-VM sollte mindestens 2 GB RAM haben.

Möglicherweise haben Sie eine noch ältere Version der pfSense im Einsatz.

Wir empfehlen dringend diese auf die aktuelle Version zu aktualisieren.

  1. Öffnen Sie die Weboberfläche der Firewall: https://firewall.paedml-linux.lokal.
  2. Melden Sie sich als admin an.
  3. Wenn ein Update zur Verfügung steht, klicken Sie auf das Wolken-Symbol.
    Falls nicht Version 2.8.1-RELEASE installiert ist und kein Update angezeigt wird, klicken Sie erneut auf das Aktualisieren-Symbol.
Version pfSense Update 2.8.1 verfügbar

pfSense-Update 2.8.1 ist vorhanden

Stellen Sie den Branch um auf "Previous Stable Version (v2.8.1). Klicken Sie dann auf Bestätigen, um das neue Update einzuspielen.

pfSense Update Branch 2.8.1 auswählen und bestätigen

pfSense Update 2.8.1 bestätigen

Führen Sie nun das nächste Update durch.

  1. Wenn ein Update zur Verfügung steht, klicken Sie auf das Wolken-Symbol.
    Falls nicht Version 2.9.0-RELEASE installiert ist und kein Update angezeigt wird, klicken Sie erneut auf das Aktualisieren-Symbol.
Version pfSense Update 2.9.0 verfügbar

pfSense-Update 2.9.0 ist vorhanden

Stellen Sie den Branch um auf "Current Stable Version (v2.9.0). Klicken Sie dann auf Bestätigen, um das neue Update einzuspielen.

pfSense Update Branch 2.9.0 auswählen und bestätigen

pfSense Update 2.9.0 bestätigen

Prüfen Sie nach dem Neustart der Firewall erneut, ob evtl. noch weitere Updates verfügbar sind und installieren Sie diese, wie oben beschrieben.

VM Server

Warnung

Die Server-VM sollte mindestens 8 GB RAM (ggf. mehr) haben.

Für das Upgrade werden auf dem Root-Dateisystem („/“) mind. 10 GB freier Speicherplatz benötigt.

Überprüfen des Versionsstands

Melden Sie sich an der Konsole der Server-VM mit root an.

Sie können den aktuellen Versionsstand überprüfen mit:

bash
univention-app info
Versionsstand Server

Die UCS-Version des paed.ML Servers ist aktuell.

Sollte die Installation nicht aktuell sein (mind. UCS 5.0-10 errata1482), führen Sie bitte den Befehl

bash
univention-upgrade --updateto=5.0-99

an der Konsole der Server-VM aus.

Außerdem müssen die UCS-Pakete lmz-settings-master in Version 5.1.2-2 oder höher und
lmz-initial-setup in Version 5.2.1-2 oder höher vorliegen. Die Pakete werden mit dem o.g. Befehl auf den aktuellen Stand gebracht.

Warnung

Die Überprüfung der installierten Apps sollte nicht übersprungen werden, da es sonst zu einem Abbruch während des Upgrades kommt.

Prüfen Sie außerdem, ob die folgenden Apps installiert sind (vgl. Screenshot oben):

App NameVersion (oder höher)
admin-dashboard5.0
admindiary-backend1.0
admindiary-frontend1.0
prometheus-node-exporter2.0.1

Sollte eine oder mehrere dieser vier Apps fehlen, so können mit dem Befehl

bash
univention-app install <name>

installiert werden. Ersetzen Sie dabei <name> durch den App Namen aus der Tabelle.

Die App admin-dashboard installiert automatisch die App prometheus-node-exporter mit.

Geben Sie bei Passwort-Rückfragen das Passwort des Domänen-Administrators ein und drücken Sie die Enter-Taste.
Bestätigen Sie andere Rückfragen mit "y" und der Enter-Taste.

Sollten andere als diese vier Apps fehlen, so installieren Sie diese bitte nicht und nehmen Sie Kontakt mit dem paed.ML Support auf.

Überprüfen des freien Speicherplatzes

Melden Sie sich an der Konsole der Server-VM mit root an.

Sie können den aktuellen Speicherplatz überprüfen mit:

bash
df -h -t ext4
Speicherplatz Server

Es ist genügend Speicherplatz vorhanden.

Sollte nicht genügend freier Speicherplatz (siehe Spalte "Verf." in der Ausgabe des Befehls) – 10 GB oder mehr – vorhanden sein, so muss die Festplatte vergrößert werden (siehe Kapitel Erweiterungen im Bereich Installation).

Erfassung der statischen Routen

Melden Sie sich an der Konsole der Server-VM mit root an.

Listen Sie die in der Univention Configuration Registry definierten statischen Routen auf:

bash
ucr dump | grep interfaces/eth0/route
ucr Befehl zur Anzeige der statischen Routen des Servers

Die im Auslieferungszustand definierten statischen Routen

Notieren Sie sich die Ausgabe - nach dem Update müssen diese Routen wieder eingetragen werden.

Passwort des Benutzers "domadmin"

Warnung

Das Passwort des Benutzers domadmin muss für das Upgrade identisch sein mit dem Passwort des Benutzers Administrator - ansonsten kommt es während des Upgradevorgang zu Abbrüchen.

Sollte das Passwort des Benutzers domadmin auf Ihrem System nicht identisch sein mit dem Passwort des Benutzers Administrator, so ändern Sie bitte das Passwort von domadmin.

Melden Sie sich an der Konsole der Server-VM mit root an.

Ändern Sie nun das Passwort des Benutzers domadmin mit dem Befehl:

bash
lmz-initial-setup --domadmin

Verwenden Sie als Passwort das Passwort des Benutzers Administrator.

VM OPSI-Server

Warnung

Die opsi-Server-VM sollte mindestens 8 GB RAM (ggf. mehr) haben.

Für das Upgrade werden auf dem Root-Dateisystem („/“) mind. 10 GB freier Speicherplatz benötigt.

Warnung

Wenn Sie OPSI noch nicht auf Version 4.3 aktualisiert haben, müssen Sie vor dem Upgrade diese Aktualisierung durchführen. Eine Anleitung für das OPSI 4.3-Upgrade ist unter Upgrade auf OPSI 4.3 zu finden.

Warnung

Stellen Sie sicher, dass eine gültige OPSI-Lizenz für das aktuelle Jahr installiert ist.

Überprüfen des Versionsstands

Melden Sie sich an der Konsole der OPSI-Server-VM mit root an.

Sie können den aktuellen Versionsstand überprüfen mit:

bash
univention-app info
Versionsstand opsi-Server

 Die UCS-Version des paed.ML OPSI-Servers ist aktuell.

Sollte die Installation nicht aktuell sein (mind. UCS 5.0-10 errata1482), führen Sie bitte den Befehl

bash
univention-upgrade --updateto=5.0-99

an der Konsole der OPSI-Server-VM aus.

Außerdem muss das UCS-Paket lmz-settings-backup in Version 5.1.2-2 oder höher vorliegen. Das Paket wird mit dem o.g. Befehl auf den aktuellen Stand gebracht.

Warnung

Die Überprüfung der installierten Apps sollte nicht übersprüngen werden, da es sonst zu einem Abbruch während des Upgrades kommt.

Prüfen Sie außerdem, ob die folgenden Apps installiert sind (vgl. Screenshot oben):

App NameVersion (oder höher)
prometheus-node-exporter2.0.1

Sollte diese App fehlen, so kann mit dem Befehl

bash
univention-app install prometheus-node-exporter

installiert werden.

Geben Sie bei Passwort-Rückfragen das Passwort des Domänen-Administrators ein und drücken Sie die Enter-Taste.

Sollten andere Apps fehlen, so installieren Sie diese bitte nicht und nehmen Sie Kontakt mit dem paed.ML Support auf.

Überprüfen des freien Speicherplatzes

Melden Sie sich an der Konsole der OPSI-Server-VM mit root an.

Sie können den aktuellen Speicherplatz überprüfen mit:

bash
df -h -t ext4
Speicherplatz opsi-Server

Es ist genügend Speicherplatz vorhanden.

Sollte nicht genügend freier Speicherplatz (siehe Spalte "Verf." in der Ausgabe des Befehls) – 10 GB oder mehr – vorhanden sein, so muss die Festplatte vergrößert werden (siehe Kapitel 13.2 im Installationshandbuch).

Erfolg

Um Speicherplatz freizugeben, können Sie nicht benötigte Daten im Ordner \\backup\opsi_workbench löschen.
Auf der Konsole finden Sie diese Daten unter /var/lib/opsi/workbench.

Überprüfen Sie auch die Daten unter /home/opsiproducts ​​​​​(der früherer Workbench-Pfad) und löschen Sie nicht benötigte Daten bzw. verschieben Sie diese nach /var/lib/opsi/workbench.

 

Überprüfen der OPSI-Version

Sie können die OPSI-Version überprüfen im Configed im Menüpunkt Hilfe.

Installierte OPSI Version im Configed

OPSI Version 4.3 ist installiert.

Sollte OPSI nicht in Version 4.3 installiert sein, so führen Sie bitte das Upgrade auf OPSI 4.3 durch.
Eine Anleitung für das OPSI 4.3-Upgrade ist unter Upgrade auf OPSI 4.3 zu finden.

Überprüfen der OPSI-Lizenz

Ob eine gültige OPSI-Lizenz installiert ist, können Sie im Configed durch Klicken auf das OPSI-Icon in der linken Menüleiste prüfen.
Es öffnet sich in der Mitte nun der Validierungsstatus der OPSI-Module.

Validierungsstatus der OPSI-Module im Configed: Lizenz für 10 Clients für das Jahr 2026 ist installiert

OPSI Lizenzübersicht: Lizenz für 10 Clients für das Jahr 2026 ist installiert

Sollte für das Jahr 2026 keine OPSI-Lizenz installiert sein, so führen Sie die Datei opsiLizenzTausch.exe im Ordner \\backup\opsi_depot_rw\update80\Skripte\ aus.

Erfassung der statischen Routen

Melden Sie sich an der Konsole der OPSI-Server-VM mit root an.

Listen Sie die in der Univention Configuration Registry definierten statischen Routen auf:

bash
ucr dump | grep interfaces/eth0/route
ucr Befehl zur Anzeige der statischen Routen des opsi-Servers

Die im Auslieferungszustand definierten statischen Routen

Notieren Sie sich die Ausgabe - nach dem Update müssen diese Routen wieder eingetragen werden.

VM AdminVM

Warnung

Wenn Sie die AdminVM noch nicht auf Windows 11 aktualisiert haben, müssen Sie vor dem Upgrade diese Aktualisierung durchführen. Eine Anleitung ist im Archiv unter Update AdminVM auf Windows 11 zu finden.

Warnung

Wenn Sie die Gruppenrichtlinien-Aktualisierung für Windows 11 25H2 noch nicht durchgeführt haben, müssen Sie vor dem Upgrade diese Aktualisierung durchführen. Eine Anleitung ist unter Update Clients auf Windows 11 25H2 | Gruppenrichtlinien aktualisieren zu finden.

Überprüfen der Windows-Version auf der AdminVM

Melden Sie sich als Domänen-Administrator (Administrator@paedml-linux.lokal) an der AdminVM an.

Sie können die Windows-Version durch Ausführen des Befehls winver überprüfen.

Version Windows 11

Windows 11 Version 25H2 ist installiert.

Falls Windows 11 Version 24H2 installiert ist, führen Sie das opsi-Paket windows11-enablement aus, um die AdminVM auf Windows 11 Version 25H2 zu aktualisieren.

Falls Windows 11 Version 23H2 oder älter installiert ist, führen Sie das opsi-Paket windows11-upgrade aus, um die AdminVM auf Windows 11 Version 25H2 zu aktualisieren.

Eine detaillierte Anleitung zu windows11-enablement und windows11-upgrade finden Sie unter Update AdminVM auf Windows 11 25H2.

Falls noch Windows 10 22H2 installiert ist, führen Sie das Update der Admin VM auf Windows 11 durch.

Upgradeanleitung-paedMLLinux80-240724_d2597335.png

windows11-enablement  - Property upgrade-to-version

Herunterfahren

Fahren Sie die AdminVM vor dem Start des Upgrades (siehe Upgrade der paed.ML Linux) herunter.

VM Nextcloud

Warnung

Wenn Sie die Nextcloud VM noch nicht auf UCS 5.0 aktualisiert haben, sollten Sie vor dem paed.ML Upgrade diese Aktualisierung durchführen (siehe Update Nextcloud auf UCS 5.0).

Das Update der App Nextcloud selbst auf dem UCS-Server, ist in Nextcloud aktualisieren beschrieben.

Warnung

Die Nextcloud-VM sollte mindestens 8 GB RAM haben.

Überprüfen des Versionsstands

Melden Sie sich an der Konsole der Nextcloud-VM mit root an.

Sie können den aktuellen Versionsstand überprüfen mit:

bash
univention-app info
Versionsstand Nextcloud

 Die UCS-Version der paed.ML Nextcloud ist aktuell.

Sollte die Installation nicht aktuell sein (mind. UCS 5.0-10 errata1482), führen Sie bitte die Befehle

bash
univention-prune-kernels -v
univention-upgrade --updateto=5.0-99

an der Konsole der Nextcloud-VM aus.

Fahren Sie die Nextcloud-VM vor dem Start des paed.ML Linux 8.2 Upgrades herunter.

VM paed.ML Hub

Fahren Sie die paed.ML Hub-VM vor dem Start des paed.ML Linux 8.2 Upgrades herunter.

VM MDM-DB

Fahren Sie die MDM-DB-VM vor dem Start des paed.ML Linux 8.2 Upgrades herunter.

VM MDM

Fahren Sie die MDM-VM vor dem Start des paed.ML Linux 8.2 Upgrades herunter.