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.
-
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é 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
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 informations d'accès aux bases de données M1 et M2 et à la clé de chiffrement. -
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 :
-
Connectez-vous au serveur d’applications en tant que propriétaire du système de fichiers ou passez à ce serveur.
-
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 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 passepass
et que vous utilisez le préfixemagento1
dans votre base de données 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.
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 :
-
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 nœud
<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 du module magento/data-migration-tool :
etc/opensource-to-opensource/1.9.4.1/map.xml
- Chemin d’accès au fichier relatif à la racine 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 :
Bien que vous travailliez la plupart du temps avec le fichier map.xml.dist
, le tableau suivant décrit chaque mappage et 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 à Data Migration Tool Spécifications techniques.