Brocade Fabric OS Command Reference Manual Supporting Fabric OS v7.0.0 (April 2011)

74 Fabric OS Command Reference
53-1001764-01
bottleneckMon
22
Credit recovery on back-end ports
Use the --cfgcredittools commands to enable or disable credit recovery of external back-end ports and
to display the configuration. When this feature is enabled, credit is recovered on external back-end ports
(ports connected to the core blade or core blade back-end ports) when credit loss has been detected on
these ports. When used with the -recover onLrOnly option, the recovery mechanism takes the following
escalating actions:
• When it detects credit loss, it performs a link reset and logs a RASlog message (RAS Cx-1014).
• If the link reset fails to recover the port, the port reinitializes. A RASlog message is generated (RAS
Cx-1015). Note that the port reinitialization does not fault the blade.
• If the port fails to reinitialize, the port is faulted. A RASlog message (RAS Cx-1016) is generated.
• If a port is faulted and there are no more online back-end ports in the trunk, the core blade is faulted.
(Note that the port blade will always be faulted). A RASlog message is generated (RAS Cx-1017).
When used with the -recover onLrThresh option, recovery is attempted through repeated link resets
and a count of the link resets is kept. If the threshold of more than two link resets per hour is reached, the
blade is faulted. Note that regardless of whether the link reset occurs on the port blade or on the core
blade, the port blade is always faulted.
NOTES Command syntax predating Fabric OS v.6.4.0 is no longer supported as of Fabric OS v.7.0.0.
The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in
place. Refer to Chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for
details.
The bottleneck detection commands are supported on F_Ports, FL_Ports, E_Ports, and EX_Ports.
The credit recovery commands are supported only on back-end ports of Condor, Condor 2, and Condor
3-based blades in the Brocade DCX, DCX-4S, DCX 8510-8, and DCX 8510-4 chassis.
OPERANDS Bottleneck detection commands
The following operands support bottleneck detection:
slot
On bladed systems only, specifies the slot number of the ports to be configured,
followed by a slash (/).
port_list
Specifies one or more ports, relative to the slot on bladed systems. Use
switchShow for a listing of valid ports. The --show option allows only a single
port or all ports ('*') to be specified with this command, unless it is used without
port operand. A port list should be enclosed in double quotation marks and can
consist of the following:
• A single port, for example, "8" or "5/8" on blades systems.
• A port range where beginning and end port are separated by a dash, for
example, "8-13" or "5/8-13" on blades systems. A port range cannot span
multiple slots.
• A set of ports, separated by a space, for example "3 5 7 8"or 5/3 5 7 8 on
bladed systems.
• A wildcard ('*') indicates all ports. The wildcard must be enclosed in single
quotation marks and is not allowed with the --config option. To make
switch-wide changes, use --config without a port specifier.
--enable
Enables bottleneck detection on the switch. This operation is switch-wide and
affects all F[L]_Ports and F_Ports. This operation enables bottleneck detection on
all eligible ports of a switch, no matter when they become eligible. If you have
Virtual Fabrics enabled and you move ports into a bottleneck enabled logical