- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
06-Error code detection commands | 121.19 KB |
Contents
crc-error bit-error-ratio algorithm-parameter
crc-error bit-error-ratio transfer-protocol
display ifmonitor background-traffic interface
link-quality crc-error bit-error-ratio
port ifmonitor crc-error bit-error-ratio
reset crc-error bit-error-ratio status interface
Error code detection commands
crc-error bit-error-ratio algorithm-parameter
Use crc-error bit-error-ratio algorithm-parameter to configure the bit error ratio calculation factors for an interface.
Use undo crc-error bit-error-ratio algorithm-parameter to restore the default.
Syntax
crc-error bit-error-ratio algorithm-parameter high-factor high-factor-value low-factor low-factor-value
undo crc-error bit-error-ratio algorithm-parameter
Default
The calculation factor is 50 for both the upper bit error ratio and lower bit error ratio.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Predefined user roles
network-admin
Parameters
high-factor high-factor-value: Specifies the upper bit error ratio calculation factor in the range of 1 to 99.
low-factor low-factor-value: Specifies the lower bit error ratio calculation factor in the range of 1 to 99.
Usage guidelines
With error code detection enabled, the device periodically samples and checks the packets sent and received by an interface and performs the following operations:
· When the interface is in lower bit error ratio status, the device uses the upper bit error ratio calculation factor to calculate a result. Then, the device compares the calculation result with the upper bit error ratio threshold to determine whether the interface is in upper bit error ratio status.
· When the interface is in upper bit error ratio status, the device uses the lower bit error ratio calculation factor to calculate a result. Then, the device compares the calculation result with the lower bit error ratio threshold to determine whether the interface is in lower bit error ratio status.
You can use this command to adjust the bit error ratio calculation factors to adjust the timeliness and reliability of the calculation results. A smaller calculation factor means a higher timeliness and lower reliability.
This command takes effect only when the link-quality crc-error bit-error-ratio or port ifmonitor crc-error bit-error-ratio command is executed.
Examples
# On Ten-GigabitEthernet 3/1/1, set the upper bit error ratio calculation factor to 10 and lower bit error ratio to 50.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] crc-error bit-error-ratio algorithm-parameter high-factor 10 low-factor 50
This command will affect the bit-error detection. Please make sure all parameters are confirmed. Continue? [Y/N]:y
Related commands
link-quality crc-error bit-error-ratio
port ifmonitor crc-error bit-error-ratio
crc-error bit-error-ratio transfer-protocol
Use crc-error bit-error-ratio transfer-protocol to specify the protocol for transferring error code detection information.
Use undo crc-error bit-error-ratio transfer-protocol to restore the default.
Syntax
crc-error bit-error-ratio transfer-protocol { bfd | lldp }
undo crc-error bit-error-ratio transfer-protocol
Default
BFD is used for transferring error code detection information.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Predefined user roles
network-admin
Parameters
bfd: Specifies BFD for transferring error code detection information.
lldp: Specifies LLDP for transferring error code detection information.
Usage guidelines
When an error code failure occurs on an interface, the error code status of the interface must be sent to the peer device. The device supports using BFD or LLDP for transferring the error code status of interfaces. When the device is connected to a third-party device, you can use this command to select a protocol for transferring error code information, so that the peer device can recognize the error code information.
To use LLDP for transferring error code detection information, make sure LLDP is enabled and LLDP operates in nearest bridge agent mode. For more information about LLDP, see LLDP configuration in Layer 2—LAN Switching Configuration Guide.
Examples
# Configure Ten-GigabitEthernet3/1/1 to use LLDP for transferring error code detection information.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] crc-error bit-error-ratio transfer-protocol lldp
This command takes effect only after LLDP is enabled both globally and on the interface.
display ifmonitor background-traffic interface
Use display ifmonitor background-traffic interface to display the background traffic information of interfaces.
Syntax
display ifmonitor background-traffic interface [ interface-type [ interface-number ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type: Specifies an interface type.
interface-number: Specifies an interface number.
Usage guidelines
If you do not specify an interface type, this command displays background traffic information about all interfaces.
If you specify an interface type but do not specify an interface number, this command displays background traffic information about all interfaces of the specified type.
If you specify both an interface type and an interface number, this command displays background traffic information about the specified interface.
Examples
# Display background traffic information about all interfaces.
<Sysname> display ifmonitor background-traffic interface
Total number of interfaces sending background traffic:0
Interface State Sending Rate (Mbps) Last start
Last stop
XGE3/1/1 Disabled N 0 -
-
Table 1 Command output
Field |
Description |
Interface |
Abbreviated interface name. |
State |
State of the background traffic sending function: · Disabled. · Enabled. |
Sending |
Whether the interface is sending the background traffic: · Y—The interface is sending background traffic. · N—The interface is not sending background traffic. |
Rate (Mbps) |
Rate (Mbps) at which the interface is sending the background traffic. |
Last start |
Last time when the interface started sending the background traffic. If the interface has never sent background traffic, this field displays a hyphen (-). |
Last stop |
Last time when the interface stopped sending the background traffic. If the interface has never sent background traffic, this field displays Stop hyphen (-). |
display ifmonitor
Use display ifmonitor to display alarm information of an interface.
Syntax
display ifmonitor interface interface-type interface-number
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface interface-type interface-number: Specifies an interface by its type and number.
Examples
# Display alarm information of Ten-GigabitEthernet 3/1/1.
<Sysname> display ifmonitor interface ten-gigabitethernet 3/1/1
Ten-GigabitEthernet3/1/1:
CRC error:
Trap enable : Y
Trigger down : N
Alarm status : N
High threshold : 1000
Low threshold : 100
Value(ratio) : 10
Interval : 10 s
Trigger at : Never
Input error:
Trap enable : Y
Trigger down : N
Alarm status : N
High threshold : 1000
Low threshold : 100
Interval : 10 s
Value : 0
Trigger at : [L]2013-05-01 11:16:00
Output error:
Trap enable : Y
Trigger down : N
Alarm status : N
High threshold : 1000
Low threshold : 100
Interval : 10 s
Value : 0
Trigger at : [L]2013-05-01 11:16:00
SDH error:
Trap enable : Y
Trigger down : N
Alarm status : N
High threshold : 1000
Low threshold : 100
Interval : 10 s
Value : 0
Trigger at : Never
SDH-B1 error:
Trap enable : Y
Trigger down : N
Alarm status : N
High threshold : 1000
Low threshold : 100
Interval : 10 s
Value : 0
Trigger at : [L]2013-05-01 11:16:00
SDH-B2 error:
Trap enable : Y
Trigger down : N
Alarm status : N
High threshold : 1000
Low threshold : 100
Interval : 10 s
Value : 0
Trigger at : [L]2013-05-01 11:16:00
Input-buffer-drop:
Trap enable : Y
Trigger down : N
Alarm status : N
High threshold : 1000
Low threshold : 100
Interval : 10 s
Value : 0
Trigger at : [L]2013-05-01 11:16:00
Output-buffer-drop:
Trap enable : Y
Trigger down : N
Alarm status : N
High threshold : 1000
Low threshold : 100
Interval : 10 s
Value : 0
Trigger at : [L]2013-05-01 11:16:00
Link-quality hardware-error:
Trigger action : Link quality
Alarm status : Y
Value : 0x4
Trigger at : [L]2013-05-01 11:16:00
# Display alarm information of Ten-GigabitEthernet3/1/1 to identify whether error codes trigger LSP switchover on the interface.
<Sysname> display ifmonitor interface ten-gigabitethernet 3/1/1
Ten-GigabitEthernet3/1/1:
CRC error(bit-error-ratio):
Trigger action : LSP
High threshold : 1E-3
Low threshold : 1E-4
Value : 0E-0
Trigger at : [H]2013-05-01 11:16:00
Input error:
Trap enable : Y
Trigger down : N
Alarm status : N
High threshold : 1000
Low threshold : 100
Interval : 10 s
Value : 0
Trigger at : [L]2013-05-01 11:16:00
Output error:
Trap enable : Y
Trigger down : N
Alarm status : N
High threshold : 1000
Low threshold : 100
Interval : 10 s
Value : 0
Trigger at : [L]2013-05-01 11:16:00
SDH error:
Trap enable : Y
Trigger down : N
Alarm status : N
High threshold : 1000
Low threshold : 100
Interval : 10 s
Value : 0
Trigger at : Never
SDH-B1 error:
Trap enable : Y
Trigger down : N
Alarm status : N
High threshold : 1000
Low threshold : 100
Interval : 10 s
Value : 0
Trigger at : [L]2013-05-01 11:16:00
SDH-B2 error:
Trap enable : Y
Trigger down : N
Alarm status : N
High threshold : 1000
Low threshold : 100
Interval : 10 s
Value : 0
Trigger at : [L]2013-05-01 11:16:00
Input-buffer-drop:
Trap enable : Y
Trigger down : N
Alarm status : N
High threshold : 1000
Low threshold : 100
Interval : 10 s
Value : 0
Trigger at : [L]2013-05-01 11:16:00
Output-buffer-drop:
Trap enable : Y
Trigger down : N
Alarm status : N
High threshold : 1000
Low threshold : 100
Interval : 10 s
Value : 0
Trigger at : [L]2013-05-01 11:16:00
Link-quality hardware-error:
Trigger action : Link quality
Alarm status : Y
Value : 0x4
Trigger at : [L]2013-05-01 11:16:00
# Display alarm information of Ten-GigabitEthernet 3/1/1 to identify whether error codes trigger section layer service protection on the interface.
<Sysname> display ifmonitor interface ten-gigabitethernet 3/1/1
Ten-GigabitEthernet3/1/1:
CRC error(bit-error-ratio):
Trigger action : Section
High threshold : 1E-3
Low threshold : 1E-4
Value : 0E-0
Trigger at : Never
Input error:
Trap enable : Y
Trigger down : N
Alarm status : N
High threshold : 1000
Low threshold : 100
Interval : 10 s
Value : 0
Trigger at : [L]2013-05-01 11:16:00
Output error:
Trap enable : Y
Trigger down : N
Alarm status : N
High threshold : 1000
Low threshold : 100
Interval : 10 s
Value : 0
Trigger at : [L]2013-05-01 11:16:00
SDH error:
Trap enable : Y
Trigger down : N
Alarm status : N
High threshold : 1000
Low threshold : 100
Interval : 10 s
Value : 0
Trigger at : Never
SDH-B1 error:
Trap enable : Y
Trigger down : N
Alarm status : N
High threshold : 1000
Low threshold : 100
Interval : 10 s
Value : 0
Trigger at : [L]2013-05-01 11:16:00
SDH-B2 error:
Trap enable : Y
Trigger down : N
Alarm status : N
High threshold : 1000
Low threshold : 100
Interval : 10 s
Value : 0
Trigger at : [L]2013-05-01 11:16:00
Input-buffer-drop:
Trap enable : Y
Trigger down : N
Alarm status : N
High threshold : 1000
Low threshold : 100
Interval : 10 s
Value : 0
Trigger at : [L]2013-05-01 11:16:00
Output-buffer-drop:
Trap enable : Y
Trigger down : N
Alarm status : N
High threshold : 1000
Low threshold : 100
Interval : 10 s
Value : 0
Trigger at : [L]2013-05-01 11:16:00
Link-quality hardware-error:
Trigger action : Link quality
Alarm status : Y
Value : 0x4
Trigger at : [L]2013-05-01 11:16:00
Table 2 Command output
Field |
Description |
Trap enable |
Whether the alarm function is enabled: · Y—Enabled. · N—Disabled. |
Trigger down |
Whether the interface is set to down when the trap threshold is reached: · Y—Sets the interface to down. · N—Does not set the interface to down. |
Trigger action |
Action triggered by error codes: · Link quality—Adjusts the link cost according to the link quality. · LSP—Triggers LSP switchover. · Section—Triggers section layer service protection. |
Alarm status |
Alarm status: · Y—The interface is in alarm status. · N—The interface is not in alarm status. |
High threshold |
Upper alarm threshold or bit error ratio threshold. |
Low threshold |
Lower alarm threshold or bit error ratio threshold. |
Interval |
Statistics collection and comparison interval in seconds. |
Value |
When an error packet alarm is triggered, this field displays the number of error packets within the most recent interval. When a bit error is triggered, this field displays the bit error ratio within the most recent interval. When a hardware error is triggered, this field indicates the cause of a hardware failure. Options include: · 0x1—HG detection failure. · 0x2—NP deadlock. · 0x4—Faulty node identified by comprehensive AI analysis. · 0x8—HG error packets. · 0x10—TM failure on a 1104 or NP5 card. · 0x20—External TCAM failure. · 0x40—Serious external TCAM failure (on NP5 cards only). · 0x80—XFPGA failure on an IPRAN subcard. · 0x100—Internal FAP failure. · 0x200—Subcard connection failure. · 0x400—Port blocking detection. · 0x800—Minor NPS module blocking failure. · 0x1000—Serious NPS module blocking failure. · 0x2000—Internal connection interface failure (for example, DOWN or error packets), which is a serious failure. · 0x4000—Serious FPGA failure. · 0x8000—Minor SEU failure of an FPGA module. · 0x10000—Serious SEU failure of an FPGA module. · 0x20000—Parity/ECC threshold exceeding, which is a minor failure. · 0x40000—Software and hardware entry inconsistency threshold exceeding, which is a minor failure. · 0x80000—Parity/ECC threshold exceeding in an MMU module, which is a serious failure. · 0x100000—Critical table entry unrecoverable error threshold exceeding, which is a serious failure. · 0x200000—FPGA packet error, which is a serious failure. · 0x400000—Minor ECC failure of an NP module. · 0x800000—Serious ECC failure of an NP module. |
Value(ratio) |
When an error packet alarm is triggered, this field indicates the ratio of error packets within the most recent interval. |
Trigger at |
Most recent time when the alarm threshold or bit error ratio threshold was triggered: · [L]YYYY/MM/DD HH:MM:SS—Most recent time when the lower alarm threshold or bit error ratio threshold was triggered. · [H]YYYY/MM/DD HH:MM:SS—Most recent time when the upper alarm threshold or bit error ratio threshold was triggered. · Never—No alarm threshold or bit error ratio threshold has been triggered. |
link-quality crc-error bit-error-ratio
Use link-quality crc-error bit-error-ratio to configure link quality detection parameters.
Use undo link-quality to restore the default.
Syntax
link-quality crc-error bit-error-ratio high-threshold high-value-coefficient high-value-power low-threshold low-value-coefficient low-value-power
undo link-quality
Default
No link quality detection parameters are set.
Views
Layer 3 Ethernet interface view
Layer 3 aggregate interface view
Predefined user roles
network-admin
Parameters
high-threshold high-value-coefficient high-value-power: Specifies the upper bit error ratio threshold, which is calculated by using the formula xE-y. The high-value-coefficient argument specifies the coefficient (x in xE-y) in the range of 1 to 9. The high-value-power argument specifies the power (y in xE-y) in the range of 1 to 7.
low-threshold low-value-coefficient low-value-power: Specifies the lower bit error ratio threshold, which is calculated by using the formula xE-y. The high-value-coefficient argument specifies the coefficient (x in xE-y) in the range of 1 to 9. The high-value-power argument specifies the power (y in xE-y) in the range of 1 to 7.
Usage guidelines
With this command executed on an interface, the device periodically samples, calculates, and detects the packets received on the interface.
· If the bit error ratio exceeds the upper threshold, an error code failure occurs on the interface. Then, the link quality of the interface becomes LOW, and an error code event is reported. In this case, IGP (for example, OSPF and IS-IS) increases the cost for the link and recalculates the routes, so that IGP does not preferentially select the link and keeps off error code failures.
· If the bit error ratio drops below the lower threshold, the error code failure is cleared on the interface. Then, the link quality of the interface restores to GOOD, and an error code clearing event is reported. In this case, IGP restores the cost value for the interface and recalculates the routes, so that IGP can preferentially select the link again.
The bit error ratio is calculated by using the formula xE-y, where E=10.
When an error code failure occurs on a Layer 3 Ethernet interface that is not assigned to any aggregation group, LSP switchover is also triggered in addition to link cost adjustment and IGP route recalculation.
Make sure the lower threshold is no greater than the upper threshold.
This command and the port ifmonitor crc-error or port ifmonitor crc-error bit-error-ratio command are mutually exclusive.
Examples
# Set the link quality detection parameters for Ten-GigabitEthernet 3/1/1 as follows:
· For the upper bit error ratio threshold, set the coefficient to 1 and the power to 3.
· For the lower bit error ratio threshold, set the coefficient to 1 and the power to 6.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] link-quality crc-error bit-error-ratio high-threshold 1 3 low-threshold 1 6
Related commands
port ifmonitor crc-error (Interface Command Reference)
port ifmonitor crc-error bit-error-ratio
port ifmonitor crc-error bit-error-ratio
Use port ifmonitor crc-error bit-error-ratio to set the error code detection parameters for an interface.
Use undo port ifmonitor crc-error to restore the default.
Syntax
port ifmonitor crc-error bit-error-ratio high-threshold high-value-coefficient high-value-power low-threshold low-value-coefficient low-value-power { trigger-lsp | trigger-section }
undo port ifmonitor crc-error
Default
No error code detection parameters are set for an interface.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Predefined user roles
network-admin
Parameters
high-threshold high-value-coefficient high-value-power: Specifies the upper bit error ratio threshold, which is calculated by using the formula xE-y. The high-value-coefficient argument specifies the coefficient (x in xE-y) in the range of 1 to 9. The high-value-power argument specifies the power (y in xE-y) in the range of 1 to 5.
low-threshold low-value-coefficient low-value-power: Specifies the lower bit error ratio threshold, which is calculated by using the formula xE-y. The high-value-coefficient argument specifies the coefficient (x in xE-y) in the range of 1 to 9. The high-value-power argument specifies the power (y in xE-y) in the range of 1 to 6.
trigger-lsp: Enables error code failures to trigger LSP switchover. Layer 2 Ethernet interfaces and Layer 2 aggregate interfaces do not support this keyword.
trigger-section: Enables error code failures to trigger section layer service protection.
Usage guidelines
With the trigger-lsp keyword specified, an error code failure occurring on an interface is reported to the upper-layer service module to switch traffic from the primary LSP to the secondary LSP. After the error code failure is cleared, traffic is switched back to the primary LSP.
With the trigger-section keyword specified, an error code failure occurring on an interface is reported to the interface management module to set the link layer protocol status of the interface to DOWN(Bit-error down). Then, the upper-layer service module associated with the interface triggers section layer service protection. After the error code failure is cleared, the link layer protocol status of the interface restores to UP and the upper-layer service module cancels section layer service protection.
The bit error ratio is calculated by using the formula xE-y, where E=10.
The requirements for the bit error ratio vary by device and service. Set the bit error ratio thresholds according to the network planning and device requirements.
This command and the link-quality crc-error bit-error-ratio command are mutually exclusive.
If you execute this command and the port ifmonitor crc-error command multiple times, the most recent configuration takes effect.
Examples
# Set the error code detection parameters for Ten-GigabitEthernet 3/1/1 as follows:
· For the upper bit error ratio threshold, set the coefficient to 1 and the power to 4.
· For the lower bit error ratio threshold, set the coefficient to 1 and the power to 5.
· Enable error code failures to trigger section layer service protection.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] port ifmonitor crc-error bit-error-ratio high-threshold 1 4 low-threshold 1 5 trigger-section
Related commands
link-quality crc-error bit-error-ratio
port ifmonitor crc-error (Interface Command Reference)
reset crc-error bit-error-ratio status interface
Use reset crc-error bit-error-ratio status interface to clear the bit error ratio status for interfaces.
Syntax
reset crc-error bit-error-ratio status interface [ interface-type [ interface-number ] ]
Views
User view
Predefined user roles
network-admin
Parameters
interface-type: Specifies an interface type.
interface-number: Specifies an interface number.
Usage guidelines
When an interface is in upper bit error ratio status, this command clears the bit error ratio and releases the upper bit error ratio status for the interface. Then, the interface restores to normal status.
When an interface is in lower bit error ratio status, this command clears the lower bit error ratio status and bit error ratio for the interface.
When an interface is in normal status, this command clears only the bit error ratio for the interface.
If you specify neither interface-type nor interface-number, this command clears the bit error ratio status for all interfaces.
If you specify interface-type but not interface-number, this command clears the bit error ratio status for interfaces of the specified type.
Examples
# Clear the bit error ratio status for Ten-GigabitEthernet 3/1/1.
<Sysname> reset crc-error bit-error-ratio status interface ten-gigabitethernet 3/1/1
Related commands
link-quality crc-error bit-error-ratio
port ifmonitor crc-error bit-error-ratio