Configure the Data Migration Tool

Create a Magento 2 module.

• <your Magento 2 install dir>/app/code/Vendor/Migration/composer.json

{
    "name": "vendor/migration",
    "description": "Providing config for migration",
    "config": {
        "sort-packages": true
    },
    "require": {
        "magento/framework": "*",
        "magento/data-migration-tool": "*"
    },
    "type": "magento2-module",
    "autoload": {
        "files": [
            "registration.php"
        ],
        "psr-4": {
            "Vendor\\Migration\\": ""
        }
    },
    "version": "1.0.0"
}

• <your Magento 2 install dir>/app/code/Vendor/Migration/registration.php

<?php

\Magento\Framework\Component\ComponentRegistrar::register(
    \Magento\Framework\Component\ComponentRegistrar::MODULE,
    'Vendor_Migration',
    __DIR__
);

• <your Magento 2 install dir>/app/code/Vendor/Migration/etc/module.xml

<?xml version="1.0"?>

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd">
    <module name="Vendor_Migration" setup_version="1.0.0">
        <sequence>
            <module name="Magento_DataMigrationTool"/>
        </sequence>
    </module>
</config>

Copy the config.xml.dist configuration file from the appropriate directory of the Data Migration Tool (<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>) into the <your Magento 2 install dir>/app/code/Vendor/Migration/etc/<migration edition>/<ce or version>/config.xml file.

For example, if you migrate Magento 1.9.3.6 Community Edition to Magento 2 Open Source:

cd <your Magento 2 install dir>

cp vendor/magento/data-migration-tool/etc/opensource-to-opensource/1.9.3.6/config.xml.dist app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.3.6/config.xml

In the config.xml file, you must set access details to M1 and M2 databases and encryption key.

If your M1 store has custom changes, you should map the rest of your configuration files to your Magento 1 store customizations. See Work with configuration and mapping files.

Log in to your application server as, or switch to, the file system owner.

Change to the following directory:

<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>

Enter the following command to create a config.xml from the provided sample:

cp config.xml.dist config.xml

Open config.xml in a text editor.

At a minimum, the config.xml file must contain access details to M1 and M2 databases and encryption keys.

<source>
   <database host="127.0.0.1" name="magento1" user="root"/>
</source>
<destination>
   <database host="127.0.0.1" name="magento2" user="root"/>
</destination>
<options>
   <crypt_key />
</options>

The <crypt_key> tag must contain a value. You can find it inside the <key> tag, which is located in the app/etc/local.xml file on your Magento 1 instance.

Optional parameters:

• Database user password: password=<password>
• Database custom port: port=<port>
• Table prefix: <source_prefix>, <dest_prefix>

For example, if your database owner’s username is root with password pass and you use the prefix magento1 in your Magento 1 database, use the following in config.xml:

<source>
   <database host="127.0.0.1" name="magento1" user="root" password="pass"/>
</source>
<destination>
   <database host="127.0.0.1" name="magento2" user="root" password="pass"/>
</destination>
<options>
   <source_prefix>magento1</source_prefix>
   <crypt_key>f3e25abe619dae2387df9fs594f01985</crypt_key>
</options>

Copy them from <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>/ to <your Magento 2 install dir>/app/code/Vendor/Migration/etc/<migration edition>/<ce or version>/ and remove the .dist extension.

Update the path to the newly copied file in the <options> node of config.xml. The updated path should be one of the following:

1. Absolute file path, e. g. /var/www/html/app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml
2. magento/data-migration-tool module relative file path: etc/opensource-to-opensource/1.9.4.1/map.xml
3. Magento root-relative file path: app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml