Data migration settings
The Settings
mode migrates stores, websites, and system configuration like shipping, payment, and tax settings. According to our data migration order, you should migrate settings first.
Before you start, take the following steps to prepare:
-
Log in to the application server as the file system owner.
-
Change to the
/bin
directory or make sure it is added to your systemPATH
.
default
mode. Developer mode can cause validation errors in the migration tool.See the first steps section for more details.
Run the settings migration command
To start migrating settings, run:
bin/magento migrate:settings [-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 to the migration tool’sconfig.xml
file; this argument is required.
The Migration completed
message is displayed after the settings are transferred successfully.
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.
-
Log in to the application server as, or switch to, the file system owner.
-
Change to the following directory:
code language-bash 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
, thesettings.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
-
-
To create a
settings.xml
file from the provided sample, run:code language-bash cp settings.xml.dist settings.xml
-
Make your changes in
settings.xml
. -
To specify the new name of the settings file for mapping, change the
<settings_map_file>
tag in thepath/to/config.xml
file.
For more details, see the Settings migration mode section of the Tool’s specification.