DokumentationCommerceTools

[Nur PaaS]{class="badge informative" title="Gilt nur für Adobe Commerce in Cloud-Projekten (von Adobe verwaltete PaaS-Infrastruktur) und lokale Projekte."}

Einstellungen für die Datenmigration

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Experte
  • Admin
  • Entwickler

Der Settings Modus migriert Stores, Websites und Systemkonfigurationen wie Versand-, Zahlungs- und Steuereinstellungen. Gemäß unserer Datenmigration Reihenfolge sollten Sie zuerst die Einstellungen migrieren.

Bevor Sie beginnen, führen Sie die folgenden Schritte aus, um Folgendes vorzubereiten:

  1. Melden Sie sich beim Anwendungs-Server als Dateisystemeigentümer“ ​.

  2. Wechseln Sie in das /bin Verzeichnis oder stellen Sie sicher, dass es zu Ihrem PATH hinzugefügt wird.

NOTE
Stellen Sie sicher, dass Magento 2 im default bereitgestellt wird. Der Entwicklermodus kann zu Validierungsfehlern im Migrations-Tool führen.

Weitere Informationen finden Sie ​ Abschnitt ​ Schritte .

Ausführen des Befehls zur Einstellungsmigration

Um mit der Migration von Einstellungen zu beginnen, führen Sie Folgendes aus:

bin/magento migrate:settings [-r|--reset] [-a|--auto] {<path to config.xml>}

Dabei gilt:

  • [-r|--reset] ist ein optionales Argument, das die Migration von Anfang an startet. Sie können dieses Argument zum Testen der Migration verwenden

  • [-a|--auto] ist ein optionales Argument, das verhindert, dass die Migration angehalten wird, wenn Fehler bei der Integritätsprüfung auftreten.

  • {<path to config.xml>} ist der absolute Dateisystempfad zur config.xml des Migrations-Tools. Dieses Argument ist erforderlich.

NOTE
Dieser Befehl migriert nicht alle Konfigurationseinstellungen. Überprüfen Sie alle Einstellungen in Magento 2 Admin, bevor Sie fortfahren.

Die Migration completed wird angezeigt, nachdem die Einstellungen erfolgreich übertragen wurden.

Konfigurieren benutzerdefinierter Migrationsregeln

Sie können die Systemkonfigurationen beim Migrieren von Einstellungen ignorieren, umbenennen oder ändern. Geben Sie dazu Ihre benutzerdefinierten Regeln in der settings.xml an.

  1. Melden Sie sich beim Anwendungs-Server als oder wechseln Sie zum Dateisystembesitzer.

  2. Wechseln Sie in das folgende Verzeichnis:

    code language-bash 
    cd <your application 2 install dir>/vendor/magento/data-migration-tool/etc/<edition-to-edition>

    Wenn die Anwendung beispielsweise in /var/www/html installiert ist, befindet sich die settings.xml.dist in einem der folgenden Verzeichnisse:

    • /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

  3. Um eine settings.xml Datei aus dem bereitgestellten Beispiel zu erstellen, führen Sie Folgendes aus:

    code language-bash 
    cp settings.xml.dist settings.xml

  4. Nehmen Sie Ihre Änderungen in settings.xml vor.

  5. Um den neuen Namen der Einstellungsdatei für die Zuordnung anzugeben, ändern Sie das <settings_map_file>-Tag in der path/to/config.xml.

Weitere Informationen finden Sie ​ Abschnitt „Einstellungen Migrationsmodus der ​ des Tools.

Nächster Migrationsschritt

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