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

NAME

7       opafabricinfo
8
9
10
11       Provides  a  brief  summary  of the components in the fabric, using the
12       first active port on the given local  host  to  perform  its  analysis.
13       opafabricinfo is supplied in both:
14
15       ·      Intel(R) Omni-Path Fabric Suite FastFabric Toolset In this situ‐
16              ation, the command can manage more than one fabric (subnet).
17
18
19       ·      FastFabric Tools In this situation, the command performs  analy‐
20              sis  against  the first active port on the system only. It takes
21              no options and uses no environment variables.
22
23
24       opafabricinfo can be very useful as a quick assessment  of  the  fabric
25       state. It can be run against a known good fabric to identify its compo‐
26       nents and then later run to see if anything has changed about the  fab‐
27       ric configuration or state.
28
29       For  more  extensive  fabric  analysis,  use opareport, opareports, and
30       opatop. These tools can be found in the Intel(R) Omni-Path Fabric Suite
31       FastFabric User Guide
32
33

Syntax

35       opafabricinfo [-t portsfile] [-p ports]
36

Options

38       --help    Produces full help text.
39
40       -t portsfile
41                 Specifies  the  file  with  list  of  local HFI ports used to
42                 access fabric(s)  for  analysis.  Default  is  /etc/opa/ports
43                 file.
44
45       -p ports  Specifies  the list of local HFI ports used to access fabrics
46                 for analysis.
47
48
49                 Default is first active port. The first HFI in the system  is
50                 1. The first port on an HFI is 1. Uses the format hfi:port,
51                 for example:
52
53
54
55                 0:0       First active port in system.
56
57
58
59
60
61                 0:y       Port y within system.
62
63
64
65
66
67                 x:0       First active port on HFI x.
68
69
70
71
72
73                 x:y       HFI x, port y.
74
75
76

Environment Variables

78       The following environment variables are also used by this command:
79
80       PORTS     List of ports, used in absence of -t and -p.
81
82       PORTS_FILE
83                 File containing list of ports, used in absence of -t and -p.
84
85
86                 For simple fabrics, the Intel(R) Omni-Path Fabric Suite Fast‐
87                 Fabric Toolset host is  connected  to  a  single  fabric.  By
88                 default, the first active port on the FastFabric Toolset host
89                 is used to analyze the fabric. However, in more complex  fab‐
90                 rics,  the  FastFabric  Toolset host may be connected to more
91                 than one fabric or subnet. In this case, you can specify  the
92                 ports or HFIs to use with one of the following methods:
93
94
95                 ·      On the command line using the -p option.
96
97                 ·      In a file specified using the -t option.
98
99                 ·      Through the environment variables PORTS or PORTS_FILE.
100
101                 ·      Using  the ports_file configuration option in opafast‐
102                        fabric.conf.
103
104
105
106                 If the specified port does not exist or is empty,  the  first
107                 active port on the local system is used. In more complex con‐
108                 figurations, you must specify the exact ports to use for  all
109                 fabrics to be analyzed.
110

Example

112       opafabricinfo
113       opafabricinfo -p '1:1 1:2 2:1 2:2'
114
115       Output example
116
117       # opafabricinfo
118       Fabric 0:0 Information:
119       SM: hds1fnb6241 hfi1_0 Guid: 0x0011750101575ffe State: Master
120       Number of HFIs: 8
121       Number of Switches: 1
122       Number of Links: 8
123       Number of HFI Links: 8 (Internal: 0 External: 8)
124       Number of ISLs: 0 (Internal: 0 External: 0)
125       Number of Degraded Links: 0 (HFI Links: 0 ISLs: 0)
126       Number of Omitted Links: 0 (HFI Links: 0 ISLs: 0)
127

Output Definitions

129       SM        Each subnet manger (SM) running in the fabric is listed along
130                 with its node name, port GUID, and present SM state  (Master,
131                 Standby, etc.).
132
133       Number of HFIs
134                 Number of unique host fabric interfaces (HFIs) in the fabric.
135                 An FI with two connected ports is counted as a single FI.
136
137
138
139
140       NOTE: Fabric Interfaces include HFIs in servers as well as HFIs  within
141       I/O Modules, Native Storage, etc.
142
143
144
145       Number of Switches
146                 Number of connected switches in the fabric.
147
148       Number of Links
149                 Number  of  links in the fabric. Note that a large switch may
150                 have internal links.
151
152       Number of HFI Links
153                 Number of HFI links (Internal and External) in the fabric.
154
155       Number of ISLs
156                 Number of Interswitch Links (Internal and  External)  in  the
157                 fabric.
158
159       Number of Degraded Links
160                 Number of degraded links (HSI and ISL) in the fabric.
161
162       Number of Omitted Links
163                 Number of omitted links (HSI and ISL) in the fabric.
164
165
166
167Copyright(C) 2015-2018         Intel Corporation              opafabricinfo(1)
Impressum