Latest News

Migrating from Magento V1 to V2; What’s Involved – A Step-by-Step Guide from Opace

Map Unavailable

Date(s) - 05/03/2016 - 10/03/2017
All Day


Magento 2.0 was released at the end of 2015 and Birmingham based Magento agency Opace have covered this in a detailed post here: Opace have now also providing a step-by-step guide for migrating Magento from V1 to 2.0, which while a relatively straightforward process, is still best done with the support of a Magento specialist to ensure that all your data, extensions, themes and customisations transition smoothly.

Before You Get Started

Before starting the migration process, ensure that you remove any outdated or redundant data from your current Magento database and follow Magento’s general rules for a successful migration guide ( to keep the process as quick and easy as possible. Generally, the settings migration should take approximately 10 minutes and the data migration time approximately 9 hours; but your site should only experience a few minutes of downtime.

The following versions are supported for migration:

– Enterprise Edition (EE) version 1.11.x, 1.12.x, 1.13.x, 1.14.x
– Community Edition (CE) version 1.6.x, 1.7.x, 1.8.x, 1.9.x

The migration flow process –

It is important to make sure you have an effective migration plan in place before you get started. Start by reviewing your current site, auditing what extensions you have installed, which extensions you need in your new site, any custom changes which have been made, and if Magento 2 supports these extensions/changes. Ensure you plan ahead in regards to both software and hardware capacity; does your site need more technical or hardware support to get ready for the continuing growth of your business?

Build and test a Magento 2 site before you migrate your current one. Set up a version 2 system using a design that matches your current system. In case of any unexpected problems, it is advised to replicate your current Magento V1 database and use this replication data for your migration. Finally, install Magento 2 on a system that meets the system requirements –

Data Migration Tool

Magento have created a Data Migration Tool to assist with the migration from V1 to 2.0 It is a command-line interface (CLI) that helps by providing verification, logging, progress tracking and testing functions. It works by migrating all possible settings configurations, bulk migrates data from your current database to your new one, and has an incremental “catch-up migration after the initial migration. Details on how to install the Data Migration Tool can be seen here –

Migrating from Magento 1 to Magento 2

  1. Ensure that the Data Migration Tool has access to connect your previous Magento V1 database to the new version 2database – check by opening any ports in your firewall.
  2. Halt any activity that is currently happening in your Magento 1 Admin Panel (excluding order management like shipping or creating invoices.
  3. Halt all Magento 1 cron jobs.

Migrating Your Settings

  1. It is recommended to migrate your settings first, which will migrate stores, websites and any system configurations.
  2. Log in to your Magento server as the Magento file system owner and change to the following directory: `<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc
  3. Then enter the following command to create settings.xml from the below sample: cp settings.xml.dist settings.xml
  4. Make all the necessary changes in settings.xml.
  5. Then, make changes to the <settings_map_file> tag in <ce or ee version>/config.xml to set the name of the new settings file.
  6. To migrate your settings, use this command: bin/magento migrate:settings [-r|–reset] {<path to config.xml>}
  7. Finally, copy your current Magento 1.0 media files to your new Magento 2.0 system. This must be completed manually from <magento1-root>/media to <magento2-root>/pub/media.

Migrating Your Data

  1. Use the Data Migration Tool to move all your data from your current Magento V1 database to your new 2.0 database. The Tool will verify that any tables or fields are consistent between the two versions, and if not an error will display. In this case:
    • Install the corresponding extensions in Magento 2.0 (if they’re available)
    • Or ignore the message by adding <ignore> takes to map.xml file
    • After any issues are resolves, you can then run the Tool again.
  2. To run Magento commands, add <your Magento install dir>/bin to your system PATH.
  3. To being migrating your data, run the following command: bin/magento migrate:data [-r|–reset] {<path to config.xml>}
  4. The Tool saves progress as it runs; if any errors stop it then it will resumed at the last known good point.
  5. If extensions have a different structure in 2.0 compared to your previous V1, you may need to install these new adapted extensions for 2.0. You can use the mapping files contained within the Data Migration tool to help with this.
  6. Use magento indexer:reindex command to ensure all your indexers are reindexed.
  7. Once the migration is complete, carry out a full and thorough test of your site to ensure it is working properly and running smoothly.

Incremental Updates

Once you’ve fully migrated your data from V1 to 2, you must incrementally capture any new data updates that are added into the V1 store and migrate this to your new 2.0 store. Do this by using the following command: bin/magento migrate:delta [-r|–reset] {<path to config.xml>}. You can stop these updates at any time by pressing CTRL+C and be sure to keep testing your site throughout the process.


Going Live

  1. Put your old Magento V1 system into maintenance mode.
  2. Press CTRL + C in the migration tool command to halt incremental updates.
  3. Begin your Magento 2.0 cron jobs.
  4. In the new Magento 2.0 system, reindex any stock indexers by using magento indexer:reindex cataloginventory_stock.
  5. Cache pages on your new Magento 2.0 site in advance of the customers using the storefront.
  6. Perform any final verification that is necessary to your new 2.0 site.
  7. Change your DNS, load balances and anything else that is necessary to ensure that these point to the new hardware.
  8. You’re now ready to use your new Magento 2.0 (and so are your customers!).

Contact Us

If you’re looking to migrate to Magento 2 now or in the near future and would like advice or technical support throughout the process, or need support with your current Magento V1 website, please get in contact with our experienced team of Magento developers at Opace ( or give us a call on 0845 017 7661 or email at [email protected].

Leave a comment