< Back to all Documentation


Extension for Magento v2.x

Installation/Upgrade

Skip to end of metadata
Go to start of metadata

Important note

As of September 2019, the migration process can be performed only from M2E Pro v6.5.6 for Magento v1.x.x to M2E Pro v1.4.1 for Magento v2.x.x.

You can upgrade your M2E Pro for Magento v1.x.x to v6.5.6 by following this instruction. To get M2E Pro v1.4.1 for Magento v2.x.x, contact Support Team at support@m2epro.com.

Start the migration only after you successfully install both M2E Pro v6.5.6 on Magento v1.x and M2E Pro v1.4.1 on Magento v2.x. Once you confirm the migration running, your Module on Magento v1.x will be put under maintenance and the process cannot be rolled back.

Recommended! Two days before the migration, please disable automatic List/Relist Rules in Synchronization Policy(-ies) and do not run the List/Relist actions manually. It will let the system complete the processing of all scheduled List/Relist actions and prevent data loss. Information about the Item List/Relist which is scheduled right before the migration will be skipped. Check this article to learn which M2E Pro data will be preserved during the migration.

Note

Some M2E Pro features are temporarily unavailable in Module versions for Magento v2.x. M2E Pro Team is working on the feature implementations. More details can be found in our Migration Notes and latest Release Notes.

This article describes the overall preparation and execution of the data migration from Magento v1.x to Magento v2.x.

Please use the following tools to migrate your data from Magento v1.x to Magento v2.x:

Note

The migration process requires technical skills. Consult your developers on any issue that you face.

Preliminary requirements

  • Complete Magento data migration from v1.x to v2.x.

Note

If you use Magento Data Migration Tool, you must add to 'ignore' all M2E Pro tables (the table names contain '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:

  • Upgrade your M2E Pro for Magento v1.x to v6.5.6.
  • Install M2E Pro v1.4.1 on your Magento v2.x platform.

Now you can migrate M2E Pro data from Magento v1.x to Magento v2.x. Please read the instruction below.

Steps to proceed

Step 1 Disable Modules

In your Magento v2.x, navigate to Stores > Configuration > Multi Channels > Advanced Settings and press Proceed to run a Migration Wizard.

Important note

Once you confirm the migration running, the process cannot be rolled back.

You will be redirected to the 1st Wizard Step:

Please go back to Magento v1.x: System > Configuration > M2E Pro > Advanced > Migration to Magento v2.x and press Proceed. It will stop the dynamic Cron tasks, put M2E Pro under maintenance and prepare its database for the migration. Please wait for at least 15 minutes until the process is fully completed.

 

Important note

Once you confirm the migration running, the process cannot be rolled back.

In Magento v2.x Migration Wizard, press Continue. It will stop the dynamic Cron tasks, put M2E Pro under maintenance and clear its database before the migration. When the process is completed, you will be redirected to the 2nd Migration Wizard step.

Step 2 Database Migration

On the 2nd Wizard step, you need to export all M2E Pro tables from your MySQL database of Magento v1.x.

Please go to Magento v1.x to create a dump of all the tables with 'm2epro_' prefix including both the structure and data. It can be done using the mysqldump utility or phpMyAdmin options. After you create the dump, import it into the MySQL database of Magento v2.x, then click Continue. M2E Pro will automatically validate and adapt the migrated data to the Magento v2.x environment. Please read more details in this article.

Once the process is completed, you will be redirected to the 3rd Migration Wizard step.

Note

The step is rather time-consuming. If you are logged out from Magento, please log in and go to Stores > Configuration > Multi Channels > Migration from Magento v1.x to get back to the Migration Wizard. 

Step 3 Marketplace Synchronization

On the 3rd Wizard Step, the marketplace data will be synchronized automatically. Once the process is completed, you can proceed to the 4th Step.

Step 4 Congratulation

 It is the final Wizard Step. Please click Complete. It will disable the maintenance mode and resume the automatic synchronization. M2E Pro will become ready to use in Magento v2.x environment.

Tip

If you have any questions, please contact the Support Team at support@m2epro.com.