Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung | ||
alle:technik:backup:sicherung [05.11.2018 21:10] – [Schulscharfe Sicherung] werner.karolus | alle: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 // | + | **Bitte exportieren Sie Ihre selbsterstellten Berichte vor einer Sicherung unbedingt mittels // |
</ | </ | ||
- | 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 ASV-Datensicherung kann auf zwei Arten erfolgen: | Die ASV-Datensicherung kann auf zwei Arten erfolgen: | ||
- | * [[alle: | + | * [[alle: |
- | * [[alle: | + | * [[alle: |
Zeile 18: | Zeile 20: | ||
<Pfad zum DSS-Installationsverzeichnis> | <Pfad zum DSS-Installationsverzeichnis> | ||
- | <WRAP center round important | + | Bitte beachten Sie, dass bei einer regional-zentralen Installation, |
- | Hinweis: \\ Das Sicherungstool ermöglicht zwar die Sicherung einzelner Schulen (Mandanten), | + | |
+ | <WRAP center round important> | ||
+ | Das Sicherungstool ermöglicht zwar die Sicherung einzelner Schulen (Mandanten), | ||
</ | </ | ||
- | |||
- | **Hinweis: | ||
- | |||
==== Aufruf des Tools ==== | ==== Aufruf des Tools ==== | ||
Zeile 33: | Zeile 34: | ||
Die genauen Parameter erhalten Sie durch den Aufruf '' | Die genauen Parameter erhalten Sie durch den Aufruf '' | ||
- | Für Nutzer anderer Betriebssystem unterscheidet sich die Verwendung der schulscharfen Sicherung. Eine genaue Beschreibung folgt noch. | + | Für Nutzer anderer Betriebssystem unterscheidet sich die Verwendung der schulscharfen Sicherung |
- | + | und der Pfadangaben mittels Slash (''/'' | |
- | Wenn in Ihrer Installation die servereigene JRE verwendet wird, dann könnte es erforderlich sein, das Skript anzupassen. | + | |
- | Es reicht meist, wenn in der letzten Zeile des Skriptes | + | |
==== Erstellung der Konfigurationsdatei ==== | ==== Erstellung der Konfigurationsdatei ==== | ||
Zeile 45: | Zeile 44: | ||
In der Konfigurationsdatei werden alle benötigten Daten zur Verbindung mit der Datenbank hinterlegt. | In der Konfigurationsdatei werden alle benötigten Daten zur Verbindung mit der Datenbank hinterlegt. | ||
- | | + | <file ini dbsettings.ini> |
- | database.host = localhost | + | # host IP oder DNS-Name |
- | # PostgreSQL DB Port | + | database.host=localhost |
- | database.port = 5432 | + | |
- | # PostgreSQL ASV Datenbank | + | # PostgreSQL DB Port |
- | database.name = asv | + | database.port=5432 |
- | # DB User und Passwort | + | |
- | database.user = asv | + | # PostgreSQL ASV Datenbank |
- | database.password = geheim! | + | database.name=asv |
+ | |||
+ | # DB User muss immer " | ||
+ | database.user=asv | ||
+ | # Passwort des DB User asv | ||
+ | database.password=geheim123 | ||
+ | </ | ||
Für den ASV-Server-School verwenden Sie: | Für den ASV-Server-School verwenden Sie: | ||
- | | + | <file ini dbsettings.ini> |
- | database.user=asv | + | database.schema=asv |
- | database.password=asv | + | database.user=asv |
- | database.url=jdbc: | + | database.password=asv |
- | database.driver=org.h2.Driver | + | database.url=jdbc: |
- | | + | database.driver=org.h2.Driver |
+ | </ | ||
Verschlüsseln Sie die angelegte Datei '' | Verschlüsseln Sie die angelegte Datei '' | ||
Zeile 69: | Zeile 75: | ||
=== Anlegen der Konfigurationsdatei ctlconfig.ini === | === Anlegen der Konfigurationsdatei ctlconfig.ini === | ||
- | In der Datei '' | + | In der Datei '' |
+ | <file ini ctlconfig.ini> | ||
+ | -d dbsettings.ini | ||
+ | -u sys | ||
+ | -p geheimesPasswort | ||
+ | backup | ||
+ | </ | ||
- | Der Aufruf erfolgt dann nur noch mit '' | + | Auch diese Datei kann verschlüsselt werden. |
- | === Passwort des Systemadministrators === | + | dbctl.cmd -d ctlconfig.ini encrypt -f ctlconfig.ini |
- | Für die unten beschriebenen Aktionen wird die Benutzerkennung eines Systemadministrators (beispielsweise des Benutzers sys) benötigt. Derzeit muss das Passwort aus Sicherheitsgründen in verschlüsselter Form aus der Datenbank bezogen werden. | + | |
- | Bitte gehen Sie beispielsweise folgendermaßen vor: | + | Der Aufruf erfolgt dann nur noch mit '' |
- | + | ||
- | * Öffnen Sie das Datenbanktool pgAdmin und rufen Sie die SQL-Ansicht auf \\ {{alle: | + | |
- | * Geben Sie folgenden SQL-Befehl in das Fenster ein: \\ {{alle: | + | |
- | * Im Ergebnis sehen Sie in der Spalte **passwort** das verschlüsselte Passwort. Dieses muss für die unten beschriebenen Schritte verwendet werden. | + | |
- | * Falls Sie eine andere Kennung als sys verwenden (beispielsweise einen extra für diese Zwecke angelegten Systemadministrator), | + | |
- | * Das Standardpasswort des sys !!ASV!! funktioniert nicht, es muss entsprechend der Passwortkonventionen geändert sein. | + | |
- | * Das verschlüsselte Passwort des sys erhält man aus einer H2 Datenbank | + | |
- | + | ||
- | + | ||
==== 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: | ||
- | <code> | + | |
+ | <WRAP center round info> | ||
+ | Sie erhalten als Datei eine .sba Datei im Unterordner '' | ||
+ | </ | ||
+ | |||
+ | | ||
Nach Ausführung dieses Befehls erhält man etwa folgende Ausgabe: | Nach Ausführung dieses Befehls erhält man etwa folgende Ausgabe: | ||
Zeile 98: | 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: | ||
- | < | + | |
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 104: | Zeile 112: | ||
**Beispiel**: | **Beispiel**: | ||
- | < | + | |
bzw. kürzer | bzw. kürzer | ||
- | < | + | |
Erklärung der Parameter: | Erklärung der Parameter: | ||
- | * -i Liste der Schulen, die in einzelnen | + | * -i Liste der Schulen, die in einzelnen |
* -e Liste der Schulen, die nicht mitgesichert werden sollen | * -e Liste der Schulen, die nicht mitgesichert werden sollen | ||
* -b Basisverzeichnis für die Sicherungen | * -b Basisverzeichnis für die Sicherungen | ||
* -u Kennung eines Systemadministrators | * -u Kennung eines Systemadministrators | ||
- | * -p verschlüsseltes | + | * -p Passwort für den bei -u genannten Systemadministrator |
Dieses Sicherungsskript kann automatisiert regelmäßig gestartet werden. | Dieses Sicherungsskript kann automatisiert regelmäßig gestartet werden. | ||
Zeile 122: | Zeile 130: | ||
==== Löschen einzelner Schulen aus einer gemeinsamen Datenbasis ==== | ==== Löschen einzelner Schulen aus einer gemeinsamen Datenbasis ==== | ||
- | Fertigen Sie zunächst | + | |
+ | [[alle: | ||
+ | Fertigen Sie eine Sicherung der kompletten Datenbank an. | ||
Geben Sie zum Löschen einer einzelnen Schule zum Beispiel folgenden Befehl ein: | Geben Sie zum Löschen einer einzelnen Schule zum Beispiel folgenden Befehl ein: | ||
- | dbctl.cmd -d dbsettings.ini -u sys -p verschlPasswort | + | dbctl.cmd -d dbsettings.ini -u sys -p geheimesPasswort |
Falls der Befehl erfolgreich ausgeführt wird, erhalten Sie etwa folgende Bildschirmanzeige: | Falls der Befehl erfolgreich ausgeführt wird, erhalten Sie etwa folgende Bildschirmanzeige: | ||
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 | + | <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. | ||
</ | </ | ||
Zeile 141: | Zeile 151: | ||
==== Löschen einer einzelnen Zeitscheibe einer Schule==== | ==== Löschen einer einzelnen Zeitscheibe einer Schule==== | ||
- | <WRAP center round important | + | <WRAP center round important> |
**Fertigen Sie zunächst eine Sicherung der kompletten Datenbank an.** | **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: \\ < | + | Geben Sie zum Löschen einer **Zeitscheibe** einer einzelnen Schule zum Beispiel folgenden Befehl ein: |
+ | | ||
+ | Falls der Befehl erfolgreich ausgeführt wird, erhalten Sie etwa folgende Bildschirmanzeige: | ||
+ | |||
+ | {{alle: | ||
+ | |||
+ | 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, | Dieses Vorgehen ermöglicht es beispielsweise, | ||
- | <WRAP center round important | + | <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! | ||
</ | </ | ||
- | Beispiel: Löschen des Schuljahres | + | Beispiel: Löschen des Schuljahres |
- | < | + | |
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 | + | <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! | ||
</ | </ | ||
- Umbenennung per SQL-Statement: | - Umbenennung per SQL-Statement: | ||
- | - < | + | - < |
- Rück-Umbenennung per SQL-Statement: | - Rück-Umbenennung per SQL-Statement: | ||
+ | |||
+ | Anmerkung: Die Umbenennung ist notwendig, da das Löschen von Schuljahren mit dem Schlüssel " | ||
==== Rücksichern der schulscharfen Sicherung in eine bestehende Datenbank ==== | ==== Rücksichern der schulscharfen Sicherung in eine bestehende Datenbank ==== | ||
- | Ist eine Schule bereits in einem Datenbestand enthalten, kann eine schulscharfe Sicherung mit dem Befehl < | ||
- | <WRAP center round info 60%> | + | 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 < | ||
+ | eingespielt werden. Nach dem Löschprozess ersetzt das eingespielte Backup den Datenbestand. | ||
+ | |||
+ | <WRAP center round info> | ||
Nach Abschluss einer Rücksicherung empfiehlt sich die unverzügliche Überprüfung der Aktualität von Programmversion, | Nach Abschluss einer Rücksicherung empfiehlt sich die unverzügliche Überprüfung der Aktualität von Programmversion, | ||
</ | </ |