echo
To customize the default behavior of echo packets, use the echo command in MPLS OAM configuration mode. To set the echo packet’s behavior to its default value, use the no form of this command.
echo {jitter jitter-value | permit vrf all | revision {3 | 4} | vendor-extension}
no echo {jitter jitter-value | permit vrf all | revision {3 | 4} | vendor-extension}
Syntax Description
jitter jitter-value |
Configures the jitter value, in milliseconds, that is used in the jitter type, length, values (TLVs) and sent as part of the echo request packets. The range is from 1 to 2147483647. The default is 200. |
permit |
Specifies VRF instances from which to permit echo packets from. |
vrf |
Specifies the VRF instance where echo packet are permitted. |
all |
Permits echo packets on all VRF instances. |
revision |
Specifies the revision number of the echo packet’s default values. Valid values are:
|
vendor-extension |
Sends Cisco-specific extension TLVs with the echo packets. |
Command Default
Cisco-specific extension TLVs are sent with the echo packet. Revision 4 is the router’s default.
Command Modes
MPLS OAM configuration
Command History
Release |
Modification |
---|---|
12.4(6)T |
This command was introduced. |
12.0(32)SY |
This command was integrated into Cisco IOS Release 12.0(32)SY. |
12.4(11)T |
This command was integrated into Cisco IOS Release 12.4(11)T. |
12.2(31)SB2 |
This command was integrated into Cisco IOS Release 12.2(31)SB2. |
12.2(33)SRB |
This command was integrated into Cisco IOS Release 12.2(33)SRB. |
12.0(33)S |
This command was integrated into Cisco IOS Release 12.0(33)S. |
12.4(20)T |
This command was integrated into Cisco IOS Release 12.4(20)T. |
12.2(33)SXI |
This command was integrated into Cisco IOS Release 12.2(33)SXI. |
15.3(3)S |
This command was modified. The jitter keyword was added. |
Usage Guidelines
Before you can use the echo command, you must first enter the mpls oam command to enter MPLS OAM configuration mode.
The jitter keyword specifies the jitter TLV that is encoded in the echo request to instruct the responder to delay responding by a random time between zero and the jitter value. This allows the echo replies to be spread out uniformly over the jitter duration. The configured jitter value is also used by the responder node. If the configured jitter value is smaller than the received jitter TLV, then the reply is generated after a random time between one and the configured jitter value. If the configured jitter value is larger than the received jitter TLV, then the reply is generated after a random time between one and the received jitter TLV.
Specify the revision keyword if one of the following conditions exists:
-
You want to change the revision number from the default value of 4 to 3 .
-
You previously entered the mpls oam command and changed the revision number to 3 and you want to change it back to 4 .
To prevent failures reported by the replying device due to TLV version issues, you can use the echo revision command to configure all devices in the core for the same version of the IEFT label-switched path (LSP) ping draft. For example, if the network is running draft RFC 4379 implementations, but one device is capable of only Version 3 (Cisco Revision 3), configure all devices in the network to operate in Revision 3 mode. Revision 3 mode is used only with Multiprotocol Label Switching (MPLS) LSP ping or traceroute. Revision 3 mode does not support MPLS multipath LSP traceroute.
The vendor-extension keyword is enabled by default in the device. If your network includes devices that are not Cisco devices, you may want to disable Cisco-extended TLVs. To disable Cisco-extended TLVs, specify the no echo vendor-extension command in MPLS OAM configuration mode. To enable Cisco-extended TLVs again, enter the echo vendor-extension command.
Examples
The following example configures the jitter value to 100 and permits echo packets on all VRFs:
Device(config)# mpls oam
Device(config-mpls)# echo jitter 100
Device(config-mpls)# echo permit vrf all
Device(config-mpls)# exit
The following example specifies revision 3 for the echo packet's default values and sends the vendor’s extension TLV with the echo packet:
Device(config)# mpls oam
Device(config-mpls)# echo revision 3
Device(config-mpls)# echo vendor-extension
Device(config-mpls)# exit