运行支持实用程序

NOTE
此功能仅适用于Adobe Commerce实例。
WARNING
所有MagentoCLI命令必须由 文件系统所有者.

Adobe Commerce支持实用程序 — 也称为 数据收集器 — 使用户能够收集有关您的系统的故障排除信息,供我们的支持团队使用。

Adobe Commerce使用这些备份,也称为 转储,以分析需要访问代码的问题。 典型情况如下:

  1. 您的Commerce商店出现问题,请联系Adobe Commerce支持部门。

  2. 支持人员确定他们需要查看代码或数据库才能重现问题。

  3. 将代码备份到 .tar.gz 文件。

    此备份不包括您的媒体文件,以加快此过程并生成一个小得多的文件(_E)。

  4. 将数据库备份到 .tar.gz 文件。

    默认情况下,在进行备份时会散列敏感数据。

  5. 将备份上载到文件共享服务。

  6. 支持人员会分析您的问题而不影响您的开发或生产环境。

这些实用程序可能需要几分钟才能完成。

创建代码备份

此命令备份代码并将其压缩到 tar.gz 格式。

TIP
support:backup 命令为 执行的相同代码备份 setup:backup 命令。 此 support:backup 命令用于备份代码以供Adobe Commerce支持部门检查。

命令选项:

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

其中:

  • --name 指定转储文件名(可选)。 如果忽略此参数,转储文件将带有时间和日期戳。
  • -o|--output=<path> 是存储备份的绝对文件系统路径(必需)。
  • -l|--logs 包含日志文件(可选)。

例如,要创建名为的代码备份 /var/www/html/magento2/var/log/mycodebackup.tar.gz

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

命令完成后,将代码备份到Adobe Commerce支持。

创建数据库备份

此命令备份Commerce数据库并将其压缩到 tar.gz 格式。

TIP
support:backup 命令为 执行的相同代码备份 setup:backup 命令。 此 support:backup 命令用于备份代码以供Adobe Commerce支持部门检查。

命令选项:

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

其中:

  • --name 指定转储文件名(可选)。 如果忽略此参数,转储文件将带有时间和日期戳。
  • **-o|--output=<path> 是存储备份的绝对文件系统路径(必需)。
  • -l|--logs 包含日志文件(可选)。
  • -i|--ignore-sanitize 表示数据会保留;在创建备份时省略用于对存储在数据库中的敏感数据进行哈希处理的标记(可选)。

敏感数据包括以下数据库表中的客户信息:

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

命令完成后,将数据库备份提供给Adobe Commerce支持部门。

故障排除:显示实用程序和路径

我们提供一些命令,这些命令显示到数据收集器和命令行所需的实用程序的路径。 例如,如果在Admin或命令行中显示以下错误,则可以使用这些命令:

Utility lsof not found

按照显示的顺序运行以下命令,以显示支持实用程序和Data Collector使用的应用程序的路径:

  1. 转到Commerce安装目录。

    例如,cd /var/www/magento2

    note info
    INFO
    命令运行正常 仅限 从您的安装目录中。
  2. bin/magento support:utility:paths 创建 <magento_root>/var/support/Paths.php,其中列出了该实用程序使用的所有应用程序的路径。

  3. bin/magento support:utility:check 显示文件系统路径。

下面是一个示例:

   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

要解决运行工具时出现的问题,请确保已安装这些应用程序并且位于Web服务器用户的 $PATH 环境变量。

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