opafabricinfo (1) - Linux Man Pages

NAME

opafabricinfo

Provides a brief summary of the components in the fabric, using the first active port on the given local host to perform its analysis. opafabricinfo is supplied in both:

Intel(R) Omni-Path Fabric Suite FastFabric Toolset In this situation, the command can manage more than one fabric (subnet).

FastFabric Tools In this situation, the command performs analysis against the first active port on the system only. It takes no options and uses no environment variables.

opafabricinfo can be very useful as a quick assessment of the fabric state. It can be run against a known good fabric to identify its components and then later run to see if anything has changed about the fabric configuration or state.

For more extensive fabric analysis, use opareport and opareports Intel(R) Omni-Path Fabric Suite FastFabric User Guide

Syntax

opafabricinfo [-t portsfile] [-p ports]

Options

--help
Produces full help text.
-t portsfile
File with list of local HFI ports used to access fabric(s) for analysis. Default is /etc/sysconfig/opa/ports file.
-p ports
List of local HFI ports used to access fabric(s) for analysis. Default is first active port. The first HFI in the system is 1. The first port on an HFI is 1.

Uses the format hfi:port, for example:

0:0 First active port in system.

0:y Port y within system.

x:0 First active port on HFI x.

x:y HFI x, port y.

Environment Variables

The following environment variables are also used by this command:

PORTS
List of ports, used in absence of -t and -p.
PORTS_FILE
File containing list of ports, used in absence of -t and -p.

For simple fabrics, the Intel(R) Omni-Path Fabric Suite FastFabric Toolset host is connected to a single fabric. By default, the first active port on the FastFabric Toolset host is used to analyze the fabric. However, in more complex fabrics, the FastFabric Toolset host may be connected to more than one fabric or subnet. In this case, you can specify the ports or HFIs to use with one of the following methods:

On the command line using the -p option.
In a file specified using the -t option.
Through the environment variables PORTS or PORTS_FILE.
Using the ports_file configuration option in opafastfabric.conf.

If the specified port does not exist or is empty, the first active port on the local system is used. In more complex configurations, you must specify the exact ports to use for all fabrics to be analyzed.

Example

opafabricinfo
opafabricinfo -p '1:1 1:2 2:1 2:2'

Output example


# opafabricinfo
Fabric 0:0 Information:
SM: hds1fnb6241 hfi1_0 Guid: 0x0011750101575ffe State: Master
Number of HFIs: 8
Number of Switches: 1
Number of Links: 8
Number of HFI Links: 8 (Internal: 0 External: 8)
Number of ISLs: 0 (Internal: 0 External: 0)
Number of Degraded Links: 0 (HFI Links: 0 ISLs: 0)
Number of Omitted Links: 0 (HFI Links: 0 ISLs: 0)