magento/data-migration-tool

Overview

We're pleased you're considering moving from the world's #1 eCommerce platform—Magento 1.x—to the eCommerce platform for the future, Magento 2. We're also excited to share the details about this process, which we refer to as migration.

Magento 2 migration involves four components: data, extensions and custom code, themes, and customizations.

Data

We've developed the Magento 2 Data Migration Tool to help you efficiently move all of your products, customers, and order data, store configurations, promotions and more to Magento 2. See the Magento Migration Guide for details.

Extensions and custom code

We've been working hard with the development community to help you use your Magento 1 extensions in Magento 2. Now we're proud to present the Magento Marketplace, where you can download or purchase the latest versions of your favourite extensions.

Also, we have developed the Code Migration Toolkit, which will help to port extensions and your custom code to Magento 2, significantly reducing your porting efforts.

More information on developing extensions for Magento 2 is available in the Magento 2 Extension Developer Guide.

Themes and Customizations

Magento 2 uses new approaches and technologies that give merchants an unmatched ability to create innovative shopping experiences and scale to new levels. To take advantage of these advances, developers will need to make changes to their themes and customizations. Documentation is available online for creating Magento 2 themes, layouts, and customizations.

Supported versions

This edition of tool supports the following versions for migration:

• Magento Open Source version 1.6.x, 1.7.x, 1.8.x, 1.9.x

• Magento Commerce version 1.11.x, 1.12.x, 1.13.x, 1.14.x

If you migrate from Magento Open Source to Magento Commerce, the following versions are supported:

• 1.6.x, 1.7.x, 1.8.x, 1.9.x

Supporting issues and Pull Request contributions

Reported issues in this project are supported mainly by Magento community. Please submit a support ticket here https://magento.com/contact-us if you migrate to Magento 2 Commerce. Contributions like Pull Requests are welcome and we will process/merge it

Prerequisites

Before you start your migration, you must do all of the following:

• Set up a Magento 2 system that meets our system requirements.

Set up your system using a topology and design that at least matches your existing Magento 1.x system.

• Do not start Magento 2 cron jobs.

• Back up or dump your Magento 2 database as soon after installation as possible.

• Check that the data migration tool has a network connection to the Magento 1.x and Magento 2 databases.

Open ports in your firewall so the migration tool can communicate with the databases and so the databases can communicate with each other.

• Migrate Magento 1.x extension and custom code to Magento 2.

Reach out to your extension providers to see if they have been ported yet.

Install the Data Migration Tool

This section discusses how to install the Magento Data Migration Tool. You can install it from either repo.magento.com or from a GitHub repository.

Note: The versions of both the migration tool and the Magento 2 code must be identical (for example, 2.4.0). To find the version of either package, open composer.json and find the value of "version".

Install the tool from GitHub

To install the migration tool from GitHub, use the following steps:

1. Log in to your Magento 2 server as a user with privileges to write to the Magento 2 file system or switch to the web server user.

2. Go to Magento 2 root directory.

3. Enter the following commands:

    composer config repositories.data-migration-tool git https://github.com/magento/data-migration-tool
    composer require magento/data-migration-tool:<version>
    bin/magento module:enable Magento_DataMigrationTool
   

   where <version> is release version (e.g. 2.4.4)

4. Wait while dependencies are updated and the tool is enabled.

Install the tool from repo.magento.com

To install the Data Migration Tool, you must update composer.json in the Magento root installation directory to provide the location of the migration tool package.

To install the migration tool, you must:

1. Decide the version of magento/data-migration-tool you want as discussed in the preceding section.

2. Run the composer config and composer require commands to update composer.json.

3. When prompted, enter your authentication keys. Your public key is your username; your private key is your password.

To update composer.json:

1. Log in to your Magento server as the web server user or as a user with root privileges.

2. Change to your Magento installation directory.

3. Enter the following command to reference Magento packages in composer.json:

    composer config repositories.magento composer https://repo.magento.com
   

4. Enter the following command to require the current version of the package:

    composer require magento/data-migration-tool:<version>
   

   where <version> is either an exact version or next significant release syntax.

   Exact version example:

    composer require magento/data-migration-tool:2.4.4
   

   Next significant release example:

    composer require magento/data-migration-tool:~2.4
   

5. Wait while dependencies are installed.

6. Enter the following command to enable the tool

    bin/magento module:enable Magento_DataMigrationTool
   

More details

See the Migration Guide for the detailed help with your data migration process.