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] < disable.csv

or

opadisableports --help

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 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.

reason

Optional text describing why ports are being disabled. If used, text is saved at the end of any new lines in the disabled file. For ports already in the disabled file, this is ignored.

disable.csv

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 with the lower LID (closer to the SM) is disabled. The reason field is optional. The reason field and any additional fields provided are saved in the disabled file. An input file such as this can be generated by using opaextractbadlinks or opaextractsellinks.

Environment

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' < disable.csv
opadisableports -p '1:1 2:1' 'dead servers' < disable.csv