Documentação Commerce Guia de configuração

Execute os utilitários de suporte

Last update: Fri May 19 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:
Configuration

Criado para:

Experienced
Admin
Developer

NOTE

Esse recurso está disponível somente para instâncias do Adobe Commerce.

WARNING

Todos os comandos da 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— permite 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:

Você está tendo um problema com sua loja de Commerce e entra em contato com o Suporte da Adobe Commerce.
O suporte determina que eles precisam ver seu código ou banco de dados para reproduzir o problema.
Você faz backup do código em um .tar.gz arquivo.

Este backup _exclui seus arquivos de mídia para acelerar o processo e resultar em um arquivo muito menor.
Você faz backup do banco de dados em um .tar.gz arquivo.

Por padrão, os dados confidenciais recebem hash ao fazer o backup.
Você faz upload de backups para um serviço de compartilhamento de arquivos.
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

Esse comando faz backup do código e o compacta em tar.gz formato.

TIP

A variável support:backup é não o mesmo backup de código executado pelo setup:backup comando. A variável support:backup destina-se a fazer backup do código para análise 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 dump (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 registro (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

Esse comando faz backup do banco de dados do Commerce e o compacta em tar.gz formato.

TIP

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 dump (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 registro (opcional).
-i|--ignore-sanitize significa que os dados são preservados; omita o sinalizador para aplicar hash a 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:

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

Por exemplo, cd /var/www/magento2

note info
INFO
Os comandos são executados corretamente somente do diretório de instalação.

bin/magento support:utility:paths cria <magento_root>/var/support/Paths.php, que lista os caminhos para todos os aplicativos usados pelo utilitário.
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 no repositório do usuário do servidor Web $PATH variável de ambiente.

recommendation-more-help

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