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, products, and categories in the Magento Admin panel

All other new or updated entities entered through the Admin panel, such as attributes or CMS pages, are not included in the incremental migration and will not be migrated.

Before you start: routine preparations

  1. Log in to Magento server as the file system owner.
  2. 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 to config.xml; this argument is required.

Incremental migration is a continuous process; it automatically restarts every 5 seconds. Use CTRL-C to abort the migration process.

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:

  1. Add the tables to be tracked to the deltalog.xml file
  2. Create an additional delta class which extends the Migration\App\Step\AbstractDelta
  3. Add the name of the newly created class to the delta mode section of config.xml

Related topics