Amtliche Schulverwaltung - Dokumentation - alle:technik:backup

Sammlung alternativer Skripte (ohne Gewähr!)

anonymous@undisclosed.example.com (Anonymous) — Sun, 28 Feb 2016 07:51:40 +0000

Sammlung alternativer Skripte (ohne Gewähr!)

Falls Sie Lösungen für Probleme spezieller Systemkonfigurationen suchen, werden Sie vielleicht hier fündig.

Bitte beachten Sie, dass die nachfolgenden Skripte nicht von Mitarbeitern des ASV-Teams auf ihre korrekte Funktionsweise hin überprüft wurden. Das KM übernimmt für die Skripte also keine Gewähr.
Sie sind vor allem als Ideenfundgrube für Systembetreuer nützlich.

Betriebssysteme	Beschreibung	Author	Links
Windows 7 Windows 8	Batch-Skripte zum manuellen/automatischen Sichern/Rücksichern sowie zum Löschen alter Sicherungsdateien	Claus Buchner (MS Ochsenfurt)	Skripte (Buchner)

Backup und Restore mit Batch-Dateien (regelmäßige, automatische Datensicherung)

anonymous@undisclosed.example.com (Anonymous) — Mon, 02 Aug 2021 14:02:35 +0000

Backup und Restore mit Batch-Dateien (regelmäßige, automatische Datensicherung)

Diese Funktion ist im Aktualisierungsdienst integriert. Lesen Sie dazu Regelmäßige, automatische Datensicherung durch den Aktualisierungsdienst.

Diese Seite wird nicht mehr gepflegt.

Diese Dokumentation soll Anhaltspunkte geben, wie es funktionieren kann, wenn der Aktualisierungsdienst nicht verwendet wird.

Für das Backup und Restore der ASV-Datenbank stehen Ihnen zwei Batch-Dateien zur Verfügung, die helfen könnten. Bitte laden Sie sich diese herunter.

Backup

Laden Sie sich zunächst die unten stehende Datei herunter (für den direkten Download auf den Dateinamen klicken).

Klicken Sie die Datei zum Anpassen mit der rechten Maustaste an und wählen Sie „Bearbeiten“. Zur besseren Übersicht sollte unter „Format“ „Zeilenumbruch“ eingestellt werden.

asv_backup.bat

@Echo off
Echo Erstellen eines Backups der ASV-Datenbank
Echo =========================================
Echo.
 
Rem Bitte hier Zielverzeichnis einstellen (ohne \ am Ende)
set ziel=C:\ASV\Sicherung
 
Rem Konfiguration
Rem Standardverzeichnisse für pg_dump.exe unter Windows
Rem (Bitte ggf. anpassen, wenn Sie von der Standardinstallation 
Rem abgewichen sind.)
 
set pgdumpProgramm="C:\Program Files\PostgreSQL\9.2\bin\pg_dump.exe"
set PGPASSWORD=geheim
 
REM Ausgabeformat
set backup=asv_20%date:~8,2%%date:~3,2%%date:~0,2%.backup
 
 
 
IF Exist %ziel%/nul (
    GOTO speichern
) ELSE (
    Echo Das Zielverzeichnis '%ziel%' existiert nicht.
    Echo Es wurde NICHTS gespeichert.
    Echo.
    GOTO Ende
)
 
:speichern
 
IF Exist %pgdumpProgramm% (
 
    Echo Backup unter Win7:
    Echo %pgdumpProgramm% -U asv -Fc -f %ziel%\%backup% asv
         %pgdumpProgramm% -U asv -Fc -f %ziel%\%backup% asv
)
 
set PGPASSWORD=null
Echo.
Echo Backup-Vorgang abgeschlossen.
Echo.
Echo Der Name der Sicherungsdatei lautet:
Echo   %ziel%\%backup%
Echo.
 
:Ende
 
PAUSE

Führen Sie die Batchdatei durch Aufruf mit asv_backup.bat in einer Eingabeaufforderung aus, nachdem Sie die Konfiguration an Ihre Verhältnisse angepasst haben.

Hinweise:

set ziel=…
in dieses Verzeichnis werden die Sicherungsdateien abgelegt
set pgdumpProgramm=„C:\Program Files\PostgreSQL\9.2\bin\pg_dump.exe“
Pfad zu pg_dump.exe, das normalerweise in der Postgres-Installation enthalten ist
set PGPASSWORD=geheim
Ersetzen Sie geheim durch das von Ihnen bei der Installation vergebene Passwort für den Datenbankbenutzer asv. (Siehe Installationsprotokoll)
Falls das Passwort des Datenbankbenutzers asv ein %-Zeichen enthält, muss dieses durch eine weiteres %-Zeichen „maskiert“ werden.
Beispiel:
Passwort: abc%123
Eintrag in das Skript: abc%%123
- Falls das Passwort andere komplexe Zeichen enthält empfiehlt sich folgende Vorgehensweise:
- Vor jedes Sonderzeichen muss das ^. In einem Kennwort mit z.B. (&)(&% würde das dann so aussehen: ^(^&^)^(^&^%

Empfehlung der PostgreSQL Projektgruppe ist die Verwendung einer Datei .pgpass, statt der Variablen PGPASSWORD. Siehe http://www.postgresql.org/message-id/ga6lj0$d6v$1@ger.gmane.org und http://www.postgresql.org/docs/current/static/libpq-pgpass.html.

Nach dem Start der Batch-Datei wird das Backup in das eingestellte Zielverzeichnis geschrieben. Der Dateiname des Backup enthält das Sicherungsdatum. (z. B. asv_20131002.backup)
Die Batch-Datei eignet sich auch, um ASV regelmäßig per „geplantem Task“ zu sichern (siehe unten).

Restore

Bitte laden Sie die Batch-Datei folgende Batch-Datei herunter. Zum direkten Download klicken Sie auf den Dateinamen.

asv_restore.bat

@ECHO Off
 
REM Bitte hier einstellen, in welchem Verzeichnis sich
REM die Postgres-Tools dropdb.exe, createdb.exe und
REM pgrestore.exe befinden. (ohne \ am Ende)
SET pgpfad="C:\Program Files\PostgreSQL\9.2\bin\"
 
CLS
ECHO Wiederherstellen einer ASV-Datenbank
ECHO =====================================
ECHO.
 
IF EXIST %1 GOTO RESTORE
ECHO Keine Datei!!!
GOTO KEINEDATEI
 
:RESTORE
 
CLS
ECHO Wiederherstellen einer ASV-Datenbank
ECHO =====================================
ECHO.
ECHO 1. dropdb
ECHO    Bitte hier das Postgres-Passwort angeben (falls es verlangt wird), 
ECHO    nicht das ASV-Datenbank-Passwort!
ECHO.
"%pgpfad%\dropdb.exe" -U postgres asv
 
CLS
ECHO Wiederherstellen einer ASV-Datenbank
ECHO =====================================
ECHO.
ECHO 1. dropdb ... Die bisherige Datenbank wurde geloescht.
ECHO.
ECHO 2. createdb
ECHO    Bitte geben Sie das ASV-Datenbank-Passwort an! (meist 'asv')
ECHO.
"%pgpfad%\createdb.exe" -U asv asv
IF NOT %ERRORLEVEL%==0 GOTO FEHLER2
 
CLS
ECHO Wiederherstellen einer ASV-Datenbank
ECHO =====================================
ECHO.
ECHO 1. dropdb ...   Die bisherige Datenbank wurde geloescht.
ECHO.
ECHO 2. createdb ... Die neue (noch leere Datenbank) wurde angelegt.
ECHO.
ECHO 3. pg_restore (Daten einspielen)
ECHO    Der Restore-Vorgang kann ein paar Minuten dauern. Bitte Geduld!
ECHO    Wiederhergestellt wird: 
ECHO    %1
ECHO.
ECHO    Bitte nochmal das ASV-Datenbank-Passwort angeben! (meist 'asv')
ECHO.
"%pgpfad%\pg_restore.exe" -d asv -U asv -v %1
 
CLS
ECHO Wiederherstellen einer ASV-Datenbank
ECHO =====================================
ECHO.
ECHO 1. dropdb ...   Die bisherige Datenbank wurde geloescht.
ECHO.
ECHO 2. createdb ... Die neue (noch leere Datenbank) wurde angelegt.
ECHO.
ECHO 3. pg_restore   Die leere Datenbank wurde mit Inhalten gefuellt.
ECHO.
ECHO.
ECHO Die Wiederherstellung der Datei 
ECHO   %1 
ECHO ist abgeschlossen.
GOTO ENDE
 
:KEINEDATEI
CLS
ECHO Wiederherstellen einer ASV-Datenbank
ECHO =====================================
ECHO.
ECHO Es wurde keine .backup-Datei fuer Postgres angegeben.
ECHO Bitte 'ziehen' Sie eine solche Datei auf diese .bat-Datei!
GOTO ENDE
 
:FEHLER2
CLS
ECHO Wiederherstellen einer ASV-Datenbank
ECHO =====================================
ECHO.
ECHO Fehler beim Erstellen der Datenbank. 
ECHO Moegliche Fehlerquellen:
ECHO   - Laeuft der ASV-Server noch?
ECHO   - Sie haben ein falsches ASV-Datenbankkennwort angegeben.
GOTO ENDE
 
:ENDE
ECHO.
 
PAUSE

Die Batch-Datei ist für eine Standard-Installation von Postgres unter Windows7 ausgelegt. Die Variable pgpfad verweist auf das Verzeichnis in dem sich die Postgres-Tools dropdb.exe, createdb.exe und pgrestore.exe befinden. Am Ende der Variablen darf kein \ stehen!

Wenn eine Sicherung zurückgespielt werden soll, …

Stoppen Sie zunächst den ASV-Server.
Ziehen Sie die Sicherungsdatei mit der Maus auf die Restore-Batch-Datei.
Geben Sie Sie auf Nachfrage die Kennwörter des Postgres-Servers bzw. der asv-Datenbank an.
Starten Sie den ASV-Server wieder.

Einrichtung einer automatisierten Datenbanksicherung

Damit Sie nicht täglich eine manuelle Sicherung der ASV-Datenbank erstellen müssen, können Sie diesen Vorgang automatisieren:

Legen Sie sich auf dem Computer, auf dem die Sicherungsdateien gespeichert werden sollen, ein Verzeichnis 'ASV-Datenbanksicherung' an.
Speichern Sie die genannten Batch-Dateien in das neu erstellte Verzeichnis.
Rufen Sie in Windows (am Beispiel von Windows 7) 'Systemsteuerung/Verwaltung/Aufgabenplanung' auf.
Klicken Sie rechts unter 'Aktionen' auf 'Einfache Aufgabe erstellen…„!
- Name: ASV-Sicherung, Beschreibung: ASV-Sicherung, täglich um 18:00 Uhr. ⇒ Weiter
- Wann soll die Aufgabe gestartet werden?: Täglich ⇒ Weiter
- Start: heutiges Datum, 18:00:00, Wiederholung alle: 1 Tage ⇒ Weiter
- Welche Aktion …?: Programm starten ⇒ Weiter
- Programm/Skript: Wählen Sie hier die oben genannte Batchdatei aus! ('Argumente hinzufügen' und 'Starten in' leer lassen.) ⇒ Weiter
- ⇒ Fertigstellen
Nun sollte die Batch-Datei jeden Tag um 18:00 Uhr eine Sicherungsdatei erstellen. Die Namen der Sicherungsdateien sind folgendermaßen aufgebaut: asv_[Datum].backup (z. B. asv_20131007.backup)
Das Rückspielen einer Backup-Datei ist über den oben beschriebenen Restore-Prozess jederzeit möglich.

Alternative Skripte von Schulen

Falls Sie Lösungen für spezielle Konfigurationen in Ihrer Systemumgebung suchen, werden Sie vielleicht in der Sammlung alternativer Skripte:start fündig.

Backup der Datenbankdatei von ASV-School mit Batch-Dateien (regelmäßige, automatische ...

anonymous@undisclosed.example.com (Anonymous) — Mon, 02 Aug 2021 14:04:36 +0000

Backup der Datenbankdatei von ASV-School mit Batch-Dateien (regelmäßige, automatische Datensicherung)

Diese Funktion ist im Aktualisierungsdienst integriert. Lesen Sie dazu Regelmäßige, automatische Datensicherung durch den Aktualisierungsdienst.

Diese Seite wird nicht mehr gepflegt.

Folgende Backupvarianten wurden im Rahmen des Moduls „Installation ASV-School“ für das Moderierten Online-Seminar für angehende ASV-Multiplikatoren erstellt. Es wurde von keinem Mitarbeiter des ASV-Kernteams getestet. Für die Funktionsfähigkeit oder evtl. entstandene Schäden wird keine Gewähr geleistet. Verwendung auf eigene Gefahr!

Problemstellung

Prinzipiell reicht es für ein Backup der Datenbank in der Version ASV-Server School aus, die Datei asv.mv.db im Ordner Server\database des ASV-Installationsverzeichnisses zu sichern. Bei Betrieb von ASV-Server School auf Windows Systemen ergibt sich jedoch das Problem, dass ein laufender DSS-Servers Prozess (und Anmeldung eines Clients) diese Datei für Zugriffe sperrt. Ein Backup durch einfaches Kopieren ist nicht möglich. Eine Möglichkeit, ein Backup der Datenbankdatei zu ermöglichen, ist das Beenden (und anschließende neu Starten) des DSS-Servers. Dies kann automatisch innerhalb des Skriptes erfolgen. Zu Bedenken ist hierbei jedoch, dass es zu unvermittelten Verbindungsabbrüchen bei den Clients kommt. Im ungünstigsten Fall (z.B. wenn die Sicherung beim Anlegen eines neuen Schuljahres den DSS-Server beendet) können Schäden an der Datenbank entstehen. Wird die Ausführung des Skriptes automatisiert, muss dies bei der Wahl des Sicherungszeitpunktes unbedingt berücksichtigt werden.

Für die Sicherung im laufenden Betrieb besteht in Windows Möglichkeit einer Volumenschattenkopie (VSS). Diese Technik wird auch von gängiger Imaging- und Kloningsoftware wie Acronis, Paragon, etc. eingesetzt und ermöglicht es, gesperrte Dateien zu sichern.

Backup durch Beenden und Neustart des DSS-Servers

Folgende Rahmenbedingungen sind für die Funktionsfähigkeit des Skriptes notwendig:

Installierter und funktionsfähiger asv-server Dienst
Ausführung des Skriptes mit Administrator-Rechten (nur dann kann der Dienst beendet und wieder gestartet werden)
Um den Speicherbedarf der Backups zu reduzieren, wird der Ordner database in ein Archiv im Format 7z gepackt. Hierzu muss die kostenlose OpenSource-Software 7-Zip auf dem Rechner installiert sein. (www.7-Zip.org)
Wird das Programm 7-zip nicht gefunden, erfolgt eine 1:1 Kopie der Datenbankdatei
Im ersten Abschnitt müssen die Umgebungsvariablen an die jeweiligen Bedürfnisse angepasst werden
Vor dem Beenden des asv-Server Dienstes ermöglicht ein Countdown, die Ausführung des Skriptes abzubrechen. Dies kann im Falle von verbundenen ASV-Clients bzw. Arbeitsvorgängen, die nicht unterbrochen werden sollen sinnvoll sein.

Laden Sie sich die unten stehende Datei herunter (für den direkten Download auf den Dateinamen klicken).

Klicken Sie die Datei zum Anpassen mit der rechten Maustaste an und wählen Sie „Bearbeiten“. Zur besseren Übersicht sollte unter „Format“ „Zeilenumbruch“ eingestellt werden.

asv_backup.bat

@Echo off
cd /d "%~dp0"
 
::Passen Sie folgende Variablen an:(Ohne \ am Ende)======================
::Installationsverzeichnis von 7z (http://www.7-zip.de/)
set zipdir=C:\Program Files\7-Zip
::Installationsordner des DSS-Servers
set quelle=C:\ASV\Server
:: Zielverzeichnis der Sicherungsdatei
set ziel=D:\asv-backup
::Countdown bis Sicherung 
set timer=30
::Ende der Anpassungen====================================================
 
IF Exist %ziel%/nul (
    GOTO countdown
) ELSE (
    Echo Das Zielverzeichnis '%ziel%' existiert nicht.
    Echo Es wurde NICHTS gespeichert.
    Echo.
    GOTO Ende
)
 
:countdown
 
::Countdown, um Nutzer die Möglichkeit des Abbruches/Beendens von ASV zu geben:                                 
@echo off
cls
for /L %%A in (%timer%,-1,0) do ( 
echo =======================================================================
echo Skript zur automatischen Sicherung der Datenbank ASV-Server School
echo =======================================================================
echo Hierzu wird der Dienst asv-server kurzzeitig gestoppt und neu gestartet.
echo Verbundene ASV-Clients werden nun getrennt und müssen sich neu anmelden!
echo =======================================================================
echo !!!Beginne mit der Sicherung in %%A Sekunden!!!
echo Mit der Tastenkombination "STRG+C" koennen Sie die Aktion abbrechen! 
echo ======================================================================= 
ping localhost -n 2 >nul
cls
)
 
echo Beginne nun mit der Sicherung und beende hierzu den Dienst asv-server
 
net stop asv-server
 
::Generiere Ordnernamen
set ARCHIVNAME=SicherungASV-%DATE:~6,4%.%DATE:~3,2%.%DATE:~0,2%-%TIME:~0,2%.%TIME:~3,2%.%TIME:~6,2%
 
IF  Exist "%zipdir%\7z.exe" (
    GOTO verpacken
) ELSE (
    Echo ============================================
    Echo Kann das Programm 7-Zip nicht finden! 
    Echo Bitte installieren Sie das Programm und/oder  
    Echo passen Sie ggf. den Installationspfad an!
    Echo ============================================
    Echo Erstelle stattdessen eine 1:1 Kopie
    XCOPY "%quelle%\database" "%ziel%\%ARCHIVNAME%\" /S /E /C /H /O /R /Y /D /V
    Echo .
    Echo Eine Sicherung der Datenbank wurde im
    Echo Ordner "%ziel%\%ARCHIVNAME%" erstellt.
    GOTO Ende
)
 
:verpacken
 
::Kopiere und verpacke die Datenbank
"%zipdir%\7z.exe" a "%ziel%\%ARCHIVNAME%.7z" -ssw "%quelle%\database"
::Überprüfe die Archivdatei
"%zipdir%\7z.exe" t "%ziel%\%ARCHIVNAME%.7z"
 
Echo.
Echo Backup-Vorgang abgeschlossen.
Echo.
Echo Eine Sicherung des Datenbankordners wurde in der
Echo Datei "%ziel%\%ARCHIVNAME%.7z" erstellt.
Echo.
 
:Ende
net start asv-server
Pause

Führen Sie die Batchdatei durch Aufruf mit asv_backup.bat in einer Eingabeaufforderung aus, nachdem Sie die Konfiguration an Ihre Verhältnisse angepasst haben.

Backup mit Hilfe von Volumenschattenkopien

Die Erstellung des VSS-Backups erfolgt im Wesentlichen durch das Opensource-Tool hobocopy. https://github.com/candera/hobocopy

Nachdem eine Kopie der Datenbankdatei erstellt wird, komprimiert das Script (bei installiertem 7-Zip) die Datenbankdatei. Wird 7-Zip nicht gefunden, wird die 1:1 Kopie belassen.

In den folgendem Paket sind die notwendigen Dateien (backup.bat, HoboCopy.exe, HoboCopy.pdb) enthalten. In der backup.bat müssen die Umgebungsvariablen angepasst werden. Die Batch-Datei muss mit Adminrechten ausgeführt werden.

Version für 64-bit Systeme (getestet in Win7/10/Server2012)
asv_school_vss_64bit.zip

Sollte ASV noch auf einem 32-Bit System betrieben werden, muss folgendes Paket verwendet werden
asv_school_vss_32bit.zip

Backup und Restore an der Kommandozeile (Windows) bzw. der Shell (Linux)

anonymous@undisclosed.example.com (Anonymous) — Thu, 04 Nov 2021 12:54:02 +0000

Backup und Restore an der Kommandozeile (Windows) bzw. der Shell (Linux)

Die hier beschriebene Methode erscheint im ersten Moment etwas kryptisch, hat aber den großen Vorteil, dass die Befehle skriptbar sind. Damit ist zum Beispiel eine automatische, nächtliche Sicherung realisierbar. Das hier vorgestellte Batch-Skript für Windows und auch pgAdmin benutzen diese Befehle.

Windows

Passen die Dateipfade an Ihre Gegebenheiten an! Sie können die Exe-Datei auch aus einem Explorerfenster in das Fenster der Eingabeaufforderung ziehen, so vermeiden Sie Tippfehler und die bei Leerzeichen nötigen Anführungszeichen werden automatisch gesetzt.

Backup der Datenbank

c:\Programme\PostgreSQL\10\bin\pg_dump.exe -U asv -Fc --schema=asv --blobs -f 2021-07-15_asv.backup asv

Erläuterung:

pg_dump.exe ist das von postgreSQL mitgebrachte Tool zum Sichern von Datenbanken
-U asv: Aktion als Datenbankbenutzer asv durchführen
-Fc: Komprimiertes Format für die Datensicherung auswählen (c = compressed)
–schema=asv: Nur die Datenbankobjekte im Schema asv werden gesichert.
–blobs: Die BLOBs sind nicht im Schema asv und müssen deshalb extra inkludiert werden.
-f <Dateiname> Ausgabe in Datei (f = file)
asv Datenbank, die gesichert wird

Bei der Ausführung des Befehls fragt pg_dump nach dem Passwort des Datenbankbenutzers asv. Um einen solchen Aufruf in eine Backup-Skript zu übernehmen, ist es nötig, dieses Passwort zu hinterlegen. Legen Sie hierzu im Verzeichnis %APPDATA%\postgresql (%APPDATA% ist das Application Data Unterverzeichnis im Userprofil) des Windows-Benutzers, der das Backup durchführt die Datei pgpass.conf an.

Die Datei pgpass.conf hat den folgenden Inhalt:

hostname:port:database:username:password

Die ersten 4 Felder können auch mit einer Wildcard (*) belegt sein.

Beispiel:

localhost:*:asv:asv:supergeheim

pg_dump wertet diese Datei automatisch aus und übernimmt das Passwort.

(Siehe auch: http://www.postgresql.org/docs/10/static/libpq-pgpass.html)

Restore der Datenbank

c:\Programme\PostgreSQL\10\bin\psql.exe -c 'DROP SCHEMA asv CASCADE;' -c 'CREATE SCHEMA asv AUTHORIZATION asv;' asv asv

Erläuterung:

psql.exe ist das von postgreSQL mitgebrachte Tool zum Ausführen von SQL-Befehlen in einer Datenbank
-c …: SQL-Befehl, der ausgeführt werden soll
asv: Datenbank, in der der Befehl ausgeführt werden soll
asv: Datenbankbenutzer, mit dem der Befehl ausgeführt werden soll

Damit sind alle ASV-spezifischen Daten in der Datenbank gelöscht. Das Schema selbst ist aber wieder angelegt.

c:\Programme\PostgreSQL\10\bin\pg_restore.exe -d asv -U asv --schema=asv 2021-07-15_asv.backup

Erläuterung:

pg_restore.exe ist das von postgreSQL mitgebrachte Tool zum Wiederherstellen von Datenbanken
-d asv: Wiederherstellung in die Datenbank asv (d = database)
-U asv: Aktion als Datenbankbenutzer asv durchführen
–schema=asv: Nur die Objekte und Daten im Schema asv innerhalb der Datenbank asv wiederherstellen
<dateiname>: aus dieser Datei wiederherstellen

Löschen der Datenbank

Vorsicht! Der folgende Befehl löscht Ihre ASV-Datenbank. Damit sind Ihre Daten unwiederbringlich verloren. Haben Sie ein Backup gemacht?

c:\Programme\PostgreSQL\10\bin\dropdb.exe -U postgres asv

Löschen des Datenbankbenutzers

Vorsicht! Der folgende Befehl löscht Ihren ASV-Datenbank-Benutzer. Dies sollten Sie nur machen, wenn Sie vorhaben, eine Neuinstallation der ASV durchzuführen!

c:\Programme\PostgreSQL\10\bin\dropuser.exe -i -U postgres asv

Linux

Zur Syntax der verwendeten Befehle rufen Sie pg_dump --help bzw. pg_restore --help oder die zugehörigen man-pages auf.

Backup der Datenbank

Komprimiertes Backup der Datenbank erzeugen:

pg_dump -h localhost -U asv -Fc --schema=asv --blobs -f <backup-name>.backup asv

Ein so erzeugtes Backup ist nachher auch mit pgAdmin wieder zurückspielbar (in diesem Fall ist die Dateiendung wichtig)

Unkomprimierten Dump der Datenbank erzeugen (als root):

pg_dump -h localhost -U asv --schema=asv --blobs -f <dump-name>.sql asv

Der so erzeugte Dump ist eine lesbare Textdatei, die SQL-Statements und die Daten enthält. Dieser ist nicht mit pgAdmin, sondern nur mit der unten genannten Methode wieder einspielbar.

Restore der Datenbank

Restore aus einem komprimierten Backup:

psql -c 'DROP SCHEMA asv CASCADE;' -c 'CREATE SCHEMA asv AUTHORIZATION asv;' asv asv
pg_restore -h localhost -d asv -U asv --schema=asv <backup-name>.backup

Restore aus einem unkomprimierten Dump:

psql -c 'DROP SCHEMA asv CASCADE;' -c 'CREATE SCHEMA asv AUTHORIZATION asv;' asv asv
psql -f <postgres_dump>.sql asv

Löschen der Datenbank

Vorsicht! Der folgende Befehl löscht Ihre ASV-Datenbank. Damit sind Ihre Daten unwiederbringlich verloren. Haben Sie ein Backup gemacht?

dropdb -h localhost -U asv asv

Löschen des Datenbankbenutzers

Vorsicht! Der folgende Befehl löscht Ihren ASV-Datenbank-Benutzer. Diesen sollten Sie nur dann löschen, wenn Sie vorhaben, eine Neuinstallation der ASV durchzuführen!

dropuser -h localhost  -i -U postgres asv

Sicherung der ASV-Datenbank (Server School)

anonymous@undisclosed.example.com (Anonymous) — Tue, 26 Nov 2019 09:27:01 +0000

Sicherung der ASV-Datenbank (Server School)

Prinzipiell reicht es für ein Backup der Datenbank in der Version ASV-Server School aus, die Datei asv.mv.db im Ordner Server\database des ASV-Installationsverzeichnisses zu sichern. Bei Betrieb von ASV-Server School auf Windows Systemen ergibt sich jedoch das Problem, dass ein laufender DSS-Servers Prozess (und Anmeldung eines Clients) diese Datei für Zugriffe sperrt.

Sicherung der ASV-Datenbank

1.) Anwender informieren

Informieren Sie die Anwender über die geplanten Wartungsarbeiten und den Zeitraum der eingeschränkten Verfügbarkeit im Vorfeld.

2.) angemeldete Benutzer sichten

Eine Abfrage des DSS im Browser über die URL des Servers ergänzt durch users liefert eine Liste der angemeldeten Benutzer. Starten Sie den Browser auf dem Server, so ist die URL üblicherweise http://localhost:8765/users. Die Anmeldung als ASV-Systemadministrator (z.B. sys) ist erforderlich.

3.) Dienstverwaltung

In der Dienstverwaltung in der Systemsteuerung (Gruppe Verwaltung) können Sie den ASV-Server manuell starten oder beenden.

4.) Kopieren der Datenbank

Kopieren Sie nun die Datei asv.mv.db im Ordner Server\database des ASV-Installationsverzeichnisses.

5.) Neustart des DSS

Am einfachsten ist es nun, den Rechner neu zu starten, auf dem der DSS Server installiert. Alternativ können Sie auch über die Dienstverwaltung (Schritt 3) den Dienst „asv-server“ wieder neu starten.

Sicherung der ASV-Datenbank mit Hilfe von pgAdmin

anonymous@undisclosed.example.com (Anonymous) — Mon, 10 Feb 2025 10:24:29 +0000

Sicherung der ASV-Datenbank mit Hilfe von pgAdmin

Unter Windows ist das Werkzeug pgAdmin bereits bei der Installation von PostgeSQL mit installiert worden. Für die Installation unter Linux ist hier eine kleine Anleitung hinterlegt.

Bitte setzen Sie in den Einstellungen von pgAdmin die Binary-paths auf den korrekten Pfad zum Ordner bin und damit zu den Tools pg_dump, pg_dumpall bzw. pg_restore der verwendeten PostgreSQL-Version (z.B. C:/Program Files/PostgreSQL/[PGVersion]/bin). Dies gewährleistet, dass die erstellte Sicherung auch in anderen Installationen wieder korrekt eingespielt werden kann.

Konfiguration von pgAdmin

Bei den neuen Installationen von PostgreSQL wird das Programm pgAdmin bereits richtig mitkonfiguriert. Die Einstellungen, aufgerufen durch einen Rechtsklick auf die Datenbank, sollten wie folgt aussehen:

Sicherung der ASV-Datenbank

Für die Datenbanksicherung klicken Sie mit der rechten Maustaste auf die Datenbank asv, wählen im Kontextmenü den Punkt Sichern oder Backup.

Geben Sie im folgenden Dialog einen Dateinamen sowie den Sicherungsort an.
Wählen Sie als Format Benutzerspezifisch bwz. Custom. Für das Kompressionsverhältnis können Sie einen Wert von 0 (wenig) bis 9 (stark komprimiert) eintragen.

Wichtig es ist bei der Kodierung UTF8 einzustellen und den Rollennamen asv auszuwählen.

Es wird nun eine Sicherung der Datenbank (dump) erstellt.

Ohne Format „Benutzerspezifisch“ oder „postgreSQLspezifisch“ werden Sie Probleme bei der Rücksicherung haben.

Wählen Sie für das Backup ein Verzeichnis, das sich nicht im ASV Installationsordner befindet. Wenn Sie einen Unterordner im Installationsverzeichnis für Ihre Backups anlegen und ASV mit Hilfe des Uninstallers von Ihrem System entfernen möchten, verlieren Sie auch Ihre Backups, da alle Daten gelöscht werden.

Wiederherstellen der ASV-Datenbank

Zum Wiederherstellen der Datenbank muss der DSS gestoppt werden!

Löschen der Datenbank: Rechtsklick auf die Datenbank ASV und Klick auf löschen/droppen
Neuanlegen der Datenbank asv mit Datenbankbenutzer asv
Im nächsten Untermenü Kodierung UTF8 und Template postgres auswählen.
Klicken Sie mit der rechten Maustaste auf den Eintrag asv und anschließend auf Wiederherstellen.
Im folgenden Dialog wählen Sie die Backupdatei.

Nach der Wiederherstellung einer Datenbank unterscheidet sich der Dialog je nach Exitcode:
Option 1 - Exitcode 0 (Es sind keine Fehler aufgetreten)

In diesem Fall beenden Sie den Dialog mit Klick auf die Schaltfläche Fertig.

Option 2 - Exitcode 1 (Es ist ein Fehler aufgetreten)
In diesem Fall sollte man die aufgetretenen Fehler genauer betrachten. Häufig taucht nur ein harmloser Fehler auf, der sich auf den Ländercode oder die Zeitzone bezieht. Diesen kann man ignorieren. In dem Fall sieht der Dialog nach der Wiederherstellung so aus:

Beenden Sie die Wiederherstellung mit Abbrechen. Sie sollten den Prozess noch einmal anstoßen.

Löschen des Datenbankbenutzers

Wenn Sie auch die Datenbankkennung bereinigen möchten, z. B. weil das bisher verwendete Passwort nicht mehr bekannt ist, dann sollten Sie auch noch den Datenbankbenutzer löschen.
Klappen Sie hierzu den Ast Login-Rollen auf, klicken Sie mit der rechten Maustaste auf den Benutzer ASV und wählen Sie im Drop-Down-Menü „Löschen/Droppen“.

Regelmäßige, automatische Datensicherung durch den Aktualisierungsdienst

anonymous@undisclosed.example.com (Anonymous) — Fri, 26 Jan 2024 11:02:59 +0000

Regelmäßige, automatische Datensicherung durch den Aktualisierungsdienst

Der Aktualisierungsdienst erstellt automatisch Sicherungen von der ganzen Datenbank.

In der Standardkonfiguration wird jede Nacht eine Sicherung unter update-service/service/backups abgelegt. Es werden 10 tägliche Sicherungen und 8 wöchentliche Sicherungen aufgehoben.

Offen bleibt damit noch die Übertragung auf einen weiteren Datenträger im besten Fall in einem anderen Gebäude. Sprechen Sie diesen Aspekt im Zweifelsfall mit ihrem Sachaufwandsträger ab.

Konfigurationsparameter für PostgreSQL (ASV-Server Enterprise)

In der Installationsvariante ASV-Server Enterprise mit Verwendung des Datenbanksystems PostgreSQL muss dem Aktualisierungsdienst der Pfad zur PostgreSQL Installation mitgeteilt werden, damit das Datenbank-Programm pg_dump zur Erstellung der Sicherung verwendet werden kann.

Laden Sie sich dazu zunächst die unten stehende Datei herunter (für den direkten Download auf den Dateinamen klicken).

config.local.ini

# Vollständiger Pfad des Ordners in dem die PostgreSQL Tools liegen.
# In dem Ordner muss das Programm pg_dump liegen.
# Unter Windows bedenken Sie, dass der Backslash im Pfad durch ein Slash ersetzt werden muss.
# Beispiel:
# backup.db.tools=C:/Program Files/PostgreSQL/14/bin
 
backup.db.tools=C:/Program Files/PostgreSQL/[installierte Version]/bin

Passen Sie den Pfad an ihre Installation an. Speichern Sie die so angepasste Datei in der DSS Installation unter update-service/service/configuration. Falls dort bereits eine Datei mit Namen config.local.ini liegt, dann ergänzen Sie den Inhalt dieser Datei am Ende der vorhandenen Datei.

Die Sicherung kann mit den Standard-Administrationswerkzeugen von PostgreSQL wiederhergestellt werden. Als graphisches Werkzeug bietet sich pgAdmin an. In der Kommandozeile kann pg_restore verwendet werden.

Konfiguration des Backups für PostgreSQL (ASV-Server Enterprise)

Standardmäßig werden das tägliche und das wöchentliche Backup im ASV Serververzeichnis im Ordner update-service/service/backups gespeichert. Der Ordner backups wird beim ersten Sicherungsvorgang automatisch angelegt.

Wenn Sie den Ordner für die Sicherungen oder auch andere Einstellungen ändern möchten, so erstellen Sie die config.local.ini des Update-Service und passen die folgenden Einträge ggf. an:

config.local.ini

# Vollständiger Pfad des Ordners in dem die PostgreSQL Tools liegen.
# In dem Ordner muss das Programm pg_dump liegen.
# Unter Windows bedenken Sie, dass der Backslash im Pfad durch ein Slash ersetzt werden muss.
# Beispiel:
# backup.db.tools=C:/Program Files/PostgreSQL/14/bin
backup.db.tools=C:/Program Files/PostgreSQL/[installierte Version]/bin
# Vollständiger Pfad des Ordners in dem Sicherungen abgelegt werden sollen.
# Unter Windows bedenken Sie, dass der Backslash im Pfad durch ein Slash ersetzt werden muss.
# backup.db.target=C:/ASV/backup
# Automatische DB-Sicherung durch den Aktualisierungsdienst ein- bzw. ausschalten.
# Default true bzw. der im Installer festgelegte Wert.
# backup.db.enable=true
# Tage an denen eine Sicherung gemacht werden soll. Default: mo,di,mi,do,fr,sa,so
# backup.db.days=mo,di,mi,do,fr,sa,so
# Tagessicherung, die als Wochensicherung behandelt werden soll. Default: mo
# backup.db.weekly.day=mo
# Zeitpunkt für die Ausführung der Sicherung. Default: 02:00. Wählen Sie eine Uhrzeit,
# zu der Ihr Server läuft.
# backup.db.time=02:00
# Ablageort für die Sicherungen im Dateisystem relativ zum Installationsverzeichnis
# des Aktualisierungsdienstes (Standard: backups).
# Es können auch absolute Pfade angegeben werden.
# Externe Laufwerke/Fileserver/etc. können hier verwendet werden, sofern sie ins lokale
# Dateisystem eingebunden (gemounted) sind (z.B. über Samba/NFS).
# Bitte bei der Pfadangabe keine Backslashes verwenden!
# backup.db.target=backups
# Anzahl der Wochensicherungen, die zusätzlich zu den Tagessicherungen aufgehoben werden.Default: 8
# backup.db.weekly.max=8
# Automatisches Backup bei Updates durch Aktualisierungsdienst ein- bzw. ausschalten.
# Default: true
# backup.db.update.enabled=true
# Beschränkung auf ein Backup pro Tag.
# Bei Erstellung der Tagessicherung wird geprüft, ob für den aktuellen Tag bereits eine Sicherung
# durch den Aktualisierungsdienst im Rahmen eines Updates gemacht wurde.
# Falls ja, wird auf die Tagessicherung verzichtet
# backup.db.single=false

Nach einer Änderung der config.local.ini starten Sie bitte den Aktualisierungsdienst neu.

Konfigurationsparameter für H2-Datenbank (ASV-Server School)

In der Installationsvariante ASV-Server School mit Verwendung des Datenbanksystems H2 kann der Backup-Dienst innerhalb einer config.local.ini angepasst werden, sollten individuelle Angaben erforderlich sein (z.B. individueller Zeitpunkt für die Durchführung des Updates). Die Vorlage unten enthält die Standardwerte jeder H2-Installation.

Möchten Sie davon abweichen, so laden Sie sich bitte zunächst die unten stehende Datei herunter (für den direkten Download auf den Dateinamen klicken):

config.local.ini

# DB backup
backup.db.enable=true
backup.db.days=mo,di,mi,do,fr,sa,so
backup.db.weekly.day=mo
backup.db.time=02:00
backup.db.target=backups
backup.db.daily.max=10
backup.db.weekly.max=8
backup.db.update.enabled=true
backup.db.single=false

Passen Sie die Werte dann mit einem Editor entsprechend an:

Folgende Einträge stehen zur Verfügung:

Eintrag	Bedeutung
backup.db.enable=true	Automatische DB-Sicherung durch den Aktualisierungsdienst ein- bzw. ausschalten
backup.db.days=mo,di,mi,do,fr,sa,so	Tage an denen eine Sicherung gemacht werden soll
backup.db.weekly.day=mo	Tagessicherung, die als Wochensicherung behandelt werden soll. Default: mo
backup.db.time=02:00	Zeitpunkt für die Ausführung der Sicherung
backup.db.target=backups	Ablageort für die Sicherungen im Dateisystem relativ zum Installationsverzeichnis des Aktualisierungsdienstes
backup.db.daily.max=10	Anzahl der Tagessicherungen
backup.db.weekly.max=8	Anzahl der Wochensicherungen
backup.db.single=false	Beschränkung auf ein Backup pro Tag

Speichern Sie die so angepasste Datei in der DSS Installation unter update-service/service/configuration.
Falls dort bereits eine Datei mit Namen config.local.ini liegt, dann ergänzen Sie den Inhalt dieser Datei am Ende der vorhandenen Datei oder passen Sie die bereits vorhandenen Werte entsprechend an.

Nach einer Änderung der config.local.ini starten Sie bitte den Aktualisierungsdienst neu.

Schulscharfe Sicherung

anonymous@undisclosed.example.com (Anonymous) — Tue, 22 Jul 2025 16:53:08 +0000

Schulscharfe Sicherung

Bitte exportieren Sie Ihre selbsterstellten Berichte vor einer Sicherung unbedingt mittels Datei / Verwaltung / Berichtsbibliothek, da diese nicht mitgesichert werden!

Die schulscharfe Sicherung dient dazu, den Datenbestand einer Schule aus einer Datenbank, in der die Daten mehrerer Schulen gespeichert sind, gezielt ohne Auswirkungen auf die anderen zu sichern und ggf. wieder einzuspielen. Bei der Rücksicherung gehen alle Änderungen, die in der Zwischenzeit gemacht wurden, verloren.

Die ASV-Datensicherung kann auf zwei Arten erfolgen:

über die Anwendung selbst: Diese Art steht der Schule selbst zur Verfügung. Eine Sicherung bzw. Rücksicherung kann nur von Benutzern erstellt werden, für die die Berechtigung besteht.
über das Kommandozeilentool dbctl.cmd: Dieses Skript unterstützt die technischen Administratoren beispielsweise bei regional-zentral betriebenen Installationen mit mehreren Schulen, um eine Datensicherung einzelner Schulen zu ermöglichen. Das gezielte Backup lässt sich unter Windows über die Aufgabenplanung gezielt automatisieren.

Kommandozeilenprogramm in einer DSS-Installation

Im Ordner bin einer DSS-Installation steht das Kommandozeilentool dbctl.cmd zur Verfügung. Genereller Aufruf des Programmes:

<Pfad zum DSS-Installationsverzeichnis>bin\dbctl [options] [commands] [command options]

Bitte beachten Sie, dass bei einer regional-zentralen Installation, die Ihr Sachaufwandsträger eingerichtet hat, kein direkter Zugriff auf die Datenbank bzw. die ASV-Serverinstallation besteht. Eine Sicherung über den hier beschriebenen Weg ist deshalb von der Schule nicht möglich. In diesem Fall wird die Sicherung durch den Sachaufwandsträger in Absprache mit der Schule geregelt. Die Möglichkeit der Sicherung über die Programmoberfläche besteht aber nach wie vor.

Das Sicherungstool ermöglicht zwar die Sicherung einzelner Schulen (Mandanten), jedoch sollten zusätzlich auch regelmäßig Datensicherungen der gesamten Datenbank erstellt werden. Dies kann z. B. mit Hilfe des Aktualisierungsdienstes erfolgen.

Aufruf des Tools

Das Datenbanktool dbctl besitzt folgende Struktur bei seinem Aufruf

dbctl.cmd	allgemeine Parameter	Aktion	Detail der Aktion
	-u, …	backup, restore, delete, encrypt, verify	-i, …

Die genauen Parameter erhalten Sie durch den Aufruf dbctl.cmd -help. Im Folgenden wird jede der genannten Aktionen an Beispielen genauer erläutert.

Für Nutzer anderer Betriebssystem unterscheidet sich die Verwendung der schulscharfen Sicherung nur im Behfehlsnamen (dbctl statt dbctl.cmd) und der Pfadangaben mittels Slash (/) statt Back-Slash (\).

Erstellung der Konfigurationsdatei

Führen Sie folgende Schritte durch:

Anlegen der Konfigurationsdatei ''dbsettings.ini''

In der Konfigurationsdatei werden alle benötigten Daten zur Verbindung mit der Datenbank hinterlegt.

dbsettings.ini

# host IP oder DNS-Name
database.host=localhost
 
# PostgreSQL DB Port
database.port=5432
 
# PostgreSQL ASV Datenbank
database.name=asv
 
# DB User muss immer "asv" sein
database.user=asv
# Passwort des DB User asv 
database.password=geheim123

Für den ASV-Server-School verwenden Sie:

dbsettings.ini

database.schema=asv
database.user=asv
database.password=asv
database.url=jdbc:h2:../database/asv;MODE=LEGACY;IFEXISTS=FALSE;CASE_INSENSITIVE_IDENTIFIERS=TRUE;COMPRESS=true;FILE_LOCK=NO;WRITE_DELAY=30000;CACHE_SIZE=65536;LOCK_MODE=3;MAX_COMPACT_TIME=60000;SCHEMA_SEARCH_PATH=PUBLIC,${database.schema}
database.driver=org.h2.Driver

Anlegen der Konfigurationsdatei ctlconfig.ini

In der Datei ctlconfig.ini können die Parameter für den Aufruf des Programmes gespeichert werden, so dass sie nicht jedesmal über die Kommandozeile eingegeben werden müssen. Diese Datei muss zusätzlich zur Konfigurationsdatei dbsettings.ini im Ordner .dbctl abgelegt werden.

ctlconfig.ini

-d dbsettings.ini
-u sys
-p geheimesPasswort
backup

Auch diese Datei kann verschlüsselt werden.

dbctl.cmd -d ctlconfig.ini  encrypt -f ctlconfig.ini

Der Aufruf erfolgt dann nur noch mit dbctl.cmd @ bzw. dbctl.cmd @<Pfad zur Datei>

Sicherung einzelner Schulen

Eine Sicherung einer einzelnen Schule mit Schulnummer n wird mit folgendem Befehl erstellt:

Sie erhalten als Datei eine .sba Datei im Unterordner svp_data, welche Sie auch nur mit dem Kommandozeilentool dbctl wieder zurücksichern können

dbctl.cmd -d dbsettings.ini -u sys -p geheimesPasswort backup -i n

Nach Ausführung dieses Befehls erhält man etwa folgende Ausgabe:

Sollen alle Schulen in einer Installation schulscharf gesichert werden, verwendet man folgenden Befehl:

dbctl.cmd -d dbsettings.ini -u sys -p geheimesPasswort backup

Sollen mehrere Schulen in getrennten Dateien gesichert werden, wird die Liste der Schulnummern nach dem Parameter i angehängt.

Beispiel: Die Schulen mit der Schulnummer 9001 bis 9010 sollen schulscharf gesichert werden. Die Schule 9008 soll dabei unberücksichtigt bleiben.

dbctl.cmd -d dbsettings.ini -u sys -p geheimesPasswort backup -i 9001 9002 9003 9004 9005 9006 9007 9009 9010

bzw. kürzer

dbctl.cmd -d dbsettings.ini -u sys -p geheimesPasswort -b <saveDir> backup -i 90.. -e 9008

Erklärung der Parameter:

-i Liste der Schulen, die in einzelnen Dateien gesichert werden sollen, der Punkt dient dabei als Wildcard
-e Liste der Schulen, die nicht mitgesichert werden sollen
-b Basisverzeichnis für die Sicherungen
-u Kennung eines Systemadministrators
-p Passwort für den bei -u genannten Systemadministrator

Dieses Sicherungsskript kann automatisiert regelmäßig gestartet werden. Die Einrichtung einer regelmäßigen Aufgabe unter Windows ist hier beschrieben.

Löschen einzelner Schulen aus einer gemeinsamen Datenbasis

Stoppen Sie den laufenden Prozess des DSS! Fertigen Sie eine Sicherung der kompletten Datenbank an.

Geben Sie zum Löschen einer einzelnen Schule zum Beispiel folgenden Befehl ein:

dbctl.cmd -d dbsettings.ini -u sys -p geheimesPasswort delete -i 9310

Falls der Befehl erfolgreich ausgeführt wird, erhalten Sie etwa folgende Bildschirmanzeige:

Durch diesen Aufruf wird die Schule mit der Schulnummer 9310 gelöscht.

Das Löschen einer Schule kann mehrere Minuten dauern. Falls sich die Anzeige in der Eingabeaufforderung nicht ändert, ist das kein Fehler.

Am Ende des Prozesses sind alle Einträge zu einer Schule gelöscht worden.

Löschen einer einzelnen Zeitscheibe einer Schule

Fertigen Sie zunächst eine Sicherung der kompletten Datenbank an.

Geben Sie zum Löschen einer Zeitscheibe einer einzelnen Schule zum Beispiel folgenden Befehl ein:

dbctl.cmd -d dbsettings.ini -u sys -p geheimesPasswort delete -i 9310 -s Zeitscheiben-Kürzel

Falls der Befehl erfolgreich ausgeführt wird, erhalten Sie etwa folgende Bildschirmanzeige:

Durch diesen Aufruf wird die Zeitscheibe mit dem Kürzel Zeitscheiben-Kürzel der Schule mit der Schulnummer 9310 gelöscht.

Dieses Vorgehen ermöglicht es beispielsweise, ein neu angelegtes Schuljahr nochmals zu löschen und den Prozess zu wiederholen.

ACHTUNG! Führen Sie den folgenden Befehl unter keinen Umständen für das aktuelle Schuljahr oder das Vorjahr aus!

Beispiel: Löschen des Schuljahres 2021/22 (= Planungsschuljahr während des Schuljahrs 2020/21) der Schule mit Schulnummer 9310:

dbctl.cmd -d dbsettings.ini -u sys -p geheimesPasswort delete -i 9310 -s 2021

Beispiel: Löschen des Schuljahres STATISTIK der Schule mit Schulnummer 9310:

Vor dem Löschen der Statistik-Zeitscheibe muss diese zwingend zuvor umbenannt werden! Nehmen Sie bezüglich der Notwendigkeit von deren Löschung zunächst Kontakt zum ASV-Kernteam auf!

Umbenennung per SQL-Statement:

update asv.svp_wl_schuljahr set schluessel='HANSI' where schluessel='STATISTIK';

dbctl.cmd -d dbsettings.ini -u sys -p geheimesPasswort delete -i 9310 -s HANSI

Rück-Umbenennung per SQL-Statement:

update asv.svp_wl_schuljahr set schluessel='STATISTIK' where schluessel='HANSI';

Anmerkung: Die Umbenennung ist notwendig, da das Löschen von Schuljahren mit dem Schlüssel „STATISTIK“ programmatisch nicht zugelassen wird.

Rücksichern der schulscharfen Sicherung in eine bestehende Datenbank

Ist eine Schule bereits in einem Datenbestand enthalten, kann eine schulscharfe Sicherung mit dem Befehl

dbctl.cmd -d dbsettings.ini -u sys -p geheimesPasswort restore -af <Pfad\Name der Sicherungsdatei>

eingespielt werden. Nach dem Löschprozess ersetzt das eingespielte Backup den Datenbestand.

Nach Abschluss einer Rücksicherung empfiehlt sich die unverzügliche Überprüfung der Aktualität von Programmversion, Wertelisten und Plausibiltäten über Datei - Verwaltung - ASD-Schnittstelle/ Schaltfläche Aktualität prüfen.

Prüfen der Datenbankstruktur

Es können verschiedene Fehlerkonstellationen einen Analyse der Datenbankstruktur erforderlich machen.

Dazu dient der Befehl dbctl.cmd verify.

Die genauere Verwendung ist auf der Seite Prüfung der Datenbankstruktur beschrieben.

Schulscharfe Sicherung

anonymous@undisclosed.example.com (Anonymous) — Thu, 09 Nov 2017 08:21:50 +0000

Schulscharfe Sicherung

Bitte exportieren Sie Ihre selbsterstellten Berichte vor einer Sicherung unbedingt mittels Datei → Verwaltung → Berichtsblibliothek, da diese nicht mit gesichert werden!

Hier geht es um die ASV Sicherung (schulscharfe Sicherung) aus der Anwendung ASV heraus. Diese Art steht der Schule selbst zur Verfügung. Eine Sicherung bzw. Rücksicherung kann nur von Schulen erstellt werden, für die eine Berechtigung besteht.

Rollenberechtigung

Die Datensicherung und Rücksicherung werden aus dem Menü Datei … Verwaltung heraus gestartet, wenn der Anwender über die erforderlichen Berechtigungen (OF_LZ, OF_UP, backup) verfügt.

ASV legt nicht von vornherein fest, wer in der Schule mit der Durchführung von Sicherungen beauftragt sein soll. Jede Schule muss für sich selber festlegen, ob der Schulleiter, ein System-Administrator oder ein Dritter mit dieser Aufgabe betraut wird.

Deswegen muss jede Schule für sich entscheiden, welche Kennung die Rolle Betreuer ASV, welche die oben genannten Berechtigungen enthält, erhalten soll.

Die entsprechenden Berechtigungen sind als Administrator einer Schule in der Rollenverwaltung unter Datei … Verwaltung … Rollenverwaltung zu setzen.

Vorgehensweise:

Als Administrator der Schule einloggen
Die Rolle Betreuer ASV zuweisen oder
Neue Rolle definieren (z. B. Rolle Backup)
der Rolle entsprechende Rechte zuweisen
die neue Rolle einer Person zuweisen
diese Person erhält folgenden Menüeintrag und kann eine Sicherung vornehmen

Schulscharfe Sicherung aus ASV

Rufen Sie, wie oben beschrieben, den Menüpunkt Vollständige Datensicherung auf und wählen Sie die Schulen aus, die Sie sichern möchten (wird nur angezeigt, falls die Berechtigung für mehr als eine Schule vorliegt).

Wählen Sie anschließend den Ordner aus, in den das Backup abgelegt werden soll.

Backup und Restore der ASV-Daten

anonymous@undisclosed.example.com (Anonymous) — Fri, 12 May 2023 15:52:09 +0000

Backup und Restore der ASV-Daten

Alle Daten werden in ASV in der Datenbank des ASV-Servers (DSS) gespeichert. Diese Daten werden in der Standardinstallation vom Aktualisierungsdienst regelmäßig jede Nacht gesichert. Dafür ist natürlich wichtig, dass der ASV-Server auf einem Computer installiert ist, der in der Regel auch nachts eingeschaltet ist. Es können aber auch die Uhrzeiten der Sicherung konfiguriert werden. Wenn der ASV-Server-Enterprise (mit PostgreSQL Datenbank) verwendet wird, dann muss der Aktualisierungsdienst noch konfiguriert werden, damit die Sicherung funktioniert.

Unabhängig von der Art der Sicherung muss durch weitere Prozesse sichergestellt werden, dass die Daten auf einem weiteren unabhängigen Speichermedium regelmäßig gesichert werden. Ansonsten ist das Risiko eines Datenverlustes durch einen Hardwaredefekt der Festplatte zu groß.

Wenn der Aktualisierungsdienst nicht verwendet wird oder die Sicherungen dort unterbunden werden, dann muss auf anderem Weg eine Datenbanksicherung eingerichtet werden. Das liegt dann in der Verantwortung des ASV-Systembetreuers.

Darüber hinaus bietet ASV die Möglichkeit einer schulscharfen Sicherung. Die schulscharfe Sicherung ist nur dann sinnvoll, wenn in einem ASV-Server (DSS) mehrere Schulen arbeiten. In seltenen Fällen der technischen Umstellung des ASV Betriebs kann die schulscharfe Sicherung auch erforderlich sein.

Beim Wiederherstellen einer Sicherung ist zu bedenken, dass die ASV-Version (genauer die Version der Datenbankstruktur) exakt zur Datensicherung passen muss. Im normalen Betrieb ist davon auszugehen, dass die Sicherung noch nicht sehr alt ist, da sonst zu viel manuelle Arbeit verloren gehen würde. Wenn ein ASV-Versionswechsel zwischen Sicherung und aktueller ASV-Installation liegt, dann lesen Sie hier nach.

In den folgenden Artikeln wird beschrieben, wie die ASV-Daten gesichert, zurückgespielt, aber auch gelöscht werden können.

Prüfung der Datenbankstruktur

anonymous@undisclosed.example.com (Anonymous) — Wed, 10 Jun 2020 15:34:49 +0000

Prüfung der Datenbankstruktur

Es ist im Betrieb von ASV immer wieder mal vorgekommen, dass die Datenbankstruktur von ASV nicht mehr dem erwarteten Zustand entspricht. Dies kann insbesondere durch Einspielen einer Datenbanksicherung geschehen.

Die Funktionalität steht mit dem Werkzeug dbctl zur Verfügung.

Die Einrichtung der Konfigurationsdatei dbsettings.ini für dbctl ist gemäß der Beschreibung einzurichten.

Der Aufruf erfolgt mittels

dbctl.cmd -d .\dbsettings.ini -u sys -p geheim verify --verbose 2

Um dbctl im Terminal von OSX Betriebssystemen laufen lassen zu können: chmod +x <Dateipfad zu dbctl> dbctl

Anschließend müssen die Pfade zu den Dateien entsprechend modifiziert werden:

Die Ausgabe dieses Programmlaufs muss gesichtet werden, um das Ergebnis zu bewerten.

Im positiven Fall sieht die Ausgabe folgendermaßen aus:

234 [main] INFO dbctl - authentication successful for user 'sys'
422 [main] INFO dbctl - Überprüfung - 26.01.2017 12:47
422 [main] INFO dbctl - Überprüfung der DSS-Datenbank wird gestartet.
422 [main] INFO dbctl - =====================================================================================
10530 [main] INFO dbctl - DSS-Datenbank entspricht der Referenzdatenbank.
10530 [main] INFO dbctl - =====================================================================================
10561 [main] INFO dbctl - Überprüfung wurde beendet.
10561 [main] INFO dbctl - Dauer: 10 Sekunde(n)

Dabei sind die Zahlen nicht relevant.

Jegliche Angabe von Unterschieden muss behandelt werden, bis die Meldung erscheint „DSS-Datenbank entspricht der Referenzdatenbank.“.

Im Allgemeinen ist als erste Maßnahme zu empfehlen, ein manuelles Update des ASV-Servers vorzunehmen.

Rücksicherung aus einer älteren ASV-Version

anonymous@undisclosed.example.com (Anonymous) — Tue, 09 Mar 2021 21:38:35 +0000

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:

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

Konkret müssen folgende Fälle unterschieden werden:

Datenbanksicherung aus der unmittelbaren Vorgängerversion

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.

Stoppen des ASV-Servers und des Aktualisierungsdienstes
Sicherung des aktuellen Datenbankstandes (für den Fall, dass etwas grob schiefläuft)
Sicherung des Standes des Installationsordners (für den Fall, dass etwas grob schiefläuft)
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
Wiederherstellen der Datenbank aus der älteren Sicherung
Durchführen des manuellen Updates auf die aktuelle ASV-Version
1. Dieser Schritt passt die Datenbankstruktur an und migriert die Dateninhalte soweit erforderlich
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.
Starten Sie die ASV-Dienste und prüfen mittels ASV-Client, ob ASV wieder erwartungsgemäß läuft.

Datenbanksicherung aus alten ASV-Vorgängerversion

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.

Stoppen des ASV-Servers und des Aktualisierungsdienstes
Sicherung des aktuellen Datenbankstandes (für den Fall, dass etwas grob schiefläuft)
Sicherung des Standes des Installationsordners (für den Fall, dass etwas grob schiefläuft)
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
Download des Installers zur Neuinstallation der ASV-Version aus dem Download-Archiv, die zur Sicherung passt.
Durchführen der Installation (Mehrplatzserver) in der passenden Variante.
Wiederherstellen der Datenbank aus der älteren Sicherung
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.
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.
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.
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.
Führen Sie ein Update der Wertelisten durch
Führen Sie eine Aktualisierung der Anwendungsdaten durch

Schulscharfe Sicherung aus einer älteren Version

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:

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.
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.
Importieren Sie die schulscharfe Sicherung in dieser Umgebung.
Führen Sie das ASV-Update auf die aktuelle Version durch.
1. Ggf. muss auch hier über mehrere Releases schrittweise upgedatet werden.
Erstellen Sie eine schulscharfe Sicherung, die jetzt mit der richtigen ASV-Version erstellt wird.
Nun ist die Rücksicherung in das eigentliche Zielsystem möglich.