Konfigurera Data Migration Tool
När du har installerat Data Migration Tool innehåller följande katalog mappnings- och konfigurationsfiler:
-
Magento Open Source:
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/opensource-to-opensource: Konfiguration och skript för migrering från Magento Open Source 1 till Magento Open Source 2
-
Adobe Commerce:
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/opensource-to-commerce: Konfiguration och skript för migrering från Magento Open Source 1 till Adobe Commerce 2<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/commerce-to-commerce: Konfiguration och skript för migrering från Adobe Commerce 1 till Adobe Commerce 2
Föregående kataloger innehåller underkataloger för varje version som stöds.
Konfigurera migreringen
Det finns två sätt att konfigurera Data Migration Tool:
- Konfigurera Data Migration Tool i en separat modul (rekommenderas)
- Ändra Data Migration Tool-konfigurationen i katalogen
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/.
Om du vill använda källkontroll för att hantera din migreringskonfiguration och använda den för distribution måste du skapa en separat modul.
Om du bara tänker köra Data Migration Tool lokalt kan du redigera filer direkt i katalogen <your Magento 2 install dir>/vendor/magento/data-migration-tool/.
Konfigurera migrering i en separat modul
Innan du migrerar några data måste du skapa en Magento 2-modul.
-
Skapa en Magento 2-modul.
<your Magento 2 install dir>/app/code/Vendor/Migration/composer.json
code language-json { "name": "vendor/migration", "description": "Providing config for migration", "config": { "sort-packages": true }, "require": { "magento/framework": "*", "magento/data-migration-tool": "*" }, "type": "magento2-module", "autoload": { "files": [ "registration.php" ], "psr-4": { "Vendor\\Migration\\": "" } }, "version": "1.0.0" }<your Magento 2 install dir>/app/code/Vendor/Migration/registration.php
code language-php <?php \Magento\Framework\Component\ComponentRegistrar::register( \Magento\Framework\Component\ComponentRegistrar::MODULE, 'Vendor_Migration', __DIR__ );<your Magento 2 install dir>/app/code/Vendor/Migration/etc/module.xml
code language-xml <?xml version="1.0"?> <config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd"> <module name="Vendor_Migration" setup_version="1.0.0"> <sequence> <module name="Magento_DataMigrationTool"/> </sequence> </module> </config> -
Kopiera konfigurationsfilen
config.xml.distfrån lämplig katalog för Data Migration Tool (<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>) till filen<your Magento 2 install dir>/app/code/Vendor/Migration/etc/<migration edition>/<ce or version>/config.xml.Om du till exempel migrerar
Magento 1.9.3.6 Community EditiontillMagento 2 Open Source:code language-bash cd <your Magento 2 install dir>code language-bash cp vendor/magento/data-migration-tool/etc/opensource-to-opensource/1.9.3.6/config.xml.dist app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.3.6/config.xml -
I filen
config.xmlmåste du ange åtkomstinformation till M1- och M2-databaser och krypteringsnyckel. -
Om din M1-butik har anpassade ändringar bör du mappa resten av konfigurationsfilerna till dina Magento 1-butiksanpassningar. Se Arbeta med konfigurations- och mappningsfiler.
Konfigurera migrering i mappen vendor
Innan du migrerar några data måste du skapa en config.xml-konfigurationsfil från det angivna exemplet.
Så här konfigurerar du Data Migration Tool för migrering:
-
Logga in på programservern som, eller växla till, ägare av filsystemet.
-
Byt till följande katalog:
code language-bash <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version> -
Ange följande kommando för att skapa en
config.xmlfrån det angivna exemplet:code language-bash cp config.xml.dist config.xml -
Öppna
config.xmli en textredigerare. -
Filen config.xml måste minst innehålla åtkomstinformation till M1- och M2-databaser och krypteringsnycklar.
code language-xml <source> <database host="127.0.0.1" name="magento1" user="root"/> </source> <destination> <database host="127.0.0.1" name="magento2" user="root"/> </destination> <options> <crypt_key /> </options>Taggen <crypt_key> måste innehålla ett värde. Du hittar den i taggen
<key>, som finns i app/etc/local.xml-filen på din Magento 1-instans.Valfria parametrar:
- Användarlösenord för databas:
password=<password> - Anpassad databasport:
port=<port> - Tabellprefix:
<source_prefix>,<dest_prefix>
Om databasägarens användarnamn till exempel är
rootmed lösenordetpassoch du använder prefixetmagento1i din Magento 1-databas använder du följande iconfig.xml:code language-xml <source> <database host="127.0.0.1" name="magento1" user="root" password="pass"/> </source> <destination> <database host="127.0.0.1" name="magento2" user="root" password="pass"/> </destination> <options> <source_prefix>magento1</source_prefix> <crypt_key>f3e25abe619dae2387df9fs594f01985</crypt_key> </options> - Användarlösenord för databas:
När du är klar sparar du ändringarna i config.xml och avslutar textredigeraren.
Anslut med TLS-protokollet
Du kan också ansluta till en databas med TLS-protokollet (dvs. med offentliga/privata kryptografiska nycklar). Lägg till följande valfria attribut i elementet database:
ssl_cassl_certssl_key
Exempel:
<source>
<database host="localhost" name="magento1" user="root" ssl_ca="/path/to/file" ssl_cert="/path/to/file" ssl_key="/path/to/file"/>
</source>
<destination>
<database host="localhost" name="magento2" user="root" ssl_ca="/path/to/file" ssl_cert="/path/to/file" ssl_key="/path/to/file"/>
</destination>
Arbeta med konfigurations- och mappningsfiler
Data Migration Tool använder mappningsfiler för att du ska kunna utföra anpassad databasmappning mellan dina Magento 1- och Magento 2-databaser, inklusive:
-
Ändra tabellnamn
-
Ändra fältnamn
-
Ignorerar tabeller eller fält
-
Anpassa överföring av data från ett fält till Magento 2-format
Mappningsfiler för Magento-versioner som stöds finns i underkataloger till <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc
Så här använder du mappningsfilerna:
-
Kopiera dem från
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>/till<your Magento 2 install dir>/app/code/Vendor/Migration/etc/<migration edition>/<ce or version>/och ta bort tillägget.dist. -
Uppdatera sökvägen till den nyligen kopierade filen i noden
<options>iconfig.xml. Den uppdaterade sökvägen ska vara någon av följande:- Absolut filsökväg, t ex
/var/www/html/app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml - modulen magento/data-migration-tool relativ filsökväg:
etc/opensource-to-opensource/1.9.4.1/map.xml - Magento rotberoende filsökväg:
app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml
- Absolut filsökväg, t ex
Katalogerna <Magento 2 dir>/vendor/magento/data-migration-tool/etc och <Magento 2 dir>/vendor/magento/data-migration-tool/etc/<ce version> innehåller följande konfigurationsfiler:
Även om du arbetar med filen map.xml.dist för det mesta, beskrivs varje mappning och andra filer i följande tabell.
class-map.xml.distconfig.xml.distcustomer-attr-document-groups.xml.distcustomer-attr-map.xml.distdeltalog.xml.disteav-attribute-groups.xml.disteav-document-groups.xml.distlog-document-groups.xml.distmap-eav.xml.distmap-log.xml.distmap-sales.xml.distmap.xml.distsettings.xml.distcore_config_data.customer-attribute-groups.xml.distcustomer-document-groups.xml.distmap-customer.xml.distorder-grids-document-groups.xml.distmap-document-groups.xml.distmap-stores.xml.distmap-tier-price.xml.distvisual_merchandiser_map.xml.distvisual_merchandiser_attribute_groups.xml.distvisual_merchandiser_document_groups.xml.distMer information finns i Data Migration Tool den tekniska specifikationen.