|
Packit Service |
3470d1 |
.\" .\" *********************************************************************
|
|
Packit Service |
3470d1 |
.\" .\" * *
|
|
Packit Service |
3470d1 |
.\" .\" * Copyright 2015-2019, Intel Corporation *
|
|
Packit Service |
3470d1 |
.\" .\" * *
|
|
Packit Service |
3470d1 |
.\" .\" * All Rights Reserved. *
|
|
Packit Service |
3470d1 |
.\" .\" * *
|
|
Packit Service |
3470d1 |
.\" .\" *********************************************************************
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.TH opacaptureall 8 "Intel Corporation" "Copyright(C) 2015\-2019" "IFSFFCLIRG (Man Page)"
|
|
Packit Service |
3470d1 |
.SH NAME
|
|
Packit Service |
3470d1 |
opacaptureall
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.PP
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
\fB(Chassis and Host)\fR
|
|
Packit Service |
3470d1 |
Captures supporting information for a problem report from all hosts or Intel(R) Omni-Path Chassis and uploads to this system.
|
|
Packit Service |
3470d1 |
.PP
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
\fBFor Hosts:\fR
|
|
Packit Service |
3470d1 |
When a host opacaptureall is performed, opacapture is run to create the specified capture file within ~root on each host (with the .tgz suffix added as needed). The files are uploaded and unpacked into a matching directory name within upload\(uldir/\fIhostname\fR/ on the local system. The default file name is hostcapture.
|
|
Packit Service |
3470d1 |
.PP
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
\fBFor Chassis:\fR
|
|
Packit Service |
3470d1 |
When a chassis opacaptureall is performed, opacapture is run on each chassis and its output is saved to upload\(uldir/\fIchassisname\fR/\fIfile\fR on the local system. The default file name is chassiscapture.
|
|
Packit Service |
3470d1 |
.PP
|
|
Packit Service |
3470d1 |
For both host and chassis capture, the uploaded captures are combined into a .tgz file with the file name specified and the suffix .all.tgz added.
|
|
Packit Service |
3470d1 |
.SH Syntax
|
|
Packit Service |
3470d1 |
opacaptureall [-C] [-p] [-f \fIhostfile\fR] [-F \fIchassisfile\fR] [-h \[aq]\fIhosts\fR\[aq]]
|
|
Packit Service |
3470d1 |
.br
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
[-H \[aq]\fIchassis\fR\[aq]] [-t \fIportsfile\fR] [-d \fIupload\(uldir\fR] [-S] [-D \fIdetail\(ullevel\fR]
|
|
Packit Service |
3470d1 |
.br
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
[ \fIfile\fR]
|
|
Packit Service |
3470d1 |
.SH Options
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
--help
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
Produces full help text.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
-C
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
Performs capture against chassis. Default is hosts.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
-p
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
Performs capture upload in parallel on all host/chassis. For a host capture, this only affects the upload phase.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
-f \fIhostfile\fR
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
Specifies the file with hosts in cluster. Default is /etc/opa/hosts file.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
-F \fIchassisfile\fR
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
Specifies the file containing a list of chassis in the cluster. Default is /etc/opa/chassis file.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
-h \fIhosts\fR
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
Specifies the list of hosts on which to perform a capture.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
-H \fIchassis\fR
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
Specifies the list of chassis on which to perform a capture.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
-t \fIportsfile\fR
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
Specifies the file with list of local HFI ports used to access fabric(s) for switch access. Default is /etc/opa/ports file.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
-d \fIupload\(uldir\fR
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
Specifies the directory to upload to. Default is uploads. If not specified, the environment variable \fBUPLOADS\(ulDIR\fR is used. If that is not exported, the default ./uploads is used.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
-S
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
Securely prompts for password for administrator on a chassis.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
-D \fIdetail\(ullevel\fR
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
Specifies the level of detail of the capture passed to host opacapture. (Only used for host captures; ignored for chassis captures.)
|
|
Packit Service |
3470d1 |
.RS
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.sp
|
|
Packit Service |
3470d1 |
1 (Local)
|
|
Packit Service |
3470d1 |
Obtains local information from each host.
|
|
Packit Service |
3470d1 |
.RE
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.RS
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.sp
|
|
Packit Service |
3470d1 |
2 (Fabric)
|
|
Packit Service |
3470d1 |
In addition to \fILocal\fR, also obtains basic fabric information by queries to the SM and fabric error analysis using opareport.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.RE
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.RS
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.sp
|
|
Packit Service |
3470d1 |
3 (Fabric+FDB)
|
|
Packit Service |
3470d1 |
In addition to \fIFabric\fR, also obtains the Forwarding Database (FDB), which includes the switch forwarding tables from the SM.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.RE
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.RS
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.sp
|
|
Packit Service |
3470d1 |
4 (Analysis)
|
|
Packit Service |
3470d1 |
In addition to \fIFabric+FDB\fR, also obtains opaallanalysis results. If opaallanalysis has not yet been run, it is run as part of the capture.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.RE
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
.BR
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.PP
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.B NOTE:
|
|
Packit Service |
3470d1 |
Detail levels 2-4 can be used when fabric operational problems occur. If the problem is node-specific, detail level 1 should be sufficient. Detail levels 2-4 require an operational Intel(R) Omni-Path Fabric Suite Fabric Manager. Typically your support representative requests a given detail level. If a given detail level takes excessively long or fails to be gathered, try a lower detail level.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.PP
|
|
Packit Service |
3470d1 |
For detail levels 2-4, the additional information is only gathered on the node running the opacaptureall command. The information is gathered for every fabric specified in the /etc/opa/ports file.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
\fIfile\fR
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
Specifies the name for capture file. The suffix .tgz is appended if it is not specified in the name.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.SH Examples
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.SH Host Capture Examples
|
|
Packit Service |
3470d1 |
opacaptureall
|
|
Packit Service |
3470d1 |
.br
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
# Creates a hostcapture directory in upload\(uldir/hostname/ for each host
|
|
Packit Service |
3470d1 |
.br
|
|
Packit Service |
3470d1 |
in
|
|
Packit Service |
3470d1 |
/etc/opa/hosts file, then creates hostcapture.all.tgz.
|
|
Packit Service |
3470d1 |
.br
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.br
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
opacaptureall mycapture
|
|
Packit Service |
3470d1 |
.br
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
# Creates a mycapture directory in upload\(uldir/hostname/ for each host
|
|
Packit Service |
3470d1 |
.br
|
|
Packit Service |
3470d1 |
in
|
|
Packit Service |
3470d1 |
/etc/opa/hosts file, then creates mycapture.all.tgz.
|
|
Packit Service |
3470d1 |
.br
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.br
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
opacaptureall -h \[aq]arwen elrond\[aq] 030127capture
|
|
Packit Service |
3470d1 |
.br
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
# Gets the list of hosts from arwen elrond file and creates
|
|
Packit Service |
3470d1 |
.br
|
|
Packit Service |
3470d1 |
030127capture.tgz file.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.SH Chassis Capture Examples
|
|
Packit Service |
3470d1 |
opacaptureall -C
|
|
Packit Service |
3470d1 |
.br
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
# Creates a chassiscapture file in upload\(uldir/chassisname/ for each
|
|
Packit Service |
3470d1 |
.br
|
|
Packit Service |
3470d1 |
chassis
|
|
Packit Service |
3470d1 |
in /etc/opa/chassis file, then creates chassiscapture.all.tgz.
|
|
Packit Service |
3470d1 |
.br
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.br
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
opacaptureall -C mycapture
|
|
Packit Service |
3470d1 |
.br
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
# Creates a mycapture.tgz file in upload\(uldir/chassisname/ for each
|
|
Packit Service |
3470d1 |
.br
|
|
Packit Service |
3470d1 |
chassis
|
|
Packit Service |
3470d1 |
in /etc/opa/chassis file, then creates mycapture.all.tgz.
|
|
Packit Service |
3470d1 |
.br
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.br
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
opacaptureall -C -H \[aq]chassis1 chassis2\[aq] 030127capture
|
|
Packit Service |
3470d1 |
.br
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
# Captures from chassis1 and chassis2, and creates 030127capture.tgz file.
|
|
Packit Service |
3470d1 |
.SH Environment Variables
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.PP
|
|
Packit Service |
3470d1 |
The following environment variables are also used by this command:
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
\fBHOSTS\fR
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
List of hosts, used if -h option not supplied.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
\fBCHASSIS\fR
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
List of chassis, used if -C is used and -h option is not supplied.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
\fBHOSTS\(ulFILE\fR
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
File containing a list of hosts, used in the absence of -f and -h.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
\fBCHASSIS\(ulFILE\fR
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
File containing a list of chassis, used in the absence of -F and -H.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
\fBUPLOADS\(ulDIR\fR
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
Directory to upload to, used in the absence of -d.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
\fBFF\(ulMAX\(ulPARALLEL\fR
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
When -p option is used, maximum concurrent operations are performed.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
\fBFF\(ulCHASSIS\(ulLOGIN\(ulMETHOD\fR
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
How to log into chassis. Can be Telnet or SSH.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.TP 10
|
|
Packit Service |
3470d1 |
\fBFF\(ulCHASSIS\(ulADMIN\(ulPASSWORD\fR
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
Password for administrator on all chassis. Used in absence of -S option.
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.SH More Information
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.PP
|
|
Packit Service |
3470d1 |
When performing opacaptureall against hosts, internally SSH is used. The command opacaptureall requires that password-less SSH be set up between the host running Intel(R) Omni-Path Fabric Suite FastFabric Toolset and the hosts opacaptureall is operating against. The opasetupssh command can aid in setting up password-less SSH.
|
|
Packit Service |
3470d1 |
.PP
|
|
Packit Service |
3470d1 |
When performing operations against chassis, Intel recommends that you set up SSH keys using opasetupssh. If SSH keys are not set up, Intel recommends that all chassis be configured with the same admin password and that you use of the -S option to avoid keeping the password in configuration files.
|
|
Packit Service |
3470d1 |
.PP
|
|
Packit Service |
3470d1 |
|
|
Packit Service |
3470d1 |
.B NOTE:
|
|
Packit Service |
3470d1 |
The resulting host capture files can require significant amounts of space on the Intel(R) Omni-Path Fabric Suite FastFabric Toolset host. Actual size varies, but sizes can be multiple megabytes per host. Intel recommends that you ensure adequate space is available on the Intel(R) Omni-Path Fabric Suite FastFabric Toolset system. In many cases, it may not be necessary to run opacaptureall against all hosts or chassis; instead, a representative subset may be sufficient. Consult with your support representative for further information.
|