[PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}

Configuration du Data Migration Tool

Après avoir installé le Data Migration Tool, le répertoire suivant contient les fichiers de mappage et de configuration :

  • MAGENTO OPEN SOURCE :

    • <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/opensource-to-opensource : configuration et scripts pour la migration de Magento Open Source 1 vers Magento Open Source 2
  • ADOBE COMMERCE :

    • <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/opensource-to-commerce : configuration et scripts pour la migration de Magento Open Source 1 vers Adobe Commerce 2
    • <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/commerce-to-commerce : configuration et scripts pour la migration d’Adobe Commerce 1 vers Adobe Commerce 2

Les répertoires précédents contiennent des sous-répertoires pour chaque version prise en charge.

Configuration de la migration

Vous pouvez configurer le Data Migration Tool de deux manières différentes :

  • Configurer le Data Migration Tool dans un module distinct (recommandé)
  • Modifiez la configuration Data Migration Tool dans le répertoire <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/.

Pour utiliser le contrôle de code source afin de gérer la configuration de la migration et l’utiliser pour le déploiement, vous devez créer un module distinct.
Si vous prévoyez d’exécuter l’Data Migration Tool localement uniquement, vous pouvez modifier directement les fichiers du répertoire <your Magento 2 install dir>/vendor/magento/data-migration-tool/ .

Configuration de la migration dans un module distinct

Avant de migrer des données, vous devez créer un module Magento 2.

  1. Créez un module Magento 2.

    • <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. Copiez le fichier de configuration config.xml.dist du répertoire approprié du Data Migration Tool (<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>) dans le fichier <your Magento 2 install dir>/app/code/Vendor/Migration/etc/<migration edition>/<ce or version>/config.xml.

    Par exemple, si vous migrez des Magento 1.9.3.6 Community Edition vers Magento 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
    
  3. Dans le fichier config.xml, vous devez définir les informations d'accès aux bases de données M1 et M2 et à la clé de chiffrement.

  4. Si votre magasin M1 comporte des modifications personnalisées, vous devez mapper le reste de vos fichiers de configuration aux personnalisations de votre magasin Magento 1. Voir Utilisation des fichiers de configuration et de mappage.

Configuration de la migration dans vendor dossier

Avant de migrer des données, vous devez créer un fichier de configuration config.xml à partir de l’exemple fourni.

Pour configurer le Data Migration Tool pour la migration :

  1. Connectez-vous au serveur d’applications en tant que propriétaire du système de fichiers ou passez à ce serveur.

  2. Accédez au répertoire suivant :

    code language-bash
    <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>
    
  3. Saisissez la commande suivante pour créer un config.xml à partir de l’exemple fourni :

    code language-bash
    cp config.xml.dist config.xml
    
  4. Ouvrez config.xml dans un éditeur de texte.

  5. Au minimum, le fichier config.xml doit contenir des détails d'accès aux bases de données M1 et M2 et aux clés de chiffrement.

    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>
    

    La balise <crypt_key> doit contenir une valeur. Vous pouvez le retrouver dans la balise <key>, qui se trouve dans le fichier app/etc/local.xml sur votre instance Magento 1.

    Paramètres facultatifs :

    • Mot de passe utilisateur de la base de données : password=<password>
    • Port personnalisé de la base de données : port=<port>
    • Préfixe du tableau : <source_prefix>, <dest_prefix>

    Par exemple, si le nom d’utilisateur du propriétaire de la base de données est root avec le mot de passe pass et que vous utilisez le préfixe magento1 dans votre base de données Magento 1, utilisez ce qui suit dans 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>
    

Lorsque vous avez terminé, enregistrez vos modifications dans config.xml et quittez l’éditeur de texte.

Se connecter en utilisant le protocole TLS

Vous pouvez également vous connecter à une base de données à l’aide du protocole TLS (c’est-à-dire à l’aide de clés cryptographiques publiques/privées). Ajoutez les attributs facultatifs suivants à l’élément database :

  • ssl_ca
  • ssl_cert
  • ssl_key

Par exemple :

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

Utilisation des fichiers de configuration et de mappage

Le Data Migration Tool utilise des fichiers de mappage pour vous permettre d’effectuer un mappage de base de données personnalisé entre vos bases de données Magento 1 et Magento 2, notamment :

  • Modification des noms de table

  • Modification des noms de champ

  • Ignorer les tables ou les champs

  • Adapter le transfert des données d’un champ au format Magento 2

Les fichiers de mappage pour les versions Magento prises en charge se trouvent dans les sous-répertoires de <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc

Pour utiliser les fichiers de mappage :

  1. Copiez-les de <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>/ vers <your Magento 2 install dir>/app/code/Vendor/Migration/etc/<migration edition>/<ce or version>/ et supprimez l’extension .dist.

  2. Mettez à jour le chemin d’accès au fichier nouvellement copié dans le nœud <options> de config.xml. Le chemin d’accès mis à jour doit être l’un des suivants :

    1. Chemin d’accès absolu au fichier, par exemple /var/www/html/app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml
    2. chemin d’accès relatif du module magento/data-migration-tool : etc/opensource-to-opensource/1.9.4.1/map.xml
    3. Chemin d’accès au fichier relatif à la racine Magento : app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml

Les répertoires <Magento 2 dir>/vendor/magento/data-migration-tool/etc et <Magento 2 dir>/vendor/magento/data-migration-tool/etc/<ce version> contiennent les fichiers de configuration suivants :

Bien que vous travailliez la plupart du temps avec le fichier map.xml.dist, le tableau suivant décrit chaque mappage et autres fichiers.

Nom du fichier de mappage
Description
class-map.xml.dist
Dictionnaire des mappages de classes entre Magento 1 et Magento 2
config.xml.dist
Fichier de configuration principal qui spécifie les configurations des bases de données Magento 1 et Magento 2, la configuration des étapes et les liens vers les fichiers de mappage
Adobe Commerce uniquement. customer-attr-document-groups.xml.dist
Liste des tables utilisées dans l’étape Attributs du client personnalisés.
Adobe Commerce uniquement. customer-attr-map.xml.dist
Fichier de mappage utilisé dans l’étape Attributs du client personnalisés.
deltalog.xml.dist
Contient la liste des tables requises pour la configuration des routines de base de données.
eav-attribute-groups.xml.dist
Contient la liste des attributs utilisés dans chaque étape.
eav-document-groups.xml.dist
Contient la liste des tableaux utilisés dans chaque étape.
log-document-groups.xml.dist
Contient la liste des tables utilisées dans l’étape de journal.
map-eav.xml.dist
Mapper le fichier utilisé dans l’étape EAV.
map-log.xml.dist
Fichier de log-mapping.
Adobe Commerce uniquement. map-sales.xml.dist
Fichier de mappage utilisé dans SalesOrder Step.
map.xml.dist
Fichier de mappage requis pour l’étape de mappage.
settings.xml.dist
Définition du fichier de configuration de migration spécifiant les règles requises pour la migration de la table core_config_data.
customer-attribute-groups.xml.dist
Contient la liste des attributs utilisés dans l’étape Attributs du client.
customer-document-groups.xml.dist
Contient la liste des tables utilisées dans l’étape Attributs du client.
map-customer.xml.dist
Fichier de mappage utilisé à l’étape Attributs du client.
order-grids-document-groups.xml.dist
Contient la liste des tables utilisées dans l’étape OrderGrids.
map-document-groups.xml.dist
Définit les champs qui sont mis à jour lorsque des duplications se produisent lors de l’insertion des données
map-stores.xml.dist
Fichier de mappage utilisé dans l’étape Magasins.
map-tier-price.xml.dist
Fichier de mappage utilisé dans l’étape de prix de niveau.
Adobe Commerce uniquement. visual_merchandiser_map.xml.dist
Fichier de mappage utilisé dans VisualMerchandiser Step.
Adobe Commerce uniquement. visual_merchandiser_attribute_groups.xml.dist
Contient la liste des attributs utilisés dans VisualMerchandiser Step.
Adobe Commerce uniquement. visual_merchandiser_document_groups.xml.dist
Contient la liste des tables utilisées dans VisualMerchandiser Step.

Pour plus d’informations, reportez-vous à Data Migration Tool Spécifications techniques.

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