Configure custom migration rules

You may ignore, rename, or change the system configurations when migrating settings. For this, specify your custom rules in the settings.xml file.

  1. Log in to the application server as, or switch to, the file system owner.

  2. Change to the following directory:

    cd <your application 2 install dir>/vendor/magento/data-migration-tool/etc/<edition-to-edition>
    

    For example, if the application is installed in /var/www/html, the settings.xml.dist file is in one of the following directories:

    • /var/www/html/vendor/magento/data-migration-tool/etc/opensource-to-commerce

    • /var/www/html/vendor/magento/data-migration-tool/etc/commerce-to-commerce

    • /var/www/html/vendor/magento/data-migration-tool/etc/opensource-to-opensource

  3. To create a settings.xml file from the provided sample, run:

    cp settings.xml.dist settings.xml
    
  4. Make your changes in settings.xml.

  5. To specify the new name of the settings file for mapping, change the <settings_map_file> tag in the path/to/config.xml file.

For more details, see the Settings migration mode section of the Tool’s specification.

Next migration step

Commerce