Contents

Error code detection commands· 1

crc-error bit-error-ratio algorithm-parameter 1

display ifmonitor 2

link-quality crc-error bit-error-ratio· 7

port ifmonitor crc-error bit-error-ratio· 8

reset crc-error bit-error-ratio status interface· 9

 

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 3 Ethernet 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 GigabitEthernet 1/0, set the upper bit error ratio calculation factor to 1 and lower bit error ratio to 50.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0

[Sysname-GigabitEthernet1/0] 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

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 GigabitEthernet 1/0.

<Sysname> display ifmonitor interface gigabitethernet 1/0

GigabitEthernet1/0:

 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

# Display alarm information of GigabitEthernet1/0 to identify whether error codes trigger LSP switchover on the interface.

<Sysname> display ifmonitor interface gigabitethernet 1/0

GigabitEthernet1/0:

 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

# Display alarm information of GigabitEthernet 1/0 to identify whether error codes trigger section layer service protection on the interface.

<Sysname> display ifmonitor interface gigabitethernet 1/0

GigabitEthernet1/0:

 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

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

Make sure the lower threshold is no greater than the upper threshold.

This command and the port ifmonitor crc-error bit-error-ratio command are mutually exclusive.

Examples

# Set the link quality detection parameters for GigabitEthernet 1/0 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 gigabitethernet 1/0

[Sysname-GigabitEthernet1/0] link-quality crc-error bit-error-ratio high-threshold 1 3 low-threshold 1 6

Related commands

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

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 command are mutually exclusive.

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Set the error code detection parameters for GigabitEthernet 1/0 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 gigabitethernet 1/0

[Sysname-GigabitEthernet1/0] port ifmonitor crc-error bit-error-ratio high-threshold 1 4 low-threshold 1 5 trigger-section

Related commands

link-quality

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 GigabitEthernet 1/0.

<Sysname> reset crc-error bit-error-ratio status interface gigabitethernet 1/0

Related commands

link-quality crc-error bit-error-ratio

port ifmonitor crc-error bit-error-ratio