Migrate data
Before you start: routine preparations
-
Log in to Magento server as the file system owner.
-
Change to the Magento installation directory or make sure it is added to your system PATH.
See the First steps section for more details.
Run the data migration command
To start migrating data, run:
1
bin/magento migrate:data [-r|--reset] [-a|--auto] {<path to config.xml>}
where:
-
[-a|--auto]
is an optional argument that prevents migration from stopping when it encounters integrity check errors. -
[-r|--reset]
is an optional argument that starts migration from the beginning. You can use this argument for testing migration. -
{<path to config.xml>}
is the absolute file system path toconfig.xml
; this argument is required
The Data Migration Tool saves its current progress as it runs. If errors or user intervention stop it from running, the Tool resumes progress at the last known good state.
To force the Data Migration Tool to run from the beginning, use the --reset
argument. In that case, we recommend you restore your Magento 2 database dump to prevent duplicating previously migrated data.
Possible consistency errors
While running, the Data Migration Tool may report inconsistencies between Magento 1 and Magento 2 databases, and display messages like this:
1
Source documents are not mapped: <EXTENSION_TABLE>
See the Troubleshooting section of this guide for more information and recommendations.