EFM Commands

efm

Syntax

efm port-id

Context

oam

Description

This command enables Ethernet in the First Mile (EFM) OAM loopbacks on the specified port. The EFM OAM remote loopback OAMPDU will be sent to the peering device to trigger a remote loopback.

Parameters

port-id

specifies the port ID in the slot/mda/port format

local-loopback

Syntax

local-loopback {start | stop}

Context

oam>efm

Description

This command enables local loopback tests on the specified port.

remote-loopback

Syntax

remote-loopback {start | stop}

Context

oam>efm

Description

This command enables remote EFM OAM loopback tests on the specified port. The EFM OAM remote loopback OAMPDU will be sent to the peering device to trigger a remote loopback.

ethernet

Syntax

ethernet

Context

config>port

Description

This command enables access to the context to configure Ethernet port attributes.

efm-oam

Syntax

efm-oam

Context

config>port>ethernet

Description

This command configures EFM OAM attributes.

accept-remote-loopback

Syntax

[no] accept-remote-loopback

Context

config>port>ethernet>efm-oam

Description

This command enables reactions to loopback control OAMPDUs from peers.

The no form of this command disables reactions to loopback control OAMPDUs.

hold-time

Syntax

hold-time time-value

no hold-time

Context

config>port>ethernet>efm-oam

Description

This command sets the amount of time that EFM-OAM will wait before going from a non-operational state to an operational state.

If EFM-OAM goes from an operational state to a non-operational state (other than link-fault), it enters the hold-time period. During this time, EFM-OAM continues to negotiate with the peer if possible, but will not transition to the "up" state until the hold time has expired.

If EFM-OAM goes down because of a lower-level fault (for example, the port goes down and EFM-OAM enters the link-fault state), the hold timer is not triggered. When the lower-level fault is cleared, EFM-OAM immediately starts running on the port and transitions to the operational state as soon as possible.

If EFM-OAM goes down because the user administratively disables the protocol, EFM-OAM immediately transitions to the disabled state. When the user re-enables EFM-OAM, the protocol enters the hold time period and EFM-OAM is not operational until the hold time expires. A hold-time value of 0 indicates that EFM-OAM returns to the operational state without delay.

The hold time affects only the transition from a non-operational state to an operational state; it does not apply to a transition from an operational state to a non-operational state.

Parameters

time-value

the number of seconds that EFM-OAM will wait before returning to an operational state from a non-operational state

Values

0 to 50

Default

0

mode

Syntax

mode {active | passive}

Context

config>port>ethernet>efm-oam

Description

This command configures the mode of OAM operation for this Ethernet port.

Active mode causes the port to initiate the negotiation process and continually send out EFM OAM information PDUs. Passive mode waits for the peer to initiate the negotiation process. A passive mode port cannot initiate monitoring activities (such as loopback) with the peer.

Default

active

transmit-interval

Syntax

[no] transmit-interval interval[multiplier multiplier]

Context

config>port>ethernet>efm-oam

Description

This command configures the transmit interval of OAMPDUs.

Parameters

interval

specifies the transmit interval

Values

1 to 600 (in 100 ms)

multiplier

specifies the multiplier for the transmit interval to set the local link down timer

Values

2 to 5

tunneling

Syntax

[no] tunneling

Context

config>port>ethernet>efm-oam

Description

This command enables EFM OAMPDU tunneling. OAMPDU tunneling is required when a loopback is initiated from a router end and must be transported over the existing network infrastructure to the other end. Enabling tunneling will allow the PDUs to be mapped to Epipes so that the OAM frames can be tunneled over MPLS to the far end. To enable Ethernet EFM OAM 802.3ah on the port, use the efm-oam>no shutdown command. The no form of the command disables tunneling.