Migrating from Magento 1 to Magento 2 using a Magento 2 data migration tool helps to move all your products, customers, orders, and other data more efficiently.
In this blog, I will show you the available migration methods and how to install the Magento 2 data migration tool using both methods.
Data Migration Tool Requirements
Here are the key requirements before using the Magento Data Migration tool:
- Check your Magento version and make sure it has the same vision as Magento 2 as the Data Migration Tool. If you use Magento 2.3.5, the data migration tool must follow the same version.
- Use a topology and design that matches your Magento 1 store.
- Verify that the Digital Migration Tool has network access to easily connect with Magento 1 and 2 databases.
- Your MySQL has the necessary privileges to access Magento databases.
Methods to Install Magento 2 Data Migration Tool
There are two methods to configure the data migration tool: Official repositories and GitHub repositories.
- Official Repositories: This method uses Composer to install the data migration tool, and this is a recommended method to ensure compatibility between your Magento 2 version and the tool.
- GitHub Repositories: Here, you can install the tool by cloning it directly from the official Magento GitHub repository. You can use this method for development or to explore the source code.
Steps to Install Data Migration Tool: Using Repositories
Step 1: Check the CLI Version
If you have downloaded the Magento using Composer metapackage, run the below command:
$ php <magento_root>/bin/magento –version
Step 2: Add Magento Repository to Composer
Login to your Magento server or switch the Magento file system owner and navigate to the Magento 2 root directory.
Then, run the below command:
$ composer config repositories.magento composer https://repo.magento.com
Step 3: Install Data Migration Tool
Now install the data migration tool based on the version you are using:
$ composer require magento/data-migration-tool:<version>Here, <version> is the version of the Magento 2 codebase.
Replace <version> with the exact Magento version, for example, Magento 2.4.7.
Then, enter the authentication keys with your username and password.
Install Magento 2 Data Migration Tool via GitHub
Step 1: Check Magento 2 Git Branch
If you cloned the Magento 2 Github repository, run these commands:
$ cd <your Magento 2 clone directory>
$ git branch
Step 2: Add the Data Migration Tool
Now login to the Magento servers or switch to Magento file system owner.
Change to the Magento 2 root directory and run the below commands
$ composer config repositories.data-migration-tool git https://github.com/magento/data-migration-tool
$ composer require magento/data-migration-tool:<version>Here, <version> is the version of the Magento 2 codebase.
After completing the installation process, check the version of your Magento migration tool.
Here are the steps to check the version:
- Change to your Data Migration Tool directory: <vendor>/magento/data-migration-tool.
- Open composer.json in a text editor.
- The version entry in that file is the version of the Data Migration Tool.
Error Messages While Using the Data Migration Tool (Cause + Solution)
While configuring the tool, you might encounter some errors. Here are the possible errors with its cause and solution.
Error Message | Cause | Solution |
Some Magento 1 entities don’t exist in the Magento 2 database | Install Adobe Commerce 2 extension. Check if the error data originates from any extension. | |
A class from Adobe Commerce 1 codebase is not found in Adobe Commerce 2 codebase. | Install the extension and add class mapping using the class-map.xml.dist file. | |
The target path in a URL is paired with Request path + Store ID | Enable the auto_resolve_urlrewrite_duplicates option in your config.xml file. |
Other Common Issues While Installing Magento 2 Data Migration Tool
- Version Compatibility Issues – If your version doesn’t match the data migration tool, then the migration will stay incomplete.
- Extension Compatibility Issues – Use Magento 2 compatible extension since the M1 extension won’t support M2.
- Composer Conflicts – Solve any conflicting dependencies that can cause errors during installation.
- Permission Access – Give proper read/write access to your Magento directories.
Hire Magento Migration Experts
Configuring Magento 2 data migration tool is an excellent choice to migrate your store data, but if not done correctly, there is a high chance that your migration will remain incomplete.
Use our Magento 2 migration service to move to the latest version of Magento 2 without any data loss and minimum downtime. Our expert’s Adobe-certified experts make your new Magento store run without any uninterrupted errors.
Move to Magento 2 with 100% data security!
Migrate Safely Now!