SVWS-Dokumentation

Appearance

Datenmigration ​

Bei der Datenmigration werden in der Datenbank des SVWS-Servers neue Schemata angelegt oder vorhandene Schemata verwendet. Die Daten einer bestehenden Datenbank werden anschließend in die entsprechenden Schemata des SVWS-Servers übernommen.

Übersicht ​

Es gibt mehrere Möglichkeiten, ein Schema in der Datenbank anzulegen beziehungsweise zu befüllen:

  • per SVWS-AdminClient (empfohlen)
  • per API (für den Einsatz in Skripten)

Migration per SVWS-AdminClient (empfohlen) ​

Kurzübersicht ​

weitere Informationen:

Ein ausführliche Dokumentation der Migration oder des Datenbankmanagementes finden Sie im Benutzerhandbuch SVWS-AdminClient.

adminclient.png

  • Rufen Sie unter https://MeinSVWS-Server/admin Ihren SVWS-AdminClient auf.
  • Melden Sie sich als root an der MariaDB an.
  • Drücken Sie auf das + Zeichen
  • Wählen Sie Schild2-Datenbank migrieren aus.
  • geben Sie die entsprechenden Daten ein.

neues Schema anlegen

Alternativ zum Mariadb-Root kann auch ein anderer Datenbankbenutzer verwendet werden. Die verfügbaren Datenbanken und Funktionen richten sich dabei nach den im Mariadb-Server vergebenen Berechtigungen.

Mit dem AdminClient können – abhängig von den Rechten des Datenbankbenutzers – folgende Aufgaben durchgeführt werden:

  • Datenbankschema für SVWS anlegen und in die svwsconfig.json aufnehmen
  • Datenbank mit Schulnummer initialisieren
  • SchILD-NRW 2 Datenbank in Schema migrieren
  • SQLite-Backup ausführen
  • SQLite-Backup wieder einspielen
  • Datenbankschema löschen

Migration per API ​

bash
curl --user "%1:%2" -k -X POST "https://localhost/api/schema/root/migrate/mdb/%3"
-H "accept: application/json"
-H "Content-Type: multipart/form-data"
-F "databasePassword=%4"
-F "schemaUsername=%5"
-F "schemaUserPassword=%6"
-F "database=@%7"
  • %1: Benutzer der Datenbank mit GRANT-Rechten, zum Anlegen neuer Datenbanken
  • %2: Passwort der o.g. Benutzers
  • %3: Name der neu anzulegenden Datenbank - Achtung: existierende Datenbanken werden überschrieben!
  • %4: Das SchILD-NRW 2 - Passwort, um die MDB-Datenbank zu öffnen.
  • %5: Der neue MariaDB-Benutzer für die neue Datenbank (Schuldatenbankadmin im Backend)
  • %6: Passwort des o.g. Benutzers
  • %7: vollständiger Pfad zur MDB auf dem Server - MIT @ davor!

Beispiel:

bash
curl --user "root:mariabd_root_pw" -k -X "POST" "https://server.svws-nrw.de/api/schema/root/migrate/mdb/svwsdb" \
 -H "accept: application/json"  \
 -H "Content-Type: multipart/form-data" \
 -F "databasePassword=kannManWissen" \
 -F "schemaUsername=svwsuser" \
 -F "schemaUserPassword=svwsadmin_PW" \
 -F "database=@/root/SVWS-TestMDBs/GOST_Abitur/Abi-Test-Daten-01/GymAbi.mdb"

Sie können die API des SVWS-Server auch mit der Swagger Oberfläche ansteuern beziehungsweiseausprobieren.

API SVWS Server

Download von Testdaten ​

Für Testzwecke und Schulungen werden anonymisierte Datenbanken verschiedener Schulformen vorgehalten. Zu bestimmten Datenbanken sind auch passende WebLuPO Dateien etc. vorhanden, um sich passende Testfälle anzusehen.

Anonymisiert

Die Daten sind vollständig anonymisiert!

SVWS-TestSqlites

Zum Testen der Migration können Sie auch auf älteren .mdb Datenbanken in unserem Entwickler Repository für Datenbanken zurückgreifen:

SVWS-TestMDBs

bekannte Fehlerquellen ​

In einigen Situation kann eine Migration misslingen.

Hier einige Beispiele und wie man damit umgehen kann.