Migrate changes
The incremental migration tool installs deltalog tables (with prefix m2_cl_*) and triggers (for tracking changes) in the Magento 1 database during the migration of data. These deltalog tables and triggers are essential to ensuring that you migrate only the changes made in Magento 1 since the last time you migrated data. These changes are:
-
Data that customers added via storefront (created orders, reviews, and changes in customer profiles)
-
All operations with orders, products, and categories in the Admin panel
Before you start, take the following steps to prepare:
- Log in to the application server as the file system owner.
- Change to the
/bindirectory or make sure it is added to your systemPATH.
See the first steps section for more details.
Run the incremental migration command
To start migrating incremental changes, run:
bin/magento migrate:delta [-r|--reset] [-a|--auto] {<path to config.xml>}
Where:
-
[-r|--reset]is an optional argument that starts migration from the beginning. You can use this argument for testing migration. -
[-a|--auto]is an optional argument that prevents migration from stopping when it encounters integrity check errors. -
{<path to config.xml>}is the absolute file system path toconfig.xml; this argument is required.
Migrate data created by third-party extensions
In the Delta mode, the Data Migration Tool migrates data created only by Magento’s own modules and is not responsible for the code or extensions made by third-party developers. If these extensions created data in the storefront database and the merchant wants to have this data in Magento 2 — config files of the Data Migration Tool should be created and modified accordingly.
If an extension has its own tables, and you need to track their changes for delta migration, follow these steps:
- Add the tables to be tracked to the
deltalog.xmlfile - Create an additional delta class which extends the
Migration\App\Step\AbstractDelta - Add the name of the newly created class to the delta mode section of
config.xml