{"id":5190,"date":"2021-11-09T03:40:00","date_gmt":"2021-11-09T03:40:00","guid":{"rendered":"https:\/\/blog.mageworx.com\/?p=5190"},"modified":"2022-05-16T11:34:30","modified_gmt":"2022-05-16T11:34:30","slug":"how-to-install-data-migration-tool-in-magento-2","status":"publish","type":"post","link":"https:\/\/www.mageworx.com\/blog\/how-to-install-data-migration-tool-in-magento-2","title":{"rendered":"How to Install Magento 2 Data Migration Tool"},"content":{"rendered":"\n<!-- SEO Ultimate (http:\/\/www.seodesignsolutions.com\/wordpress-seo\/) - Code Inserter module -->\n<!-- Google Tag Manager (noscript) -->\r\n<noscript><iframe src=\"https:\/\/www.googletagmanager.com\/ns.html?id=GTM-5DTCW7B8\"\r\nheight=\"0\" width=\"0\" style=\"display:none;visibility:hidden\"><\/iframe><\/noscript>\r\n<!-- End Google Tag Manager (noscript) -->\n<!-- \/SEO Ultimate -->\n\n<span class=\"span-reading-time rt-reading-time\" style=\"display: block;\"><span class=\"rt-label rt-prefix\">Reading Time: <\/span> <span class=\"rt-time\"> 4<\/span> <span class=\"rt-label rt-postfix\">minutes<\/span><\/span>\n<p>Migration from Magento 1 to Magento 2 is the right move towards a high-performing and profitable eCommerce store. To migrate data smoothly, you need a Magento 2 <a href=\"https:\/\/devdocs.magento.com\/guides\/v2.3\/migration\/migration-tool-install.html\">Data Migration Tool<\/a>.<\/p>\n\n\n\n<p>In this article, we\u2019ll take you through the step-by-step process of installing this tool in Magento 2.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What to Know Before Migrating to Magento 2<\/h2>\n\n\n\n<p>Merchants running the unsupported Magento 1 platform risk facing security and performance issues. Also, they risk their competitive edge since innovative features are no longer added to Magento 1.<\/p>\n\n\n\n<p>In turn, the Magento 2 store owners stay one step ahead of the game. They get new powerful features and performance improvements with each software release.<\/p>\n\n\n\n<p>Migration to Magento 2 is not as easy as it might look at first. Some believe it\u2019s just a transfer of Magento data from the old store to a new one, but the procedure is a lot more complicated. It involves a complete recreation of Magento 1 data, settings, and design on a clean Magento 2 installation.&nbsp;<\/p>\n\n\n\n<p>How much effort the migration will take depends on the number of customizations on the original Magento 1 store. So does the cost of Magento 1 to Magento 2 migration.<\/p>\n\n\n\n<p>For example, migrating a simple store with a default theme and no extensions will take around a workday and cost $1,500\u20132,000. The more customizations you have, the more time and money it will need to migrate.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What Magento 2 Data Migration Tool is for<\/h2>\n\n\n\n<p>For easy Magento 2 data migration, Adobe developed the official Data Migration Tool. This is a command-line interface tool that has verification, logging, progress tracking, and test functions. It\u2019s free to download and aims to help merchants migrate their stores over to the new and improved Magento 2.&nbsp;<\/p>\n\n\n\n<p>Note:<\/p>\n\n\n\n<p>Data Migration Tool is designed to migrate data from Magento 1 to Magento 2 only. It\u2019s not suitable for migrating from one platform to another, e.g., from <a href=\"https:\/\/www.mageworx.com\/blog\/ultimate-guide-to-migrate-from-woocommerce-to-magento\/\">WooCommerce to Magento<\/a>.<\/p>\n\n\n\n<p>Data Migration Tool automates the transfer of the following data to Magento 2:<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>Customers<\/li><li>Catalogs<\/li><li>Orders<\/li><li>Promotions<\/li><li>Core configurations<\/li><\/ul>\n\n\n\n<p>However, the tool cannot transfer media files, admin rights, and some custom data.<\/p>\n\n\n\n<p>You will require third-party solutions if you need, for example, <a href=\"https:\/\/www.mageworx.com\/magento-2-advanced-product-options-suite.html\">product options migration<\/a> or <a href=\"https:\/\/www.mageworx.com\/wiki\/magento-2-export-import-orders\">order import and export<\/a>. Also, the content migration tool doesn\u2019t allow you to migrate extensions and a theme\u2014they should be created for a Magento 2 store afresh.<\/p>\n\n\n\n<p>What are the three data migration tools available?<\/p>\n\n\n\n<p>The Magento 2 Data Migration Tool operates in three modes:<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li><strong>Settings<\/strong>. The tool migrates the store and system configuration settings from Magento 1 to Magento 2.<\/li><li><strong>Data<\/strong>. The tool migrates data from Magento 1 database to Magento 2 database.<\/li><li><strong>Delta<\/strong>. The tool migrates incremental data such as new orders and catalog data that may have changed since the primary data migration.<\/li><\/ul>\n\n\n\n<p>Adobe <a href=\"https:\/\/devdocs.magento.com\/guides\/v2.4\/migration\/migration-migrate.html#migration_order\">recommends following<\/a> the sequence as above to migrate with no issues.&nbsp;<\/p>\n\n\n\n<p>Every mode has steps such as the EAV step, the settings step, and the URL rewrite step.&nbsp;<\/p>\n\n\n\n<p>But how is data migration done?<\/p>\n\n\n\n<p>During every step, the tool verifies consistency between the Magento 1 and Magento 2 databases and after it performs data transfer. In the delta mode, the tool transfers changes in store data made since primary migration. The final step is verification tests to ensure all data were migrated successfully.<\/p>\n\n\n<p><a href=\"https:\/\/www.mageworx.com\/blog\/migration-to-magento-2-case-study-tassenfuzzi\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-15217 size-full\" src=\"https:\/\/www.mageworx.com\/blog\/wp-content\/uploads\/2016\/12\/Migration-to-Magento-2_-Case-Study-1.png\" alt=\"data migration magento 2 case study\" width=\"690\" height=\"190\" srcset=\"https:\/\/www.mageworx.com\/blog\/wp-content\/uploads\/2016\/12\/Migration-to-Magento-2_-Case-Study-1.png 690w, https:\/\/www.mageworx.com\/blog\/wp-content\/uploads\/2016\/12\/Migration-to-Magento-2_-Case-Study-1-600x165.png 600w, https:\/\/www.mageworx.com\/blog\/wp-content\/uploads\/2016\/12\/Migration-to-Magento-2_-Case-Study-1-250x69.png 250w\" sizes=\"auto, (max-width: 690px) 100vw, 690px\" \/><\/a><\/p>\n\n\n<h2 class=\"wp-block-heading\">Requirements for Data Migration Tool Installation<\/h2>\n\n\n\n<p>Before the <a href=\"https:\/\/www.mageworx.com\/magento-database-migration-service.html\">database migration to Magento 2<\/a>, make sure the versions of Magento and Data Migration Tool match.<\/p>\n\n\n\n<p>If you are using the latest version of Magento 2, you should also use the latest version of the Data Migration Tool.<\/p>\n\n\n\n<p>If you don\u2019t know which version you currently use, follow the steps below.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">How to Find Magento 2 Software Version<\/h3>\n\n\n\n<p>To find your Magento 2 version, run the following command in the terminal:<\/p>\n\n\n\n<p><code>php &lt;your Magento 2 install dir&gt;\/bin\/magento --version<\/code><\/p>\n\n\n\n<p>If you have downloaded the Magento 2 software using Composer, you should execute the following command:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>cd &lt;your Magento 2 clone directory&gt;\ngit branch<\/code><\/pre>\n\n\n\n<p>If you are in the <strong>develop<\/strong> branch used by default, you should first change it to the <strong>released <\/strong>branch.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">How to Find the Data Migration Tool Version<\/h3>\n\n\n\n<p>Here\u2019s what you should do to find the version of your Magento 2 migration tool:<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>Navigate to your Data Migration Tool directory: <code>vendor\/Magento\/data-migration-tool<\/code>.<\/li><li>Open your composer.json file in the text <a href=\"https:\/\/www.mageworx.com\/magento2-order-editor-extension.html\" data-type=\"URL\" data-id=\"https:\/\/www.mageworx.com\/magento2-order-editor-extension.html\">editor<\/a> and find the value \u201cVersion.\u201d You\u2019ll see there is the current version of your tool.<\/li><\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Installing Data Migration Tool in Magento 2<\/h2>\n\n\n\n<p>There are two ways to install the Data Migration Tool:&nbsp;<\/p>\n\n\n\n<ol class=\"wp-block-list\"><li>Using repo.magento.com<\/li><li>Using the GitHub repository<\/li><\/ol>\n\n\n\n<p>In this guide, we\u2019ll describe both methods.&nbsp;<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Install from repo.magento.com<\/h3>\n\n\n\n<p>For the correct Data Migration Tool installation, navigate to the Magento root installation directory and update a composer.json file. This is needed to provide the location for the Data Migration Tool package.<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>Log in to your Magento 2 server as the command-line user.<\/li><li>Navigate to the Magento 2 root directory.<\/li><li>Execute these commands in the terminal:<\/li><\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code>composer config repositories.magento composer https:\/\/repo.magento.com\ncomposer require magento\/data-migration-tool:&lt;version&gt;\n<\/code><\/pre>\n\n\n\n<ul class=\"wp-block-list\"><li>Replace the &lt;version&gt; tag with the current version of your Data Migration Tool. For example, if you have version 2.0.2, enter the following:<\/li><\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code>composer config repositories.magento composer https:\/\/repo.magento.com\ncomposer require magento\/data-migration-tool:2.0.2\n<\/code><\/pre>\n\n\n\n<ul class=\"wp-block-list\"><li>Next, enter your authentication keys. You might copy them from the account page on <a href=\"https:\/\/marketplace.magento.com\/\">Commerce Marketplace<\/a>, where your public key is the username and the private key is passwords.<\/li><\/ul>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1282\" height=\"707\" src=\"https:\/\/www.mageworx.com\/blog\/wp-content\/uploads\/2016\/12\/screen-1.png\" alt=\"magento 2 data migration and how to find authentication keys\" class=\"wp-image-15218\" srcset=\"https:\/\/www.mageworx.com\/blog\/wp-content\/uploads\/2016\/12\/screen-1.png 1282w, https:\/\/www.mageworx.com\/blog\/wp-content\/uploads\/2016\/12\/screen-1-1200x662.png 1200w, https:\/\/www.mageworx.com\/blog\/wp-content\/uploads\/2016\/12\/screen-1-600x331.png 600w, https:\/\/www.mageworx.com\/blog\/wp-content\/uploads\/2016\/12\/screen-1-768x424.png 768w, https:\/\/www.mageworx.com\/blog\/wp-content\/uploads\/2016\/12\/screen-1-250x138.png 250w, https:\/\/www.mageworx.com\/blog\/wp-content\/uploads\/2016\/12\/screen-1-696x385.png 696w, https:\/\/www.mageworx.com\/blog\/wp-content\/uploads\/2016\/12\/screen-1-1068x589.png 1068w, https:\/\/www.mageworx.com\/blog\/wp-content\/uploads\/2016\/12\/screen-1-762x420.png 762w\" sizes=\"auto, (max-width: 1282px) 100vw, 1282px\" \/><\/figure><\/div>\n\n\n\n<h3 class=\"wp-block-heading\">Install from GitHub<\/h3>\n\n\n\n<p>You can use GitHub to install the Data Migration Tool in Magento. Follow these steps to install the Data Migration Tool from GitHub:<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>Log in to your Magento server as the command-line user and navigate to the Magento 2 root directory.<\/li><li>Execute these commands in the terminal:<\/li><\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code>composer config repositories.data-migration-tool git https:\/\/github.com\/magento\/data-migration-tool\ncomposer require magento\/data-migration-tool:&lt;version&gt;\n<\/code><\/pre>\n\n\n\n<ul class=\"wp-block-list\"><li>Replace the &lt;version&gt; tag with the current version of your Data Migration Tool. For example, if you have version 2.0.2, enter the following:<\/li><\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code>composer config repositories.data-migration-tool git https:\/\/github.com\/magento\/data-migration-tool\ncomposer require magento\/data-migration-tool:2.0.2\n<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">Wrapping It Up<\/h2>\n\n\n\n<p>Congratulations! If you followed the instructions, you should have successfully installed the Magento 2 Data Migration Tool.<\/p>\n\n\n\n<p>However, this is only one of the steps in Magento migration. If you\u2019re tech-savvy enough, you can <a href=\"https:\/\/www.mageworx.com\/services-magento-migration\">migrate to Magento 2<\/a> yourself.<\/p>\n\n\n\n<p>But if you lack the required experience, you\u2019d better contact a <a href=\"https:\/\/staylime.com\/contacts\/\">reliable Magento agency<\/a> to assist you, or opt for a safe Magento Database Migration Service as a starter:<\/p>\n\n\n<p><a href=\"https:\/\/www.mageworx.com\/magento-database-migration-service.html\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-15215 size-full\" src=\"https:\/\/www.mageworx.com\/blog\/wp-content\/uploads\/2016\/12\/banner-1.png\" alt=\"magento 2 migration tool\" width=\"690\" height=\"210\" srcset=\"https:\/\/www.mageworx.com\/blog\/wp-content\/uploads\/2016\/12\/banner-1.png 690w, https:\/\/www.mageworx.com\/blog\/wp-content\/uploads\/2016\/12\/banner-1-600x183.png 600w, https:\/\/www.mageworx.com\/blog\/wp-content\/uploads\/2016\/12\/banner-1-250x76.png 250w\" sizes=\"auto, (max-width: 690px) 100vw, 690px\" \/><\/a><\/p>","protected":false},"excerpt":{"rendered":"<p><span class=\"span-reading-time rt-reading-time\" style=\"display: block;\"><span class=\"rt-label rt-prefix\">Reading Time: <\/span> <span class=\"rt-time\"> 4<\/span> <span class=\"rt-label rt-postfix\">minutes<\/span><\/span>Migration from Magento 1 to Magento 2 is the right move towards a high-performing and profitable eCommerce store. To migrate data smoothly, you need a Magento 2 Data Migration Tool. In this article, we\u2019ll take you through the step-by-step process of installing this tool in Magento 2. What to Know Before Migrating to Magento 2 [&hellip;]<\/p>\n","protected":false},"author":27,"featured_media":15214,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[289,255,425],"tags":[431,444],"class_list":{"0":"post-5190","1":"post","2":"type-post","3":"status-publish","4":"format-standard","5":"has-post-thumbnail","7":"category-magento","8":"category-magento-2","9":"category-magento-how-tos","10":"tag-how-tos","11":"tag-migration"},"_links":{"self":[{"href":"https:\/\/www.mageworx.com\/blog\/wp-json\/wp\/v2\/posts\/5190","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.mageworx.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.mageworx.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.mageworx.com\/blog\/wp-json\/wp\/v2\/users\/27"}],"replies":[{"embeddable":true,"href":"https:\/\/www.mageworx.com\/blog\/wp-json\/wp\/v2\/comments?post=5190"}],"version-history":[{"count":17,"href":"https:\/\/www.mageworx.com\/blog\/wp-json\/wp\/v2\/posts\/5190\/revisions"}],"predecessor-version":[{"id":15986,"href":"https:\/\/www.mageworx.com\/blog\/wp-json\/wp\/v2\/posts\/5190\/revisions\/15986"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.mageworx.com\/blog\/wp-json\/wp\/v2\/media\/15214"}],"wp:attachment":[{"href":"https:\/\/www.mageworx.com\/blog\/wp-json\/wp\/v2\/media?parent=5190"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.mageworx.com\/blog\/wp-json\/wp\/v2\/categories?post=5190"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.mageworx.com\/blog\/wp-json\/wp\/v2\/tags?post=5190"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}