Sammeln von unterstützen Informationen zu Intel® Ethernet Fabric Suite Problemen
Wie verwende ich den ethcapture -Befehl?
Der ethcapture -Befehl erfasst kritische Systeminformationen in einer zip-Datei. Die daraus resultierende Datei sollte zusammen mit Intel® Ethernet Fabric-Problembericht zu diesem System an den Kundensupport gesendet werden.
| Hinweis | Die daraus resultierende Host-Capture-Datei kann erhebliche Mengen an Speicherplatz auf dem Host erfordern. Die tatsächliche Größe variiert, aber die Größen können mehrere Megabyte sein. Intel empfiehlt, sicherzustellen, dass auf dem Hostsystem ausreichender Speicherplatz verfügbar ist. |
ethcapture [-d detail] output_tgz_file
Optionen:
--help: Liefert den vollständigen Hilfetext.
-d detail: Erfasst die Detailgenauigkeit:
1 (Local): Bezieht sich auf lokale Informationen vom Host. Dies ist die Standardeinstellung, wenn keine Optionen eingegeben werden.
2 (Fabric): Bezieht sich neben Local auch grundlegende Fabric-Informationen durch Abfragen zur SM- und Fabric-Fehleranalyse unter Verwendung von ethreport.
3 (Analyse): Liefert neben Fabric auch Ethallanalyse-Ergebnisse. Wenn ethallanalysis noch nicht ausgeführt wurde, wird er als Teil der Erfassung ausgeführt.
| Hinweis | Die Detailstufen 2 bis 3 können verwendet werden, wenn Fabric-Betriebsprobleme auftreten. Falls das Problem knotenspezifisch ist, sollte Detailstufe 1 ausreichend sein. Die Detailstufen 2 bis 3 erfordern eine betriebsfähige Fabric. In der Regel fordert Ihr Support-Vertreter eine bestimmte Detailstufe an. Wenn eine bestimmte Detailebene zu lange dauert oder nicht gesammelt wird, versuchen Sie es mit einer niedrigeren Detailebene. Für die Detailstufen 2 bis 3 sind die zusätzlichen Informationen nur auf einem Knoten verfügbar, auf dem Intel® Ethernet Fabric Suite FastFab ascii-Toolset installiert ist. |
output_tgz_file: Gibt den Namen einer Datei an, die von ethcapture erstellt werden soll. Der angegebene Dateiname wird überschrieben, wenn er bereits vorhanden ist. Intel empfiehlt, im angegebenen Dateinamen den .tgz Suffix zu verwenden. Wenn der angegebene Dateiname kein .tgz Suffix hat, wird das .tgz Suffix hinzugefügt.
Beispiele:
ethcapture mycapture.tgz
ethcapture -d 3 030127capture.tgz
Wie verwende ich den ethpacaptureall -Befehl?
Der ethcaptureall -Befehl erfasst unterstützende Informationen für einen Problembericht von allen Hosts und lädt in dieses System hoch.
Wenn ein Host- ethcaptureall durchgeführt wird, wird ethcapture ausgeführt, um die angegebene Capture-Datei innerhalb ~root auf jedem Host zu erstellen (wobei das .tgz Suffix bei Bedarf hinzugefügt wird). Die Dateien werden innerhalb upload_dir/hostname/ auf dem lokalen System hochgeladen und in einen passenden Verzeichnisnamen entpackt. Der Standarddateiname ist hostcapture.
Die hochgeladenen Captures werden in einer .tgz Datei mit dem angegebenen Dateinamen und dem Suffix .all.tgzkombiniert, hinzugefügt.
Optionen:
--help: Liefert den vollständigen Hilfetext.
-p: Führt den Capture-Upload parallel auf allen Hosts durch.
-f hostfile: Gibt die Datei mit Hosts im Cluster an. Der Standard ist /etc/ethtools/hosts Datei.
-h hosts: Gibt die Liste der Hosts an, auf denen eine Erfassung durchgeführt werden soll.
-d upload_dir: Gibt das Verzeichnis an, in das hochgeladen werden soll. Die Standardeinstellung ist uploads. Falls nicht angegeben, wird die Umgebungsvariable UPLOADS_DIR verwendet.
-D detail_level: Gibt die Detailebene der Erfassung an, die an den Host-ethcapture weitergegeben wird.
1 (Local): Bezieht sich auf lokale Informationen von jedem Host.
2 (Fabric): Bietet neben Local auch grundlegende Fabric-Informationen durch Abfragen zur Fabric- und Fabric-Fehleranalyse unter Verwendung von ethreport.
3 (Analyse): Liefert neben Fabric auch ethallanalysis Ergebnisse. Wenn ethallanalysis noch nicht ausgeführt wurde, wird er als Teil der Erfassung ausgeführt.
| Hinweis | Für die Detailstufen 2-3 werden die zusätzlichen Informationen nur auf dem Knoten gesammelt, auf dem der befehl ethcaptureall ausgeführt wird. |
file: Gibt den Namen für die Capture-Datei an. Das Suffix .tgz wird angehängt, wenn es nicht im Namen angegeben ist.
Beispiele:
ethcaptureall
# Creates a hostcapture directory in upload_dir/hostname/ for each host in
/etc/eth-tools/hosts file, then creates hostcapture.all.tgz.
ethcaptureall mycapture
# Creates a mycapture directory in upload_dir/hostname/ for each host in
/etc/eth-tools/hosts file, then creates mycapture.all.tgz.
ethcaptureall -h 'arwen elrond' 030127capture
# Gets the list of hosts from arwen elrond file and creates
030127capture.tgz file.
Umgebungsvariablen
Die folgenden Umgebungsvariablen werden auch von diesem Befehl verwendet:
- HOSTS: Liste der Hosts, verwendet, wenn -h Option nicht geliefert wird.
- HOSTS_FILE: Datei mit einer Liste der Hosts, die ohne -f und -h verwendet wird.
- UPLOADS_DIR: Verzeichnis zum Hochladen, wird ohne -d verwendet.
- FF_MAX_PARALLEL: Wenn die option -p verwendet wird, werden maximal gleichzeitige Vorgänge durchgeführt.
Weitere Informationen
Bei der Durchführung ethcaptureall gegen Hosts wird intern SSH verwendet. Der Befehl ethcaptureall erfordert, dass ssh ohne Passwort zwischen dem Host, der Intel® Ethernet Fabric Suite FastFabfile Toolset ausführt, und dem Hosts eingerichtet werden, auf dem ethcaptureall funktioniert. Der ethsetupssh -Befehl kann die Einrichtung von passwortfreiem SSH unterstützen.
| Hinweis | Die daraus resultierenden Host-Capture-Dateien können erhebliche Mengen an Speicherplatz auf dem Intel® Ethernet Fabric Suite FastFabrand Toolset Host erfordern. Die tatsächliche Größe variiert, aber die Größen können mehrere Megabyte pro Host sein. Intel empfiehlt, dass Sie sicherstellen, dass auf dem Intel® Ethernet Fabric Suite FastFab aktuelle Toolset-System ausreichend Platz zur Verfügung steht. In vielen Fällen ist es möglicherweise nicht erforderlich, ethcaptureall gegen alle Hosts auszuführen; stattdessen kann ein repräsentativer Teilsatz ausreichend sein. Wenden Sie sich an Ihren Support-Vertreter, um weitere Informationen zu erhalten. |