No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

Command Reference

CloudEngine 8800, 7800, 6800, and 5800 V200R002C50

This document describes all the configuration commands of the device, including the command function, syntax, parameters, views, default level, usage guidelines, examples, and related commands.
Rate and give feedback :
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
EFM Configuration Commands

EFM Configuration Commands

NOTE:

CE6880EI does not support this feature.

display efm

Function

The display efm command displays the EFM configuration on an interface.

Format

display efm { all | interface interface-type interface-number }

Parameters

Parameter Description Value
all

Displays the EFM configuration on all the interfaces enabled with EFM.

-
interface-type interface-number

Displays the EFM configuration of a specified interface.

  • interface-type specifies the interface type.

  • interface-number specifies the interface number.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To view the EFM configuration on the device, run the display efm command.
  • If all is specified, all EFM configuration is displayed.

  • If interface interface-type interface-number is specified, the EFM configuration of a specified interface is displayed.

Prerequisites

EFM has been enabled globally using the efm enable command.

Example

# Display the EFM configuration on 10GE1/0/1.

<HUAWEI> display efm interface 10ge 1/0/1
    Item                           Value
    ----------------------------------------------------
    Interface:                     10GE1/0/1
    EFM Enable Flag:               enable
    Mode:                          active
    Loopback IgnoreRequest:        no
    OAMPDU MaxSize:                128
    OAMPDU Timeout:                5000  
    OAMPDU Interval:               1000
    Parser:                        forward
    Multiplexer:                   forward
    ErrCodeNotification:           enable
    ErrCodePeriod:                 5
    ErrCodeThreshold:              5
    ErrFrameNotification:          enable
    ErrFramePeriod:                5
    ErrFrameThreshold:             5
    ErrFrameSecondNotification:    enable
    ErrFrameSecondPeriod:          120
    ErrFrameSecondThreshold:       5
    Hold Up Time:                  0
    TriggerIfDown:                 disable
    TriggerMacRenew:               disable
    Remote MAC:                    0010-0010-0010
    Remote EFM Enable Flag:        enable
    Remote Mode:                   passive
    Remote MaxSize:                128
    Remote Loopback IgnoreRequest: no  
    Remote State:                  --
    Remote Parser:                 forward
    Remote Multiplexer:            forward
Table 15-31  Description of the display efm command output

Item

Description

Interface

Indicates the interface enabled with EFM.

EFM Enable Flag

Indicates whether EFM is enabled on an interface:
  • disable: indicates that EFM is disabled on the interface.
  • enable: indicates that EFM is enabled on the interface.

Mode

Indicates the EFM working mode of an interface:
  • active: indicates that the EFM working mode of the interface is the active mode.
  • passive: indicates that the EFM working mode of the interface is the passive mode.

OAMPDU MaxSize

Indicates the maximum size of an OAM PDU on an interface. The value ranges from 64 to 1518, in bytes. The default value is 128 bytes.

OAMPDU Interval

Indicates the interval at which OAM PDUs are sent on an interface. The value is 1000 milliseconds.

OAMPDU Timeout

Indicates the timeout period for waiting for OAM PDUs on an interface. The value ranges from 3000 to 30000, in milliseconds. The default value is 5000 milliseconds.

ErrCodeNotification

Indicates whether error code detection is enabled on an interface:
  • disable: indicates that error code detection is disabled on the interface.
  • enable: indicates that error code detection is enabled on the interface.

ErrCodePeriod

Indicates the period during which error codes are detected on an interface. The value ranges from 1 to 60, in seconds. The default value is 1 second.

ErrCodeThreshold

Indicates the threshold for the number of error codes detected on an interface. The value ranges from 0 to 65535. The default value is 1.

ErrFrameNotification

Indicates whether error frame detection is enabled on an interface:
  • disable: indicates that error frame detection is disabled on the interface.
  • enable: indicates that error frame detection is enabled on the interface.

ErrFramePeriod

Indicates the period during which error frames are detected on an interface. The value ranges from 1 to 60, in seconds. The default value is 1 second.

ErrFrameThreshold

Indicates the threshold for the number of error frames detected on an interface. The value ranges from 0 to 65535. The default value is 1.

ErrFrameSecondNotification

Indicates whether error frame second detection is enabled on an interface:
  • disable: indicates that error frame second detection is disabled on the interface.
  • enable: indicates that error frame second detection is enabled on the interface.

ErrFrameSecondPeriod

Indicates the period during which error frame seconds are detected on an interface. The value ranges from 10 to 900, in seconds. The default value is 60 seconds.

ErrFrameSecondThreshold

Indicates the threshold for the number of error frame seconds detected on an interface. The value ranges from 0 to 900. The default value is 1.

TriggerIfDown

Indicates whether to block an interface when a fault is detected on the link between the interface and its remote interface:
  • disable: indicates that the interface is not blocked after a link fault is detected.
  • enable: indicates that the interface is blocked after a link fault is detected.

TriggerMacRenew

Whether the MAC address entry on an interface is updated when the interface detects a fault on the link between the local and peer interfaces:
  • disable: The system does not update the MAC address entry when detecting a fault on the link between the local and peer interfaces.

  • enable: The system updates the MAC address entry when detecting a fault on the link between the local and peer interfaces.

Hold Up Time

Indicates the delay in changing the EFM protocol state of an interface from Down to Up after a link connectivity fault is rectified. The value ranges from 0 to 65535, in seconds. never indicates that the EFM protocol state of an interface is never changed from Down to Up.

Remote MAC

Indicates the MAC address of the remote interface.

Remote EFM Enable Flag

Indicates whether EFM is enabled on the remote interface:
  • disable: indicates that EFM is disabled on the interface.

  • enable: indicates that EFM is enabled on the interface.

  • --: indicates that the system cannot obtain the EFM status on the remote device.

Remote Mode

Indicates the EFM working mode of the remote interface:
  • active: indicates that the EFM working mode of the interface is the active mode.

  • passive: indicates that the EFM working mode of the interface is the passive mode.

  • --: indicates that the system cannot obtain the operation mode of EFM on the remote device.

Remote MaxSize

Indicates the maximum size of an OAM PDU on the remote interface. The value ranges from 64 to 1518, in bytes. The default value is 128 bytes.

Remote Loopback IgnoreRequest

Whether the remote interface ignores loopback requests from the local end:
  • yes: The remote interface ignores loopback requests from the local end.

  • no: The remote interface processes loopback requests from the local end.

  • --: The system cannot obtain the mode in which the remote interface processes loopback requests from the local end.

Remote State

Active/Standby information of the peer device. The value -- indicates that the system cannot obtain the active/standby information of the peer device.

Remote Parser

Remote parser
  • forward: device is forwarding non-OAMPDUS to the lower sublayer.

  • discard: device is discarding non-OAMPDUS.

Remote Multiplexer

Remote Multiplexer
  • forward: device is forwarding non-OAMPDUs to higher sublayer.
  • loopback: device is looping back non-OAMPDUs to lower sublayer.

  • discard: device is discarding non-OAMPDUS.

display efm session

Function

The display efm session command displays information about an EFM session between the specified interface and the peer.

Format

display efm session { all | interface interface-type interface-number }

Parameters

Parameter Description Value
all

Displays information about EFM sessions between all interfaces configured with EFM and the peers.

-
interface-type interface-number

Displays information about the EFM session between the specified interface and the peer.

  • interface-type specifies the interface type.

  • interface-number specifies the interface number.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To check whether an EFM session configured on a device is negotiated successfully, run the display efm session command. The command output includes the EFM status and timeout interval of a loopback test.
  • If all is specified, information about all EFM sessions configured on the device is displayed.

  • If interface interface-type interface-number is specified, information about EFM sessions configured on a specified interface is displayed.

Prerequisites

EFM has been enabled globally using the efm enable command.

Example

# Display information about EFM sessions between all interfaces and the peers.

<HUAWEI> display efm session all
Interface                 EFM State                   Loopback Timeout
----------------------------------------------------------------------
10GE1/0/1                 discovery                   --
Table 15-33  Description of the display efm session command output

Item

Description

EFM State

EFM protocol status on the interface:
  • discovery: The interface is in OAM discovery state.

  • detect: The interface is in Detect state.

  • loopback (control): The interface initiates remote loopback and discards the packets looped back.

  • loopback (be controlled): The interface responds to remote loopback.

LoopBack Timeout

Timeout interval of a loopback test.

display efm test-packet result

Function

The display efm test-packet result command displays information about sent test packets.

Format

display efm test-packet result

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

After remote loopback is enabled and the efm test-packet start command is used to configure a device to send test packets, the display efm test-packet result command can be used to view information about sent test packets. You can determine link performance based on the information about test packets.

Example

# Display information about sent test packets.

<HUAWEI> display efm test-packet result
  TestResult         Value
--------------------------------------------------------
  PacketsSend    :   5
  PacketsReceive :   5
  PacketsLost    :   0
  BytesSend      :   320
  BytesReceive   :   320
  BytesLost      :   0
  StartTime      :   Oct 10 2013 13:44:47
  EndTime        :   Oct 10 2013 13:44:48
  State          :   Finished
Table 15-34  Description of the display efm test-packet result command output

Item

Description

PacketsSend

Number of sent test packets.

PacketsReceive

Number of received test packets.

PacketsLost

Number of discarded test packets.

BytesSend

Total length of sent test packets, in bytes.

BytesReceive

Total length of received test packets, in bytes.

BytesLost

Total length of discarded test packets, in bytes.

StartTime

Start time test packets are sent.

EndTime

End time test packets are sent.

State

Test state.

Related Topics

display snmp-agent trap feature-name efm all

Function

The display snmp-agent trap feature-name efm all command displays the status of all traps of the EFM module.

Format

display snmp-agent trap feature-name efm all

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The Simple Network Management Protocol (SNMP) is a network management standard widely used on the TCP/IP network. It uses a central computer (a network management station) that runs network management software to manage network elements. The SNMP agent reports trap messages to the network management station so that the network management station can obtain the network status in a timely manner, and the network administrator can take measures accordingly.

The display snmp-agent trap feature-name efm all command displays the following information:
  • Trap names supported by the EFM module. The trap names are the same as the trap names specified by the snmp-agent trap enable feature-name efm trap-name trap-name command. Each trap name corresponds to a network element abnormality.

  • Trap status of the EFM module. You can check whether the trap is reported based on the trap name.

Prerequisites

SNMP has been enabled. See snmp-agent.

Example

# Display the status of all traps of the EFM module.

<HUAWEI> display snmp-agent trap feature-name efm all
------------------------------------------------------------------------------
Feature name: EFM
Trap number : 5
------------------------------------------------------------------------------
Trap name                       Default switch status   Current switch status
threshold                       off                     off
nonthreshold                    off                     off
dyinggasp                       off                     off
nonthredholdrecovery            off                     off
loopbackfailed                  off                     off
Table 15-35  Description of the display snmp-agent trap feature-name efm all command output

Item

Description

Feature name

Name of the module that the trap belongs to.

Trap number

Number of traps.

Trap name

Trap name. Traps of the EFM module include:

  • nonthreshold: trap sent when a non-threshold crossing event occurs.
  • threshold: trap sent when a threshold crossing event occurs.
  • dyinggasp: trap of dying gasp.
  • nonthredholdrecovery: trap sent when a non-threshold fault is rectified.
  • loopbackfailed: trap sent when the loopback failed.

Default switch status

Default status of the trap function:
  • on: indicates that the trap function is enabled by default.
  • off: indicates that the trap function is disabled by default.

Current switch status

Status of the trap function:

  • on: indicates that the trap function is enabled.
  • off: indicates that the trap function is disabled.

efm enable

Function

The efm enable command enables EFM globally or on an interface.

The undo efm enable command disables EFM globally or on an interface.

By default, EFM is disabled globally. That is, EFM is disabled on all interfaces.

Format

efm enable

undo efm enable

Parameters

None

Views

System view, GE interface view, 10GE interface view, 25GE interface view, 40GE interface view, 100GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Before using EFM functions, you must enable EFM globally.

After EFM is enabled on an interface, the interface starts to send OAM PDUs to perform point-to-point EFM link detection. EFM link detection can be implemented between two interfaces only after EFM is enabled on the peer interface.

Precautions

When you use the undo efm enable command to disable EFM globally, the device deletes all EFM configurations. When the device is implementing remote loopback and sending a great deal of test packets, running the undo efm enable command will cause packets to be forwarded.

Example

# Enable EFM globally.

<HUAWEI> system-view
[~HUAWEI] efm enable

# Enable EFM on interface 10GE1/0/1.

<HUAWEI> system-view
[~HUAWEI] efm enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] efm enable
Related Topics

efm error-code notification enable

Function

The efm error-code notification enable command enables an interface to detect EFM errored codes.

The undo efm error-code notification enable command disables an interface from detecting EFM errored codes.

By default, an interface is not enabled to detect EFM errored codes.

Format

efm error-code notification enable

undo efm error-code notification enable

Parameters

None

Views

GE interface view, 10GE interface view, 25GE interface view, 40GE interface view, 100GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Monitoring Ethernet links is difficult if network performance deteriorates while traffic is being transmitted over physical links. Link monitoring is used to detect link layer faults in various environments. After EFM link monitoring is configured, the device queries statistics about the physical layer data of the interface management module to monitor the quality of the link connected to an interface. EFM link monitoring implements the following functions:
  • Reports an alarm when the number of errored codes detected during a specified detection interval exceeds the preset threshold.

  • Reports an alarm when the number of errored frames detected during a specified detection interval exceeds the preset threshold.

  • Reports an alarm when the number of errored frame seconds detected during a specified interval exceeds the preset threshold.

  • Reports an alarm when the number of errored frames among a specified number of received frames exceeds the specified threshold.

The efm error-code notification enable command enables an interface to detect EFM errored codes. The local device considers a link faulty if the number of detected errored codes within the detection interval reaches or exceeds the preset threshold. Then the local device generates an alarm, and sends an OAM PDU to notify the peer device of the link failure.

Prerequisites

EFM has been enabled globally and on an interface using the efm enable command.

Example

# Enable interface 10GE1/0/1 to detect errored codes.

<HUAWEI> system-view
[~HUAWEI] efm enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] efm enable
[*HUAWEI-10GE1/0/1] efm error-code notification enable

efm error-code period

Function

The efm error-code period command sets the period for detecting EFM errored codes on an interface.

The undo efm error-code period command restores the default period for detecting EFM errored codes on an interface.

By default, the period for detecting EFM errored codes on an interface is 1s.

Format

efm error-code period period

undo efm error-code period

Parameters

Parameter Description Value
period

Specifies the period for detecting EFM errored codes.

The value is an integer that ranges from 1 to 60, in seconds. The default value is 1s.

Views

GE interface view, 10GE interface view, 25GE interface view, 40GE interface view, 100GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the efm error-code period period command is run to set the period for detecting EFM errored codes, run the efm error-code notification enable command to enable an interface to detect EFM errored codes. When the number of detected errored codes during the period reaches or exceeds a preset threshold, the local device generates an alarm and notifies the peer device of the alarm event.

Prerequisites

EFM has been enabled globally using the efm enable command.

Example

# Set the period for detecting EFM errored codes on interface 10GE1/0/1 to 20s.

<HUAWEI> system-view
[~HUAWEI] efm enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] efm error-code period 20

efm error-code threshold

Function

The efm error-code threshold command sets the threshold for detecting EFM errored codes on an interface.

The undo efm error-code threshold command restores the default threshold for detecting EFM errored codes on an interface.

By default, the threshold for threshold for detecting EFM errored codes on an interface is 1.

Format

efm error-code threshold threshold

undo efm error-code threshold

Parameters

Parameter Description Value
threshold

Specifies the threshold for detecting EFM errored codes.

The value is an integer that ranges from 0 to 65535. The default value is 1. The value 0 is not recommended.

Views

GE interface view, 10GE interface view, 25GE interface view, 40GE interface view, 100GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the efm error-code period period command is executed to set the period for detecting EFM errored codes, run the efm error-code threshold threshold command to set the threshold for detecting errored codes. Run the efm error-code notification enable command to enable an interface to detect EFM errored codes. When the number of detected errored codes during the period reaches or exceeds the threshold specified by threshold, the local device generates an alarm and notifies the peer device of the alarm event.

Prerequisites

EFM has been enabled globally using the efm enable command.

Example

# Set the threshold for detecting EFM errored codes on interface10GE1/0/1 to 100.

<HUAWEI> system-view
[~HUAWEI] efm enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] efm error-code threshold 100

efm error-frame notification enable

Function

The efm error-frame notification enable command enables an interface to detect EFM errored frames.

The undo efm error-frame notification enable command disables an interface from detecting EFM errored frames.

By default, an interface is not enabled to detect EFM errored frames.

Format

efm error-frame notification enable

undo efm error-frame notification enable

Parameters

None

Views

GE interface view, 10GE interface view, 25GE interface view, 40GE interface view, 100GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Monitoring Ethernet links is difficult if network performance deteriorates while traffic is being transmitted over physical links. Link monitoring is used to detect link layer faults in various environments. After EFM link monitoring is configured, the device queries statistics about the physical layer data of the interface management module to monitor the quality of the link connected to an interface. EFM link monitoring implements the following functions:
  • Reports an alarm when the number of errored codes detected during a specified detection interval exceeds the preset threshold.

  • Reports an alarm when the number of errored frames detected during a specified detection interval exceeds the preset threshold.

  • Reports an alarm when the number of errored frame seconds detected during a specified interval exceeds the preset threshold.

  • Reports an alarm when the number of errored frames among a specified number of received frames exceeds the specified threshold.

The efm error-frame notification enable command enables an interface to detect EFM errored frames. The local device considers a link faulty if the number of detected errored frames within the detection interval reaches or exceeds the preset threshold. Then the local device generates an alarm, and sends an OAM PDU to notify the peer device of the link failure.

Prerequisites

EFM has been enabled globally and on an interface using the efm enable command.

Example

# Enable interface10GE1/0/1 to detect errored frames.

<HUAWEI> system-view
[~HUAWEI] efm enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] efm enable
[*HUAWEI-10GE1/0/1] efm error-frame notification enable

efm error-frame period

Function

The efm error-frame period command sets the period for detecting EFM errored frames on an interface.

The undo efm error-frame period command restores the default period for detecting EFM errored frames on an interface.

By default, the period for detecting EFM errored frames on an interface is 1s.

Format

efm error-frame period period

undo efm error-frame period

Parameters

Parameter Description Value
period Specifies the period for detecting EFM errored frames. The value is an integer that ranges from 1 to 60, in seconds. The default value is 1s.

Views

GE interface view, 10GE interface view, 25GE interface view, 40GE interface view, 100GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the efm error-code period period command is run to set the period for detecting EFM errored frames on an interface, run the efm error-frame notification enable command to enable an interface to detect EFM errored frames. When the number of detected errored frames during the period reaches or exceeds a preset threshold, the local device generates an alarm and notifies the peer device of the alarm event.

Prerequisites

EFM has been enabled globally using the efm enable command.

Example

# Set the period for detecting EFM errored frames on interface 10GE1/0/1 to 20 seconds.

<HUAWEI> system-view
[~HUAWEI] efm enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] efm error-frame period 20

efm error-frame threshold

Function

The efm error-frame threshold command sets the threshold for detecting EFM errored frames on an interface.

The undo efm error-frame threshold command restores the default threshold for detecting EFM errored frames on an interface.

By default, the threshold for detecting EFM errored frames on an interface is 1.

Format

efm error-frame threshold threshold

undo efm error-frame threshold

Parameters

Parameter Description Value
threshold

Specifies the threshold for detecting EFM errored frames.

The value is an integer that ranges from 0 to 65535. The default value is 1. The value 0 is not recommended.

Views

GE interface view, 10GE interface view, 25GE interface view, 40GE interface view, 100GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the efm error-frame period period command is executed to set the period for detecting EFM errored frames on an interface, run the efm error-frame threshold threshold command to set the threshold for detecting errored frames. Run the efm error-frame notification enable command to enable an interface to detect EFM errored frames. When the number of detected errored frames during the period reaches or exceeds the threshold specified by threshold, the local device generates an alarm and notifies the peer device of the alarm event.

Prerequisites

EFM has been enabled globally using the efm enable command.

Example

# Set the threshold for detecting EFM errored frames on interface 10GE1/0/1 to 100.

<HUAWEI> system-view
[~HUAWEI] efm enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] efm error-frame threshold 100

efm error-frame-second notification enable

Function

The efm error-frame-second notification enable command enables an interface to detect EFM errored frame seconds.

The undo efm error-frame-second notification enable command disables an interface from detecting EFM errored frame seconds.

By default, an interface is not enabled to detect EFM errored frame seconds.

Format

efm error-frame-second notification enable

undo efm error-frame-second notification enable

Parameters

None

Views

GE interface view, 10GE interface view, 25GE interface view, 40GE interface view, 100GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Monitoring Ethernet links is difficult if network performance deteriorates while traffic is being transmitted over physical links. Link monitoring is used to detect link layer faults in various environments. After EFM link monitoring is configured, the device queries statistics about the physical layer data of the interface management module to monitor the quality of the link connected to an interface. EFM link monitoring implements the following functions:
  • Reports an alarm when the number of errored codes detected during a specified detection interval exceeds the preset threshold.

  • Reports an alarm when the number of errored frames detected during a specified detection interval exceeds the preset threshold.

  • Reports an alarm when the number of errored frame seconds detected during a specified interval exceeds the preset threshold.

  • Reports an alarm when the number of errored frames among a specified number of received frames exceeds the specified threshold.

The efm error-frame-second notification enable command enables an interface to detect EFM errored frame seconds. The local device considers a link faulty if the number of detected errored frame seconds within the detection interval reaches or exceeds the preset threshold. Then the local device generates an alarm, and sends an OAM PDU to notify the peer device of the link failure.

Prerequisites

EFM has been enabled globally and on an interface using the efm enable command.

Example

# Enable interface 10GE1/0/1 to detect errored frame seconds.

<HUAWEI> system-view
[~HUAWEI] efm enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] efm enable
[*HUAWEI-10GE1/0/1] efm error-frame-second notification enable

efm error-frame-second period

Function

The efm error-frame-second period command sets the period for detecting EFM errored frame seconds on an interface.

The undo efm error-frame-second period command restores the default period for detecting EFM errored frame seconds on an interface.

By default, the period for detecting EFM errored frame seconds on an interface is 60s.

Format

efm error-frame-second period period

undo efm error-frame-second period

Parameters

Parameter Description Value
period

Specifies the period for detecting EFM errored frame seconds.

The value is an integer that ranges from 10 to 900, in seconds. The default value is 60s.

Views

GE interface view, 10GE interface view, 25GE interface view, 40GE interface view, 100GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the efm error-frame-second period period command is run to set the period for detecting EFM errored frame seconds on an interface, run the efm error-frame-second notification enable command to enable an interface to detect EFM errored frame seconds. When the number of detected errored frame seconds during the period reaches or exceeds a preset threshold, the local device generates an alarm and notifies the peer device of the alarm event.

Prerequisites

EFM has been enabled globally using the efm enable command.

Example

# Set the period for detecting EFM errored frame seconds on interface 10GE1/0/1 to 20s.

<HUAWEI> system-view
[~HUAWEI] efm enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] efm error-frame-second period 20

efm error-frame-second threshold

Function

The efm error-frame-second threshold command sets the threshold for detecting EFM errored frame seconds on an interface.

The undo efm error-frame-second threshold command restores the default threshold for detecting EFM errored frame seconds on an interface.

By default, the threshold for detecting EFM errored frame seconds on an interface is 1.

Format

efm error-frame-second threshold threshold

undo efm error-frame-second threshold

Parameters

Parameter Description Value
threshold

Specifies the threshold for detecting EFM errored frame seconds.

The value is an integer that ranges from 0 to 900. The default value is 1. The value 0 is not recommended.

Views

GE interface view, 10GE interface view, 25GE interface view, 40GE interface view, 100GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the efm error-frame-second period period command is executed to set the threshold for detecting EFM errored frame seconds on an interface, run the efm error-frame-second threshold threshold command to set the threshold for detecting errored frame seconds. Run the efm error-frame-second notification enable command to enable an interface to detect EFM errored frame seconds. When the number of detected errored frame seconds during the period reaches or exceeds the threshold specified by threshold, the local device generates an alarm and notifies the peer device of the alarm event.

Prerequisites

EFM has been enabled globally using the efm enable command.

Example

# Set the threshold for detecting EFM errored frame seconds on interface 10GE1/0/1 to 10.

<HUAWEI> system-view
[~HUAWEI] efm enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] efm error-frame-second threshold 10

efm holdup-timer

Function

The efm holdup-timer command sets the value of the EFM faulty-state holdup timer on an interface.

The undo efm holdup-timer command restores the default value interval of the EFM faulty-state holdup timer on an interface.

By default, the value of the EFM faulty-state holdup timer is 0s.

Format

efm holdup-timer time

undo efm holdup-timer

Parameters

Parameter Description Value
time

Specifies the value of the EFM faulty-state holdup timer on an interface.

The value is an integer that ranges from 0 to 50, in seconds. The default value is 0.

Views

GE interface view, 10GE interface view, 25GE interface view, 40GE interface view, 100GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the efm trigger if-down command is used to associate EFM with an interface, run the efm holdup-timer command to set the value of the EFM faulty-state holdup timer for connectivity faults detected by EFM. The faulty state remains unchanged within the value of the holdup timer. EFM does not detect whether the connectivity fault is cleared until the faulty-state holdup timer expires.

After the failed link recovers, EFM works as follows:
  • If time is not specified, EFM immediately changes the link status to Up.
  • If time is specified, EFM changes the link status to Up only after the time specified by time expires. This prevents the link from frequently alternating between Up and Down. You can run the recover efm-down command to immediately change the EFM OAM protocol state of the interface from Down to Up.

Prerequisites

EFM has been enabled globally and on interfaces using the efm enable command.

It is recommended that you run the efm trigger if-down command to associate EFM with an interface before running the efm holdup-timer command to set the value of EFM faulty-state holdup timer on the interface. Otherwise, the holdup timer does not take effect.

Example

# Set the value of EFM faulty-state holdup timer on 10GE1/0/1 to 10s.

<HUAWEI> system-view
[~HUAWEI] efm enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] efm enable
[*HUAWEI-10GE1/0/1] efm trigger if-down
[*HUAWEI-10GE1/0/1] efm holdup-timer 10

efm interval

Function

The efm interval command sets an interval at which an interface sends EFM OAMPDUs.

The undo efm interval command restores the default interval.

The default interval is 1000 milliseconds.

Format

efm interval interval-value

undo efm interval

Parameters

Parameter Description Value
interval-value Specifies an interval at which an interface sends OAMPDUs. The value is an integer ranging from 100 to 1000, in milliseconds. The step is 100 milliseconds. The default value is 1000 milliseconds.

Views

GE interface view, 10GE interface view, 25GE interface view, 40GE interface view, 100GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By setting the interval at which an interface sends EFM OAMPDUs, you can change the time required for connectivity fault detection.

Prerequisites

EFM has been globally enabled but has not been enabled on an interface.

Precautions

When setting an interval at which an interface sends EFM OAMPDUs, ensure that the same interval is set for interfaces on both ends of a link. Otherwise, EFM session negotiation may fail, or the EFM session may flap.

The interval at which an interface sends EFM OAMPDUs cannot be changed after EFM is enabled on the interface.

Example

# Set an interval at which 10GE1/0/1 sends EFM OAMPDUs to 500 milliseconds.

<HUAWEI> system-view
[~HUAWEI] efm enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] efm interval 500

efm loopback

Function

The efm loopback command configures an interface to initiate or end an EFM remote loopback.

Format

efm loopback { start [ timeout timeout ] | stop }

Parameters

Parameter Description Value
start

Initiate an EFM remote loopback.

-
timeout timeout

Specifies the timeout interval of an EFM remote loopback.

The value is an integer that ranges from 0 to 1000, in minutes. The default value is 20. The value 0 indicates that no timeout interval is set. That is, the interface remains in remote loopback state.
stop

Ends an EFM remote loopback.

-

Views

GE interface view, 10GE interface view, 25GE interface view, 40GE interface view, 100GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

EFM remote loopback is used to locate link failures and test the link quality. After remote loopback is enabled, configure the local device to send test packets to the peer device. Based on the statistics about sent and received test packets, you can check connectivity and performance of a specified link.

  • If start is specified, an interface on the local device sends a remote loopback message to the peer device. After receiving the message, the peer device enters the loopback state. In loopback state, the peer sends back all received packets, except EFM OAMPDUs, to the local device through the interface that has received these packets.

  • If stop is specified, an interface on the local device sends a remote loopback stop message to the peer device. After receiving the message, the peer device exits from the loopback state.
  • If remote loopback is left enabled, the remote device keeps looping back service data, causing a service interruption. To prevent this problem, a capability can be configured to disable remote loopback automatically after a specified timeout interval. By default, the timeout interval for remote loopback is 20 minutes. The remote loopback test stops after 20 minutes. You can set the timeout interval to 0 to keep a link in remote loopback state.

    NOTE:

    The link in remote loopback state will not forward service data. Therefore, execute caution when you set the timeout interval to 0.

Prerequisites

  • EFM has been enabled and is in detect state.

  • The device has been configured to work in active mode using the efm mode active command.

Precautions

After remote loopback is enabled, all packets except EFM OAMPDUs are looped back on the remote device. EFM OAM remote loopback must be implemented on the link that does not need to forward service data. Otherwise, service data forwarding is affected.

Remote loopback is implemented successfully only when EFM protocols at the local end and the peer are in handshake state and EFM at the local end works in active mode. You can use the display efm session command to check whether EFM OAM protocols on the local interface and the peer are in handshake state.

Example

# Configure interface 10GE1/0/1 to initiate an EFM OAM remote loopback.

<HUAWEI> system-view
[~HUAWEI] efm enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] efm enable
[*HUAWEI-10GE1/0/1] efm loopback start

# Set the timeout interval for an EFM OAM remote loopback on interface 10GE1/0/1.

<HUAWEI> system-view
[~HUAWEI] efm enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] efm enable
[*HUAWEI-10GE1/0/1] efm loopback start timeout 10

# Configure interface 10GE1/0/1 to stop an EFM OAM remote loopback.

<HUAWEI> system-view
[~HUAWEI] efm enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] efm enable
[*HUAWEI-10GE1/0/1] efm loopback stop

efm loopback ignore-request

Function

The efm loopback ignore-request command enables an interface to ignore loopback requests sent by the remote end.

The undo efm loopback ignore-request command restores the default setting for the loopback function on an interface.

By default, an interface supports remote loopback. After receiving a loopback request from a remote end, the interface enters the loopback state.

Format

efm loopback ignore-request

undo efm loopback ignore-request

Parameters

None

Views

GE interface view, 10GE interface view, 25GE interface view, 40GE interface view, 100GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Remote loopback is used to monitor link quality and locate link faults. Periodic loopback detection helps detect network faults in a timely manner.

If an interface is in loopback state, the interface loops back all received traffic, causing service interruption and imposing attacks. To solve this problem, run the efm loopback ignore-request command to enable the interface to reject the remote Ethernet OAM loopback request carried in a Loopback Control OAMPDU sent by a remote interface.

Prerequisites

EFM has been enabled globally and on an interface using the efm enable command and the interface is not in loopback state.

Precautions

After the efm loopback ignore-request command is run, the interface will discard an OAMPDU carrying a remote loopback request.

Example

# Enable interface 10GE1/0/1 to ignore loopback requests sent by a specified remote interface.

<HUAWEI> system-view
[~HUAWEI] interface 10ge 1/0/1
[~HUAWEI-10GE1/0/1] efm loopback ignore-request

efm mode

Function

The efm mode command configures the working mode of EFM on an interface.

The undo efm mode command restores the default working mode of EFM on an interface.

By default, EFM on an interface works in active mode.

Format

efm mode { active | passive }

undo efm mode

Parameters

Parameter Description Value
active

Indicates that EFM on an interface works in active mode.

-
passive

Indicates that EFM on an interface works in passive mode.

-

Views

GE interface view, 10GE interface view, 25GE interface view, 40GE interface view, 100GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

EFM supports two connection modes: active and passive. By setting the working mode of EFM OAM, you can configure whether a device can send or receive a specified type of EFM OAMPDU. Table 15-36 describes the differences between the active and passive modes.

Table 15-36  Capabilities for processing OAMPDUs in active and passive modes
Event Active Mode Passive Mode
Initiate a connection request by sending an Information OAMPDU during the discovery process Supported Not supported
Respond to a connection request during the discovery process Supported Supported
Send Information OAMPDUs Supported Supported
Send Event Notification OAMPDUs Supported Supported
Send Loopback Control OAMPDUs Supported Not supported
Respond to Loopback Control OAMPDUs Supported (The remote EFM entity must work in active mode.) Supported

Precautions

  • The working mode of EFM can be set on an interface only after EFM is enabled globally and before EFM is enabled on the interface. The working mode of EFM on an interface cannot be changed after EFM is enabled on the interface. Before changing the working mode of EFM on an interface, run the undo efm enable command to disable EFM on the interface.

  • An EFM connection can only be initiated by an OAM entity working in active mode. An OAM entity working in passive mode waits to receive a connection request from its peer entity.

  • Two OAM entities both working in passive mode cannot establish an EFM connection between them.

Example

# Configure EFM OAM on interface 10GE1/0/1 to work in passive mode.

<HUAWEI> system-view
[~HUAWEI] efm enable
[*HUAWEI] interface interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] efm mode passive

efm packet max-size

Function

The efm packet max-size command sets the maximum size of an EFM OAMPDU on an interface. All EFM OAMPDUs that exceed the maximum size on an interface are discarded as invalid packets.

The undo efm packet max-size command restores the default maximum size of an EFM OAMPDU on an interface.

By default, the maximum size of an EFM OAMPDU on an interface is 128 bytes.

Format

efm packet max-size size

undo efm packet max-size

Parameters

Parameter Description Value
size

Specifies the maximum size of an EFM OAMPDU. The size contains the length of Layer 2 frame header and the length of the cyclic redundancy check (CRC) field.

The value is an integer that ranges from 64 to 1518, in bytes. The default value is 128 bytes.

Views

GE interface view, 10GE interface view, 25GE interface view, 40GE interface view, 100GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the efm packet max-size command to adjust the maximum size of an EFM OAMPDU so that non-Huawei devices can communicate.

Prerequisites

EFM has been enabled globally using the efm enable command.

Precautions

The local device and the peer determine the actual value of the maximum size of an EFM OAMPDU through negotiation. The smaller maximum size of an EFM OAMPDU set on the local interface or the peer is used.

Example

# Set the maximum size of an EFM OAMPDU on interface 10GE1/0/1 to 120 bytes.

<HUAWEI> system-view
[~HUAWEI] efm enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] efm packet max-size 120

efm timeout

Function

The efm timeout command sets the timeout interval at which EFM OAMPDUs are received.

The undo efm timeout command restores the default timeout interval.

By default, the timeout interval at which EFM OAMPDUs are received is 5000 milliseconds.

Format

efm timeout timeout-value

undo efm timeout

Parameters

Parameter Description Value
timeout-value

Specifies the timeout interval at which an interface receives EFM OAMPDUs.

The value is an integer that ranges from 300 to 30000, in milliseconds. The step is 100 milliseconds. The default value is 5000 milliseconds.

Views

GE interface view, 10GE interface view, 25GE interface view, 40GE interface view, 100GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By setting the timeout interval at which OAMPDUs are received, you can change the time required for connectivity fault detection.

Prerequisites

EFM OAM has been enabled globally but is not enabled on an interface.

Precautions

After the timeout interval expires, the EFM OAM protocol switches back to the discovery state. Ensure that interfaces on both ends of a link use the same timeout interval. Otherwise, EFM session negotiation may fail, or the EFM session may flap.

After EFM OAM is enabled on an interface, the timeout interval cannot be changed.

  • A shorter timeout interval indicates a shorter time required for connectivity fault detection.

  • A longer timeout interval indicates a longer time required for connectivity fault detection.

Example

# Set the timeout interval at which EFM OAMPDUs are received on interface 10GE1/0/1 to 3000 ms.

<HUAWEI> system-view
[~HUAWEI] efm enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] efm timeout 3000

efm trigger if-down

Function

The efm trigger if-down command associates EFM with an interface.

The undo efm trigger if-down command disassociates EFM from an interface.

By default, EFM OAM is not associated with any interface.

Format

efm trigger if-down

undo efm trigger if-down

Parameters

None

Views

GE interface view, 10GE interface view, 25GE interface view, 40GE interface view, 100GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

EFM can be associated with interfaces. On a scenario with primary and backup links, if EFM detects a fault on the primary link, it will set the protocol status of the associated interface to ETHOAM Down, speeding up routing convergence. Traffic can be fast switched to the backup link.

Prerequisites

EFM has been enabled globally and on an interface, and is in detect state.

Precautions

If EFM is associated with an interface and detects a link fault, the protocol status of the interface becomes ETHOAM Down, and no packet except EFM OAMPDUs can be forwarded by the interface, and all Layer 2 and Layer 3 services are blocked. Therefore, associating EFM with an interface may greatly affect services. When the interface detects link recovery using EFM, the interface can forward all packets and unblocks Layer 2 and Layer 3 services.

If Layer 2 and Layer 3 services are blocked due to a misoperation, run the undo efm trigger if-down command in the interface view to restore services.

Example

# Associate EFM with interface 10GE1/0/1.

<HUAWEI> system-view
[~HUAWEI] efm enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] efm enable
[*HUAWEI-10GE1/0/1] efm trigger if-down

efm test-packet start

Function

The efm test-packet start command configures the device to send test packets.

Format

efm test-packet start interface interface-type interface-number [ -c count | -p speed | -s size ] *

Parameters

Parameter Description Value
interface-type interface-number

Specifies the outbound interface of test packets.

  • interface-type specifies the interface type.

  • interface-number specifies the interface number.

-
-c count

Specifies the number of test packets to be sent.

The value is an integer that ranges from 1 to 65535. The default value is 5.
-p speed

Specifies the rate at which test packets are sent.

The value is an integer that ranges from 1 to 5, in Mbit/s. The default value is 1 Mbit/s.
-s size

Specifies the length of a test packet.

The value is an integer that ranges from 64 to 1518, in bytes. The default value is 64 bytes.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After remote loopback is enabled on the device, run the efm test-packet start command on an interface in active mode to configure the device to send test packets. Then check link connectivity and performance based on returned test packets.

Press Ctrl+C to stop sending test packets. After using this command to send test packets, use the display efm test-packet result command to view the test result.

Precautions

During test packet transmission, parameters of sent test packets cannot be changed.

Example

# Send test packets from outbound interface 10GE1/0/1.
<HUAWEI> system-view
[~HUAWEI] efm test-packet start interface 10ge 1/0/1

recover efm-down

Function

The recover efm-down command changes the EFM OAM protocol state of an interface from Down to Up.

Format

recover efm-down

Parameters

None

Views

GE interface view, 10GE interface view, 25GE interface view, 40GE interface view, 100GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the efm trigger if-down command is run to associate EFM OAM with an interface, the EFM OAM protocol state of the interface is not changed from Down to Up when a link connectivity fault is rectified. To change the EFM OAM protocol state of the interface from Down to Up, run the recover efm-down command.

Prerequisites

EFM OAM has been associated with an interface.

Precautions

After the recover efm-down command is run, the EFM OAM protocol state of an interface is changed from Down to Up immediately after a link connectivity fault is rectified. When this occurs, the interface can forward all packets and process all Layer 2 and Layer 3 services on itself.

Example

# Change the EFM protocol state of 10GE1/0/1 from Down to Up.

<HUAWEI> system-view
[~HUAWEI] efm enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] efm enable
[*HUAWEI-10GE1/0/1] recover efm-down

snmp-agent trap enable feature-name efm

Function

The snmp-agent trap enable feature-name efm command enables the trap function for the EFM module.

The undo snmp-agent trap enable feature-name efm command disables the trap function for the EFM module.

By default, the trap function is disabled for the EFM module.

Format

snmp-agent trap enable feature-name efm [ trap-name { nonthreshold | threshold | nonthredholdrecovery | dyinggasp | loopbackfailed } ]

undo snmp-agent trap enable feature-name efm [ trap-name { nonthreshold | threshold | nonthredholdrecovery | dyinggasp | loopbackfailed } ]

Parameters

Parameter Description Value
trap-name

Enables or disables the trap function for the specified event.

-
nonthreshold

Enables the device to send a trap when a non-threshold crossing event occurs.

-
threshold

Enables the device to send a trap when a threshold crossing event occurs.

-
nonthredholdrecovery

Enables the device to send a trap when a non-threshold fault is rectified.

-
loopbackfailed

Enables the device to send a trap when loopback fails.

-
dyinggasp

Enables the device to send a trap when a remote Dying Gasp event occurs.

-

Views

System view

Default Level

2: Configuration level

Usage Guidelines

You can specify trap-name to enable the trap function for one or more events.

Example

# Enable the device to send a trap when a non-threshold crossing event occurs.

<HUAWEI> system-view
[~HUAWEI] snmp-agent trap enable feature-name efm trap-name nonthreshold
Translation
Download
Updated: 2019-03-21

Document ID: EDOC1000166501

Views: 42615

Downloads: 326

Average rating:
This Document Applies to these Products
Related Documents
Related Version
Share
Previous Next