[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."}

Présentation de la migration

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

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

  1. N’apportez pas modifications dans l’administrateur Magento 1, à l’exception de la gestion des commandes (expédition, création de factures et avoirs)
  2. Ne modifiez code
  3. N’apportez pas modifications dans l’administration et le storefront de Magento 2.
TIP
Toutes les opérations effectuées dans le storefront Magento 1 sont autorisées.

Exécuter 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

  1. Connectez-vous au serveur d’applications en tant qu’utilisateur ou en tant qu’utilisateur disposant des autorisations d’écriture sur le système de fichiers. Voir passer au propriétaire du système de fichiers.

    Si vous utilisez le shell bash, vous pouvez utiliser la syntaxe suivante pour passer au propriétaire du système de fichiers et saisir simultanément la commande :

    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>
    
  2. Pour exécuter des commandes Magento à partir de n’importe quel répertoire, ajoutez des <magento_root>/bin à votre PATH système.

    Étant donné que les shell ont 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 des manières suivantes :

    • cd <magento_root>/bin et exécutez-les en tant que ./magento <command name>
    • <magento_root>/bin/magento <command name>
    • <magento_root> est un sous-répertoire de la racine docroot de votre serveur web.

Syntaxe des commandes

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 depuis le 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 contrôle d’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

Lors de la création du Data Migration Tool, nous avons supposé que la séquence de transfert de données suivante était active :

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

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