|
Packit |
857059 |
.\" .\" *********************************************************************
|
|
Packit |
857059 |
.\" .\" * *
|
|
Packit |
857059 |
.\" .\" * Copyright 2015-2019, Intel Corporation *
|
|
Packit |
857059 |
.\" .\" * *
|
|
Packit |
857059 |
.\" .\" * All Rights Reserved. *
|
|
Packit |
857059 |
.\" .\" * *
|
|
Packit |
857059 |
.\" .\" *********************************************************************
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.TH opaallanalysis 8 "Intel Corporation" "Copyright(C) 2015\-2019" "IFSFFCLIRG (Man Page)"
|
|
Packit |
857059 |
.SH NAME
|
|
Packit |
857059 |
opaallanalysis
|
|
Packit |
857059 |
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.PP
|
|
Packit |
857059 |
|
|
Packit |
857059 |
\fB(All)\fR
|
|
Packit |
857059 |
opaallanalysis command performs the set of analysis specified in FF\(ulALL\(ulANALYSIS and can be specified for fabric, chassis, esm, or hostsm.
|
|
Packit |
857059 |
.SH Syntax
|
|
Packit |
857059 |
opaallanalysis [-b|-e] [-s] [-d \fIdir\fR] [-c \fIfile\fR] [-t \fIportsfile\fR]
|
|
Packit |
857059 |
.br
|
|
Packit |
857059 |
[-p \fIports\fR]
|
|
Packit |
857059 |
[-F \fIchassisfile\fR] [-H \[aq]\fIchassis\fR\[aq]] [-G \fIesmchassisfile\fR]
|
|
Packit |
857059 |
.br
|
|
Packit |
857059 |
[-E \fIesmchassis\fR]
|
|
Packit |
857059 |
[-T \fItopology\(ulinput\fR]
|
|
Packit |
857059 |
.SH Options
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
--help
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Produces full help text.
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
-b
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Sets the baseline mode. Default is compare/check mode.
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
-e
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Evaluates health only. Default is compare/check mode.
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
-s
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Saves history of failures (errors/differences).
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
-d \fIdir\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Identifies the top-level directory for saving baseline and history of failed checks. Default is /var/usr/lib/opa/analysis
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
-c \fIfile\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Specifies the error thresholds configuration file. Default is /etc/opa/opamon.conf
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
-t \fIportsfile\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Specifies the file with list of local HFI ports used to access fabric(s) for analysis. Default is /etc/opa/ports
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
-p \fIports\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Specifies the list of local HFI ports used to access fabric(s) for analysis. Default is the first active port. Specified as HFI:port as follows:
|
|
Packit |
857059 |
.RS
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.sp
|
|
Packit |
857059 |
0:0
|
|
Packit |
857059 |
First active port in system.
|
|
Packit |
857059 |
.RE
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.RS
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.sp
|
|
Packit |
857059 |
0:\fIy\fR
|
|
Packit |
857059 |
Port \fIy\fR within system.
|
|
Packit |
857059 |
.RE
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.RS
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.sp
|
|
Packit |
857059 |
\fIx\fR:0
|
|
Packit |
857059 |
First active port on HFI \fIx\fR.
|
|
Packit |
857059 |
.RE
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.RS
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.sp
|
|
Packit |
857059 |
\fIx\fR:\fIy\fR
|
|
Packit |
857059 |
HFI \fIx\fR, port \fIy\fR.
|
|
Packit |
857059 |
.RE
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
-F \fIchassisfile\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Specifies the file with a chassis in a cluster. Default is /etc/opa/chassis
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
-H \[aq]\fIchassis\fR\[aq]
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Specifies the list of chassis on which to execute the command.
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
-G \fIesmchassisfile\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Specifies the file with embedded SM chassis in the cluster. Default is /etc/opa/esm\(ulchassis
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
-E \fIesmchassis\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Specifies the list of embedded SM chassis to analyze.
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
-T \fItopology\(ulinput\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Specifies the name of topology input file to use. Any %P markers in this filename are replaced with the HFI:port being operated on, such as 0:0 or 1:2. Default is /etc/opa/topology.%P.xml. If -T NONE is specified, no topology input file is used. See
|
|
Packit |
857059 |
\fIopareport\fR
|
|
Packit |
857059 |
for more information.
|
|
Packit |
857059 |
.SH Example
|
|
Packit |
857059 |
opaallanalysis
|
|
Packit |
857059 |
.br
|
|
Packit |
857059 |
|
|
Packit |
857059 |
opaallanalysis -p \[aq]1:1 2:1\[aq]
|
|
Packit |
857059 |
.SH Environment Variables
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.PP
|
|
Packit |
857059 |
The following environment variables are also used by this command:
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
\fBPORTS\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
List of ports, used in absence of -t and -p.
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
\fBPORTS\(ulFILE\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
File containing list of ports, used in absence of -t and -p.
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
\fBFF\(ulTOPOLOGY\(ulFILE\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
File containing topology\(ulinput (may have %P marker in filename), used in absence of -T.
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
\fBCHASSIS\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
List of chassis, used if -F and -H options are not supplied.
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
\fBCHASSIS\(ulFILE\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
File containing list of chassis, used if -F and -H options are not supplied.
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
\fBESM\(ulCHASSIS\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
List of SM chassis, used if -G and -E options are not supplied.
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
\fBESM\(ulCHASSIS\(ulFILE\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
File containing list of SM chassis, used if -G and -E options are not supplied.
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
\fBFF\(ulANALYSIS\(ulDIR\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Top level directory for baselines and failed health checks.
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
\fBFF\(ulCHASSIS\(ulCMDS\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
List of commands to issue during analysis, unused if -e option supplied.
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
\fBFF\(ulCHASSIS\(ulHEALTH\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Single command to issue to check overall health during analysis, unused if -b option supplied
|
|
Packit |
857059 |
.SH Details
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.PP
|
|
Packit |
857059 |
The opaallanalysis command performs the set of analysis specified in \fBFF\(ulALL\(ulANALYSIS\fR, which must be a space-separated list. This can be provided by the environment or using /etc/opa/opafastfabric.conf. The analysis set includes the options: fabric, chassis, esm, or hostsm. For a fabric with only externally managed switches, \fBFF\(ulALL\(ulANALYSIS\fR should be set to -fabric in opafastfabric.conf.
|
|
Packit |
857059 |
.PP
|
|
Packit |
857059 |
Note that the opaallanalysis command has options which are a super-set of the options for all other analysis commands. The options are passed along to the respective tools as needed. For example, the -c file option is passed on to opafabricanalysis if it is specified in \fBFF\(ulALL\(ulANALYSIS\fR.
|
|
Packit |
857059 |
.PP
|
|
Packit |
857059 |
The output files are all the output files for the \fBFF\(ulALL\(ulANALYSIS\fR selected set of analysis. See the previous sections for the specific output files.
|