DokumentationCommerceKonfigurationshandbuch

Ausführen der Support-Dienstprogramme

Last update: Mon Dec 30 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 Dateisystembesitzer“ ausgeführt.

Mit den Adobe Commerce-Support-Dienstprogrammen (auch als Datenerfassung bezeichnet) können Benutzende Informationen zur Fehlerbehebung in Ihrem System sammeln, die von unserem Support-Team verwendet werden können.

Adobe Commerce verwendet diese Sicherungskopien, auch als "" bezeichnet, um Probleme zu analysieren, die Zugriff auf Ihren Code erfordern. Es folgt ein typisches Szenario:

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

  2. Der Support entscheidet, ob der Code oder die Datenbank angezeigt werden müssen, um das Problem zu reproduzieren.

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

    Durch dieses Backup werden Ihre Mediendateien _ausgeschlossen, um den Vorgang zu beschleunigen und eine wesentlich kleinere Datei zu erhalten.

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

    Standardmäßig werden vertrauliche Daten bei der Sicherung in Hash-Werte umgewandelt.

  5. Sie laden Ihre Backups in einen Dateifreigabedienst hoch.

  6. Der Support analysiert Ihre Probleme, ohne Ihre Entwicklungs- oder Produktionsumgebung zu beeinträchtigen.

Es kann mehrere Minuten dauern, bis die Dienstprogramme abgeschlossen sind.

Erstellen eines Code-Backups

Mit diesem Befehl wird Code gesichert und im tar.gz komprimiert.

TIP
Der support:backup Befehl ist nicht derselbe Code-Backup, der vom setup:backup Befehl ausgeführt wird. Der Befehl support:backup dient zum Sichern des Codes, der vom Adobe Commerce-Support geprüft werden soll.

Befehlsoptionen:

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

Dabei gilt:

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

So erstellen Sie beispielsweise eine Code-Sicherung 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 den Code-Backup für den Adobe Commerce-Support bereit.

Erstellen einer Datenbanksicherung

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

TIP
Der support:backup Befehl ist nicht derselbe Code-Backup, der vom setup:backup Befehl ausgeführt wird. Der Befehl support:backup dient zum Sichern des Codes, der vom Adobe Commerce-Support geprüft werden soll.

Befehlsoptionen:

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

Dabei gilt:

  • --name gibt den Namen der Dumpdatei an (optional). Wenn Sie diesen Parameter weglassen, wird die Dump-Datei mit einem Zeit- und 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 die Daten beibehalten werden. Lassen Sie die Markierung weg, um sensible Daten, die in der Datenbank gespeichert sind, beim Erstellen des Backups zu hashen (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: Anzeigen von Dienstprogrammen und Pfaden

Wir stellen Befehle bereit, die Pfade zu Dienstprogrammen anzeigen, die vom Data Collector und der Befehlszeile benötigt werden. Sie können diese Befehle beispielsweise verwenden, wenn Fehler wie die folgenden in der Admin oder in der Befehlszeile angezeigt werden:

Utility lsof not found

Führen Sie die folgenden Befehle in der angegebenen Reihenfolge aus, um die Pfade zu den Anwendungen anzuzeigen, die von den Support-Dienstprogrammen und der Datenerfassung verwendet werden:

  1. Wechseln Sie in das Commerce-Installationsverzeichnis.

    Beispiel: cd /var/www/magento2

    note info
    INFO
    Die Befehle werden ordnungsgemäß Ihrem Installationsverzeichnis 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.

Es folgt 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 Programme installiert sind und sich in der $PATH-Umgebungsvariablen des Webserverbenutzers befinden.

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