Migration process - Magento

Prepare migration

Access to the Magento installation

For a successful migration it is necessary that the migration extension in the Shopware 6 installation has access to the Magento installation and the database. Only then can all media be migrated completely from the Magento shop directory.

Extension installation

Once you have successfully installed Shopware 6 on your server, you can begin migrating your Magento Shop. For this, you need the extensions SwagMigrationAssistant for Shopware 6 and the Magento Migration Profile, both available from the Community Store.
After you have purchased the extension in the store for free, you can install it in the Shopware administration under Settings > Extensions.
If the extension is not yet displayed here, check whether you are logged in to Shopware 6 Admin with the same Shopware account as in the Shopware Community Store. 

The following description of the migration process refers to the migration assistant from version 16.0.0 of the extension

Establish connection

To migrate your data from Magento to your Shopware 6 shop, you must first connect your Shopware 6 installation to the database of your Magento shop. You start this in Shopware 6 administration under the menu item Settings > Extensions > Migration Assistant
Once this connection to your Magento database has been established, you can migrate data from your Magento shop at any time.
Your Magento Shop will not be changed until your Shopware 6 Shop goes live and will run until then. You can also migrate subsequent changes to your Magento data at any time. 

Follow the instructions for creating the migration connection in this Docs article: Create a migration connection

Edit connection

The next step is to specify the Magento database you want to migrate from. This database is generally read only. No changes will be made there.

  • Host: Enter the Host URL of your database here. If the database is installed on the same server, you can also enter localhost here.

  • Port: Enter the default port of your database here. Usually this is 3306 by default.

  • Username: Enter a database user with administration rights here.

  • Password: Enter here the password for the database user specified above.

  • Database name: Here you enter the database name of the database which contains the data of your Magento installation.

  • Migrate media via download: Activate this option if the media path of the source system is not locally accessible through the migration wizard. You then have the option to specify an external source system url from which the product images should be downloaded.

  • Shop installation folder: This field is available if you have not checked the option migrate media by download. Enter the absolute path to the directory where Magento was installed. This is necessary because some media are only stored locally in the Magento directory and not in the database.

  • Source system url: This field is available if you have enabled the option Migrate media via download. Enter the URL to the source system from which the product images are to be downloaded and then migrated.

  • Database table prefix: In Magento you had the possibility to set a global prefix before the database tables. If you did, enter this prefix here. 



When you have finished, click on Connect to establish a connection to the specified database.

It is important to enter the exact and complete path to the Magento installation in the area Shop installation folder and Source system Url, otherwise problems may occur during the migration of the product images.


Modify Meta Data

As part of the migration, some metadata will be truncated as the database type will change from mediumtext to varchar(255). These values will therefore be truncated after 255 characters. 
The following values are affected: 
 

tablecolumn
s_articledescription
s_categoriesmetadescription
metakeywords

Check migration & perform the migration

Once you have entered all the necessary information about your connection, you will be redirected to the migration overview. Here you will find an overview of the current connection, can select which data to migrate, and track your previous migrations.

Follow the instructions for checking the migration data and then performing the migration in this Docs article: Check migration data

Was this article helpful?