Execute os utilitários de suporte

NOTE
Esse recurso está disponível somente para instâncias do Adobe Commerce.
WARNING
Todos os comandos CLI do Magento devem ser executados pelo proprietário do sistema de arquivos.

Os utilitários de Suporte da Adobe Commerce, também conhecidos como Coletor de Dados, permitem que os usuários coletem informações de solução de problemas do seu sistema, que podem ser usadas pela nossa equipe de suporte.

O Adobe Commerce usa esses backups, também chamados de despejos, para analisar problemas que exigem acesso ao seu código. Um cenário típico é o seguinte:

  1. Você está tendo um problema com sua loja da Commerce e entra em contato com o Suporte da Adobe Commerce.

  2. O suporte determina que eles precisam ver seu código ou banco de dados para reproduzir o problema.

  3. Você faz backup do código em um arquivo .tar.gz.

    Este backup _exclui seus arquivos de mídia para acelerar o processo e resultar em um arquivo muito menor.

  4. Você faz backup do banco de dados em um arquivo .tar.gz.

    Por padrão, os dados confidenciais recebem hash ao fazer o backup.

  5. Você faz upload de backups para um serviço de compartilhamento de arquivos.

  6. O suporte analisa seus problemas sem afetar o ambiente de desenvolvimento ou produção.

Os utilitários podem levar vários minutos para serem concluídos.

Criar um backup de código

Este comando faz backup do código e o compacta no formato tar.gz.

TIP
O comando support:backup é não o mesmo backup de código executado pelo comando setup:backup. O comando support:backup deve fazer backup do código para ser examinado pelo Suporte da Adobe Commerce.

Opções de comando:

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

Onde:

  • --name especifica o nome do arquivo de despejo (opcional). Se você omitir esse parâmetro, o arquivo de despejo terá carimbo de data e hora.
  • -o|--output=<path> é o caminho absoluto do sistema de arquivos para armazenar o backup (necessário).
  • -l|--logs inclui arquivos de log (opcional).

Por exemplo, para criar um backup de código chamado /var/www/html/magento2/var/log/mycodebackup.tar.gz:

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

Depois que o comando for concluído, forneça o backup do código para o Suporte da Adobe Commerce.

Criar um backup de banco de dados

Este comando faz backup do banco de dados Commerce e compacta-o no formato tar.gz.

TIP
O comando support:backup é não o mesmo backup de código executado pelo comando setup:backup. O comando support:backup deve fazer backup do código para ser examinado pelo Suporte da Adobe Commerce.

Opções de comando:

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

Onde:

  • --name especifica o nome do arquivo de despejo (opcional). Se você omitir esse parâmetro, o arquivo de despejo terá carimbo de data e hora.
  • **-o|--output=<path> é o caminho absoluto do sistema de arquivos para armazenar o backup (necessário).
  • -l|--logs inclui arquivos de log (opcional).
  • -i|--ignore-sanitize significa que os dados são preservados; omita o sinalizador para fazer hash de dados confidenciais armazenados no banco de dados ao criar o backup (opcional).

Os dados confidenciais incluem informações de clientes das seguintes tabelas de banco de dados:

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

Após a conclusão do comando, forneça o backup do banco de dados para o Suporte da Adobe Commerce.

Solução de problemas: utilitários de exibição e caminhos

Fornecemos comandos que exibem caminhos para utilitários exigidos pelo Coletor de dados e pela linha de comando. Você pode usar esses comandos, por exemplo, se erros como o seguinte forem exibidos no Admin ou na linha de comando:

Utility lsof not found

Execute os seguintes comandos na ordem mostrada para exibir os caminhos para os aplicativos usados pelos utilitários de suporte e pelo Coletor de dados:

  1. Altere para o diretório de instalação do Commerce.

    Por exemplo, cd /var/www/magento2

    note info
    INFO
    Os comandos são executados somente corretamente a partir do diretório de instalação.
  2. bin/magento support:utility:paths cria <magento_root>/var/support/Paths.php, que lista os caminhos para todos os aplicativos usados pelo utilitário.

  3. bin/magento support:utility:check exibe os caminhos do sistema de arquivos.

A seguir, há uma amostra:

   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

Para resolver problemas com a execução das ferramentas, verifique se esses aplicativos estão instalados e se estão na variável de ambiente $PATH do usuário do servidor Web.

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