DocumentazioneCommerceGuida alla configurazione

Eseguire le utilità di supporto

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

Creato per:

  • Esperto
  • Amministratore
  • Sviluppatore
NOTE
Questa funzione è disponibile solo per le istanze di Adobe Commerce.
WARNING
Tutti i comandi CLI di Magento devono essere eseguiti dal proprietario del file system.

Le utility di supporto di Adobe Commerce, denominate anche Data Collector, consentono agli utenti di raccogliere informazioni sulla risoluzione dei problemi del sistema che possono essere utilizzate dal team di supporto.

Adobe Commerce utilizza questi backup, detti anche dump, per analizzare i problemi che richiedono l'accesso al codice. Di seguito è riportato uno scenario tipico:

  1. Stai avendo un problema con il tuo store Commerce e contatta il Supporto Adobe Commerce.

  2. Il supporto determina che devono visualizzare il codice o il database per riprodurre il problema.

  3. È possibile eseguire il backup del codice in un file .tar.gz.

    Questo backup _esclude i file multimediali per velocizzare il processo e ottenere un file molto più piccolo.

  4. Eseguire il backup del database in un file .tar.gz.

    Per impostazione predefinita, i dati sensibili vengono sottoposti a hashing durante l’esecuzione del backup.

  5. I backup vengono caricati in un servizio di condivisione file.

  6. Il supporto analizza i problemi senza influire sull’ambiente di sviluppo o produzione.

Il completamento delle utilità può richiedere alcuni minuti.

Creare un backup del codice

Questo comando esegue il backup del codice e lo comprime nel formato tar.gz.

TIP
Il comando support:backup è non lo stesso backup del codice eseguito dal comando setup:backup. Il comando support:backup ha lo scopo di eseguire il backup del codice per l'esame da parte del supporto Adobe Commerce.

Opzioni comando:

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

Dove:

  • --name specifica il nome del file di dump (facoltativo). Se si omette questo parametro, il file di dump sarà contrassegnato con data e ora.
  • -o|--output=<path> è il percorso assoluto del file system per archiviare il backup (obbligatorio).
  • -l|--logs include i file di registro (facoltativo).

Ad esempio, per creare un backup del codice denominato /var/www/html/magento2/var/log/mycodebackup.tar.gz:

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

Al termine del comando, fornisci il backup del codice al supporto Adobe Commerce.

Creare un backup del database

Questo comando esegue il backup del database di Commerce e lo comprime nel formato tar.gz.

TIP
Il comando support:backup è non lo stesso backup del codice eseguito dal comando setup:backup. Il comando support:backup ha lo scopo di eseguire il backup del codice per l'esame da parte del supporto Adobe Commerce.

Opzioni comando:

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

Dove:

  • --name specifica il nome del file di dump (facoltativo). Se si omette questo parametro, il file di dump sarà contrassegnato con data e ora.
  • **-o|--output=<path> è il percorso assoluto del file system in cui archiviare il backup (obbligatorio).
  • -l|--logs include i file di registro (facoltativo).
  • -i|--ignore-sanitize significa che i dati sono conservati. Omettere il flag per eseguire l'hashing dei dati sensibili memorizzati nel database durante la creazione del backup (facoltativo).

I dati riservati includono le informazioni sui clienti delle tabelle di database seguenti:

'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'

Al termine del comando, fornire il backup del database al supporto Adobe Commerce.

Risoluzione dei problemi: utility di visualizzazione e percorsi

Forniamo comandi che visualizzano i percorsi delle utility richieste dall’agente di raccolta dati e dalla riga di comando. Puoi utilizzare questi comandi, ad esempio, se nella riga di comando o in Amministrazione vengono visualizzati errori come i seguenti:

Utility lsof not found

Eseguire i seguenti comandi nell'ordine indicato per visualizzare i percorsi delle applicazioni utilizzate dalle utility di supporto e dall'agente di raccolta dati:

  1. Passare alla directory di installazione di Commerce.

    Ad esempio: cd /var/www/magento2

    note info
    INFO
    I comandi vengono eseguiti correttamente only dalla directory di installazione.

  2. bin/magento support:utility:paths crea <magento_root>/var/support/Paths.php, che elenca i percorsi di tutte le applicazioni utilizzate dall'utility.

  3. bin/magento support:utility:check visualizza i percorsi del file system.

Di seguito è riportato un esempio:

   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

Per risolvere i problemi relativi all'esecuzione degli strumenti, assicurarsi che queste applicazioni siano installate e che siano incluse nella variabile di ambiente $PATH dell'utente del server Web.

recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c