ibnodes(8)

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

NAME

6       IBNODES - show InfiniBand nodes in topology
7

SYNOPSIS

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

DESCRIPTION

12       ibnodes  is  a script which either walks the IB subnet topology or uses
13       an already saved topology file and  extracts  the  IB  nodes  (CAs  and
14       switches).
15

OPTIONS

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

FILES

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

DEPENDENCIES

95       ibnetdiscover, ibnetdiscover format
96

AUTHOR

98       Hal Rosenstock
99              < halr@voltaire.com >
100
101
102
103
104                                  2012-05-14                        IBNODES(8)