ibrouters(8)

1IBROUTERS(8)                  OpenIB Diagnostics                  IBROUTERS(8)
2
3
4

NAME

6       IBROUTERS - show InfiniBand router nodes in topology
7

SYNOPSIS

9       ibrouters [options] [<topology-file>]
10

DESCRIPTION

12       ibrouters is a script which either walks the IB subnet topology or uses
13       an already saved topology file and extracts the router nodes.
14

OPTIONS

16       -C, --Ca <ca_name>    use the specified ca_name.
17
18       -P, --Port <ca_port>    use the specified ca_port.
19
20       -t, --timeout <timeout_ms> override the default  timeout  for  the  so‐
21       licited mads.
22
23       -y, --m_key <key>
24              use the specified M_key for requests. If non-numeric value (like
25              'x') is specified then a value will be prompted for.
26
27       -h, --help      show the usage message
28
29       --config, -z  <config_file> Specify alternate config file.
30          Default: /etc/infiniband-diags/ibdiag.conf
31
32   Local port Selection
33       Multiple port/Multiple CA support: when no IB device or port is  speci‐
34       fied (see the "local umad parameters" below), the libibumad library se‐
35       lects the port to use by the following criteria:
36
37          1. the first port that is ACTIVE.
38
39          2. if not found, the first port that is UP (physical link up).
40
41          If a port and/or CA name is specified,  the  libibumad  library  at‐
42          tempts  to fulfill the user request, and will fail if it is not pos‐
43          sible.
44
45          For example:
46
47              ibaddr                 # use the first port (criteria #1 above)
48              ibaddr -C mthca1       # pick the best port from "mthca1" only.
49              ibaddr -P 2            # use the second (active/up) port from the first available IB device.
50              ibaddr -C mthca0 -P 2  # use the specified port only.
51

FILES

53   CONFIG FILE
54       /etc/infiniband-diags/ibdiag.conf
55
56       A global config file is provided to set some of the common options  for
57       all tools.  See supplied config file for details.
58
59   NODE NAME MAP FILE FORMAT
60       The  node  name map is used to specify user friendly names for nodes in
61       the output.  GUIDs are used to perform the lookup.
62
63       This  functionality  is  provided  by  the  opensm-libs  package.   See
64       opensm(8) for the file location for your installation.
65
66       Generically:
67
68          # comment
69          <guid> "<name>"
70
71       Example:
72
73          # IB1
74          # Line cards
75          0x0008f104003f125c "IB1 (Rack 11 slot 1   ) ISR9288/ISR9096 Voltaire sLB-24D"
76          0x0008f104003f125d "IB1 (Rack 11 slot 1   ) ISR9288/ISR9096 Voltaire sLB-24D"
77          0x0008f104003f10d2 "IB1 (Rack 11 slot 2   ) ISR9288/ISR9096 Voltaire sLB-24D"
78          0x0008f104003f10d3 "IB1 (Rack 11 slot 2   ) ISR9288/ISR9096 Voltaire sLB-24D"
79          0x0008f104003f10bf "IB1 (Rack 11 slot 12  ) ISR9288/ISR9096 Voltaire sLB-24D"
80
81          # Spines
82          0x0008f10400400e2d "IB1 (Rack 11 spine 1   ) ISR9288 Voltaire sFB-12D"
83          0x0008f10400400e2e "IB1 (Rack 11 spine 1   ) ISR9288 Voltaire sFB-12D"
84          0x0008f10400400e2f "IB1 (Rack 11 spine 1   ) ISR9288 Voltaire sFB-12D"
85          0x0008f10400400e31 "IB1 (Rack 11 spine 2   ) ISR9288 Voltaire sFB-12D"
86          0x0008f10400400e32 "IB1 (Rack 11 spine 2   ) ISR9288 Voltaire sFB-12D"
87
88          # GUID   Node Name
89          0x0008f10400411a08 "SW1  (Rack  3) ISR9024 Voltaire 9024D"
90          0x0008f10400411a28 "SW2  (Rack  3) ISR9024 Voltaire 9024D"
91          0x0008f10400411a34 "SW3  (Rack  3) ISR9024 Voltaire 9024D"
92          0x0008f104004119d0 "SW4  (Rack  3) ISR9024 Voltaire 9024D"
93

DEPENDENCIES

98       ibnetdiscover, ibnetdiscover format
99

AUTHOR

101       Hal Rosenstock
102              < halr@voltaire.com >
103
104
105
106
107                                  2016-12-20                      IBROUTERS(8)