Migrationsprozess - Shopware 5

Migration vorbereiten

Installation der Erweiterungen

Nachdem du Shopware 6 auf deinem Server erfolgreich installiert hast, kannst du mit der Migration deines Shopware-5-Shops beginnen. Hierzu benötigst du zunächst die Erweiterung SwagMigrationAssistent für Shopware 6, die du aus dem Community Store erhältst.
Zudem ist es notwendig, in deinem Shopware-5-Shop, aus dem du migrieren möchtest, die Erweiterung SwagMigrationConnector zu installieren.

Die nachfolgende Beschreibung des Migrationsprozesses bezieht sich auf den Migrationsassistenten ab Version 16.0.0 der Erweiterung.

Migrationsverbindung herstellen

Damit du deine Daten aus Shopware 5 in deinen Shopware-6-Shop migrieren kannst, muss zunächst eine Verbindung zu deinem bisherigen Shopware-5-Shop hergestellt werden. Dies startest du in der Shopware-6-Administration unter dem Menüpunkt Einstellungen > Erweiterungen > Migration.

 
Solange diese Verbindung zu deinem Shopware-5-Shop besteht, kannst du jederzeit Daten aus dem Shopware-5-Shop migrieren. 

Folge der Anleitung zur Herstellung der Migrationsverbindung in diesem Docs-Artikel: Migrationsverbindung herstellen

Bitte verwende keine Bindestriche im Verbindungsnamen. Die Freitextfelder aus Shopware 5 werden in Shopware 6 als Zusatzfelder mit dem Verbindungsnamen übernommen. Wenn ein Bindestrich vorhanden ist, werden die Zusatzfelder in der Storefront nicht mehr korrekt dargestellt.

Verbindung bearbeiten

Je nach Schnittstelle, die du im letzten Schritt gewählt hast, erhältst du nun eine der folgenden beiden Abfragen.

API:
 

• API-Schlüssel: Hier trägst du den API-Schlüssel deines Shopware-5-Benutzers ein. Wenn noch keiner angelegt wurde, kannst du das in der Benutzerverwaltung von Shopware 5 nachholen.

• Benutzername: Hier trägst du den Benutzernamen deines Shopware 5-Administrators ein. Dies muss der Benutzer sein, für den der o.a. API-Schlüssel zugeordnet wurde. Wichtig ist, dass dieser Benutzer der Gruppe "local_admins" angehört. 

• Shopdomain: Trage hier die Domain deines Hauptshops ein. Achte darauf, anzugeben, ob der Shop eine sichere SSL-Verbindung nutzt.

Local:
 

• DB-Host: Trage hier die Host-URL deiner Datenbank ein. Wenn die Datenbank auf demselben Server installiert ist, kannst du hier auch localhost eingeben.

• DB-Port: Trage hier den Standardport deiner Datenbank ein. In der Regel ist dies standardmäßig 3306.

• DB-Benutzer: Gib hier einen Datenbankbenutzer mit Administrationsrechten an.

• DB-Passwort: Gib hier das Passwort für den oben angegebenen Datenbankbenutzer an.

• DB-Name: Hier trägst Du den Datenbanknamen der Datenbank ein, welche die Daten deiner Shopware-5-Installation beinhaltet.

• Root Verzeichnis: Trage hier den absoluten Pfad zu dem Verzeichnis an, in dem Shopware 5 installiert wurde. 

Meta Daten anpassen

Im Rahmen der Migration wird es dazu kommen, dass einige Metadaten gekürzt werden, da sich der Datentyp von mediumtext auf varchar(255) ändern wird. Diese Werte werden somit nach 255 Zeichen abgeschnitten. 
Folgende Werte sind davon betroffen: 
 

Migrationsdaten kontrollieren & Migration durchführen

Nachdem du alle notwendigen Angaben zu deiner Verbindung gemacht hast, wirst du zur Migrationsübersicht weitergeleitet. Hier hast du eine Übersicht über die aktuelle Verbindung, kannst wählen, welche Daten migriert werden, und deine bisherigen Migrationen verfolgen.

Folge der Anleitung zur Kontrolle der Migrationsdaten und der anschließenden Durchführung der Migration in diesem Docs-Artikel: Migrationsdaten kontrollieren