If the fabric is configured to allow multiple LIDs per port, then using any of them is valid for defining a port. Using port LIDs: (Tool option ‘-l’): In this mode, the source and destination ports are defined by means of their LIDs.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.The following addressing modes can be used to define the IB ports: A tool command may require defining the destination device or port to which it applies. This section applies to the ibdiagpath tool only. Define the environment variable IBDIAG_DEV_IDX.On the command line, specify the index of the local device using the following option: ‘-i ’.For this use on of the following options: 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. Define the environment variable IBDIAG_PORT_NUM.On the command line, specify the port number using the option ‘-p ’ (see below).To specify this port to an IB diagnostic tool use one of the following options: The diagnostic tools installed on a machine connect to the IB fabric by means of an HCA port through which they send MADs. Define the environment variable IBDIAG_SYS_NAME.On the command line, specify the system name using the option ‘-s ’.To specify the local system name to an diagnostic tool use one of the following two options: Define the environment variable IBDIAG_TOPO_FILE.On the command line, specify the file name using the option ‘-t ’.
To specify a topology file to a diagnostic tool use one of the following two options: For diagnostic tools to fully support the topology file, the user may need to provide the local system name (if the local hostname is not used in the topology file). 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. Since a GUID is a non-user-friendly string of characters, it is better to alias it to a meaningful, user-given name. To identify devices in a fabric (or even in one switch system), each device is given a GUID (a MAC equivalent). Common Configuration, Interface and Addressing Topology File (Optional)Īn InfiniBand fabric is composed of switches and channel adapter (HCA/TCA) devices. This section first describes common configuration, interface, and addressing for all the tools in the package.