User Manual

Rev 4.70
Mellanox Technologies
101
14.3.1.1 Common Configuration, Interface and Addressing
Topology File (Optional)
An InfiniBand fabric is composed of switches and channel adapter (HCA/TCA) devices. To iden-
tify devices in a fabric (or even in one switch system), each device is given a GUID (a MAC
equivalent). Since a GUID is a non-user-friendly string of characters, it is better to alias it to a
meaningful, user-given name. For this objective, the IB Diagnostic Tools can be provided with a
“topology file”, which is an optional configuration file specifying the IB fabric topology in user-
given names.
For diagnostic tools to fully support the topology file, the user may need to provide the local sys-
tem name (if the local hostname is not used in the topology file).
To specify a topology file to a diagnostic tool use one of the following two options:
1. On the command line, specify the file name using the option ‘-t <topology file name>’
2. Define the environment variable IBDIAG_TOPO_FILE
To specify the local system name to a diagnostic tool, use one of the following two options:
1. On the command line, specify the system name using the option ‘-s <local system name>’
2. Define the environment variable IBDIAG_SYS_NAME
14.3.1.2 IB Interface Definition
The diagnostic tools installed on a machine connect to the IB fabric by means of an HCA port
through which they send MADs. To specify this port to an IB diagnostic tool use one of the fol-
lowing options:
1. On the command line, specify the port number using the option ‘-p <local port number>’ (see
below)
2. Define the environment variable IBDIAG_PORT_NUM
In case more than one HCA device is installed on the local machine, it is necessary to specify the
device’s index to the tool as well. For this use on of the following options:
1. On the command line, specify the index of the local device using the following option:
‘-i <index of local device>’
2. Define the environment variable IBDIAG_DEV_IDX
14.3.1.3 Addressing
The following addressing modes can be used to define the IB ports:
• Using a Directed Route to the destination: (Tool option ‘-d’)
This option defines a directed route of output port numbers from the local port to the destination.
• Using port LIDs: (Tool option ‘-l’):
In this mode, the source and destination ports are defined by means of their LIDs. If the fabric is con-
figured to allow multiple LIDs per port, then using any of them is valid for defining a port.
This section applies to the ibdiagpath tool only. A tool command may
require defining the destination device or port to which it applies.