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.

  1. 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>
    
  2. 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 auf Magento 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
    
  3. In der Datei config.xml müssen Sie die Zugriffsdetails auf die Datenbanken von M1 und M2 und den Verschlüsselungsschlüssel festlegen.

  4. 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:

  1. Melden Sie sich bei Ihrem Anwendungsserver als Dateisysteminhaber an oder wechseln Sie zu ihm.

  2. 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>
    
  3. 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
    
  4. Öffnen Sie config.xml in einem Texteditor.

  5. 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 Kennwort pass lautet und Sie das Präfix magento1 in Ihrer Magento 1-Datenbank verwenden, verwenden Sie Folgendes in config.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>
    

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:

  1. 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.

  2. Aktualisieren Sie den Pfad zur neu kopierten Datei im Knoten <options> von config.xml. Der aktualisierte Pfad sollte einer der folgenden sein:

    1. Absoluter Dateipfad, z. B. /var/www/html/app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml
    2. magento/data-migration-tool module relativer Dateipfad: etc/opensource-to-opensource/1.9.4.1/map.xml
    3. Magento root-relative Dateipfad: app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml

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.

Dateinamen zuordnen
Beschreibung
class-map.xml.dist
Wörterbuch der Klassenzuordnungen zwischen Magento 1 und Magento 2
config.xml.dist
Hauptkonfigurationsdatei, die die Datenbankkonfigurationen für Magento 1 und Magento 2, Schrittkonfiguration und Links zu Zuordnungsdateien angibt
Nur Adobe Commerce. customer-attr-document-groups.xml.dist
Liste der Tabellen, die im Schritt für benutzerdefinierte Kundenattribute verwendet werden.
Nur Adobe Commerce. customer-attr-map.xml.dist
Zuordnungsdatei, die im Schritt Benutzerdefinierte Kundenattribute verwendet wird.
deltalog.xml.dist
Enthält die Liste der Tabellen, die für die Einrichtung von Datenbankroutinen erforderlich sind.
eav-attribute-groups.xml.dist
Enthält eine Liste der Attribute, die in jedem Schritt verwendet werden.
eav-document-groups.xml.dist
Enthält eine Liste der Tabellen, die in jedem Schritt verwendet werden.
log-document-groups.xml.dist
Enthält eine Liste der Tabellen, die im Protokollschritt verwendet werden.
map-eav.xml.dist
Zuordnungsdatei, die im EAV-Schritt verwendet wird.
map-log.xml.dist
Protokollzuordnungsdatei.
Nur Adobe Commerce. map-sales.xml.dist
Zuordnungsdatei, die im SalesOrder-Schritt verwendet wird.
map.xml.dist
Zuordnungsdatei, die für den Schritt "Zuordnung"erforderlich ist.
settings.xml.dist
Festlegen der Migrationskonfigurationsdatei, die die für die Migration der core_config_data -Tabelle erforderlichen Regeln angibt.
customer-attribute-groups.xml.dist
Enthält eine Liste der Attribute, die im Schritt Kundenattribute verwendet werden.
customer-document-groups.xml.dist
Enthält eine Liste der Tabellen, die im Schritt Kundenattribute verwendet werden.
map-customer.xml.dist
Zuordnungsdatei, die im Schritt "Kundenattribute"verwendet wird.
order-grids-document-groups.xml.dist
Enthält eine Liste der Tabellen, die im Schritt "OrderGrids"verwendet werden.
map-document-groups.xml.dist
Definiert, welche Felder aktualisiert werden, wenn beim Einfügen von Daten Duplikate auftreten
map-stores.xml.dist
Zuordnungsdatei, die im Store-Schritt verwendet wird.
map-tier-price.xml.dist
Zuordnungsdatei, die im Schritt "Level Price"verwendet wird.
Nur Adobe Commerce. visual_merchandiser_map.xml.dist
Zuordnungsdatei, die im VisualMerchandiser-Schritt verwendet wird.
Nur Adobe Commerce. visual_merchandiser_attribute_groups.xml.dist
Enthält eine Liste der Attribute, die im VisualMerchandiser-Schritt verwendet werden.
Nur Adobe Commerce. visual_merchandiser_document_groups.xml.dist
Enthält eine Liste der Tabellen, die im VisualMerchandiser-Schritt verwendet werden.

Weitere Informationen finden Sie unter Data Migration Tool Technische Spezifikation .

recommendation-more-help
c2d96e17-5179-455c-ad3a-e1697bb4e8c3