1
2opacapture(1)          Master map: IFSFFCLIRG (Man Page)         opacapture(1)
3
4
5

NAME

7       opacapture
8
9
10
11       (Host) Captures critical system information into a zipped tar file. The
12       resulting tar file should be sent to Customer Support  along  with  any
13       Intel(R) Omni-Path 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
21

Syntax

23       opacapture [-d detail] output_tgz_file
24

Options

26       --help    Produces full help text.
27
28
29       -d detail Captures level of detail:
30
31
32
33                 1 (Local) Obtains local information from host. Default if  no
34                           options are entered.
35
36
37
38
39
40                 2 (Fabric)
41                           In  addition  to  Local,  also obtains basic fabric
42                           information by queries to the SM and  fabric  error
43                           analysis using opareport.
44
45
46
47
48
49                 3 (Fabric+FDB)
50                           In  addition to Fabric, also obtains the Forwarding
51                           Database (FDB), which includes the switch  forward‐
52                           ing  tables  from  the  SM and the server multicast
53                           membership.
54
55
56
57
58
59                 4 (Analysis)
60                           In addition to Fabric+FDB, also obtains opaallanal‐
61                           ysis  results.  If  opaallanalysis has not yet been
62                           run, it is run as part of the capture.
63
64
65
66
67
68
69
70       NOTE: Detail levels 2 - 4 can be used when fabric operational  problems
71       occur. If the problem is node-specific, detail level 1 should be suffi‐
72       cient. Detail levels 2 - 4 require an operational Fabric Manager. Typi‐
73       cally  your  support representative requests a given detail level. If a
74       given detail level takes excessively long or fails to be gathered,  try
75       a lower detail level.
76
77
78       For  detail  levels 2 - 4, the additional information is only available
79       on a node with  Intel(R)  Omni-Path  Fabric  Suite  FastFabric  Toolset
80       installed.  The  information  is gathered for every fabric specified in
81       the /etc/opa/ports file.
82
83
84       output_tgz_file
85                 Specifies the name of a file to be created by opacapture. The
86                 file  name  specified  is  overwritten  if it already exists.
87                 Intel recommends using the .tgz suffix in the file name  sup‐
88                 plied. If the filename given does not have a .tgz suffix, the
89                 .tgz suffix is added.
90
91

Examples

93       opacapture mycapture.tgz
94       opacapture -d 3 030127capture.tgz
95
96
97
98Copyright(C) 2015-2018         Intel Corporation                 opacapture(1)
Impressum