User guide

A–FastFabric Configuration Files
Externally Managed Switch List File
A-14 IB0054607-01 A
The following is a sample ibanodes file:
# [ICS VERSION STRING: @(#) ./fastfabric/ib_tools/ibnodes x_x_x_x_x [MM/DD/YY hh:mm]
# This file lists all the QLogic 9000 and 12000 Externally Managed Switches
#
# specify one line per switch of the form guid,nodeDesc,distance
# guid - node guid of the switch
# nodeDesc - optional node description which should be programmed into
# the switch by FastFabric. It is recommended to supply a unique
# nodeDesc for each switch to simplify management of the cluster.
# distance - optional relative distance of the switch from the FastFabric node
# this is used by reboot operations to first operate on switches furthest
# from the FastFabric node.
# Nodes without a distance specified will be treated as furthest.
# For fabrics with multiple IB subnets, the local hca and port to use may be
# specified as: guid:hca:port,nodeDesc,distance.
# See the FastFabric Manual for more info
#
# The iba_gen_ibnodes tool can be used to query the SM and generate a list
# Externally Managed switches in the proper form for this file.
#
# for example:
# 0x00066a00e300299f,SwitchA1,2
Each line of the switch list file may specify a single switch, a comment, or another
switch list file to include.
Switches can be specified by node GUID optionally followed by a colon and the
hca:port, optionally followed by a comma and the IB Node Description
(nodename) to be assigned to the switch, and optionally followed by the distance
value indicating the relative distance from the FastFabric node for each switch.
The
iba_gen_ibnodes can be used to help locate externally managed switches in
the fabric and generate an
ibnodes file. The iba_gen_ibnodes tool will by default
provide the proper distance value relative to the FastFabric node from which it
was run. This capability requires use of IBTA standard TraceRecord queries which
are not supported by openSM, but can be supplied by the QLogic Fabric Manager.
Alternatively the
iba_gen_ibnodes -R option can suppress generation of this
field. See the QLogic FastFabric Command Line Interface Reference Guide for
more information.
In a typical pure fat tree topology with externally managed switches as edge
switches and internally managed switches as core switches, the user can also
easily manually specify proper distance by simply specifying 1 for the distance
value of the switch next to the FastFabric node. Note that in such a topology all
other switches are an equal length from the FastFabric node and a missing
distance value will cause them to be treated as having a distance value which is
larger than any other found in the file. Therefore the other switches would be
rebooted first and the FastFabric node's switch would be rebooted last.