Overview of Data Migration Tool configuration
After you install the data migration tool, the following directory contains mapping and configuration files:
Magento Open Source:
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/opensource-to-opensource: Configuration and scripts for migrating from Magento Open Source 1 to Magento Open Source 2
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/opensource-to-commerce: Configuration and scripts for migrating from Magento Open Source 1 to Magento Commerce 2
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/commerce-to-commerce: Configuration and scripts for migrating from Magento Commerce 1 to Magento Commerce 2
The preceding directories contain subdirectories for each supported version.
Configuring the migration
Before you migrate any data, you must create a
config.xml configuration file from the provided sample.
To create a configuration file:
Log in to your Magento server as, or switch to, the Magento 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.xmlfrom the provided sample:
cp config.xml.dist config.xml
config.xmlin a text editor.
Specify the following at minimum:
<crypt_key> tag is mandatory to fill. It can be found in
local.xml file which is located in the directory of Magento 1 instance at
- Database user password:
- Database custom port:
- Table 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
When finished, save your changes to
config.xml and exit the text editor.
You can also connect to a database using the TLS protocol (i.e., using public/private cryptographic keys). Add the following optional attributes to the
Work with configuration and mapping files
The Data Migration Tool uses mapping files to enable you to perform custom database mapping between your Magento 1 and Magento 2 databases, including:
Changing table names
Changing field names
Ignoring tables or fields
Adapt transferring data of a field to Magento 2 format
Mapping files for supported Magento versions are located in subdirectories of
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc
To use the mapping files:
Rename or copy them to remove the
Edit them using the schema located in
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc.
Then change config.xml in
<options>node with the new name of the file.
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc and
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<ce version> directories contain the following configuration files:
Even though you will be working with
map.xml.dist file most of the time, the following table discusses each mapping and other files.
|Mapping file name||Description|
|class-map.xml.dist||Dictionary of class mappings between Magento 1 and Magento 2|
|config.xml.dist||Main configuration file that specifies the Magento 1 and Magento 2 database configurations, step configuration, and links to mapping files|
|Magento Commerce only. customer-attr-document-groups.xml.dist||List of tables used in the custom customer attributes step.|
|Magento Commerce only. customer-attr-map.xml.dist||Map file that is used in Custom Customer Attributes Step.|
|deltalog.xml.dist||Contains the list of tables required for database routines setup.|
|eav-attribute-groups.xml.dist||Contains list of attributes that are used in Eav Step.|
|eav-document-groups.xml.dist||Contains list of tables that are used in Eav Step.|
|log-document-groups.xml.dist||Contains list of tables that are used in Log Step.|
|map-eav.xml.dist||Map file that is used in EAV Step.|
|map-log.xml.dist||Log mapping file.|
|Magento Commerce only. map-sales.xml.dist||Map file that is used in SalesOrder step.|
|map.xml.dist||Mapping file required for the map step.|
|settings.xml.dist||Setting migration configuration file that specifies rules required for migrating the
|customer-attribute-groups.xml||Contains list of attributes that are used in Customer Attributes Step.|
|customer-document-groups.xml||Contains list of tables that are used in Customer Attributes Step.|
|map-customer.xml||Map file that is used in Customer Attributes Step.|
|order-grids-document-groups.xml||Contains list of tables that are used in OrderGrids Step.|
You can refer to Data Migration Tool Technical Specification for more details.