Migration Planning – Moving From Magento1 To Magento 2

After a very long wait, Magento was finally launched in November last year. Magento team has put a lot of efforts in the release of Magento2 and delighted it’s users with many new improvements.

The new version of Magento is build on a totally different architecture and is more optimized, faster and more user-friendly. So, if you’re planning to build an all new Magento store, it’s no-brainer that you should be using Magento2 for your new project. However, if you already have a Magento1 driven store many online store-owners are eager to know whether they should move from Magento1 to Magento2 and when exactly?

For easy migration and a flawless execution you need to Hire certified Magento developer to ensure a smooth migration and easy installation. In this article, I’m going to discuss the migration process; pre-requisites and all the important aspects needed to be considered briefly:

Things To Consider Before Migration

The very important decision to be made here is: should you stick with Magento1 or plan to migrate to Magento2 right away? Here are few things to be considered while making the decision:


1. No doubt, Magento2 is more faster and better than Magento1. So, if you’ve launched a new store just a while back, and you have little or no traffic at this early stage, you need to start the migration process right away.

2. If your Magento1 store is high-performing and things are working fine for you, there’s no urgent need to migrate to Magento2. Just because it’s a newer version launched, it doesn’t mean that Magento1 is dead. Magento’s announcement says: Magento1 can be supported for three more years and they won’t release any new themes or extensions for Magento1. So, there’s not a dire need to upgrade your Magento1 store for a year or so..

3. If you are having an important season like Black Friday or New year for your ecommerce store, it’s absolutely a bad idea to start upgrading your website’s configurations because it may need maintenance and you never know when things might go wrong. So, why to take the risk?

4. The next important thing is considering whether the theme or extension you’re using is compatible with Magento2 yet. As Magento2 is just a few months old and the Magento community is struggling to upgrade the existing themes and extensions but are not ready for Magento2, so you should definitely wait!

The Migration Plan

If you’re through to the pros and cons of migrating from Magento1 to Magento2 and made the final decision to migrate, here is a step-by-step migration plan:

1. Review Your Website : As we discussed above, just look out whether the themes and extensions available are compatible with Magento2. Also look for any database assets you have to migrate or any unnecessary assets which you can drop.

  • Plan for Infrastructure  : Ask your hosting partner if they have the required capacity to host Magento2 store without any issues and if they can also sustain and support your site when traffic boosts in future.
  • Create a Magento2 store :Now, start installing fresh version of Magento2 and after installing, backup your database. Next, start installing the required extensions on this fresh Magento2 store.
  • Migration Steps : First, install Magento migration tool and ensure it has access to both Magento1 and Magento2 databases to start the migration process.

Installing Magento Migration Tool

Login to Magento site server as user with edit and create files access.

Go to Magento2 root directory and enter the following command to update composer.json file first:

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

Enter the following command to require the current version of the package

composer require magento/data-migration-tool:2.0.0

This will install version 2.0.0 of the package. Now, wait while dependencies are installed. When done, enter these two commands to install the migration tool:

composer config repositories.data-migration-tool git https://github.com/magento/data-migration-tool-ce
composer require magento/data-migration-tool:dev-master

On running these commands, it prompts you for authentication keys. For public key, enter username and for private key, enter password. This will install Magento migration tool on your Magento2 store.

2. Stop all the Magento1 jobs in admin panel except the order management issues and do not resume the activity till the migration is completed and Magento2 site goes live.

3. Now, transfer all the media files from your Magento1 site to Magento2 manually, and use the migration tool to migrate the settings to Magento2 site.

4. Now, using migration tool, transfer the Magento1 database to Magento2 database. Although both the databases have different structures, the migration tool knows what to migrate where, so that data remains accessible in your Magento2 installation.

5. Once, you’ve successfully completed the database transfer, reindex your Magento2 site.

6. And, the last step goes with thorough testing of your new Magento2 site.

Best Practices To Consider

Here are some important things to keep in mind before and throughout the migration process:

Before migration, create a duplicate Magento1 database and connect your Magento2 to that duplicate database. You should do this because if you accidently connect to Magento1 live database, you may end up losing your Magento1 database. Often database losses are irrecoverable.

Once, you duplicate the database, remove all the unnecessary data from it and keep only essential data. For example, you can remove old promotional rules, recently viewed or compared product records, order quotes, logs etc.

Stop all the activities except order management activity in Magento1 admin panel.

During migration process, avoid any kind of code changes.

To boost the migration performance you can set the 1 option in your config.xml. To do this, Magento1 and Magento2 databases should be there in one MySQL instance and the database account should access each database.

In this article, my intention was to point out some important things to consider to help you decide whether it’s the right decision for you to migrate to Magento2. I gave an overview of the migration process and gave you some tips for the best practices in the migration process.

Did you found this article helpful. Please share your comments below!

Leave a Reply