Shopware aktualisieren / updaten

Das Update ist durchgeführt und du kannst die Administration aufrufen.

Update per Administration

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. 

Schritt 1: Systemvoraussetzungen überprüfen

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

(2) Beim Punkt Erweiterungskompatibilität erfährst du noch, ob deine aktivierten Erweiterungen in der nächsten Version zur Verfügung stehen. Eine der drei folgenden Statusmeldungen wird bei dir im System hinter jeder Erweiterung beim Update stehen:

• Bereits kompatibel - Bedeutet, dass die installierte Version der Erweiterung mit der neuen Shopware Version bereits kompatibel ist.

• Mit der neuen Shopware Version - Bedeutet, dass du nach dem Update des Shops die Möglichkeit hast, die Erweiterung auf eine kompatible Version zu aktualisieren.

• Nicht kompatibel - Bedeutet, dass es für diese Erweiterung keine Nachfolgeversion gibt und diese inkompatibel mit der neuen Shopware Version sein wird. 

Schritt 2: Erweiterungen deaktivieren

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.

Die Bestätigung, dass du eine Sicherung erstellt hast, ist immer notwendig. Setze den Haken bei Ja, ich habe meine Daten gesichert, wenn du auf ein aktuelles Backup zurrückgreifen kannst. Im Anschluss wird Installieren aktiv und du kannst das Update starten.
Das obere Formular wird dir angezeigt, wenn Shopware bei der Überprüfung inkompatible oder nicht überprüfbare Erweiterungen in deiner Installation feststellt.

• Alle Erweiterungen deaktivieren versuche alle aktiven Erweiterungen zu deaktivieren, unabhängig davon, ob sie kompatibel sind oder nicht.

• Inkompatible Erweiterungen deaktivieren führt dazu, dass der Shopware Updater vor dem eigentlichen Update alle Erweiterungen deaktiviert, die dir vorher als nicht kompatibel angezeigt worden sind. 

• Ich bin mir der potentiellen Gefahren bewusst... hiermit bestätigst du, dass du ein Update durchführen möchtest, ohne dass Shopware eine Erweiterung deaktiviert. Wenn du diese Option wählst, birgt das die Gefahr, dass das Update abbricht oder der Shop bei erfolgreichem Update nicht mehr aufgerufen werden kann.

In der Regel reicht es aus, dass du das Update mit der empfohlenen Einstellung startest. 

Welche Möglichkeiten habe ich, wenn der automatische Updater nicht alle Erweiterungen deaktivieren kann?

Wenn das Update nicht startet, kann das unterschiedliche Gründe haben. Daher stellen die folgenden Punkte mögliche Lösungen dar, die bereits bei mehrmals erfolgreich angewendet wurden.

1. Da per Standard nur die inkompatiblen Erweiterungen deaktiviert werden, wähle Alle Erweiterungen deaktivieren und starte dann das Update erneut.

2. Wenn du auch hier die Meldung erhältst, dass der automatische Updater die Erweiterungen nicht deaktivieren konnte, versuche unter Erweiterungen > Meine Erweiterungen die Erweiterungen manuell zu deaktivieren. 

3. Die Deaktivierung der Erweiterungen ist auch per Datenbank möglich. Dazu findest du eine ausführliche Anleitung hier.

4. Beim Majorupdate, zum Beispiel von 6.4 auf 6.5 ist es notwendig alle Erweiterungen zu deaktivieren. Auch dafür kannst du die Anleitung unter 3. verwenden. Bei dem SQL Befehl zur Deaktivierung der Erweiterungen lässt du dann den WHERE Teil weg. 

Hast du einen der Punkte 2.-4. angewendet, wähle beim Update keine der Optionen zur Deaktivierung der Erweiterungen durch den Updater. 

Schritt 3: Installiere das Update

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.

Update über Composer

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 

Die Versionen von shopware/administration, -storefront, elasticsearch usw. müssen ebenfalls für die gewünschte Shopware Version angepasst werden.

Führe die Datenbank Migration mit folgendem Befehl aus: 

bin/console system:update:finish

Um die Aktualisierung aller Konfigurationsdateien zu erzwingen, führe diesen Befehl aus:  

composer recipes:update

Bekannte Fehler umgehen

 APP_ENV=dev web_profiler fehlende Erweiterung Fehler: Vor Shopware Version 6.4.17.0 musst du das Profiler-Bundle installieren, damit APP_ENV=dev funktioniert:

composer require --dev profiler

framework:demo-data fehlen Faker-Klassen: Vor Shopware Version 6.4.17.0 musst du einige Pakete installieren, damit der Befehl framework:demo-data funktioniert:

composer require --dev mbezhanov/faker-provider-collection maltyxx/images-generator