Wie führe ich eine Datensicherung der S2-Schnittstelle durch? (S2 Backup)

Mit dem Betrieb der neuen S2-Schnittstelle ist es nun nicht länger ausreichend nur das PRG-
Verzeichnis zu sichern, um eine vollständige Datensicherung durchzuführen. Die S2-Schnittstelle nutzt
anstelle der bisherigen dateibasierten Datenbank einen zusätzlichen Datenbankserver (Postgres).
Generell können Sie die S2 auf zwei unterschiedliche Arten sichern:

1. Sicherung der kompletten Maschine (Virtuelle Maschine)
2. Nutzung unseres BackupUtils und Sichern des Datenauszugs

In dieser Anleitung beschreiben wir nur die 2. Methode. Die Postgres-Datenbank ist, zusammen mit dem S2Server-Dienst (s.o.), auf der Server-Maschine installiert. 

Um den entsprechenden Server / Hauptrechner zu identifizieren können Sie den Namen des Hostrechners auch aus der S2Config.json im PRG/S2-Verzeichnis ermitteln.

Die ServerConfig.json können Sie einfach mit dem Windows Editor öffnen und finden dort den Eintrag "Host", dabei handelt es sich um den PC / Server auf dem der S2-Server und die Postgres Datenbank läuft.

In unserem Beispiel befindet sich die S2-Schnittstelle auf dem Host "Tobi-Glaskasten".

Normalerweise wird während der Installation der Pfad zu den Datenbank-Tools in die PATH-Variable des Betriebssystems aufgenommen. Die Erreichbarkeit der Datenbanktools über die PATH-Variable ist erforderlich, damit die S2 Datensicherung mittels der BackupUtils funktioniert.

Für die Datensicherung wird mit der S2 ein entsprechendes Tool „BackupUtil.exe“ mitgeliefert. Dieses befindet sich ebenfalls im PRG/S2-Verzeichnis Ihrer CSB Warenwirtschaft.

Dieses Tool erzeugt eine Sicherungsdatei, die auf einem beliebigen Sicherungsmedium abgespeichert
werden kann. BackupUtil muss an dem Server laufen, auf dem der S2 Server installiert ist (bspw. als
geplanter Task in der Windows Aufgabenplanung).

Wichtig! Das BackupUtil benötigt für den reibungslosen Betrieb zwingend Internetzugriff.

Der liegt darin begründet, dass die Datensicherung aus Sicherheitsgründen mit einem geheimen Schlüssel verschlüsselt wird. Dieser ist nicht lokal auf dem Server gespeichert, sondern wird über einen zentralen Dienst von CSB bereitgestellt. Dadurch wird verhindert, dass Dritte Zugriff auf die Daten innerhalb des Backups erlangen können!

Das BackupUtil kann mit folgenden Parametern aufgerufen werden:

-d, --destination-dir

Zielverzeichnis der zu erstellenden Sicherungsdatei, standardmäßig im selben Verzeichnis.

-f, --file-name

Name der zu erstellenden Sicherungsdatei, standardmäßig yyyy-MM-dd-HH-mm-
CSB-Backup.tar.gz

Das Backup kann so von der Kommandozeile aus mit einem einfachen Befehl aus dem S2-Verzeichnis heraus (bspw. C:\Daten\CSB\PRG\S2) durchgeführt werden. Achten Sie bitte darauf, dass
das Ausführungsverzeichnis des BackupUtils auch wirklich im S2 Verzeichnis liegt.

cd C:\Daten\CSB\PRG\S2
BackupUtil.exe -d M:\

Hierbei handelt es sich natürlich nur um ein simples Beispiel bei dem die Sicherungsdatei bspw.
„2019-09-12-13-56-CSB-Backup.tar.gz“ auf das Laufwerk M:\ (bspw. ein Wechseldatenträger) kopiert
wird. In der Sicherungsdatei ist sowohl der Inhalt der Datenbank, als auch das Dokumentenverzeichnis vollständig enthalten. Es gilt zu beachten, dass für den Verzeichniswechsel der d-Schalter gesetzt ist, wenn sich das Zielverzeichnis auf einem anderen Laufwerk befindet z.B.

cd /d E:\CSB\PRG\S2“

Mit dem Schalter

--no-documents

ist es möglich eine Sicherung ohne Bilder und Dokumente zu erstellen. Diese müssen dann aber zwingend getrennt gesichert werden. Man beachte, dass es in diesem Fall bei einer Wiederherstellung dazu kommen kann, dass der Stand der Dokumente nicht zum Stand der Datenbank passt (abhängig vom Sicherungsverfahren, dass für die Dokumente verwendet wird).

Während eines Backups ist es normalerweise nicht notwendig, dass der S2Server-Dienst beendet wird,
es könnte aber dazu führen, dass Dateien im Zugriff sind und dadurch nicht kopiert werden können.
Bei Bedarf kann der S2Server-Dienst über die üblichen Steuerungsmechanismen kontrolliert werden
z.B. von der Windows-Shell mit dem Programm net. Ein Beispiel zum Beenden des S2-Servers wäre hier:

 net stop S2Server 

bzw. zum Starten des Servers:

net start S2Server

Es wird empfohlen mindestens täglich eine Datensicherung auf wechselnde externe Speichermedien
durchzuführen, damit im Worst-Case-Szenario möglichst wenig Daten verloren gehen.

Rücksicherung
Wenn Sie eine alte Datensicherung zurückspielen möchten nutzen Sie die „RestoreUtil.exe“ und
folgen den Anweisungen. Bitte beachten Sie, dass durch das Rücksichern der alte Datenbestand
zum Zeitpunkt der Datensicherung wieder eingespielt wird. Die Rücksicherung sollten Sie im besten
Falle nur unter Absprache mit IT-Fachpersonal wie dem CSB Support durchführen.