Exécution des utilitaires d’assistance

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :
Configuration

Créé pour :

Expérimenté
Administration
Développeur

NOTE

Cette fonctionnalité est disponible uniquement pour les instances Adobe Commerce.

WARNING

Toutes les commandes de l’interface de ligne de commande Magento doivent être exécutées par le propriétaire du système de fichiers.

Les utilitaires d’assistance Adobe Commerce (également appelés collecteurs de données🔗 permettent aux utilisateurs de collecter des informations de dépannage sur votre système, que notre équipe d’assistance peut utiliser.

Adobe Commerce utilise ces sauvegardes, également appelées vidages, pour analyser les problèmes qui nécessitent l’accès à votre code. Voici un scénario type :

Vous rencontrez un problème avec votre boutique Commerce et vous contactez l’assistance Adobe Commerce.
L’assistance détermine qu’ils ont besoin de voir votre code ou votre base de données pour reproduire le problème.
Vous sauvegardez le code dans un fichier .tar.gz.

Cette sauvegarde _exclut vos fichiers multimédias afin d’accélérer le processus et d’obtenir un fichier beaucoup plus petit.
Vous sauvegardez la base de données dans un fichier .tar.gz.

Par défaut, les données sensibles sont hachées lors de la sauvegarde.
Vous chargez vos sauvegardes vers un service de partage de fichiers.
L’assistance analyse vos problèmes sans affecter votre environnement de développement ou de production.

Les utilitaires peuvent prendre plusieurs minutes.

Création d’une sauvegarde du code

Cette commande sauvegarde le code et le compresse au format tar.gz.

TIP

La commande support:backup n’est pas la même sauvegarde de code effectuée par la commande setup:backup. La commande support:backup est destinée à sauvegarder le code pour examen par le support Adobe Commerce.

Options de commande :

bin/magento support:backup:code [--name=<file name>] [-o|--output=<path>] [-l|--logs]

Où :

--name indique le nom du fichier de vidage (facultatif). Si vous omettez ce paramètre, le fichier de vidage est horodaté.
-o|--output=<path> est le chemin d’accès absolu au système de fichiers pour stocker la sauvegarde (obligatoire).
-l|--logs inclut les fichiers journaux (facultatif).

Par exemple, pour créer une sauvegarde de code nommée /var/www/html/magento2/var/log/mycodebackup.tar.gz :

bin/magento support:backup:code --name mycodebackup -o /var/www/html/magento2/var/log

Une fois la commande terminée, fournissez la sauvegarde du code au support Adobe Commerce.

Création d’une sauvegarde de base de données

Cette commande sauvegarde la base de données Commerce et la compresse au format tar.gz.

TIP

Options de commande :

bin/magento support:backup:db [--name=<name>] [-o|--output=<path>] [-l|--logs] [-i|--ignore-sanitize]

Où :

--name indique le nom du fichier de vidage (facultatif). Si vous omettez ce paramètre, le fichier de vidage est horodaté.
**-o|--output=<path> est le chemin d’accès absolu au système de fichiers pour stocker la sauvegarde (obligatoire).
-l|--logs inclut les fichiers journaux (facultatif).
-i|--ignore-sanitize signifie que les données sont conservées ; omettez l’indicateur pour hacher les données sensibles stockées dans la base de données lors de la création de la sauvegarde (facultatif).

Les données sensibles incluent des informations client provenant des tables de base de données suivantes :

'customer_entity',
'customer_entity_varchar',
'customer_address_entity',
'customer_address_entity_varchar',
'customer_grid_flat',
'quote',
'quote_address',
'sales_order',
'sales_order_address',
'sales_order_grid'

Une fois la commande terminée, fournissez la sauvegarde de la base de données au support Adobe Commerce.

Dépannage : utilitaires d’affichage et chemins d’accès

Nous fournissons des commandes qui affichent les chemins d’accès aux utilitaires requis par le collecteur de données et la ligne de commande. Vous pouvez utiliser ces commandes, par exemple, si des erreurs telles que celles-ci s’affichent dans l’interface d’administration ou sur la ligne de commande :

Utility lsof not found

Exécutez les commandes suivantes dans l’ordre indiqué pour afficher les chemins d’accès aux applications utilisées par les utilitaires de prise en charge et le collecteur de données :

Modifiez votre répertoire d’installation Commerce.

Par exemple, cd /var/www/magento2

note info
INFO
Les commandes s’exécutent correctement uniquement à partir de votre répertoire d’installation.

bin/magento support:utility:paths crée des <magento_root>/var/support/Paths.php qui répertorient les chemins d’accès à toutes les applications utilisées par l’utilitaire.
bin/magento support:utility:check affiche les chemins d’accès au système de fichiers.

Voici un exemple :

   gzip => /bin/gzip
   lsof => /usr/sbin/lsof
   mysqldump => /usr/bin/mysqldump
   nice => /bin/nice
   php => /usr/bin/php
   tar => /bin/tar
   sed => /bin/sed
   bash => /bin/bash
   mysql => /usr/bin/mysql

Pour résoudre les problèmes d’exécution des outils, assurez-vous que ces applications sont installées et se trouvent dans la variable d’environnement $PATH de l’utilisateur ou de l’utilisatrice du serveur web.

recommendation-more-help

386822bd-e32c-40a8-81c2-ed90ad1e198c