MDM | Migration der Datenbank und des S3-Speicher

Zuletzt geändert von Soo-Dong Kim am 2026/09/01 17:41

Vorwort

Damit Sie Ihr aktives MDM-Modul "Relution" weiterhin nachhaltig und sicher nutzen können, ist es notwendig, die derzeit eingesetzte Datenbank MariaDB und den Objektspiecher Minio nach PostgreSQL (Datenbank) und SeaweedFS (Objektspeicher) zu migrieren. Dieses How-To beschreibt die Migration mit Hilfe des Migrationstools.

Fehler

ACHTUNG | Snapshots/Backups erstellen!

Da es sich um eine Änderung handelt, sie man nicht ohne Weiteres rückgängig machen kann, empfehlen wir dringend, dass je ein Backup der beiden VMs MDM (Relution) und MDM-DB VOR der Migration erstellt werden. Darüber hinaus sollten Sie einen Snapshot der beiden VMs im ausgeschalteten Zustand erstellen. Das kann dafür sorgen, dass in einem Störungsfall der Zustand der VMs vor der Migration schnell und unkompliziert wiederhergestellt wird.

Voraussetzungen

Die Migration muss nur durchgeführt werden, wenn Sie Relution bereits mit der paed.ML Version 5.4 aktiviert haben. Nur dann können Sie die Migration durchführen, da Sie aktuell noch die Datenbank MariaDB und den S3-Speicher MinIO nutzen. Wenn Sie den MDM-Baustein "Relution" erstmalig aktivieren möchten, gehen Sie bitte nach unserer Installationsanleitung vor: Mobile Device Management(MDM) in der paed.ML Windows

Warnung

Um Relution nach dem paed.ML Update auf die Version 5.5 weiterhin nutzen zu können, müssen Sie diese Migration der Datenbank und des Objektspeichers zwingend durchführen. Um Relution nach der Migration wiederum nutzen zu können, müssen Sie die paed.ML auf Version 5.5 updaten. Die Reihenfolge spielt keine Rolle.

Folgende Voraussetzungen müssen erfüllt sein, damit Sie die Migration erfolgreich durchführen können:

Vorarbeiten (Firewallregeln, OVF-Vorlage und Migrationstool)

OVF-Vorlage und Migrationstool

  1. Laden Sie die OVF-Vorlagen paed.ML MDM-DB V2 und das Migrationstool über das LMZ Download Portal herunter und stellen Sie die neue Datenbank-VM auf Ihrem ESXi- oder Proxmox-Server bereit:
    ➡ OVF-Vorlage "paed.ML_MDM_DB_V2"
    ➡ Migrationstool "MDM-Datenbank_migrieren.zip
  2. Starten Sie die importierte VM „MDM-DB V2“.
  3. Öffnen Sie die gestartete VM "MDM-DB V2" und wählen Sie im SETUP-Assistenten die Option <Standard übernehmen> .
    VM-Wizard | Standard übernehmen
     
  4. Bestätigen Sie mit <OK> und warten Sie, bis die VM neugestartet ist.

    Setup-Assistent | Assistent schließen

Warnung

Wenn Sie den MDM-Baustein zentralisiert und diesen zum Beispiel in einer anderen DMZ mit anderen IP-Adressen betreiben, dann müssen Sie über die Option <Assistent starten> die Netzwerkkonfiguration der VMs entsprechend bearbeiten.

ACHTUNG:
Definieren Sie mithilfe des Wizard der VM "MDM-DB V2" das Netzwerk nach Ihren vorgaben. Zur Migration der Datenbank, darf die IP der neuen VM nicht gleich der alten sein. Das Migrationstool über nimmt das passende Ändern der IPs am Ende der Migration automatisch.

Neue Firewallregel

Warnung

Wenn Sie über den Setup-Assistenten der neuen VM eine abweichende IP konfiguriert haben, muss die Regel für die von Ihnen eingegebene IP erstellt werden.
Das Regel-Beispiel hier gilt für den paed.ML-Standard.

  1. Erstellen Sie eine neue Firewall-Regel (Standard-Netzwerk-Topologie der paed.ML).
    BeschreibungPortProt.INQuelleOUTZiel
    paedML-MDM-Allow-MDM-DBv25432,8333TCPINT10.1.1.2DMZ192.168.201.0/24
  2. Wenn Sie eine Sophos Firewall im Einsatz haben, importieren Sie die Firewall-Regeln nach folgender ➡ Anleitung erneut.
    Die fehlende Regel wird dann automatisch ergänzt und bestehende Regeln werden - falls nötig - angepasst.
  3. Screenshot der Regel für die Firewall OctoGate v4.
    Migration | Temporäre Firewall-Regel - OctoGate v4
     
  4. Screenshot der Regel für die Firewall OctoGate v3.
    Migration | Temporäre Firewall-Regel - OctoGate v3

Migration durchführen

Migrationsskript ausführen

Warnung

Überprüfen Sie, ob in Ihrem DMZ-Netzwerk die folgenden VMs laufen:

  • paed.ML Hub
  • paed.ML "MDM"
  • paed.ML "MDM-DB" (die ursprüngliche und aktive)
  • paed.ML "MDM-DB V2" (die neu importierte DB-VM)
  1. Führen Sie das heruntergeladene und entpackte Migrationstool "MDM-Datenbank_migrieren.exe" mit einem Doppelklick aus.
    Folgen Sie den geführten Migrationsschritten bis das Tool die Migration erfolgreich beendet.
  2. Nach der erfolgreichen Migration läuft Ihre Relution-Instanz mit der neuen Datenbank PostgreSQL und mit dem neuen Objektspeicher SeaweedFS.
    Erfolg der Migration  
     

paed.ML Update durchführen

Warnung

Wenn der Baustein "MDM Relution" bereits vor dem paed.ML-Update auf die Version 5.5 - also über die Schulkonsole der paed.ML-Version 5.4 - aktiviert wurde, dann läuft Ihe Relution-Instanz aktuell noch mit der Datenbank "MariaDB" und dem S3-Speicher "MinIO".

​​​In diesem Fall müssen Sie zunächst unser ➡ Skript zur Datenbank/S3-Migration durchführen.

Für den künftigen Betrieb von Relution wird die Datenbank "PostgreSQL" und der S3-Speicher "SeaweedFS" vorausgesetzt, was Ihnen das Modal entsprechend rückmelden wird. Nach der Durchführung unseres Migrationsskriptes erfüllen Sie beide Kriterien und können Relution wie gewohnt und mit den Vorteilen der paed.ML Version 5.5 nutzen.

Erfolg

Führen Sie das paed.ML-Update auf Version 5.5 nach unserer ➡ Update-Anleitung durch.

API-Migration in der paed.ML Schulkonsole

  1. Loggen Sie sich als paed.ML-Systemadministrator auf dem SP01 in die Schulkonsole ein und fügen Sie die Kachel „MDM | Grundeinstellungen“ zu Ihrem Dashboard hinzu.
    Schulkonsole | Kachel hinzufügen
     
  2. Öffnen Sie die Kachel „MDM | Grundeinstellungen“ und prüfen Sie den Status (= Update nötig) Ihrer MDM-Instanz in der entsprechenden Zeile.
    Schulkonsole | Status prüfen
     
  3. Öffnen Sie das Modal „MDM-Server starten“, klicken Sie unter Schritt 1 auf "Initialisieren", springen Sie mit einem Klick auf OK  zur "JobQueue-Ansicht" und warten Sie bis der Job abgearbeitet wurde.
    Schulkonsole | MDM-Server initialisieren

     

  4. Kehren Sie zur Kachel „MDM | Grundeinstellungen“ zurück uns aktualisieren Sie die Ansicht. Prüfen Sie den Status (= gestartet) und die Lizenz (= EDUCATION) nach der Aktualisierung.
    Schulkonsole | Status aktualisieren
    Schulkonsole | Status prüfen
     
  5. Öffnen Sie erneut das Modal „MDM-Server starten“, klicken Sie unter Schritt 3 auf "Konfigurieren", springen Sie mit einem Klick auf OK  zur "JobQueue-Ansicht" und warten Sie bis der Job abgearbeitet wurde.
    Schulkonsole | MDM-Server konfigurieren'
     
  6. Kehren Sie zur Kachel „MDM | Grundeinstellungen“ zurück, prüfen Sie abschließend den Status Ihrer Relution-Instanz und öffnen Sie erneut das Modal „MDM-Server starten“.
    Sind alle Schritt erfolgreich abgearbeitet, war die API-Migration erfolgreich. 
    Schulkonsole | Status prüfen
    Schulkonsole | Alles OK!
Erfolg

Melden Sie sich nun in Ihrer Relution-Instanz an und prüfen Sie, ob alles wie gewohnt funktioniert.

Änderungsdokumentation

VersionGeänderte oder ergänzte Kapitel
Stand 04.06.2025
 Version 1.0.0
Initialversion
Stand 08.12.2025
 Version 1.0.1
  • Fehler bei der Kapitelverlinkung behoben
  • Aktualisierung zweier Screenshots

Stand 20.07.2026
 Version 1.1

Aktualisierung der Anleitung passend zur paed.ML Version 5.5

Stand 01.09.2026
 Version 1.2

Links aktualisiert / fehlerhafte Links korrigiert