opadisableports (8) - Linux Man Pages

NAME

opadisableports

(Linux) Accepts a CSV file listing links to disable. For each HFI-SW link, the switch side of the link is disabled. For each SW-SW link, the side of the link with the lower LID (typically, the side closest to the SM) is disabled. This approach generally permits a future opaenableports operation to re-enable the port once the issue is corrected or ready to be retested. When using the -R option, this tool does not look at the routes, it disables the switch ports with the lower value LID. The list of disabled ports is tracked in /etc/sysconfig/opa/disabled*.csv.

Syntax

opadisableports [-R] [-t portsfile] [-p ports] [ reason] #8217lt; disable.csv

Options

--help
Produces full help text.

-R
Does not attempt to get routes for computation of distance. Instead, disables switch port with lower LID assuming that it is closer to this node.

-t portsfile
File with list of local HFI ports used to access fabric(s) for operation. Default is /etc/sysconfig/opa/ports.

-p ports
List of local HFI ports used to access fabric(s) for operation. Default is first active port. The first HFI in the system is 1. The first port on an HFI is 1.

NOTE: In this release, in multi-rail fabrics, this script does not work as expected when supplied with multiple egress ports. The script processes the entire input file against the first egress port specified, leaving no data to be applied against other egress ports. As a workaround, call the script once for each egress port.

Uses the format hfi:port :

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.


 reason 
Optional text describing why ports are being disabled. If used, text is saved in the reason field of the output file.

disable.csv
Input file listing the links to disable. The list is of the form: NodeGUID;PortNum;NodeType;NodeDesc;NodeGUID;PortNum; NodeType;NodeDesc;Reason

For each listed link, the switch port closer to this node is disabled. The reason field is optional. An input file such as this can be generated by using opaextractbadlinks or opaextractsellinks.
Information about the links disabled and the reason is saved (in the same format) to an output file named /etc/sysconfig/opa/disabled:hfi:port.csv where the hfi:port part of the file name is replaced by the HFI number and the port number being operated on (such as 0:0 or 1:2). This CSV file can be used as input to opaenableports.

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.

Examples

opadisableports 'bad cable' #8217lt; disable.csv


opadisableports -p '1:1 1:2 2:1 2:2' 'dead servers' #8217lt; disable.csv