Rücksicherung aus einer älteren ASV-Version

Wenn eine Datensicherung aus einem Stand mit einer älteren ASV-Version erfolgen soll, dann ist das direkt nicht möglich.

Hintergrund: Bei der Weiterentwicklung von ASV ist es auch immer wieder notwendig die Datenstrukturen anzupassen. Dabei kommen neue Datenfelder dazu, andere Felder werden nicht mehr gebraucht und entfernt. Auch die Beziehungen zwischen den Daten werden gelegentlich geändert. Dabei ist es auch notwendig die Dateninhalte auf die neuen Strukturen zu migrieren.

Aufgrund dieser Veränderungen kann eine ältere Sicherung nicht einfach direkt eingespielt und verwendet werden. Dabei würden unweigerlich Daten verloren gehen und die Programme könnten nicht damit arbeiten.

Es gibt für ASV genau ein Werkzeug/Programm, welches diese Anpassungen der Datenstrukturen mit den notwendigen Datenmigrationen durchführen kann. Das ist der Updatemechanismus, der im Updateinstaller und im Aktualisierungsdienst verwendet wird.

Deshalb ist folgendes grundlegende Vorgehen erforderlich:

1. Feststellen der ASV-Version die zur Sicherung passt
2. Aufbau dieser ASV-Version
3. Einspielen der Sicherung
4. Durchführen des ASV-Updates auf die aktuelle ASV-Version
5. Ggf. Übertragen der Daten in der richtigen Version in das Zielsystem

Konkret müssen folgende Fälle unterschieden werden:

Dieser Fall trifft zu, wenn die Sicherung aus einer ASV-Vorgängerversion des selben Releases oder aus einer Version des direkten Vorgängerreleases erfolgt.

Beispiel: Aktuell ist die Version 2.14.12.

• Wenn die Sicherung aus der Version 2.14.10 stammt, ist dieses Vorgehen anwendbar.
• Wenn die Sicherung aus der Version 2.13.480 stammt, ist dieses Vorgehen anwendbar.
• Wenn die Sicherung aus der Version 2.12.463 stammt, ist dieses Vorgehen nicht anwendbar.

Hier ist es möglich die ASV-Installation direkt zu verwenden.

1. Stoppen des ASV-Servers und des Aktualisierungsdienstes
2. Sicherung des aktuellen Datenbankstandes (für den Fall, dass etwas grob schiefläuft)
3. Sicherung des Standes des Installationsordners (für den Fall, dass etwas grob schiefläuft)
4. Löschen des aktuellen Datenbankinhalts
   1. ASV-Server-School (h2): Löschen des Ordners database im Installationsordner (z.B. C:\ASV\Server)
   2. ASV-Server-Enterprise (PostgreSQL): Löschen (drop cascade) des Schemas asv in der Datenbank z.B. mittels pgAdmin
5. Wiederherstellen der Datenbank aus der älteren Sicherung
6. Durchführen des manuellen Updates auf die aktuelle ASV-Version
   1. Dieser Schritt passt die Datenbankstruktur an und migriert die Dateninhalte soweit erforderlich
7. Zur Kontrolle, ob alles richtig gelaufen ist
   1. Sichten des Installationsprotokolls im Ordner install des ASV-Servers. Achten Sie insbesondere auf Exception und ERROR. Im Zweifelsfall fragen Sie bei ihrem Multiplikator nach.
   2. Führen Sie eine Überprüfung der Datenbankstruktur mittels dbctl verify aus.
8. Starten Sie die ASV-Dienste und prüfen mittels ASV-Client, ob ASV wieder erwartungsgemäß läuft.

Wenn die Sicherung bereits älter ist, sodass das Vorgehen im vorherigen Abschnitt nicht anwendbar ist, dann muss das hier beschriebene Vorgehen gewählt werden. In diesen Fällen ist die Sicherung in der Regel älter als 3 Monate.

Hier ist es nicht möglich die ASV-Installation direkt zu verwenden.

1. Stoppen des ASV-Servers und des Aktualisierungsdienstes
2. Sicherung des aktuellen Datenbankstandes (für den Fall, dass etwas grob schiefläuft)
3. Sicherung des Standes des Installationsordners (für den Fall, dass etwas grob schiefläuft)
4. Die bisherige Installation ist zu entfernen damit eine ASV-Neuinstallation vornehmen zu können
   1. ASV-Server-Enterprise (PostgreSQL): Löschen (drop cascade) des Schemas asv in der Datenbank z.B. mittels pgAdmin
   2. Löschen bzw. umbenennen des Installationsordners des ASV-Servers
5. Download des Installers zur Neuinstallation der ASV-Version aus dem Download-Archiv, die zur Sicherung passt.
6. Durchführen der Installation (Mehrplatzserver) in der passenden Variante.
7. Wiederherstellen der Datenbank aus der älteren Sicherung
8. Zur Kontrolle, ob alles richtig gelaufen ist
   1. Sichten des Installationsprotokolls im Ordner install des ASV-Servers. Achten Sie insbesondere auf Exception und ERROR. Im Zweifelsfall fragen Sie bei ihrem Multiplikator nach.
   2. Führen Sie eine Überprüfung der Datenbankstruktur mittels dbctl verify aus.
9. Nun ist die schrittweise Aktualisierung dieser Installation für jedes ASV-Release erforderlich.
   Dafür machen Sie jeweils folgende Schritte:
   1. Download des Update-Installers zum manuellen Update der ASV-Installation aus dem Download-Archiv
   2. Durchführen des manuellen Updates auf diese ASV-Version
      1. Dieser Schritt passt die Datenbankstruktur an und migriert die Dateninhalte soweit erforderlich
   3. Zur Kontrolle, ob alles richtig gelaufen ist
      1. Sichten des Installationsprotokolls im Ordner install des ASV-Servers. Achten Sie insbesondere auf Exception und ERROR. Im Zweifelsfall fragen Sie bei ihrem Multiplikator nach.
      2. Führen Sie eine Überprüfung der Datenbankstruktur mittels dbctl verify aus.
   4. Wenn alle Prüfungen zu einem guten Ergebnis führen, fahren Sie mit dem nächsten Release fort.
10. Jetzt müsste die aktuelle ASV installiert sein. Der Datenstand wurde technisch auf die aktuelle Version gehoben. Es sind aber immer noch die um Monate veralteten schulischen Daten.
11. Starten Sie die ASV-Dienste und prüfen mittels ASV-Client, ob ASV wieder erwartungsgemäß läuft.
    1. Falls der ASV-Client nicht startet, dann installieren Sie den Client mittels passendem ASV-Installer für die Neuinstallation.
12. Führen Sie ein Update der Wertelisten durch
13. Führen Sie eine Aktualisierung der Anwendungsdaten durch

Wenn nur eine Schule in dem ASV-Server verwaltet wird oder alle Schulen auf den gleichen Stand zurückgebracht werden sollen, dann verwenden Sie die entsprechende Datenbanksicherung und gehen wie oben beschrieben vor.

Für die Rücksicherung einer schulscharfen Sicherung, die mit einer älteren ASV-Version erstellt wurde, müssen diese Daten zuerst technisch auf die neue Version gehoben werden. Erst danach können die Daten in das eigentliche Zielsystem eingespielt werden.

Folgende Schritte sind dafür erforderlich:

1. Bauen Sie dafür eine (lokale) ASV-Installation z.B. auf einem Arbeitsplatz-PC oder einem anderen Server auf, mit der älteren ASV-Version auf.
2. Stellen Sie eine dazu passende Datenbanksicherung wieder her.
   1. Wenn das nicht vorliegt, kann dieser Schritt übersprungen werden. Darunter leidet allerdings die Vollständigkeit und Konsistenz der Daten.
3. Importieren Sie die schulscharfe Sicherung in dieser Umgebung.
4. Führen Sie das ASV-Update auf die aktuelle Version durch.
   1. Ggf. muss auch hier über mehrere Releases schrittweise upgedatet werden.
5. Erstellen Sie eine schulscharfe Sicherung, die jetzt mit der richtigen ASV-Version erstellt wird.
6. Nun ist die Rücksicherung in das eigentliche Zielsystem möglich.