Présentation de la migration

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :
Configuration

Créé pour :

Expérimenté
Administration
Développeur

Avant de commencer la migration, arrêtez toutes les tâches Magento 1 cron.

Lors du processus de migration, suivez les règles générales suivantes pour réussir la migration :

N’effectuez pas de modifications dans l’administrateur Magento 1, à l’exception de la gestion des commandes (expédition, création de factures et de notes de crédit).
Ne modifiez pas le code
N’effectuez pas de modifications dans l’administrateur et le storefront de Magento 2

TIP

Toutes les opérations dans le storefront Magento 1 sont autorisées.

Exécutez le Data Migration Tool

Cette section explique comment exécuter le Data Migration Tool pour migrer les paramètres, les données ou les modifications incrémentielles.

Premières étapes

Connectez-vous au serveur d’applications en tant qu’utilisateur ou passez à un utilisateur autorisé à écrire sur le système de fichiers. Voir basculement vers le propriétaire du système de fichiers.

Si vous utilisez le shell bash, vous pouvez utiliser la syntaxe suivante pour basculer vers le propriétaire du système de fichiers et saisir la commande en même temps :

code language-bash
`su <file system owner> -s /bin/bash -c <command>`

Si le propriétaire du système de fichiers n’autorise pas les connexions, vous pouvez effectuer les opérations suivantes :

code language-bash
`sudo -u <file system owner> <command>`

Pour exécuter des commandes de Magento depuis n’importe quel répertoire, ajoutez <magento_root>/bin à votre système PATH.

Les shells ayant une syntaxe différente, consultez une référence telle que unix.stackexchange.com.

Exemple de shell bash pour CentOS :

code language-bash
`export PATH=$PATH:/var/www/html/magento2/bin`

Vous pouvez éventuellement exécuter les commandes comme suit :

cd <magento_root>/bin et exécutez-les comme ./magento <command name>
<magento_root>/bin/magento <command name>
<magento_root> est un sous-répertoire de votre serveur web docroot.

Syntaxe de la commande

Voici un exemple de commande type :

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

Où :

<mode> peut être : settings, data ou delta
[-r|--reset] est un argument facultatif qui lance la migration à partir du début. Vous pouvez utiliser cet argument pour tester la migration.
[-a|--auto] est un argument facultatif qui empêche l’arrêt de la migration lorsqu’elle rencontre des erreurs de vérification de l’intégrité.
{<path to config.xml>} est le chemin d’accès absolu au système de fichiers config.xml ; cet argument est obligatoire.

NOTE

Les journaux sont écrits dans le répertoire <magento_root>/var/.

Ordre de migration

Lorsque nous avons créé le Data Migration Tool, nous avons supposé la séquence de transfert de données suivante :

Nous vous recommandons vivement de migrer les données dans le même ordre.

recommendation-more-help

c2d96e17-5179-455c-ad3a-e1697bb4e8c3