Umzug einer bestehenden ASV-Server-Installation

In bestimmten Situationen kann es notwendig sein, eine bestehende ASV-Server-Installation auf ein neues System zu migrieren, beispielsweise

• falls ein Serverumzug durchgeführt werden muss,
• die Infrastruktur (z.B. Umzug in eine virtuelle Maschine) verändert wird,
• ein neues PostgreSQL Major-Release benötigt wird,
• der bisherige Server defekt ist.

Falls bei dem Umzug die Installationsvariante von School zu Enterprise gewechselt werden soll, dann lesen Sie hier weiter.

Bitte planen Sie eine solche Maßname sehr sorgfältig und stimmen Sie sich unbedingt mit allen Beteiligten ab, um mögliche Einschränkungen für die ASV-Anwender möglichst gering zu halten.

• Die technischen und organisatorischen Vorarbeiten auf dem neuen Server sind erledigt.
• Alle Beteiligten (Schule, Anwender, Administratoren, Techniker, etc) sind informiert, und der Ablauf wurde vorab abgestimmt.
• Folgende Programme stehen auf dem neuen Server zur Verfügung:
  • ASV-Installer (im Falle einer Neuinstallation)
  • ASV-Updateinstaller (Kontrolle sowie Update älterer Installationen)
  • berechtigtes Zertifikat und PIN (von der Schule oder eigenes als zentraler Betreiber)

• Installieren Sie auf dem neuen Server
  • die aktuelle Version des ASV-Servers (Enterprise oder School).
• Richten Sie den ASV-Server und den Aktualisierungsdienst ein.
  • Übertragen Sie dabei insbesondere die lokalen Anpassungen, die notwendig sind.
  • Evtl. muss auch die Dienst-Konfiguration noch angepasst werden, z.B. mehr Speicher zuweisen.
• Starten Sie den ASV-Server (bzw. den Dienst).
• Installieren Sie zu Testzwecken einen ASV-Client, der sich mit dem neuen Server verbinden kann.
• Kontrollieren Sie zum Abschluss, ob Sie sich als Standardbenutzer sys mit dem Standardpasswort !!ASV!! über den ASV-Client einloggen können und eine Verbindung zum ZSS möglich ist.

Führen Sie sowohl auf dem abgebenden System, als auch auf dem Zielsystem ein Update der Wertelisten durch!

• Stoppen Sie alle ASV-Server-Prozesse und Dienste (Programm- und auch Aktualisierungsdienst).
• Erstellen Sie eine komplette Datenbanksicherung (KEINE Schulscharfe Sicherung).
  • Postgres-Sicherung bei ASV-Server Enterprise oder
  • eine komplette Dateisicherung des Ordners database bei ASV-Server School
• Sichern Sie alle Konfigurationsdateien, insbesondere die "local"-Dateien für lokale Anpassungen.

• Stoppen Sie alle ASV-Server-Prozesse auf dem neuen Server (ASV-Server- und Aktualisierungsdienst).
• Spielen Sie die Datenbanksicherung wieder ein.
  • Bei ASV-Server Enterprise: Löschen des Datenbankschemas asv und Wiederherstellen der Sicherung aus dem Backup.
  • Bei ASV-Server School: Den Ordner database wieder herstellen.
• Falls die Datenbank-Sicherung mit der Vorgänger-ASV-Version erstellt wurde, dann muss die Datenbankstruktur evtl. noch angepasst werden.
  • Führen Sie das manuelle Update mittels ASV-Updateinstaller für die neue Installation durch. Dabei werden auch die Programmdateien nochmal überschrieben, was aber unschädlich ist.
• Starten Sie den ASV-Server-Dienst und kontrollieren Sie, ob Sie sich als Systemadministrator über den ASV-Client (mit der ursprünglichen Kennung) einloggen können.
• Starten Sie den Aktualisierungsdienst.

• Prüfen Sie in der Datei asv.log im Ordner logs des Ziel-Servers, ob es im Rahmen der Rücksicherung zu Auffälligkeiten (sog. Exceptions) gekommen ist.
• Kontrollieren Sie, ob alle ASV-Server-Prozesse auf dem alten Server gestoppt sind (nur ein ASV-Server in einem Netz!).
• Deaktivieren Sie auf dem alten Server die Dienste, damit diese beim nächsten Serverstart nicht automatisch gestartet werden.
• Kontrollieren Sie, ob die Durchführung regelmäßiger Backups auf dem neuen Server funktioniert.
• Prüfen Sie, ob der Zugriff auf das Zentralsystem möglich ist (eventuelle Anpassungen an der Firewall).
• Aktualisieren Sie die Anwendungsdaten.

• Falls sich die Adresse / IP des Servers geändert haben sollte, muss diese Anpassung auch in jeder Client-Installation durchgeführt werden. Führen Sie deshalb
  • entweder eine Neuinstallation durch (Angabe der neuen Adresse / IP des ASV-Servers) oder
  • tragen Sie server.url und update.server in der config.local.ini ein (nicht in der config.ini!)