Du siehst Dir gerade den Artikel zu einer älteren Shopware Version an!
Damit Du ein Shopware Update vorab in Deiner Umgebung testen kannst, empfehlen wir Dir eine Testumgebung anzulegen. Wie genau Du diese anlegst, erfährst Du hier.
Wenn Du keine Testumgebung angelegt hast, erstelle in jedem Fall ein Backup, nur so kannst Du bei Problemen einfach wieder den Betrieb aufnehmen! Außerdem empfehlen wir in jedem Fall das immer vor einem Update des Live-Systems ein Backup erstellt werden muss, auch wenn dies vorher im Testsystem geprüft wurde.
Beachte, dass Shopware selber keine Backups erstellt. Diese solltest Du auf Deinem Server separat einrichten. Wenn Du Deinen Server bei einem Hostingpartner gehostet hast, übernimmt dieser in der Regel das Erstellen der Backups. Im Zweifel solltest Du Dich mit dem Hostingpartner in Verbindung setzen.
Bitte beachten Sie, dass sich die Systemvoraussetzungen geändert haben, die Systemvoraussetzungen für 6.4.0.0 finden Sie hier.
Stelle vor dem Update sicher, dass alle Deine installierten Erweiterungen aktuell und kompatibel sind und lösche ggf. inkompatible Erweiterungen, bevor Du updatest, da es sonst beim Update zu Problemen kommen kann und Du ein Backup einspielen musst. Es dürfen keine inkompatiblen Erweiterungen unter Meine Erweiterungen auftauchen! Egal ob aktiv oder nicht.
Ob Deine Erweiterungen kompatibel sind, siehst Du in unserem Store, über die Überprüfung durch den Auto-Updater im Admin oder über den Shopware-Account unter Lizenzen prüfen.
Entpacke das zip-Archiv (Shopware-Update) und kopiere alle Dateien per FTP über Deine Shopware Installation - die vorhandenen Dateien müssen überschrieben werden.
Alternativ kannst Du auch das Update-Paket in Dein Shopware-Verzeichnis auf den Server hochladen und es über die Verwaltungsoberfläche Deines Hosters entpacken, was meist deutlich schneller geht.
Nutze bitte nur das Update Paket auf der Changelog-Seite für das Entpacken!
Nachdem Du die Dateien erfolgreich hochgeladen hast, erscheint automatisch die Wartungsseite im Shop:
Rufe nun im Browser den Updater auf: http(s)://www.mein-shop.de/recovery/update/index.php
Folge nun den Schritten im Updater. Bei Shops mit größeren Datenbeständen kann der Schritt der Datenbank Migration längere Zeit in Anspruch nehmen.
Sollte nach Abschluss des Update-Vorgangs weiterhin der Wartungs-Modus aktiv sein, musst Du noch im Installationsverzeichnis den Ordner /update-assets entfernen. Wenn die Berechtigungen auf Deinem Server korrekt gesetzt sind, sollte dies jedoch automatisch passieren.
Bevor Du den Admin aufrufst, lösche bitte den Cache Deines Browsers (Cache & Offline Website Daten)
Rufe die Storefront auf und prüfe die Funktionalität - Sollten hier Probleme auftauchen, lösche ggf. die folgenden Ordner im Installationsverzeichnis von Shopware:
/var/cache/prod_xxxxxxxxxxxxxx
Prüfe nach dem Update, ob Dir Erweiterungs-Updates angeboten werden. Falls ja, installiere diese, um das Update vollständig abzuschließen.
Dieses Tutorial richtet sich an Nutzer, die mit der Shell vertraut sind. Die Shell führt Befehle ohne Rückfragen aus. Du solltest das Tutorial daher nur befolgen, wenn Du weißt, was Du tust. Im Falle eines Datenverlustes können wir keine Garantie gewährleisten. Erstelle daher vorher ein Backup Deines Servers!
Suche Dir im Changelog die richtige Shopware Version raus und kopiere den Downloadlink dafür. Achte darauf, dass der Link auf das Archiv mit dem Update verweist. Du bekommst den Download Link, indem Du mit der rechten Maustaste auf den Update-Button klickst und dort Link-Adresse kopieren auswählst.
Navigiere nun mit der Shell in das Hauptverzeichnis des Shops. Dort gibst Du diesen Befehl ein, um das Updatepaket downzuloaden:
wget URL_ZUM_DOWNLOAD
Oft kann der Downloadlink in der Shell ergänzt werden, indem dort mit der Maus rechts geklickt wird. Wenn Deine Shell kein Einfügen aus der Zwischenablage unterstützt, gib den Downloadlink manuell ein.
Nachdem der Download abgeschlossen ist, entpackst Du das Archiv mit:
unzip NAME_DER_ZIP_DATEI
Hier reicht es meist, einen eindeutigen Teil des Namens nach unzip einzugeben. Mit der Tab-Taste wird der komplette Name ergänzt.
Wichtig! Beide Befehle müssen innerhalb des Shopware Hauptverzeichnisses ausgeführt werden.
Möglichkeit 1: Update per Wizard
Das Wizard-Update wird mit dem folgenden Befehl angestoßen:
php public/recovery/update/index.php
Der Updater öffnet sich:
Mit ENTER startest Du das Update. Nachdem die Datenbank geupdated wurde, werden noch nicht mehr verwendete Dateien und der Cache gelöscht.
Vor der Version 6.4.2.0 kann es vereinzelt zu PHP Fehlermeldungen kommen. Diese beeinflussen das Update aber nicht. Folge dennoch dem folgenden Schritt, um zu überprüfen, ob das Update erfolgreich verlaufen ist.
Nachdem das Update abgeschlossen ist, meldet der Updater, dass die /update-assets noch gelöscht werden müssen, damit der Wartungsmodus des Shops entfernt wird:
Die /update-assets kannst Du mit dem folgenden Befehl löschen:
rm -r update-assets/
Neben den /update-assets kannst Du nach dem Update zusätzlich noch das Archiv löschen.
Dieses entfernst Du mit dem Befehl:
rm NAME_DER_ZIP_DATEI
Das Update ist damit abgeschlossen.
Möglichkeit 2: One-Line Update
Das Update kann auch kompakt mit nur einem Befehl ausgeführt werden, hierzu stehen die folgenden Attribute zur Auswahl:
Der Befehl zum Update lautet dann:
php public/recovery/update/index.php --no-interaction --quiet && rm -r update-assets/
Bevor Du den Shopware Admin aufrufst, lösche bitte den Cache Deines Browsers (Cache & Offline Website Daten).
Rufe das Frontend auf und prüfe die Funktionalität - Sollten hier Probleme auftauchen, lösche den Cache im Admin unter Einstellungen > System > Cache & Indizes
und ggf. zusätzlich die folgenden Ordner:
xxxxxxxxxxxx stellt hierbei die Revision der Shopware-Version dar.
Nach dem Update von Shopware, öffne im Shopware Admin den Punkt Erweiterungen > Meine Erweiterungen und schau, ob Dir Erweiterungs-Updates angeboten werden, falls ja, installiere diese, um das Update vollständig abzuschließen.
Selbstverständlich kannst Du ein Update auch direkt über die Administration durchführen. Du findest die Option unter Einstellungen > System > Shopware-Update. In dem Fenster bekommst Du Deine aktuelle Version angezeigt. Das Feld "Aktualisierungscode" kannst Du erst einmal außer Acht lassen. Dieser ist nur in Einzelfällen notwendig, wenn Du diesen vom Support erhältst, um beispielsweise gezielt ein Bugfix zu installieren.
Ein Update über die Administration kann im Gegensatz zu den beiden anderen Varianten immer nur auf die neueste Version vorgenommen werden.
(1) Über den Button Nach Updates suchen kannst Du gezielt suchen und überprüfen, ob Du ein Update auf die neueste Version durchführen kannst.
(2) Bevor Du das Update startest, werden die Systemvoraussetzungen nochmal überprüft. Sollte dort etwas nicht im grünen Bereich sein, solltest Du Dein System unbedingt vorher auf die erforderlichen Systemvoraussetzungen überprüfen und gegebenenfalls anpassen.
Der letzte Schritt vor der Installation des Updates erfordert die Überprüfung Deiner Erweiterungen. Hier solltest Du alle inkompatiblen Erweiterungen deaktivieren (3). Im Anschluss kannst Du das Update installieren.
Wenn Du alle Schritte befolgt hast und das Update installierst, wirst Du auf der linken Seite die grünen Häkchen sehen. Dann kannst Du das Update erfolgreich abschließen.
Bitte beachte, dass diese Methode aktuell nicht bei einem Update von Shopware 6.4.20.2 auf 6.5.x.x möglich ist.
Seit Version 6.3.0 ist dieser Weg möglich.
Navigiere mit der Shell in das Hauptverzeichnis des Shops. Dort gibst Du diesen Befehl ein:
bin/console system:update:prepare
Öffne dann die composer.json im Hauptverzeichnis und ersetze shopware/core... mit der benötigten Shopware Version.
Daraufhin kannst Du mit folgendem Befehl das Update durchführen:
composer update
Führe die Datenbank Migration mit folgendem Befehl aus:
bin/console system:update:finish