Zum Inhalt springen

Schild-NRW-Daten in eine andere Datenbank übertragen (migrieren) (Tutorial)

Aus Schulverwaltungssoftware
Wichtig!

Starten Sie die SchILD-NRW-2-Datenbank vor einer Migration mit einer aktuellen Version von SchILD2, damit das technische Datenbankschema bei Bedarf auf den aktuellsten Stand gebracht werden kann.

Der empfohlene und von der Fachberatung unterstützte Weg zur Migration wird über den SVWS-AdminClient vorgenommen. Dessen Dokumentation und eine Anleitung zur Migration finden Sie auf https://doku.svws-nrw.de.

Um eine Datenbank in SchILD-NRW 3 verwenden zu können, ist im Anschluss die Connection-Datei (.con) zu generieren. Sie finden diese Anleitung hier weiter unten.
Hinweis

Eine Migration dauert je nach verwendeter CPU und Umfang der Datenbank "einige mitunter lange Minuten". Wenn Sie eine Schule migrieren, die sich bisher im Quartalsbetrieb befand, werden die alten Quartale in Halbjahre und Quartalsnoten umgeschrieben. Dieser Prozess kann im Vergleich zu anderen Migrationen viel länger dauern und je nach Datenbank und CPU mitunter 30 bis ~60 Minuten zusätzlich in Anspruch nehmen.

In diesem Kontext wäre eventuell darüber nachzudenken, die Datenbank noch in SchILD2 auf abgelaufene Löschristen zu prüfen und nicht mehr aufzubewahrende Schuljahre mit den Leistungsdaten löschen zu lassen.

Über die Datei svws_server_service.out.log im SVWS-Daten-Verzeichnis\logs\ lässt sich die Migration nachvollziehen. In diesem Verzeichnis finden sich noch weitere logs, z.B. zu Fehlern des Servers.

Erzeugen einer Connection-Datei für SchILD-NRW 3

Das Verzeichnis für die Verbindungsdateien im SVWS-Arbeitsverzeichnis.

Eine migrierte Schul-Datenbank kann direkt im SVWS-Client verwendet ewrden.

Um ein im SVWS-Server vorhandenes Schema mit SchILD-NRW-3 verwenden zu können, muss sich eine passende Verbindungs-Datei, hier Connection-Datei oder .con-Datei genannt, im Verzeichnis /SVWS-Arbeitsverzeichnis/Connection-Files/ befinden.

Starten Sie die Datei DBConfig.exe.

Sie finden das Programm zum genierenden der Con-Dateien im SchILD-NRW-3-Installationsverzeichnis. Starten Sie die Datei.

Beachten Sie hier, dass MS Windows als Standard die Dateiendung .exe ausblendet.

Wenn Sie die Datei als Windows-Administrator auf dem Rechner starten, auf dem SchILD-NRW-3 installiert ist, kann es sein, dass viele Daten zum Schema schon ausgefüllt sind.

Starten Sie die DBConfig.exe, um mit den Verbindungsdaten eine Verbindungsdatei zu erzeugen.

Sofern die Daten noch nicht ausgefüllt sind, füllen Sie die Maske korrekt aus.

Im Bereich Datenbank:

  • Server bezieht sich auf den Netzwerkpfad oder die IP-Adresse, unter der das Schema im Netzwerk erreicht wird. Hier im Beispiel wird ein lokaler Rechner verwendet. Nutzen Sie in diesem Falle den Rechnernamen oder localhost. Beim Server wird kein https:// vor der Adresse eingetragen.
  • Port bezieht sich auf den Port. Der Standardwert ist 3306, abweichende Werte erhalten Sie von Ihrer IT.
  • Das Datenbankschema ist der Name Ihrer "Datenbank" im SVWS-Server.
  • Der Benutzername ist der SVWS-Administrator, der einzig und allein dem technischen Zugang dient. Es ist nicht der Datenbank-root und es nicht einer der Datenbank-Administratoren. Dieser Name und das passende Kennwort wurden bei der Installation gesetzt.
  • Beim Kennwort handelt es sich um das zugehörige Kennwort des SVWS-Administrator, der für dieses Schema eingerichtet wurde.

Im Bereich SVWS-Server geben Sie an, unter welcher URL oder IP-Adresse und auf welchem Port in ihrem Netzwerk der SVWS-Server erreicht werden kann. Der Standard hier ist 443. Hiervon abweichende Ports erhalten Sie von Ihrer IT.

Für eine lokale Installation können Sie die Adresse https://localhost verwenden.

Setzen Sie auch den Haken Beim Verbindungstest berücksichtigen, um mögliche Fehler schon hier abzufangen und zu korrigieren.

Es ist zwingend ein https:// vor der Server-Adresse zu verwenden.

Im Bereich Proxy-Server sind diese Daten von diesem einzutragen. Oft gibt es keinen Proxy-Server. Wird einer verwendet erhalten Sie die notwendigen Daten von Ihrer IT.

Geben Sie abschließend im Bereich Konfigurationsdatei den Pfad des SVWS-Arbeitsverzeichnisses mit dem Verzeichnis der Verbindungsdateien an. Per Standard liegen diese im Unterordner Connection-Files im SVWS-Arbeitsverzeichnis.

Bennen Sie Ihre Konfigurationsdatei. Es empfiehlt sich, diese Datei nach dem Schemanamen zu benennen. Geben Sie die Dateiendung .con nicht mit an.

Klicken Sie auf Verbindungstest. War dieser erfolgreich, klicken Sie auf Datei speichern.

Fertig
Die Konfiguration für SchILD-NRW 3 ist abgeschlossen. Sie können diesen Artikel nun schließen.

Um eine vorhandene Con-Datei zu bearbeiten, können Sie deren Daten mit Datei öffnen laden.


Migration in SchILD-NRW 3 über Verwaltung ➜ Datenbank

Diese Form der Migration erlaubt es, in einer schon vorhandenen SchILD-NRW-3-Umgebung weitere Datenbanken zu migrieren. Hier kann auch die existierende Datenbank mit einer Neumigration überschrieben werden.

Hinweis
Beachten Sie, dass dennoch die Migration über den SVWS-AdminClient empfohlen wird.

Navigieren Sie zu Verwaltung ➜ Datenbank und klicken Sie auf Datenbank migrieren.

Es muss das Root-Kennwort des Super-Admins für den Datenbankserver eingeben werden.
Achtung!
An dieser Stelle ist nun zwingend das Root-Kennwort des Datenbankservers anzugeben. Es handelt sich hier nicht um ein Admin-Kennwort von SchILD oder das Kennwort als Schema-Admin.


Wälen Sie, in welches Datenbankschema migriert werden soll. Hier wird ein neues Schema angelegt.

Nun ist die SchILD2-Quelldatenbank, eine MS Access .mdb-Datei zu wählen. Weiterhin sind die Daten für das neue Schema anzugeben. Hier im Beispiel wird als Datenbankname das Schema svwsdb_GS für eine zusätzliche Grundschuldatenbank gewählt.

Als Benutzername wird hier im Beispiel der hier für alle Datenbanken verwendete svwsadmin genutzt mit dem existierenden Kennwort genutzt. Sie können auch für jedes Schema, also für jede Datenbank, einen neuen Namen mit neuen Kennwörtern vergeben.

Hinweis

Zur Erklärung

SchILD und der SVWS-Server kennen drei Typen von Kennwörtern: Zuerst der Root-Zugriff auf den kompletten Datenbankserver. Zweitens wird jedes Schema von einem Admin-Zugang gesteuert, der für den technischen Zugriff des SchILD-NRW-Programms hinterlegt wird. Schlussendlich gibt es die unterschiedlichen Nutzer in SchILD-NRW selbst mit ihren jeweiligen Berechtigungen.

Klicken sie anschließend auf Übernehmen.

Wichtig!
Migrieren Sie in ein existierendes Schema, wird die dort vorhandene Datenbank überschrieben!
Bitte warten...

Es erscheint während der Migration ein Fenster, in dem zum Warten angehalten wird.

Bei Erfolg wird diese Meldung angezeigt.

Bei Erfolg der Migration werden Sie benachrichtigt.

Nach einem Neustart von SchILD-NRW steht die neue Datenbank zur Auswahl bereit.

Nach einem Neustart von SchILD-NRW steht die migrierte Datenbank zur Verfügung.

Fertig
Die Migration ist abgeschlossen


Hinweis
Beachten Sie, dass in diesem Modus kein Fenster mit weiteren Informationen und eventuellen Fehlern zum Migrationsprozess anzeigt wird.