Backup und Wiederherstellung

Zur Sicherung einer On-Premises-Installation empfehlen wir Ihnen, die Vorteile der Containerisierung zu nutzen und sie einfach zu halten. Dementsprechend stellt die Sicherung der Inhalte der Docker-Volumes die Sicherung Ihres KIX dar.

Die Sicherung und Wiederherstellung des Systems erfolgt über die Befehlskonsole.

Wichtig

Erstellen Sie Sicherungen möglichst in Zeiten mit wenig Datenverkehr, um Datenverlust zu vermeiden.

Hinweis

Erstellen Sie Backups in regelmäßigen Abständen, damit Sie im Ernstfall auf eine aktuelle Version mit aktuellem Datenbestand zurückgreifen können.

Sichern einer On-Premises Installation

Zum Erstellen einer Sicherung in einer On-Premises-Umgebung gehen Sie wie folgt vor:

Docker-Services stoppen
1. Navigieren Sie in das Linux- bzw. Windows-Verzeichnis:
  Linux: cd kix-on-premise/deploy/linux
  Windows: cd kix-on-premise/deploy/windows
2. Führen Sie das Skript zum Stoppen des Docker-Services aus:
  Linux: ./stop.sh
  Windows: stop.ps1
Siehe auch: https://github.com/kix-service-software/kix-on-premise/tree/master/deploy/linux#readme
Docker-Volumes sichern
Die Sicherung wird als Zip-Datei gespeichert (auf dem Docker-Host unter Ubuntu in /var/lib/docker/volumes/).
Anstelle von KIXDockerVolumes_backup können Sie einen anderenDateinamen angeben, unter dem Sie die Sicherung speichern möchten.
Im Beispiel wird am Dateinamen der Zeitpunkt der Sicherung gespeichert. Ist dies nicht gewünscht, können Sie im Befehl den Teil-String $.(date "+%Y-%m-%dT:%H:%M:%S") entfernen.
```
shell> tar cfvz /tmp/KIXDockerVolumes_backup.$(date "+%Y-%m-%dT:%H:%M:%S").tar.gz /var/lib/docker/volumes/kix_backend/ /var/lib/docker/volumes/kix_frontend/ /var/lib/docker/volumes/kix_db/ /var/lib/docker/volumes/kix_shared/
```
Hinweis: Fahren Sie mit Schritt 3 fort, wenn Sie eine angepasste (oder externe) Datenbank nutzen.
Optional: Sichern der Datenbank (Datenbank-Dump erstellen)
Dieser Schritt ist nicht notwendig, wenn KIX ohne Anpassungen im Datenbank-Setup verwendet wird. Dann ist die Datenbanksicherung bereits in der Archivierung der Docker-Volumes enthalten (s. Schritt 2).
Neben den Docker-Volumes können Sie zusätzlich die KIX-Datenbank sichern. Dazu können Sie pg_dump des DB-Containers verwenden. Anhänge und Inhalte von Artikeln werden dabei nicht gesichert!
Anstelle von KIX-DB_backup können Sie einen anderen Dateinamen angeben, unter dem Sie die Datenbank sichern möchten.
```
shell> docker exec kix_db_1 pg_dump -U kix kix >> /tmp/KIXDB_backup.$(date "+%Y-%m-%dT:%H:%M:%S").sql.gz
```
Danach ist das Backup erstellt. Sie können KIX wieder starten.
Docker-Services wieder starten
1. Navigieren Sie in das Linux- bzw. Windows-Verzeichnis:
  Linux: cd kix-on-premise/deploy/linux
  Windows: cd kix-on-premise/deploy/windows
2. Führen Sie das Skript zum Starten des Docker-Services aus:
  Linux: ./start.sh
  Windows: start.ps1

Tipp

Standardmäßig nutzen ".tar" und ".gzip" nur einen Kern. Dadurch kann die Sicherung umfangreicher Installationen etwas Zeit in Anspruch nehmen.

Durch Installation und Verwendung des Tools Pigz können Sie das Sichern der Docker-Volumes beschleunigen. Pigz komprimiert die Datenpakte mithilfe von Threads, um mehrere Prozessoren und Kerne zu verwenden.

Beispiel

Es werden 4 Kerne zur Komprimierung verwendet.

shell> tar cf - /var/lib/docker/volumes/kix_backend/ /var/lib/docker/volumes/kix_frontend/ /var/lib/docker/volumes/kix_db/ /var/lib/docker/volumes/kix_shared/ | pigz p 4 > /tmp//KIXDockerVolumes.$(date "+%Y%m-%dT:%H:%M:%S").tar.gz

Mehr Informationen zu Pigz und dessen Verwendung finden Sie u. a. unter: https://de.ubunlog.com/pigz-komprimiert-Dateien-vom-Terminal/.

Eine On-Premises Installation wiederherstellen

Voraussetzung für das erfolgreiche Wiederherstellen einer On-Premises Installation ist das Vorhandensein eines zuvor erstellten, aktuellen und geprüften Backups.

Gehen Sie wie folgt vor:

Docker-Services stoppen
1. Navigieren Sie in das Linux- bzw. Windows-Verzeichnis:
  Linux: cd kix-on-premise/deploy/linux
  Windows: cd kix-on-premise/deploy/windows
2. Führen Sie das Skript zum Stoppen des Docker-Services aus:
  Linux: ./stop.sh
  Windows: stop.ps1
Siehe auch: https://github.com/kix-service-software/kix-on-premise/tree/master/deploy/linux#readme
Optional: Wiederherstellen der Datenbank
Dieser Schritt ist nur erforderlich, wenn Sie die Datenbank gesondert gesichert haben.
Spezifikation der Datenbank (gilt für alle Container):
• Vor Freigabe Version v26: kix_db_1
• Nach Freigabe Version v26: kix-db-1
1. Herstellen einer Datenbankverbindung
```
shell> docker exec -it kix_db_1 psql -U kix
```
2. Bisherige Datenbank löschen
```
shell> DO $$ DECLARE r RECORD;
BEGIN FOR r IN (SELECT tablename FROM pg_tables WHERE schemaname = current_schema()) LOOP
   EXECUTE 'DROP TABLE ' || quote_ident(r.tablename) || ' CASCADE';
END LOOP;
END $$;
```
3. Datenbank wiederherstellen (Dump importieren)
  Geben Sie anstelle KIXDockerVolumes_backup den Dateinamen an, unter dem Sie die Datenbank-Sicherung gespeichert haben.
  Im Beispiel erfolgt die Wiederherstellung über eine Zip-Datei. Haben Sie die Sicherung
```
shell> gunzip < /opt/KIXDB_backup.sql.gz | docker exec -i kix_db_1 psql kix -U kix
```
Sicherung der Docker-Volumes wiederherstellen
Docker-Volumes mit Sicherung ersetzen (auf dem Docker-Host unter Ubuntu bspw. in: /var/lib/docker/volumes/ )
Docker-Services wieder starten
1. Navigieren Sie in das Linux- bzw. Windows-Verzeichnis:
  Linux: cd kix-on-premise/deploy/linux
  Windows: cd kix-on-premise/deploy/windows
2. Führen Sie das Skript zum Starten des Docker-Services aus:
  Linux: ./start.sh
  Windows: start.ps1
Siehe auch: https://github.com/kix-service-software/kix-on-premise/tree/master/deploy/linux#readme

Hinweis

Beachten Sie die Datensicherungsstrategie Ihres Unternehmens. KIX kann auf einer Virtuellen Maschine betrieben werden, sodass auch diese Wiederherstellungspunkte verwendet werden können.

Sichern der KIX Cloud Umgebung

Sicherungen für KIX Cloud erfolgen regelmäßig und automatisiert.

Ein Backup der KIX Cloud kann auf Anfrage zum Download bereitgestellt werden.

Nutzer der KIX Cloud können sich im Rahmen ihres Supportvertrags an support@kixdesk.com wenden, wenn ein Backup benötigt wird oder um das System zurücksetzen zu lassen.

In diesem Abschnitt: