Alles über das Shopware 6 Update.

1. Schritt: Backup

Backup des FileSystems

Die schnellste und einfachste Methode, um ein Backup als Zip-Datei zu erstellen, ist via SSH. Der folgende Befehl hilft dabei, die komprimierte Backup-Datei ohne die Verzeichnisse für Bilder, Cache und Log zu erstellen.

Achtung: Der Pfad zur Installation ~/htdocs/shopware muss ggf. angepasst werden!

zip -r backup-file.zip ~/htdocs/shopware -x ~/htdocs/shopware/public/thumbnail/**\* ~/htdocs/shopware/public/media/**\* ~/htdocs/shopware/var/cache/**\* ~/htdocs/shopware/var/log/**\*

Backup der Datenbank

Auch hier bietet sich die Sicherung der Datenbank via SSH an.

Hosting-Tipps

Backup einer Datenbank via SSH erstellen

2. Schritt: Update

Es ist empfehlenswert, vor dem Update den Cache Ordner zu leeren, um später Zeit bei der Update-Routine zu sparen:

rm -r ~/htdocs/shopware/var/cache/*

Minor Update

Minor Updates (z.B. 6.6.0.x → 6.6.1.x) sind kleine Updates oder Sicherheits-Patches.

Update via SSH & Composer

Ab Shopware v6.5

Das Update kann via SSH mithilfe von Composer in drei einfachen Schritten durchgeführt werden.

Achtung: Diese Methode gilt ausschließlich für Minor-/Patch-Updates innerhalb derselben Major-Version; nicht für Major-Upgrades.

Achtung: In manchen Fällen muss vorher die Version für Shopware in der composer.json Datei angepasst werden.

bin/console system:update:prepare

composer update

bin/console system:update:finish

Offizielle Dokumentation

Update über Composer

Major Update

Major Updates (z.B. 6.6.x → 6.7.x) sind umfangreiche Updates mit teilweise kritischen Änderungen. Vor dem Update müssen alle Plugins, Apps und Themes auf Kompatibilität geprüft werden. Anschließend kann das Upgrade gemäß dem offiziellen Guide durchgeführt werden.

Wichtige Anpassungen

Von Shopware v6.4 auf Shopware v6.5

• Den Inhalt von Datei /config/packages/shopware.yaml nach /config/packages/z-shopware.yaml verschieben
• Individuelle Konfigurationen aus der Datei .env in eine neue Datei .env.local übertragen

Update via Backoffice

Bevor das Upgrade auf eine höhere Major Version durchgeführt wird, müssen alle installierten Plugins deaktiviert werden, sowie auch das eingesetzte Theme auf das Standard-Theme zurückgesetzt werden. Es bietet sich für ein solch umfangreiches Update außerdem an, den Wartungsmodus zu aktivieren.

In einigen Projekten kann das Update via Backend gesperrt sein - dies muss zunächst wieder rückgängig gemacht werden. Dazu muss lediglich das entsprechende Flag auf true gesetzt werden, oder es kann auch der gesamte Code-Block aus der Datei shopware.yaml, bzw. z-shopware.yaml entfernt werden:

shopware:
    auto_update:
        enabled: true

Anschließend sollte der Cache geleert werden. nun können Updates wieder via Backend abgerufen werden:

Offizielle Dokumentation

Update per Administration

Sonstiges

System-Voraussetzungen

• Git muss auf dem Server installiert sein
• In den PHP-Einstellungen muss das Verzeichnis /usr/bin für die Option open_basedir in der Liste der erlaubten Verzeichnisse aufgelistet sein
• Der Datenbank-Nutzer benötigt SUPER-Rechte, oder zumindest die aktive Option log_bin_trust_function_creators
• proc_open muss aufrufbar sein

Bekannte Fehler während des Updates

Von Shopware v6.6 auf Shopware v6.7