|
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 opacabletest 8 "Intel Corporation" "Copyright(C) 2015\-2019" "IFSFFCLIRG (Man Page)"
|
|
Packit |
857059 |
.SH NAME
|
|
Packit |
857059 |
opacabletest
|
|
Packit |
857059 |
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.PP
|
|
Packit |
857059 |
|
|
Packit |
857059 |
\fB(Switch)\fR
|
|
Packit |
857059 |
Initiates or stops Cable Bit Error Rate stress tests for Intel(R) Omni-Path Host Fabric Interface (HFI)-to-switch links and/or ISLs.
|
|
Packit |
857059 |
.SH Syntax
|
|
Packit |
857059 |
opacabletest [-C|-A] [-c \fIfile\fR] [-f \fIhostfile\fR] [-h \fI\[aq]hosts\[aq]\fR] [-n \fInumprocs\fR]
|
|
Packit |
857059 |
.br
|
|
Packit |
857059 |
|
|
Packit |
857059 |
[-t \fIportsfile\fR] [-p \fIports\fR] [start|start\(ulfi|start\(ulisl|stop|stop\(ulfi|
|
|
Packit |
857059 |
.br
|
|
Packit |
857059 |
stop\(ulisl] ...
|
|
Packit |
857059 |
.SH Options
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
--help
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Produces full help text.
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
-C
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Clears error counters.
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
-A
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Forces the system to clear hardware error counters. Implies -C.
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
-c \fIfile\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Specifies the error thresholds configuration file. Default is /etc/opa/opamon.si.conf file. Only used if -C or -A specified.
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
-f \fIhostfile\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Specifies the file with hosts to include in HFI -to-SW test. Default is /etc/opa/hosts file.
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
-h \fIhosts\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Specifies the list of hosts to include in HFI -SW test.
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
-n \fInumprocs\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Specifies the number of processes per host for HFI -SW test.
|
|
Packit |
857059 |
|
|
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 fabrics when clearing counters. Default is /etc/opa/ports file.
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
-p \fIports\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Specifies the list of local HFI ports used to access fabrics for counter clear.
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.IP
|
|
Packit |
857059 |
Default is first active port. The first HFI in the system is 1. The first port on an HFI is 1. Uses the format hfi:port,
|
|
Packit |
857059 |
.br
|
|
Packit |
857059 |
for example:
|
|
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 |
|
|
Packit |
857059 |
.RE
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.RS
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.sp
|
|
Packit |
857059 |
0:y
|
|
Packit |
857059 |
Port \fIy\fR within system.
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.RE
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.RS
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.sp
|
|
Packit |
857059 |
x:0
|
|
Packit |
857059 |
First active port on HFI \fIx\fR.
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.RE
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.RS
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.sp
|
|
Packit |
857059 |
x:y
|
|
Packit |
857059 |
HFI \fIx\fR, port \fIy\fR.
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.RE
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
start
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Starts the HFI -SW and ISL tests.
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
start\(ulfi
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Starts the HFI -SW test.
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
start\(ulisl
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Starts the ISL test.
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
stop
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Stops the HFI -SW and ISL tests.
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
stop\(ulfi
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Stops the HFI -SW test.
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
stop\(ulisl
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Stops the ISL test.
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.PP
|
|
Packit |
857059 |
The HFI -SW cable test requires that the \fBFF\(ulMPI\(ulAPPS\(ulDIR\fR is set, and it contains a pre-built copy of the mpi\(ulapps for an appropriate message passing interface (MPI).
|
|
Packit |
857059 |
.PP
|
|
Packit |
857059 |
The ISL cable test started by this tool assumes that the master Host Subnet Manager (HSM) is running on this host. If using the Embedded Subnet Manager (ESM), or if a different host is the master HSM, the ISL cable test must be controlled by the switch CLI, or by Intel(R) Omni-Path Fabric Suite FastFabric on the master HSM respectively.
|
|
Packit |
857059 |
.SH Examples
|
|
Packit |
857059 |
opacabletest -A start
|
|
Packit |
857059 |
.br
|
|
Packit |
857059 |
|
|
Packit |
857059 |
opacabletest -f good -A start
|
|
Packit |
857059 |
.br
|
|
Packit |
857059 |
|
|
Packit |
857059 |
opacabletest -h \[aq]arwen elrond\[aq] start\(ulfi
|
|
Packit |
857059 |
.br
|
|
Packit |
857059 |
|
|
Packit |
857059 |
HOSTS=\[aq]arwen elrond\[aq] opacabletest stop
|
|
Packit |
857059 |
.br
|
|
Packit |
857059 |
|
|
Packit |
857059 |
opacabletest -A
|
|
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 |
\fBHOSTS\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
List of hosts, used if -h option not supplied.
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
\fBHOSTS\(ulFILE\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
File containing list of hosts, used in absence of -f and -h.
|
|
Packit |
857059 |
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
\fBPORTS\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
List of ports, used in absence of -t and -p.
|
|
Packit |
857059 |
|
|
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 |
|
|
Packit |
857059 |
.TP 10
|
|
Packit |
857059 |
\fBFF\(ulMAX\(ulPARALLEL\fR
|
|
Packit |
857059 |
|
|
Packit |
857059 |
Maximum concurrent operations.
|