Name
opaportconfig — Controls the configuration and state of a specified CN5000 Omni-Path SuperNIC port on the local host or a remote switch.
Syntax
opaportconfig [-l lid [-m dest_port]] [-h hfi] [-p port] [-r secs] [-z] [-S state] [-P physstate] [-s speed] [-w width] [-c LTPCRC] [-v] [-x] [-L lid] [<sub command>]
Description
Note
This tool is designed for expert users only. Non-expert users should use other tools such as opaenableports, opadisableports, and opaportinfo for basic functionality.
Port configuration is transient in nature. If the given host is rebooted or its CN5000 Omni-Path Fabric Stack is restarted, the port reverts to its default configuration and state. Typically, the default state is to have the port enabled with all speeds and widths supported by the given SuperNIC port.
To access switch ports using this command, the -l and -m options must be given. The -l option specifies the lid of switch port 0 (the logical management port for the switch) and -m specifies the actual switch port to access.
Note
The /etc/init.d/opaportconfig script is provided as an example of changing port speed every time the server boots. This script can be edited, then scheduled, using chkconfig to control link settings on any set of SuperNIC ports.
Caution
When using this command to disable or reconfigure switch ports, if the final port in the path between the Fabric Management Node and the switch is disabled or fails to come online, then opaenableports is not able to reenable it. In this case, the switch CLI and/or a switch reboot may be needed to correct the situation.
Options
--helpProduces full help text.
-llidSpecifies the destination LID. Default is local port.
-mdest_portSpecifies the destination port. Default is port with given LID. Used to access switch ports.
-hhfiSpecifies the SuperNIC to send through/to. Default is first SuperNIC.
-pportSpecifies the port to send through/to. Default is first port.
sub commandSpecifies one of the following choices:
enableEnables port.
disableDisables port.
bounceBounces port.
Note
Bouncing remote ports may cause timeouts.
ledonTurns port LED on.
ledoffTurns port LED off.
-h and -p options permit a variety of selections:
-h 0First active port in the system (Default).
-h 0 -p 0First active port in the system.
-hxFirst active port on SuperNIC
x.-hx-p 0First active port on SuperNIC
x.-h 0 -pyPort
ywithin the system (no matter which ports are active).-hx-pySuperNIC
x, porty.
Configuration Options
-rsecsRepeats to keep the port down for the specified amount of seconds.
-SstateSpecifies the new state. Default is 0.
0 = No-op
1 = Down
2 = Initiate
3 = Armed
4 = Active
-PphysstateSpecifies the new physical state. Default is 0.
Note
All transitions are valid.
0 = No-op
2 = Polling
3 = Disabled
11 = Phy-Test. Current physstate must be
disabled.
-sspeedSpecifies the new link speeds enabled. Default is 0. To enable multiple speeds, use the sum of the desired speeds.
0 = No-op
2 = 0x0002 - 25 Gbps
4 = 0x0004 - 50 Gbps
8 = 0x0008 - 100 Gbps
-wwidthSpecifies the new link widths enabled. Default is 0. To enable multiple widths, use sum of desired widths.
0 = No-op
1 = 0x01 - 1x
2 = 0x02 - 2x
4 = 0x04 - 3x
8 = 0x08 - 4x
-cLTPCRCSpecifies the new LTP CRCs enabled. Default is 0. To enable multiple LTP CRCs, use sum of desired LTP CRCs.
0 = No-op
1 = 0x1 - 14-bit LTP CRC mode
2 = 0x2 - 16-bit LTP CRC mode
4 = 0x4 - 48-bit LTP CRC mode
8 = 0x8 - 12/16 bits per lane LTP CRC mode
Debug Options
-vVerbose output. Additional invocations turn on debugging,
openibdebugging, andlibibumaddebugging.-zDoes not get port information first; clears most port attributes.
-LlidSets PortInfo.LID = lid.
Examples
opaportconfig -w 1 opaportconfig -p 1 -h 2 -w 3