Documentation Commerce Guide de configuration

Exécution des utilitaires de support

Last update: Thu Jul 18 2024 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 du Magento doivent être exécutées par le propriétaire du système de fichiers.

Les utilitaires de support Adobe Commerce, également appelés Collecteur de données, permettent aux utilisateurs de collecter des informations de dépannage sur votre système qui peuvent être utilisées par notre équipe de support.

Adobe Commerce utilise ces sauvegardes, également appelées dumps, 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 doivent 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 transférez 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.

L’exécution des utilitaires peut prendre plusieurs minutes.

Création d’une sauvegarde de code

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

TIP

La commande support:backup est et non 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 spécifie le nom de fichier de vidage (facultatif). Si vous omettez ce paramètre, le fichier de vidage est horodaté et horodaté.
-o|--output=<path> est le chemin d’accès absolu au système de fichiers pour stocker la sauvegarde (obligatoire).
-l|--logs comprend des 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, effectuez la sauvegarde du code auprès de l’assistance 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 spécifie le nom de fichier de vidage (facultatif). Si vous omettez ce paramètre, le fichier de vidage est horodaté et horodaté.
**-o|--output=<path> est le chemin d’accès absolu au système de fichiers pour stocker la sauvegarde (obligatoire).
-l|--logs comprend des 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 sur les clients 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, effectuez la sauvegarde de la base de données auprès du 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 comme celle-ci s’affichent dans l’Admin 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 support et le collecteur de données :

Accédez au répertoire d’installation de Commerce.

Par exemple, cd /var/www/magento2

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

bin/magento support:utility:paths crée <magento_root>/var/support/Paths.php, qui répertorie 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 liés à l’exécution des outils, assurez-vous que ces applications sont installées et se trouvent dans la variable d’environnement $PATH de l’utilisateur du serveur web.

recommendation-more-help

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