Benutzer-Werkzeuge


Sidebar

ASV-Webseite

Dokumentation

Hilfe



Druck/Export

Drucken/PDF erzeugen

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
alle:technik:backup:sicherung [21.12.2020 13:06] – KEIN verschlüsseltes Passwort verwenden maukeralle:technik:backup:sicherung [13.12.2023 09:37] (aktuell) matthias.gold
Zeile 1: Zeile 1:
 +~~NOTOC~~
 ====== Schulscharfe Sicherung ====== ====== Schulscharfe Sicherung ======
  
-<WRAP center round alert 60%+<WRAP center round alert>  
-**Bitte exportieren Sie Ihre selbsterstellten Berichte vor einer Sicherung unbedingt mittels //Datei -> Verwaltung -> Berichtsbibliothek//, da diese nicht mit gesichert werden!**+**Bitte exportieren Sie Ihre selbsterstellten Berichte vor einer Sicherung unbedingt mittels //Datei Verwaltung Berichtsbibliothek//, da diese nicht mitgesichert werden!**
 </WRAP> </WRAP>
  
-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 wieder einzuspielen.+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: Die ASV-Datensicherung kann auf zwei Arten erfolgen:
  
-  * [[alle:technik:backup:sicherung#datensicherungsfunktion_aus_der_anwendung_heraus|über die Anwendung selbst]]: Diese Art steht der Schule selbst zur Verfügung. Eine [[einfuehrung:verwaltung:sichern|Sicherung]] bzw. [[einfuehrung:verwaltung:ruecksichern|Rücksicherung]] kann nur von Schulen erstellt werden, für die eine Berechtigung besteht.+  * [[alle:technik:backup:sicherung#datensicherungsfunktion_aus_der_anwendung_heraus|über die Anwendung selbst]]: Diese Art steht der Schule selbst zur Verfügung. Eine [[einfuehrung:verwaltung:sichern|Sicherung]] bzw. [[einfuehrung:verwaltung:ruecksichern|Rücksicherung]] kann nur von Benutzern erstellt werden, für die die Berechtigung besteht.
   * [[alle:technik:backup:sicherung#kommandozeilenprogramm_in_einer_dss-installation|ü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.   * [[alle:technik:backup:sicherung#kommandozeilenprogramm_in_einer_dss-installation|ü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.
  
Zeile 18: Zeile 20:
   <Pfad zum DSS-Installationsverzeichnis>bin\dbctl [options] [commands] [command options]   <Pfad zum DSS-Installationsverzeichnis>bin\dbctl [options] [commands] [command options]
  
-<WRAP center round important 60%+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 [[alle:technik:backup:sicherung#datensicherungsfunktion_aus_der_anwendung_heraus|Sicherung über die Programmoberfläche]] besteht aber nach wie vor. 
-Hinweis: \\ Das Sicherungstool ermöglicht zwar die Sicherung einzelner Schulen (Mandanten),  jedoch sollte zusätzlich auch ein Backup der gesamten Datenbank erstellt werden! \\ + 
-Das kann z.B. durch den Aktualisierungsdienst erledigt werden.+<WRAP center round important> 
 +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 [[alle:technik:backup:service|Aktualisierungsdienstes]] erfolgen.
 </WRAP> </WRAP>
- 
-**Hinweis:** \\ Bei einer regional-zentralen Installation, die Ihr Sachaufwandsträger eingerichtet hat, besteht kein direkter Zugriff auf die Datenbank bzw. die ASV-Serverinstallation. 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 [[alle:technik:backup:sicherung#datensicherungsfunktion_aus_der_anwendung_heraus|Sicherung über die Programmoberfläche]] besteht aber nach wie vor. 
- 
  
 ==== Aufruf des Tools ==== ==== Aufruf des Tools ====
Zeile 54: Zeile 54:
 database.name=asv database.name=asv
  
-# DB User und Passwort+# DB User muss immer "asv" sein
 database.user=asv database.user=asv
 +# Passwort des DB User asv 
 database.password=geheim123 database.password=geheim123
 </file> </file>
Zeile 65: Zeile 66:
 database.user=asv database.user=asv
 database.password=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}
-# Passen Sie nur den Teil "<Pfad_zur_ASV_Server_Installation>" an +
-database.url=jdbc:h2:file:<Pfad_zur_ASV_Server_Installation>/database/asv;IFEXISTS=TRUE;MV_STORE=true;MVCC=TRUE;FILE_LOCK=NO;WRITE_DELAY=60000;CACHE_SIZE=16384;LOCK_MODE=3;MULTI_THREADED=1;SCHEMA_SEARCH_PATH=ASV,PUBLIC+
 database.driver=org.h2.Driver database.driver=org.h2.Driver
-database.shutdown.sql=SHUTDOWN COMPACT 
 </file> </file>
  
Zeile 78: Zeile 76:
 === Anlegen der Konfigurationsdatei ctlconfig.ini === === 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.  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. 
 +<file ini ctlconfig.ini>
 +-d dbsettings.ini
 +-u sys
 +-p geheimesPasswort
 +backup
 +</file>
 +
 +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>'' Der Aufruf erfolgt dann nur noch mit ''dbctl.cmd @'' bzw. ''dbctl.cmd @<Pfad zur Datei>''
  
 ==== Sicherung einzelner Schulen ==== ==== Sicherung einzelner Schulen ====
 +
 Eine Sicherung einer einzelnen Schule mit Schulnummer **n** wird mit folgendem Befehl erstellt: Eine Sicherung einer einzelnen Schule mit Schulnummer **n** wird mit folgendem Befehl erstellt:
  
  
-<WRAP center round info 60%+<WRAP center round info> 
-Sie erhalten als Datei eine .sba Datei, welche sie auch nur mit dem Kommandozeilentool DBCTL wieder zurücksichern können+Sie erhalten als Datei eine .sba Datei im Unterordner ''svp_data'', welche Sie auch nur mit dem Kommandozeilentool ''dbctl'' wieder zurücksichern können
 </WRAP> </WRAP>
  
Zeile 97: Zeile 106:
 Sollen alle Schulen in einer Installation schulscharf gesichert werden, verwendet man folgenden Befehl: Sollen alle Schulen in einer Installation schulscharf gesichert werden, verwendet man folgenden Befehl:
  
-<code>dbctl.cmd -d dbsettings.ini -u sys -p geheimesPasswort backup </code>+  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. Sollen mehrere Schulen** in getrennten Dateien** gesichert werden, wird die Liste der Schulnummern nach dem Parameter i angehängt.
Zeile 103: Zeile 112:
 **Beispiel**: Die Schulen mit der Schulnummer 9001 bis 9010 sollen schulscharf gesichert werden. Die Schule 9008 soll dabei unberücksichtigt bleiben. **Beispiel**: Die Schulen mit der Schulnummer 9001 bis 9010 sollen schulscharf gesichert werden. Die Schule 9008 soll dabei unberücksichtigt bleiben.
  
-<code>dbctl.cmd -d dbsettings.ini -u sys -p verschlPasswort backup -i 9001 9002 9003 9004 9005 9006 9007 9009 9010</code> +  dbctl.cmd -d dbsettings.ini -u sys -p geheimesPasswort backup -i 9001 9002 9003 9004 9005 9006 9007 9009 9010
  
 bzw. kürzer bzw. kürzer
  
-<code>dbctl.cmd -d dbsettings.ini -u sys -p verschlPasswort -b saveDir backup -i 90.. -e 9008</code>+  dbctl.cmd -d dbsettings.ini -u sys -p geheimesPasswort -b saveDir backup -i 90.. -e 9008
  
 Erklärung der Parameter:  Erklärung der Parameter: 
Zeile 121: Zeile 130:
  
 ==== Löschen einzelner Schulen aus einer gemeinsamen Datenbasis ==== ==== Löschen einzelner Schulen aus einer gemeinsamen Datenbasis ====
 +
 [[alle:technik:dss:stoppen|Stoppen]] Sie den laufenden Prozess des DSS! [[alle:technik:dss:stoppen|Stoppen]] Sie den laufenden Prozess des DSS!
 Fertigen Sie eine Sicherung der kompletten Datenbank an.  Fertigen Sie eine Sicherung der kompletten Datenbank an. 
Zeile 133: Zeile 143:
 Durch diesen Aufruf wird die Schule mit der Schulnummer 9310 gelöscht. Durch diesen Aufruf wird die Schule mit der Schulnummer 9310 gelöscht.
  
-<WRAP center round important 60%>+<WRAP center round important>
 Das Löschen einer Schule kann mehrere Minuten dauern. Falls sich die Anzeige in der Eingabeaufforderung nicht ändert, ist das kein Fehler.  Das Löschen einer Schule kann mehrere Minuten dauern. Falls sich die Anzeige in der Eingabeaufforderung nicht ändert, ist das kein Fehler. 
 </WRAP> </WRAP>
Zeile 141: Zeile 151:
 ==== Löschen einer einzelnen Zeitscheibe einer Schule==== ==== Löschen einer einzelnen Zeitscheibe einer Schule====
  
-<WRAP center round important 60%>+<WRAP center round important>
 **Fertigen Sie zunächst eine Sicherung der kompletten Datenbank an.** **Fertigen Sie zunächst eine Sicherung der kompletten Datenbank an.**
 </WRAP> </WRAP>
Zeile 155: Zeile 165:
 Dieses Vorgehen ermöglicht es beispielsweise, ein neu angelegtes Schuljahr nochmals zu löschen und den Prozess zu wiederholen. Dieses Vorgehen ermöglicht es beispielsweise, ein neu angelegtes Schuljahr nochmals zu löschen und den Prozess zu wiederholen.
  
-<WRAP center round important 60%>+<WRAP center round important>
 ACHTUNG! Führen Sie den folgenden Befehl **unter keinen Umständen** für das aktuelle Schuljahr oder das Vorjahr aus! ACHTUNG! Führen Sie den folgenden Befehl **unter keinen Umständen** für das aktuelle Schuljahr oder das Vorjahr aus!
 </WRAP> </WRAP>
Zeile 161: Zeile 171:
 Beispiel: Löschen des Schuljahres 2021/22 (= Planungsschuljahr während des Schuljahrs 2020/21) der Schule mit Schulnummer 9310: Beispiel: Löschen des Schuljahres 2021/22 (= Planungsschuljahr während des Schuljahrs 2020/21) der Schule mit Schulnummer 9310:
  
-<code>dbctl.cmd -d dbsettings.ini -u sys -p verschlPasswort delete -i 9310 -s 2021</code> +  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: Beispiel: Löschen des Schuljahres STATISTIK der Schule mit Schulnummer 9310:
  
-<WRAP center round important 60%>+<WRAP center round important>
 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! 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!
 </WRAP> </WRAP>
  
   - Umbenennung per SQL-Statement: <code>update asv.svp_wl_schuljahr set schluessel='HANSI' where schluessel='STATISTIK';</code>   - Umbenennung per SQL-Statement: <code>update asv.svp_wl_schuljahr set schluessel='HANSI' where schluessel='STATISTIK';</code>
-  - <code>dbctl.cmd -d dbsettings.ini -u sys -p verschlPasswort delete -i 9310 -s HANSI</code> +  - <code>dbctl.cmd -d dbsettings.ini -u sys -p geheimesPasswort delete -i 9310 -s HANSI</code> 
   - Rück-Umbenennung per SQL-Statement: <code>update asv.svp_wl_schuljahr set schluessel='STATISTIK' where schluessel='HANSI';</code>   - Rück-Umbenennung per SQL-Statement: <code>update asv.svp_wl_schuljahr set schluessel='STATISTIK' where schluessel='HANSI';</code>
  
Zeile 178: Zeile 188:
  
 Ist eine Schule bereits in einem Datenbestand enthalten, kann eine schulscharfe Sicherung mit dem Befehl  Ist eine Schule bereits in einem Datenbestand enthalten, kann eine schulscharfe Sicherung mit dem Befehl 
-  dbctl.cmd -d dbsettings.ini -u sys -p verschlPasswort restore -af <Pfad\Name der Sicherungsdatei>+  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. eingespielt werden. Nach dem Löschprozess ersetzt das eingespielte Backup den Datenbestand.
  
-<WRAP center round info 60%>+<WRAP center round info>
 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. 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.
 </WRAP> </WRAP>