DokumentationCommerceKonfigurationshandbuch

Führen Sie die Hilfsprogramme aus

Last update: Sat Nov 02 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Experte
  • Admin
  • Entwickler
NOTE
Diese Funktion ist nur für Adobe Commerce-Instanzen verfügbar.
WARNING
Alle Magento-CLI-Befehle müssen vom Dateisysteminhaber ausgeführt werden.

Die Adobe Commerce-Support-Dienstprogramme - auch als Datenerfassung bezeichnet - ermöglichen es Benutzern, Informationen zur Fehlerbehebung zu Ihrem System zu erfassen, die von unserem Supportteam verwendet werden können.

Adobe Commerce verwendet diese Sicherungen, auch Dumps genannt, um Probleme zu analysieren, die Zugriff auf Ihren Code erfordern. Ein typisches Szenario sieht wie folgt aus:

  1. Sie haben ein Problem mit Ihrem Commerce-Store und wenden sich an den Adobe Commerce-Support.

  2. Der Support legt fest, dass er Ihren Code oder Ihre Datenbank sehen muss, um das Problem zu reproduzieren.

  3. Sie sichern den Code in einer .tar.gz -Datei.

    Dieses Backup_schließt Ihre Mediendateien aus, um den Prozess zu beschleunigen und zu einer wesentlich kleineren Datei zu führen.

  4. Sie sichern die Datenbank in einer .tar.gz -Datei.

    Standardmäßig werden vertrauliche Daten beim Erstellen der Sicherung gehasht.

  5. Sie laden Ihre Sicherungen in einen Dateifreigabedienst hoch.

  6. Der Support analysiert Ihre Probleme, ohne dass sich dies auf Ihre Entwicklungs- oder Produktionsumgebung auswirkt.

Die Ausführung der Dienstprogramme kann mehrere Minuten dauern.

Codesicherung erstellen

Dieser Befehl sichert den Code und komprimiert ihn im Format tar.gz.

TIP
Der Befehl support:backup lautet nicht und entspricht der vom Befehl setup:backup durchgeführten Codesicherung. Der Befehl support:backup dient dazu, den Code für die Prüfung durch den Adobe Commerce-Support zu sichern.

Befehlsoptionen:

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

Dabei gilt:

  • --name gibt den Dateinamen der Dump-Datei an (optional). Wenn Sie diesen Parameter weglassen, wird die Dump-Datei mit dem Zeitstempel und dem Datumsstempel versehen.
  • -o|--output=<path> ist der absolute Dateisystempfad zum Speichern der Sicherung (erforderlich).
  • -l|--logs enthält Protokolldateien (optional).

So erstellen Sie beispielsweise eine Codesicherung mit dem Namen /var/www/html/magento2/var/log/mycodebackup.tar.gz:

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

Stellen Sie nach Abschluss des Befehls die Codesicherung für den Adobe Commerce-Support bereit.

Datenbanksicherung erstellen

Mit diesem Befehl wird die Commerce-Datenbank gesichert und im tar.gz-Format komprimiert.

TIP
Der Befehl support:backup lautet nicht und entspricht der vom Befehl setup:backup durchgeführten Codesicherung. Der Befehl support:backup dient dazu, den Code für die Prüfung durch den Adobe Commerce-Support zu sichern.

Befehlsoptionen:

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

Dabei gilt:

  • --name gibt den Dateinamen der Dump-Datei an (optional). Wenn Sie diesen Parameter weglassen, wird die Dump-Datei mit dem Zeitstempel und dem Datumsstempel versehen.
  • **-o|--output=<path> ist der absolute Dateisystempfad zum Speichern der Sicherung (erforderlich).
  • -l|--logs enthält Protokolldateien (optional).
  • -i|--ignore-sanitize bedeutet, dass Daten beibehalten werden. Lassen Sie die Markierung weg, um beim Erstellen der Sicherung gespeicherte vertrauliche Daten in der Datenbank zu hash-Daten zu speichern (optional).

Sensible Daten umfassen Kundeninformationen aus den folgenden Datenbanktabellen:

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

Stellen Sie nach Abschluss des Befehls die Datenbanksicherung für den Adobe Commerce-Support bereit.

Fehlerbehebung: Anzeigeprogramme und Pfade

Wir stellen Befehle bereit, die Pfade zu Dienstprogrammen anzeigen, die für die Datenerfassung und die Befehlszeile erforderlich sind. Sie können diese Befehle beispielsweise verwenden, wenn Fehler wie die folgende in der Admin- oder Befehlszeile angezeigt werden:

Utility lsof not found

Führen Sie die folgenden Befehle in der angezeigten Reihenfolge aus, um die Pfade zu den von den Support-Dienstprogrammen und dem Data Collector verwendeten Anwendungen anzuzeigen:

  1. Wechseln Sie zum Installationsverzeichnis von Commerce.

    Beispiel: cd /var/www/magento2

    note info
    INFO
    Die Befehle werden im Installationsverzeichnis ordnungsgemäß mit nur ausgeführt.

  2. bin/magento support:utility:paths erstellt <magento_root>/var/support/Paths.php, in dem die Pfade zu allen vom Dienstprogramm verwendeten Anwendungen aufgelistet werden.

  3. bin/magento support:utility:check zeigt die Dateisystempfade an.

Ein Beispiel:

   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

Um Probleme beim Ausführen der Tools zu beheben, stellen Sie sicher, dass diese Anwendungen installiert sind und sich in der Umgebungsvariablen "$PATH" des Webserver-Benutzers befinden.

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