ibswitches(8)

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

NAME

6       IBSWITCHES - show InfiniBand switch nodes in topology
7

SYNOPSIS

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

DESCRIPTION

12       ibswitches  is  a  script  which either walks the IB subnet topology or
13       uses an already saved topology file and extracts the switch 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
21       solicited mads.
22
23       -h, --help      show the usage message
24
25       --config, -z  <config_file> Specify alternate config file.
26          Default: /etc/infiniband-diags/ibdiag.conf
27
28   Local port Selection
29       Multiple  port/Multiple CA support: when no IB device or port is speci‐
30       fied (see the "local umad parameters"  below),  the  libibumad  library
31       selects the port to use by the following criteria:
32
33          1. the first port that is ACTIVE.
34
35          2. if not found, the first port that is UP (physical link up).
36
37          If  a  port  and/or  CA  name  is  specified,  the libibumad library
38          attempts to fulfill the user request, and will fail  if  it  is  not
39          possible.
40
41          For example:
42
43              ibaddr                 # use the first port (criteria #1 above)
44              ibaddr -C mthca1       # pick the best port from "mthca1" only.
45              ibaddr -P 2            # use the second (active/up) port from the first available IB device.
46              ibaddr -C mthca0 -P 2  # use the specified port only.
47

FILES

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

DEPENDENCIES

94       ibnetdiscover, ibnetdiscover format
95

AUTHOR

97       Hal Rosenstock
98              < halr@voltaire.com >
99
100
101
102
103                                                                 IBSWITCHES(8)