Konfigurieren des Data Migration Tool
Nach der Installation von Data Migration Tool enthält der folgende Ordner Zuordnungs- und Konfigurationsdateien:
-
Magento Open Source:
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/opensource-to-opensource
: Konfiguration und Skripte für die Migration von Magento Open Source 1 zu Magento Open Source 2
-
Adobe Commerce:
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/opensource-to-commerce
: Konfiguration und Skripte für die Migration von Magento Open Source 1 zu Adobe Commerce 2<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/commerce-to-commerce
: Konfiguration und Skripte für die Migration von Adobe Commerce 1 zu Adobe Commerce 2
Die vorherigen Ordner enthalten Unterverzeichnisse für jede unterstützte Version.
Konfigurieren der Migration
Es gibt zwei Möglichkeiten, den Data Migration Tool zu konfigurieren:
- Konfigurieren Sie die Data Migration Tool in einem separaten Modul (empfohlen).
- Ändern Sie die Konfiguration Data Migration Tool im Verzeichnis
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/
.
Um die Migrationskonfiguration mithilfe der Quellcodeverwaltung zu verwalten und für die Bereitstellung zu verwenden, müssen Sie ein separates Modul erstellen.
Wenn Sie die Data Migration Tool nur lokal ausführen möchten, können Sie Dateien im Verzeichnis <your Magento 2 install dir>/vendor/magento/data-migration-tool/
direkt bearbeiten.
Konfigurieren der Migration in einem separaten Modul
Bevor Sie Daten migrieren, müssen Sie ein Magento 2-Modul erstellen.
-
Erstellen Sie ein 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>
-
Kopieren Sie die Konfigurationsdatei
config.xml.dist
aus dem entsprechenden Verzeichnis der Data Migration Tool (<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>
) in die Datei<your Magento 2 install dir>/app/code/Vendor/Migration/etc/<migration edition>/<ce or version>/config.xml
.Wenn Sie beispielsweise
Magento 1.9.3.6 Community Edition
aufMagento 2 Open Source
migrieren: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
-
In der Datei
config.xml
müssen Sie die Zugriffsdetails auf die Datenbanken von M1 und M2 und den Verschlüsselungsschlüssel festlegen. -
Wenn Ihr M1-Store benutzerdefinierte Änderungen aufweist, sollten Sie den Rest Ihrer Konfigurationsdateien Ihren Magento 1-Store-Anpassungen zuordnen. Siehe Arbeiten mit Konfigurations- und Zuordnungsdateien.
Konfigurieren der Migration im Ordner "vendor
"
Bevor Sie Daten migrieren, müssen Sie eine config.xml
-Konfigurationsdatei aus dem bereitgestellten Beispiel erstellen.
Konfigurieren des Data Migration Tool für die Migration:
-
Melden Sie sich bei Ihrem Anwendungsserver als Dateisysteminhaber an oder wechseln Sie zu ihm.
-
Wechseln Sie in den folgenden Ordner:
code language-bash <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>
-
Geben Sie den folgenden Befehl ein, um einen
config.xml
aus dem bereitgestellten Beispiel zu erstellen:code language-bash cp config.xml.dist config.xml
-
Öffnen Sie
config.xml
in einem Texteditor. -
Die Datei "config.xml"muss mindestens Zugriffsdetails zu den Datenbanken von M1 und M2 sowie Verschlüsselungsschlüssel enthalten.
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>
Das Tag <crypt_key> muss einen Wert enthalten. Sie finden ihn im Tag
<key>
, das sich in der Datei app/etc/local.xml auf Ihrer Magento 1-Instanz befindet.Optionale Parameter:
- Database user password:
password=<password>
- Benutzerdefinierter Datenbankport:
port=<port>
- Tabellenpräfix:
<source_prefix>
,<dest_prefix>
Wenn beispielsweise der Benutzername Ihres Datenbankinhabers
root
mit dem Kennwortpass
lautet und Sie das Präfixmagento1
in Ihrer Magento 1-Datenbank verwenden, verwenden Sie Folgendes inconfig.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>
- Database user password:
Speichern Sie abschließend Ihre Änderungen in config.xml
und beenden Sie den Texteditor.
Verbindung mit dem TLS-Protokoll herstellen
Sie können auch über das TLS-Protokoll (d. h. mithilfe öffentlicher/privater kryptografischer Schlüssel) eine Verbindung zu einer Datenbank herstellen. Fügen Sie dem Element database
die folgenden optionalen Attribute hinzu:
ssl_ca
ssl_cert
ssl_key
Beispiel:
<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>
Arbeiten mit Konfigurations- und Zuordnungsdateien
Data Migration Tool verwendet Zuordnungsdateien, um Ihnen die Durchführung einer benutzerdefinierten Datenbankzuordnung zwischen Ihren Magento 1- und Magento 2-Datenbanken zu ermöglichen, darunter:
-
Ändern von Tabellennamen
-
Ändern von Feldnamen
-
Ignorieren von Tabellen oder Feldern
-
Anpassen der Übertragung von Daten eines Felds in das Magento 2-Format
Zuordnungsdateien für unterstützte Magento-Versionen befinden sich in Unterverzeichnissen von <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc
So verwenden Sie die Zuordnungsdateien:
-
Kopieren Sie sie von
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>/
in<your Magento 2 install dir>/app/code/Vendor/Migration/etc/<migration edition>/<ce or version>/
und entfernen Sie die.dist
-Erweiterung. -
Aktualisieren Sie den Pfad zur neu kopierten Datei im Knoten
<options>
vonconfig.xml
. Der aktualisierte Pfad sollte einer der folgenden sein:- Absoluter Dateipfad, z. B.
/var/www/html/app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml
- magento/data-migration-tool module relativer Dateipfad:
etc/opensource-to-opensource/1.9.4.1/map.xml
- Magento root-relative Dateipfad:
app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml
- Absoluter Dateipfad, z. B.
Die Verzeichnisse <Magento 2 dir>/vendor/magento/data-migration-tool/etc
und <Magento 2 dir>/vendor/magento/data-migration-tool/etc/<ce version>
enthalten die folgenden Konfigurationsdateien:
Auch wenn Sie die meiste Zeit mit der Datei map.xml.dist
arbeiten, werden in der folgenden Tabelle alle Mapping- und anderen Dateien erläutert.
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
-Tabelle erforderlichen Regeln angibt.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
Weitere Informationen finden Sie unter Data Migration Tool Technische Spezifikation .