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

NAME

7       opacaptureall
8
9
10
11       (Chassis and Host) Captures supporting information for a problem report
12       from all hosts or Intel(R) Omni-Path Chassis and uploads to  this  sys‐
13       tem.
14
15       For Hosts: When a host opacaptureall is performed, opacapture is run to
16       create the specified capture file within ~root on each host  (with  the
17       .tgz  suffix added as needed). The files are uploaded and unpacked into
18       a matching directory name within upload_dir/hostname/ on the local sys‐
19       tem. The default file name is hostcapture.
20
21       For  Chassis:  When a chassis opacaptureall is performed, opacapture is
22       run on each chassis and its  output  is  saved  to  upload_dir/chassis‐
23       name/file on the local system. The default file name is chassiscapture.
24
25       For  both  host and chassis capture, the uploaded captures are combined
26       into a .tgz file with the file name specified and the  suffix  .all.tgz
27       added.
28

Syntax

30       opacaptureall [-C] [-p] [-f hostfile] [-F chassisfile] [-h 'hosts']
31       [-H 'chassis'] [-t portsfile] [-d upload_dir] [-S] [-D detail_level]
32       [ file]
33

Options

35       --help    Produces full help text.
36
37
38       -C        Performs capture against chassis. Default is hosts.
39
40
41       -p        Performs  capture upload in parallel on all host/chassis. For
42                 a host capture, this only affects the upload phase.
43
44
45       -f hostfile
46                 Specifies  the  file  with  hosts  in  cluster.  Default   is
47                 /etc/opa/hosts file.
48
49
50       -F chassisfile
51                 Specifies  the file containing a list of chassis in the clus‐
52                 ter. Default is /etc/opa/chassis file.
53
54
55       -h hosts  Specifies the list of hosts on which to perform a capture.
56
57
58       -H chassis
59                 Specifies the list of chassis on which to perform a capture.
60
61
62       -t portsfile
63                 Specifies the file with list  of  local  HFI  ports  used  to
64                 access fabric(s) for switch access, default is /etc/opa/ports
65                 file.
66
67
68       -d upload_dir
69                 Specifies the directory to upload to; default is uploads.  If
70                 not  specified, the environment variable UPLOADS_DIR is used.
71                 If that is not exported, the default (./uploads) is used.
72
73
74       -S        Securely prompts for password for administrator on a chassis.
75
76
77       -D detail_level
78                 Specifies the level of detail of the capture passed  to  host
79                 opacapture. (Only used for host captures; ignored for chassis
80                 captures.)
81
82
83
84                 1 (Local) Obtains local information from each host.
85
86
87
88
89                 2 (Fabric)
90                           In addition to Local,  also  obtains  basic  fabric
91                           information  by  queries to the SM and fabric error
92                           analysis using opareport.
93
94
95
96
97
98                 3 (Fabric+FDB)
99                           In addition to Fabric, also obtains the  Forwarding
100                           Database  (FDB), which includes the switch forward‐
101                           ing tables from the SM.
102
103
104
105
106
107                 4 (Analysis)
108                           In addition to Fabric+FDB, also obtains opaallanal‐
109                           ysis  results.  If  opaallanalysis has not yet been
110                           run, it is run as part of the capture.
111
112
113
114
115
116
117
118       NOTE: Detail levels 2-4 can be used when  fabric  operational  problems
119       occur. If the problem is node-specific, detail level 1 should be suffi‐
120       cient. Detail levels 2-4 require an operational Intel(R) Omni-Path Fab‐
121       ric   Suite  Fabric  Manager.  Typically  your  support  representative
122       requests a given detail level. If a given  detail  level  takes  exces‐
123       sively long or fails to be gathered, try a lower detail level.
124
125
126       For  detail  levels 2-4, the additional information is only gathered on
127       the node running the opacaptureall command. The information is gathered
128       for every fabric specified in the /etc/opa/ports file.
129
130
131       file      Specifies  the  name  for  capture  file.  The suffix .tgz is
132                 appended if it is not specified in the name.
133
134

Examples

Host Capture Examples

137       opacaptureall
138       # Creates a hostcapture directory in upload_dir/hostname/ for each host
139       in
140       /etc/opa/hosts file, then creates hostcapture.all.tgz.
141
142       opacaptureall mycapture
143       #  Creates  a mycapture directory in upload_dir/hostname/ for each host
144       in
145       /etc/opa/hosts file, then creates mycapture.all.tgz.
146
147       opacaptureall -h 'arwen elrond' 030127capture
148       # Gets the list of hosts from arwen elrond file and creates  030127cap‐
149       ture.tgz file.
150
151

Chassis Capture Examples

153       opacaptureall -C
154       #  Creates  a  chassiscapture  file in upload_dir/chassisname/ for each
155       chassis
156       in /etc/opa/chassis file, then creates chassiscapture.all.tgz.
157
158       opacaptureall -C mycapture
159       # Creates a mycapture.tgz  file  in  upload_dir/chassisname/  for  each
160       chassis
161       in /etc/opa/chassis file, then creates mycapture.all.tgz.
162
163       opacaptureall -C -H 'chassis1 chassis2' 030127capture
164       #  Captures  from  chassis1 and chassis2, and creates 030127capture.tgz
165       file.
166

Environment Variables

168       The following environment variables are also used by this command:
169
170       HOSTS     List of hosts, used if -h option not supplied.
171
172
173       CHASSIS   List of chassis, used if -C is used and -h option is not sup‐
174                 plied.
175
176
177       HOSTS_FILE
178                 File  containing  a  list of hosts, used in the absence of -f
179                 and -h.
180
181
182       CHASSIS_FILE
183                 File containing a list of chassis, used in the absence of  -F
184                 and -H.
185
186
187       UPLOADS_DIR
188                 Directory to upload to, used in the absence of -d.
189
190
191       FF_MAX_PARALLEL
192                 When  -p  option  is  used, maximum concurrent operations are
193                 performed.
194
195
196       FF_CHASSIS_LOGIN_METHOD
197                 How to log into chassis. Can be Telnet or SSH.
198
199
200       FF_CHASSIS_ADMIN_PASSWORD
201                 Password for administrator on all chassis. Used in absence of
202                 -S option.
203
204

More Information

206       When  performing  opacaptureall  against hosts, internally SSH is used.
207       The command opacaptureall requires that password-less  SSH  be  set  up
208       between  the  host  running  Intel(R) Omni-Path Fabric Suite FastFabric
209       Toolset and the hosts opacaptureall is operating  against.  The  opase‐
210       tupssh command can aid in setting up password-less SSH.
211
212       When  performing  operations against chassis, Intel recommends that you
213       set up SSH keys using opasetupssh. If SSH keys are not  set  up,  Intel
214       recommends  that all chassis be configured with the same admin password
215       and that you use of the -S option to avoid keeping the password in con‐
216       figuration files.
217
218       NOTE:  The resulting host capture files can require significant amounts
219       of space on the Intel(R)  Omni-Path  Fabric  Suite  FastFabric  Toolset
220       host. Actual size varies, but sizes can be multiple megabytes per host.
221       Intel recommends that you ensure adequate space  is  available  on  the
222       Intel(R)  Omni-Path  Fabric  Suite  FastFabric  Toolset system. In many
223       cases, it may not be necessary to run opacaptureall against  all  hosts
224       or chassis; instead, a representative subset may be sufficient. Consult
225       with your support representative for further information.
226
227
228
229Copyright(C) 2015-2018         Intel Corporation              opacaptureall(8)
Impressum