To make the Magento Migration process easy, there is a Data Migration Tool that is based on Command Line (CLI) that offers verification, logging, progress tracking and test functions.
Table of Contents
Three Effective Modes to Migrate Data from Magento 1 to Magento 2
- Data Mode: Bulk migration mode that migrates data from Magento 1 database to Magento 2 database
- Delta Mode: Catch up migration after the bulk data migration
- Settings Mode: Migrates all possible configuration settings from Magento 1 to Magento 2
Note - It is necessary that the same versions of Magento and the Data Migration Tool are used.
How to Checke Mageno 2 Version?
To check the Magento 2 Version, follow this step:
php <your Magento 2 install dir>/bin/magento --version
If you have downloaded the Magento 2 software using composer use the following command:
cd <your Magento 2 clone directory>
git branch
If you are in the developer branch, Firstly you must need to change this to a released branch before you continue.
How to install the Magento 2 Data Migration Tool?
There are 2 ways to install the Data Migration Tool from:
Before installing, make sure you have:
- Completed all tasks mentioned in the Preconditions section
- Verified the version of the Magento 2 software
1. Install Magento 2 Data Migration Tool from
To install the Data Migration Tool, you must update composer.json in the Magento root installation directory to provide the location of the Data Migration Tool package.
Step 1. Log in to your Magento server as, or switch to, the Magento file system owner.
Step 2. Change to Magento 2 root directory.
Step 3. Enter the following commands:
composer config repositories.magento composer https://repo.magento.com
composer require magento/data-migration-tool:<version>
where <version> must match the version of the Magento 2 codebase.
For example, for version 2.2.0, enter:
composer config repositories.magento composer https://repo.magento.com composer require magento/data-migration-tool:2.2.0
Step 4. When prompted, enter your authentication keys. Your public key is your username; your private key is your password.
2. Install Magento 2 Data Migration Tool from GitHub
If you’ve cloned Magento 2 from the GitHub repository, follow the steps below to install the Data Migration Tool.
Step 1. Log in to your Magento server as, or switch to, the Magento file system owner.
Step 2. Change to Magento 2 root directory.
Step 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>
where <version> must match the version of the Magento 2 codebase.
For example, for version 2.2.0, enter:
composer config repositories.data-migration-tool git https://github.com/magento/data-migration-tool composer require magento/data-migration-tool:2.2.0
How to Check the version of the installed Magento 2 Data Migration Tool?
Here are the steps to check the version of the installed Magento 2 Data Migration Tool.
Step 1. Change to your Data Migration Tool directory: <vendor>/magento/data-migration-tool.
Step 2. Open composer.json in a text editor.
Step 3. The version entry in that file is the version of the Data Migration Tool.
We hope we have got everything covered to help you install the data migration tool Magento 2. If we missed out on anything, feel free to get in touch with us.
Our Migration Services is here to help you with uninterrupted migration services. Check it out now!
Recommended Read: How to Use Code Migration Tool in Magento 2 for Migration?
