Wie führe ich eine Datensicherung / Backup des S2-Servers / 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

S2 Backup erstellen

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).

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
Die Rücksicherung eines Backups erfolgt über das Tool „RestoreUtil.exe", dies kann jedoch nicht vom Anwender selbst ausgeführt werden! Sollte die Notwendigkeit des Rückspielens einer Sicherung nötig sein wenden Sie sich bitte an den CSB Support.

Benachrichtigung über Backup-Status in der S2

Auf der S2 Startseite wird eine Warnung dargestellt sollte das letzte S2 Backup älter als sieben Tage sein. Sollten Sie die S2 über einen anderen Weg sichern und das CSB BackupUtil nicht verwenden, kann diese Warnung in den S2-Einstellungen unter Programmpunkt 2-1 - Einstellungen unter dem Eintag "Benachrichtigungen" im Seitenmenü, deaktiviert werden.