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.dist
frå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 Edition
tillMagento 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.xml
må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 anpassningar för Magento 1-butiken. 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.xml
från det angivna exemplet:code language-bash cp config.xml.dist config.xml
-
Öppna
config.xml
i 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 kan hitta den inuti taggen
<key>
, som finns i app/etc/local.xml-filen på Magento 1-instansen.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
root
med lösenordetpass
och du använder prefixetmagento1
i 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_ca
ssl_cert
ssl_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 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.dist
config.xml.dist
customer-attr-document-groups.xml.dist
customer-attr-map.xml.dist
deltalog.xml.dist
eav-attribute-groups.xml.dist
eav-document-groups.xml.dist
log-document-groups.xml.dist
map-eav.xml.dist
map-log.xml.dist
map-sales.xml.dist
map.xml.dist
settings.xml.dist
core_config_data
.customer-attribute-groups.xml.dist
customer-document-groups.xml.dist
map-customer.xml.dist
order-grids-document-groups.xml.dist
map-document-groups.xml.dist
map-stores.xml.dist
map-tier-price.xml.dist
visual_merchandiser_map.xml.dist
visual_merchandiser_attribute_groups.xml.dist
visual_merchandiser_document_groups.xml.dist
Mer information finns i Data Migration Tool den tekniska specifikationen.