1opacaptureall(8) Master map: IFSFFCLIRG (Man Page) opacaptureall(8)
3
7 opacaptureall
8 (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 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 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 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
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
35 --help Produces full help text.
36 -C Performs capture against chassis. Default is hosts.
39 -p Performs capture upload in parallel on all host/chassis. For
42 a host capture, this only affects the upload phase.
43 -f hostfile
46 Specifies the file with hosts in cluster. Default is
47 /etc/opa/hosts file.
48 -F chassisfile
51 Specifies the file containing a list of chassis in the clus‐
52 ter. Default is /etc/opa/chassis file.
53 -h hosts Specifies the list of hosts on which to perform a capture.
56 -H chassis
59 Specifies the list of chassis on which to perform a capture.
60 -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 -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 -S Securely prompts for password for administrator on a chassis.
75 -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 1 (Local) Obtains local information from each host.
85 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 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 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 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 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 file Specifies the name for capture file. The suffix .tgz is
132 appended if it is not specified in the name.
133
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 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 opacaptureall -h 'arwen elrond' 030127capture
148 # Gets the list of hosts from arwen elrond file and creates 030127cap‐
149 ture.tgz file.
150
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 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 opacaptureall -C -H 'chassis1 chassis2' 030127capture
164 # Captures from chassis1 and chassis2, and creates 030127capture.tgz
165 file.
166
168 The following environment variables are also used by this command:
169 HOSTS List of hosts, used if -h option not supplied.
171 CHASSIS List of chassis, used if -C is used and -h option is not sup‐
174 plied.
175 HOSTS_FILE
178 File containing a list of hosts, used in the absence of -f
179 and -h.
180 CHASSIS_FILE
183 File containing a list of chassis, used in the absence of -F
184 and -H.
185 UPLOADS_DIR
188 Directory to upload to, used in the absence of -d.
189 FF_MAX_PARALLEL
192 When -p option is used, maximum concurrent operations are
193 performed.
194 FF_CHASSIS_LOGIN_METHOD
197 How to log into chassis. Can be Telnet or SSH.
198 FF_CHASSIS_ADMIN_PASSWORD
201 Password for administrator on all chassis. Used in absence of
202 -S option.
203
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 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 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.
226Copyright(C) 2015-2018 Intel Corporation opacaptureall(8)