1
2ethcapture(1)                EFSFFCLIRG (Man Page)               ethcapture(1)
3
4
5

NAME

7       ethcapture
8
9
10
11       Captures  critical  system  information into a zipped tar file. The re‐
12       sulting tar file should be sent to Customer Support along with any  In‐
13       tel(R) Ethernet Fabric problem report regarding this system.
14
15       NOTE:  The  resulting host capture file can require significant amounts
16       of space on the host. The actual size varies, but sizes can be multiple
17       megabytes. Intel recommends ensuring that adequate disk space is avail‐
18       able on the host system.
19
20

Syntax

22       ethcapture [-d  detail]  output_tgz_file
23

Options

25       --help
26
27                 Produces full help text.
28
29
30       -d detail
31
32                 Captures level of detail:
33
34
35
36                 1 (Local) Obtains local information from host.  This  is  the
37                           default if no options are entered.
38
39
40
41
42
43                 2 (Fabric)
44                           In addition to Local, also obtains basic fabric in‐
45                           formation by queries to the  SM  and  fabric  error
46                           analysis using ethreport.
47
48
49
50
51
52                 3 (Analysis)
53                           In  addition to Fabric, also obtains ethallanalysis
54                           results. If ethallanalysis has not yet been run, it
55                           is run as part of the capture.
56
57
58
59
60
61
62
63       NOTE:  Detail levels 2 - 3 can be used when fabric operational problems
64       occur. If the problem is node-specific, detail level 1 should be suffi‐
65       cient.  Detail  levels  2  - 3 require an operational Fabric. Typically
66       your support representative requests a given detail level. If  a  given
67       detail  level  takes  excessively  long  or fails to be gathered, try a
68       lower detail level.
69
70
71       For detail levels 2 - 3, the additional information is  only  available
72       on  a  node  with Intel(R) Ethernet Fabric Suite FastFabric Toolset in‐
73       stalled.
74
75
76       output_tgz_file
77
78                 Specifies the name of a file to be created by ethcapture. The
79                 file  name specified is overwritten if it already exists. In‐
80                 tel recommends using the .tgz suffix in the  file  name  sup‐
81                 plied. If the filename given does not have a .tgz suffix, the
82                 .tgz suffix is added.
83
84

Examples

86       ethcapture mycapture.tgz
87
88       ethcapture -d 3 030127capture.tgz
89
90
91
92Copyright(C) 2020-2022         Intel Corporation                 ethcapture(1)
Impressum