Migrationsprozess - Shopware 6

Migration vorbereiten

Migrationsassistent installieren

Für diese Verbindung zwischen dem Quellshop und dem Zielshop ist die Erweiterung Migration-Assistent notwendig. Installiere diese Erweiterung sowohl im Quellshop als auch im Zielshop. Eine Verbindung ist nur dann möglich, wenn die Erweiterung in beiden Shops installiert und auch aktiviert wurde. 

Die Einrichtung des Shops sollte erst dann beendet werden, wenn die Migration erfolgreich abgeschlossen wurde. Fehler während der Migration sollten nicht ignoriert werden. Wenn dies nicht beachtet wird, ist eine Neuinstallation des Shops notwendig.

Integration erstellen

Um mit dem Zielshop auf die Daten des Quellshops zuzugreifen ist es notwendig, im Quellshop zusätzlich eine Integration bereit zu stellen. Mit Integrationen kannst Du Drittanwendungen über die API Zugriff auf verschiedene Ressourcen Deines Shops geben. Detaillierte Informationen dazu, was Integrationen sind und wie Du sie verwendest erhälst Du hier. 
Um eine neue Integration für die Migration anzulegen öffnest Du im Quellshop Einstellungen > System > Integrationen und klickst rechts oben auf Integration anlegen.  Anschließend speicherst Du dort folgende Einstellungen:

Name (1): Trage hier einen eindeutigen Namen wie Migration ein, damit Du diese Integration von den anderen unterscheiden kannst.
Administrator (2): Aktiviere diese Option, damit der Zielshop auf alle wichtigen Ressourcen in Deinem Quellshop zugreifen kann. 
Zugangs-ID (3): Die Zugangs-ID wird automatisch generiert. Mit Hilfe dieser ID kann der Zielshop auf den Quellshop zugreifen. Du solltest sie Dir notieren, da Du sie im nächsten Schritt benötigen wirst. 
Sicherheitsschlüssel (4): Auch derSicherheitsschlüssel wird automatisch generiert und wird benötigt um den Zugriff aus dem Zielshop zu legitimieren. Auch diesen Schlüssel benötigst Du beim Herstellen der Verbindung. Du solltest dir diesen also auch zwischenspeichern. 

Nachdem Du die Integration über den Button Integration speichern angelegt hast, kannst Du nun im nächsten Schritt die Verbindung zwischen dem Zielshop und dem Quellshop aufbauen. 

Verbindung herstellen

Damit Du Deine Daten aus dem Shopware 6 Quellshop in Deinen Shopware 6 Zielshop migrieren kannst, ist es notwendig eine Verbindung zwischen diesen beiden Shops her zu stellen.
Nach der Installation der Erweiterung öffnest Du die Konfigurationen im Admin des Zielshops unter dem Menüpunkt Einstellungen > Erweiterungen > Migrations-Assistent und baust Dort die Verbindung zu dem Quellshop auf. 

Beim ersten Start öffnet sich der Assistent zum Verbindungsaufbau automatisch. Sollte dieser nicht automatisch starten oder Du ihn geschlossen haben klicke auf Verbindung anlegen um eine neue Verbindung anzulegen.

Name: Hier gibst Du zunächst einen eindeutigen Namen für die Verbindung an. Dies ist vor allem Dann notwendig, wenn du eventuell zu mehreren Shops eine Verbindung aufbauen möchtest. 
Profil: Bezeichnet die Art des Quellsystems. Für eine Migration von einem Shopware 6 Shop wähle hier Shopware >=6.3.0.0. 
Schnittstelle: Bezeichnet die Art der Verbindung zwischen den beiden Systemen. Dies ist nur bei dem Profil 5.3 von bedeutung. Für das Shopware 6 Profil steht Dir hier nur API zur Verfügung.

Migrationsdaten kontrollieren

Nachdem Du alle notwendigen Angaben Deiner Verbindung gemacht hast, wirst Du zur Migrationsübersicht weiter geleitet. Hier hast Du eine Übersicht über die aktuelle Verbindung, kannst wählen, welche Daten migriert werden und Deine bisherigen Migrationen verfolgen. 

Übersicht

Nachdem Du die Verbindung erfolgreich aufgebaut hast, gelangst Du automatisch zur Übersicht der Migration. Hier siehst Du, zu welchem Shopsystem (1) Du aktuell eine Verbindung aufgebaut hast. Zu der Verbindung kannst Du auch gleich einsehen, welches System-Profil und welche Schnittstelle verwendet wurde, wann der letzte Verbindungscheck durchgeführt wurde und wann mit dieser Verbindung die letzte Migration durchgeführt wurde. Über den Button Verbindung bearbeiten (2) kannst Du Änderungen an der aktuellen Verbindung vornehmen.
Über das Dropdown Menü (3) kannst Du eine neue Verbindung anlegen, die Zugangsdaten der aktuellen Verbindung löschen oder zu einer anderen angelegten Verbindung zu wechseln. Außerdem lässt sich über dieses Dropdown Menü die Prüfsummen zurücksetzen, um nestehende Daten erneut zu migrieren. 

Datenauswahl

In der Datenauswahl entscheidest Du, welche Daten Du aus Deiner Verbindung in den Shopware 6 Shop migrieren möchtest. Hierzu setzt Du einfach den Haken bei den entsprechenden Daten, die migriert werden sollen. Die Liste zeigt Dir außerdem, ob es sich um Shopdaten oder Erweiterungsdaten handelt und wie viele Datensätze migriert werden.

Erweiterungen: Daten, die aus Erweiterungen von Drittanbietern migriert werden können, werden in dieser Liste mit dem Typ Plugindaten angezeigt.
Unter Umständen bieten einige Drittanbieter auch ein eigenes Migrationsprofil für Ihre Erweiterungen Daten an, welches dann zur Migration verwendet werden muss. In diesem Fall erhältst Du alle Informationen zur Migration von dem entsprechenden Anbieter.

Historie

In der Historie hast Du die Möglichkeit, dir alle bisherigen Migrationen und Migrationsversuche anzusehen. Hierbei werden die sämtliche Informationen der Migrationen angezeigt. 

 

Migration durchführen

Während des Migrationsvorganges ist es wichtig, dass der Tab, in der die Migration gestartet wurde, bis zum Abschluss der Migration geöffnet bleibt, da es sonst zu einem Abbruch der Migration kommen kann. 

Nach dem Du auf Migration starten geklickt hast, wird die Migration in vier Schritten durchgeführt. Datencheck, Lesen der Daten, Schreiben der Daten und dem Medien Download.

Datencheck

Die Migration führt nun einen Datencheck durch. Hierbei wird überprüft, ob Daten aus dem alten Shop dem neuen zugeordnet werden können.

Manuelle Zuordnung:

Wenn Daten, wie beispielsweise die Standard Zahlungsart, nicht korrekt zugeordnet werden konnten, ist es notwendig diese manuell zuzuordnen. Sobald Du alle nicht zugeordneten Daten manuell zugeordnet hast, kannst Du die Migration über den Button Fortfahren fortsetzen. Wenn alle Daten ohne Probleme zugeordnet werden konnten ist keine manuelle Zuordnung mehr notwendig. In diesem Fall kannst Du die Migration sofort fortfahren. 

Durchgeführte Zuordnung: 

 

In den durchgeführten Zuordnungen kannst Du kontrollieren ob die automatisch zugeordneten Daten korrekt zugeordnet wurden. Hier kannst Du auch nachträglich Deine Zuordnungen ändern oder auch die automatischen Zuordnungen nachträglich ändern. 

Solltest Du eine besonders große Shopware 6 Installation haben, kannst Du die Migration an diesem Punkt auch über die Konsole (CLI) durchführen. Bricht den Vorgang hierzu nach dem Datencheck ab und setze die Migration hier fort. 

Lesen der Daten

In diesem Schritt werden alle Daten aus dem Quell-Shop gelesen, die migriert werden sollen. 
Alle gelesenen Daten erhalten eine Checksumme, mit der bei späteren Migrationen überprüft wird, ob die Daten schon mal migriert wurde. Alle unveränderten Daten werden somit nicht erneut migriert. 

Sollte es dazu kommen, dass Daten nicht migriert werden, obwohl sie sich geändert haben, können die Checksummen zurückgesetzt werden. Näheres dazu erfährst Du im Bereich Migration erneut durchführen.

Schreiben der Daten

Die gelesenen Daten werden nun in Shopware 6 geschrieben. Dabei werden Kundengruppen, Kategorien, Sprachen, Währungen und Verkaufskanäle in diesem Schritt, wenn noch nicht vorhanden, automatisch in Shopware 6 angelegt.

Medien Download

In diesem Schritt werden alle Mediadateien aus dem Quellshop heruntergeladen und in die Zielshop Medienverwaltung geladen. 

Migration bei großen Datenmengen über die Konsole

Wenn Du die Schritte Lesen der Daten, Schreiben der Daten und Medien Download bereits durchgeführt hast, kannst Du diesen Punkt überspringen.

Die Migration lässt sich nach dem Schritt Datencheck auch über die Konsole (CLI) starten. Dies ist beispieslweise dann sinnvoll, wenn Dein Quellshop sehr große Datenmengen beinhaltet oder Du die Migration im Hintergrund laufen lassen möchtest.

Wichtig ist, dass Du die Migration zunächst normal über die Administration startest und nach dem Schritt Datencheck abbrichst. 
Navigiere dann in der Konsole in das Hauptverzeichnis des Zielshops. Du solltest Dich jetzt oberhalb des Ordners public befinden.

 

Führe hier folgenden Befehl aus:

php bin/console migration:migrate Argument

Die Variable Argument kann folgende Werte enthalten: 
 

basicSettings	Grundeinstellungen und Kategorien (SalesChannel Anlage etc.) Wird automatisch beim Import anderer DataSelections ausgeführt.
cms	Layouts
customersOrders	Alle Kunden, Bestellungen und Dokumente.
media	Alle Medien und Ordner.
newsletterRecipient	Newsletter-Empfänger
products	Alle Produktdaten und dazugehörigen Entitäten. Ebenfalls dazugehörige Entitäten aus "media".
productReviews	Produktbewertungen
promotions	Rabatte & Aktionen
seoUrls	SEO URLs
customerWishlists	Merklisten

Migration erneut durchführen

Du kannst die Migration beliebig oft erneut durchführen. Bei der ersten Migration erhalten alle migrierten Daten eine Prüfsumme. Anhand dieser Prüfsumme erkennt der Migrations-Assistent, ob Daten migriert werden müssen oder nicht. So wird verhindert, dass Daten doppelt migriert werden und ggf. überschrieben werden. 
Wenn Du eine Migration komplett erneut durchführen möchtest, sodass alle Daten im Zielsystem überschrieben werden, kannst Du die Prüfsummen zurücksetzen. Dies tust Du in der Migrationsübersicht im Bereich Shopsystem über das Dropdownmenü.