Installation

Systemanforderungen

Bevor Sie EcomSec Backup Professional installieren, stellen Sie sicher, dass Ihr System die folgenden Anforderungen erfüllt.

Shopware

• Shopware Version: 6.4.x oder höher
• PHP Version: 8.0 oder höher
• MySQL/MariaDB: 5.7+ / 10.2+

PHP-Funktionen

Die folgenden PHP-Funktionen müssen aktiviert sein:

• exec - Für Ausführung von System-Befehlen
• shell_exec - Für Shell-Befehle
• proc_open - Für Prozess-Verwaltung

Shared Hosting

Auf manchen Shared-Hosting-Umgebungen sind diese Funktionen aus Sicherheitsgründen deaktiviert. Kontaktieren Sie Ihren Hoster falls Probleme auftreten.

System-Tools

Die folgenden Tools müssen auf Ihrem Server installiert sein:

Tool	Zweck	Prüfen mit
mysqldump	Datenbank-Export	which mysqldump
mysql	Datenbank-Import	which mysql
tar	Archiv-Erstellung	which tar
gzip	Komprimierung	which gzip

Speicherplatz

Stellen Sie sicher, dass ausreichend Speicherplatz verfügbar ist:

• Minimum: 2x die Größe Ihrer Datenbank + Media-Dateien
• Empfohlen: 3-5x für mehrere Backup-Versionen

Beispiel:

• Datenbank: 1 GB
• Media-Dateien: 10 GB
• Benötigter Speicher: Mindestens 22 GB (besser 33-55 GB)

---

Installation über Shopware Plugin Manager

Schritt 1: Plugin hochladen

1. Laden Sie die Plugin-ZIP-Datei herunter
2. Melden Sie sich in Ihrer Shopware-Administration an
3. Navigieren Sie zu Erweiterungen > Meine Erweiterungen
4. Klicken Sie auf Erweiterung hochladen
5. Wählen Sie die heruntergeladene ZIP-Datei aus
6. Klicken Sie auf Hochladen

Schritt 2: Plugin installieren

1. Suchen Sie "EcomSec Backup Professional" in der Liste
2. Klicken Sie auf Installieren
3. Warten Sie bis die Installation abgeschlossen ist
4. Sie sehen eine Erfolgs-Meldung

Schritt 3: Plugin aktivieren

1. Klicken Sie auf Aktivieren
2. Der Cache wird automatisch geleert
3. Das Plugin ist nun aktiv

Tipp

Nach der Aktivierung finden Sie das Plugin im Hauptmenü unter "EcomSec Backup".

---

Erste Konfiguration

Nach der Aktivierung müssen Sie das Plugin konfigurieren.

Konfiguration öffnen

1. Gehen Sie zu Einstellungen > System > Plugins
2. Suchen Sie "EcomSec Backup Professional"
3. Klicken Sie auf das 3-Punkte-Menü (⋮)
4. Wählen Sie Konfiguration

1. Backup-Pfad festlegen

Standard: /var/backups

Der Backup-Pfad ist das Verzeichnis, in dem Ihre Backups gespeichert werden.

Empfehlungen:

Hosting-Typ	Empfohlener Pfad
VPS/Dedicated	/var/backups (Standard)
Shared Hosting	/home/username/backups
Docker	/var/www/html/var/backups

Wichtig:

• Das Verzeichnis muss schreibbar sein
• Es muss ausreichend Speicherplatz haben
• Es sollte außerhalb des öffentlichen Web-Verzeichnisses liegen

Sicherheit

Legen Sie den Backup-Pfad NIEMALS in public/ oder einem öffentlich zugänglichen Verzeichnis an!

2. Encryption Key generieren

1. Klicken Sie auf Encryption Key generieren
2. Ein zufälliger, sicherer Key wird erstellt
3. WICHTIG: Kopieren Sie den Key und speichern Sie ihn an einem sicheren Ort!

KRITISCH

Ohne den Encryption Key können verschlüsselte Backups NICHT wiederhergestellt werden!

Best Practice:

• Speichern Sie den Key in einem Passwort-Manager
• Notieren Sie ihn zusätzlich auf Papier
• Bewahren Sie ihn an einem sicheren Ort auf
• Teilen Sie ihn NIEMALS mit Dritten

3. Retention Policy einstellen

Die Retention Policy legt fest, wie viele alte Backups automatisch behalten werden.

Empfohlene Werte:

Shop-Größe	Backup-Frequenz	Retention
Klein	Täglich	7 Tage
Mittel	Täglich	14 Tage
Groß	Mehrmals täglich	30 Tage

Beispiel:

• Retention: 7 Tage
• Backup-Frequenz: Täglich
• Ergebnis: Es werden immer die letzten 7 Backups behalten, ältere werden automatisch gelöscht

4. Weitere Einstellungen (Optional)

• E-Mail-Benachrichtigungen: Erhalten Sie E-Mails bei erfolgreichen/fehlgeschlagenen Backups
• Komprimierung: Standardmäßig aktiviert (empfohlen)
• Verschlüsselung aktivieren: Standardmäßig für neue Backups

---

Verifizierung der Installation

1. Backup-Verzeichnis prüfen

Prüfen Sie, ob das Backup-Verzeichnis erstellt wurde und schreibbar ist:

# SSH auf Ihren Server
ls -la /var/backups

# Sollte zeigen:
drwx------ 2 www-data www-data 4096 Jan 15 10:00 .

2. Erstes Test-Backup erstellen

1. Gehen Sie zu EcomSec Backup > Backups
2. Klicken Sie auf Backup erstellen
3. Wählen Sie Database Only (schnellster Test)
4. Klicken Sie auf Erstellen
5. Warten Sie bis das Backup abgeschlossen ist

Tipp

Das erste Backup dauert je nach Datenbankgröße 1-5 Minuten.

3. Backup-Datei prüfen

Prüfen Sie, ob die Backup-Datei erstellt wurde:

ls -lh /var/backups

Sie sollten eine Datei sehen wie:

database_2025-01-15_10-30-45_a1b2c3d4.sql.gz

4. Audit-Log prüfen

1. Gehen Sie zu EcomSec Backup > Audit Log
2. Prüfen Sie, ob das Backup erfolgreich geloggt wurde
3. Sie sollten einen Eintrag "backup_created" sehen

---

Troubleshooting

Problem: "mysqldump not found"

Lösung: mysqldump ist nicht installiert oder nicht im PATH.

Debian/Ubuntu:

sudo apt-get update
sudo apt-get install mysql-client

CentOS/RHEL:

sudo yum install mysql

Shared Hosting: Kontaktieren Sie Ihren Hoster.

Problem: "Permission denied" beim Backup

Lösung: Backup-Verzeichnis ist nicht schreibbar.

# Berechtigungen setzen
sudo chmod 700 /var/backups
sudo chown www-data:www-data /var/backups

Problem: Plugin erscheint nicht im Menü

Lösung: Cache leeren.

cd /path/to/shopware
bin/console cache:clear

Oder über die Administration: Einstellungen > System > Caches & Indizes > Alle löschen

Problem: "exec() has been disabled"

Lösung: PHP-Funktion exec ist deaktiviert.

Shared Hosting: Kontaktieren Sie Ihren Hoster und bitten Sie um Aktivierung.

VPS/Dedicated: Entfernen Sie exec aus disable_functions in php.ini:

; Vorher:
disable_functions = exec,shell_exec,system

; Nachher:
disable_functions = system

Danach PHP-FPM/Apache neu starten.

---

Nächste Schritte

Glückwunsch! Das Plugin ist jetzt installiert und konfiguriert.

Empfohlene nächste Schritte:

1. Quick Start Guide - Ihr erstes richtiges Backup
2. Was wird gesichert? - Verstehen Sie was gesichert wird
3. Automatische Backups einrichten - Backups automatisieren
4. Test-Restore durchführen - Testen Sie die Wiederherstellung

---

Support

Benötigen Sie Hilfe?

• FAQ - Häufig gestellte Fragen
• Troubleshooting - Probleme lösen
• GitHub Issues - Bug melden
• E-Mail Support - Direkter Support