Migrate changes
Overview
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, changes in customer profiles, etc.)
-
all operations with orders in the Magento Admin panel
All new or updated entities entered through the Admin panel, like products and categories, are not included in incremental migration and will not be migrated.
Before you start: routine preparations
-
Log in to Magento server as the file system owner.
-
Change to the Magento
/bin
directory or make sure it is added to your system PATH.
See the First steps section for more details.
Run the incremental migration command
To start migrating incremental changes, run:
1
bin/magento migrate:delta [-r|--reset] {<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. -
{<path to config.xml>}
is the absolute file system path toconfig.xml
; this argument is required.
Incremental migration runs continuously until you stop it by pressing CTRL+C.
Migrate data created by 3rd 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.xml
file -
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