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

NAME

7       opacabletest
8
9
10
11       (Switch)  Initiates  or  stops  Cable  Bit  Error Rate stress tests for
12       Intel(R) Omni-Path Host Fabric Interface (HFI)-to-switch  links  and/or
13       ISLs.
14

Syntax

16       opacabletest [-C|-A] [-c file] [-f hostfile] [-h 'hosts'] [-n numprocs]
17       [-t portsfile] [-p ports] [start|start_fi|start_isl|stop|stop_fi|
18       stop_isl] ...
19

Options

21       --help    Produces full help text.
22
23
24       -C        Clears error counters.
25
26
27       -A        Forces  the  system to clear hardware error counters. Implies
28                 -C.
29
30
31       -c file   Specifies the error thresholds configuration file. Default is
32                 /etc/opa/opamon.si.conf  file.  Only  used if -C or -A speciā€
33                 fied.
34
35
36       -f hostfile
37                 Specifies the file with hosts to include in HFI -to-SW  test.
38                 Default is /etc/opa/hosts file.
39
40
41       -h hosts  Specifies the list of hosts to include in HFI -SW test.
42
43
44       -n numprocs
45                 Specifies the number of processes per host for HFI -SW test.
46
47
48       -t portsfile
49                 Specifies  the  file  with  list  of  local HFI ports used to
50                 access   fabrics   when   clearing   counters.   Default   is
51                 /etc/opa/ports file.
52
53
54       -p ports  Specifies  the list of local HFI ports used to access fabrics
55                 for counter clear.
56
57
58                 Default is first active port. The first HFI in the system  is
59                 1. The first port on an HFI is 1. Uses the format hfi:port,
60                 for example:
61
62
63
64                 0:0       First active port in system.
65
66
67
68
69
70                 0:y       Port y within system.
71
72
73
74
75
76                 x:0       First active port on HFI x.
77
78
79
80
81
82                 x:y       HFI x, port y.
83
84
85
86       start     Starts the HFI -SW and ISL tests.
87
88
89       start_fi  Starts the HFI -SW test.
90
91
92       start_isl Starts the ISL test.
93
94
95       stop      Stops the HFI -SW and ISL tests.
96
97
98       stop_fi   Stops the HFI -SW test.
99
100
101       stop_isl  Stops the ISL test.
102
103
104       The HFI -SW cable test requires that the FF_MPI_APPS_DIR is set, and it
105       contains a pre-built copy of the mpi_apps for  an  appropriate  message
106       passing interface (MPI).
107
108       The  ISL  cable  test started by this tool assumes that the master Host
109       Subnet Manager (HSM) is running on this host.  If  using  the  Embedded
110       Subnet Manager (ESM), or if a different host is the master HSM, the ISL
111       cable test must be controlled by the switch CLI, or by  Intel(R)  Omni-
112       Path Fabric Suite FastFabric on the master HSM respectively.
113

Examples

115       opacabletest -A start
116       opacabletest -f good -A start
117       opacabletest -h 'arwen elrond' start_fi
118       HOSTS='arwen elrond' opacabletest stop
119       opacabletest -A
120

Environment Variables

122       The following environment variables are also used by this command:
123
124       HOSTS     List of hosts, used if -h option not supplied.
125
126
127       HOSTS_FILE
128                 File containing list of hosts, used in absence of -f and -h.
129
130
131       PORTS     List of ports, used in absence of -t and -p.
132
133
134       PORTS_FILE
135                 File containing list of ports, used in absence of -t and -p.
136
137
138       FF_MAX_PARALLEL
139                 Maximum concurrent operations.
140
141
142
143Copyright(C) 2015-2018         Intel Corporation               opacabletest(8)
Impressum