As of January 2021, the migration process can be performed from M2E Pro v6.13.x on Magento v1.x to M2E Pro v1.13.x on Magento v2.x.

Start the migration only after you successfully install both required Module versions. Once you confirm the migration running, your Module on Magento v1.x will be put under maintenance and the process cannot be stopped.

During the migration, all M2E Pro data will be saved, including your Channel Sales, Product and Order logs, Scheduled and In Progress actions, etc. Read more here.

Some features may work differently or be temporarily unavailable in M2E Pro Magento v2.x. More details can be found in our Migration Notes.

If you are still worried about how the migration process will go, why don’t you try it on first? You can find instructions on how to run test Migration in our article

This article describes the overall preparation and execution of the data migration from Magento v1.x to Magento v2.x. Please note that the process requires technical skills. You can consult your developers if you need it.

Preliminary requirements

1. Install the minimum supported Module versions for the data migration:

2. Transfer your Magento database from v1.x to v2.x.

Note

If you use the Magento Data Migration Tool to migrate your Magento database, you must ignore all M2E Pro tables (the table names contain prefix 'm2epro_') navigating by the pattern:

%magento2_installation_directory%/vendor/magento/data-migration-tool/etc/%from_edition%_to_%to_edition%/%source_magento_version%/map.xml .

Please find the example below:

<map xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="../../map.xsd">
    <source>
        <document_rules>
            <ignore>
                <document>m2epro_account</document>
            </ignore>
            ...
        </document_rules>
        ...
    </source>

    <destination>
        <document_rules>
            <ignore>
                <document>m2epro_account</document>
            </ignore>
            ...
        </document_rules>
        ...
    </destination>


The full list of ignoring tags for both <source> and <destination> you can download from the links below:

Once it is done, you can start migrating your M2E Pro database. Read the details below.

Steps to proceed

M2E Pro Migration Tool will help you to transfer your Module database. Follow the Migration Wizard hints to complete the process.

Step 1 Disable Modules

To start the process, navigate your Magento v2.x: Stores > Settings > Configuration > M2E Pro > Advanced Settings > Migration from Magento v1.x and click Proceed. You will be redirected to Step 1 of the Migration Wizard. 

In Magento v1.x, go to System > Configuration > M2E Pro > Advanced > Migration to Magento v2.x and click Proceed. It can take up to 15 minutes to stop the dynamic Cron tasks, put M2E Pro under maintenance, and prepare its database for the migration. Wait until the process is completed, then get back to your Magento v2.x installation.

Before clicking Proceed, it is recommended to create a backup of M2E Pro data in case you need to restore it in Magento v1.x. Once you confirm the migration running, the process cannot be stopped.

In Magento v2.x, click Continue at Wizard Step 1. It will stop the dynamic Cron tasks, put M2E Pro under maintenance, and clear its database before the migration. Once the process is completed, you will be redirected to the next step.

Step 2 Database Migration

At Wizard Step 2, you need to transfer M2E Pro data from Magento v1.x to Magento v2.x. To do it, complete the following actions:

  • In Magento v1.x, create a dump of all the tables with prefix 'm2epro_' including both the structure and data. You can use the mysqldump utility or phpMyAdmin options.

Note

All the existing M2E Pro table names must not be changed. If you've added custom prefixes to M2E Pro table names in the Magento 1.x database, e.g. 'myprefix_m2epro_ ', preserve them during the dump creation.

  • Import the created dump into the MySQL database of Magento v2.x.

  • Go back to the Migration Wizard following Stores > Settings > Configuration > M2E Pro > Advanced Settings > Migration from Magento v1.x and click Continue. The imported data will be adapted to the Magento v2.x environment. Once the process is completed, you will be redirected to the next step.

Step 3 Congratulation

That's it! Your M2E Pro is ready to work on Magento v2.x Enable automatic synchronization to start syncing your Magento inventory and sales with Channels.

Click Complete to exit the Wizard.

If the Domain/IP of your Magento is changed after the migration, you should get a new M2E Pro License Key to ensure correct data synchronization.