Configurez le Data Migration Tool
Après l’installation de 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
Il existe deux manières de configurer le Data Migration Tool :
- Configurez 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 votre configuration de migration et l’utiliser pour le déploiement, vous devez créer un module distinct.
Si vous prévoyez d’exécuter 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.
-
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>
-
Copiez le fichier de configuration
config.xml.dist
du répertoire approprié de 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
Magento 1.9.3.6 Community Edition
versMagento 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
-
Dans le fichier
config.xml
, vous devez définir les détails d'accès aux bases de données M1 et M2 et à la clé de chiffrement. -
Si votre boutique M1 comporte des modifications personnalisées, vous devez mapper le reste de vos fichiers de configuration à vos personnalisations de magasin Magento 1. Voir Utilisation des fichiers de configuration et de mappage.
Configuration de la migration dans le dossier vendor
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 :
-
Connectez-vous à votre serveur d’applications en tant que propriétaire du système de fichiers ou basculez-vous vers cette application.
-
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>
-
Saisissez la commande suivante pour créer un
config.xml
à partir de l’exemple fourni :code language-bash cp config.xml.dist config.xml
-
Ouvrez
config.xml
dans un éditeur de texte. -
Au minimum, le fichier config.xml doit contenir les 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 trouver dans la balise
<key>
située dans le fichier app/etc/local.xml de 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 de table :
<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 passepass
et que vous utilisez le préfixemagento1
dans la base de données du Magento 1, utilisez ce qui suit dansconfig.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>
- Mot de passe utilisateur de la base de données :
Lorsque vous avez terminé, enregistrez vos modifications dans config.xml
et quittez l’éditeur de texte.
Connexion à l’aide du 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 personnalisé de la base de données entre vos bases de données Magento 1 et Magento 2, notamment :
-
Modification des noms de table
-
Modification des noms de champ
-
Ignorer les tableaux ou les champs
-
Adapter le transfert des données d'un champ au format Magento 2
Les fichiers de mappage pour les versions de 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 :
-
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
. -
Mettez à jour le chemin d’accès au fichier nouvellement copié dans le noeud
<options>
deconfig.xml
. Le chemin d’accès mis à jour doit être l’un des suivants :- 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
- chemin d’accès relatif au module magento/data-migration-tool :
etc/opensource-to-opensource/1.9.4.1/map.xml
- Chemin d’accès au fichier relatif à la racine du Magento :
app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml
- Chemin d’accès absolu au fichier, par exemple
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 :
Même si vous travaillez la plupart du temps avec le fichier map.xml.dist
, le tableau suivant traite de chaque mappage et d’autres fichiers.
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
Pour plus d’informations, reportez-vous à la Data Migration Tool Spécification technique .