To send Ethernet
connectivity fault management (CFM) loopback messages to a destination
maintenance endpoint (MEP) and maintenance intermediate point (MIP), use the
ping ethernet command in privileged EXEC mode.
ping ethernet {mac-address | mpid mpid | multicast} domain domain-name {port | service icc icc-code meg-id} [cos cos-value | source source-mpid [cos cos-value]] [de]
Cisco IOS XE Release 3.7S for
Cisco Series ASR 1000 Routers
ping ethernet {mac-address | mpid mpid | multicast} domain domain-name service {short-ma-name | icc icc-code meg-id | number ma-number | vlan-id vlan-id | vpn-id vpn-id} [cos cos-value | source source-mpid [cos cos-value]] [de] [pad {data-pattern | test pattern-type pattern-value} validate]
Cisco ASR 901 Series
Aggregation Services Routers
ping ethernet {mac-address | mpid mpid} {domain domain-name {vlan vlan-id [source source-mpid] level level-id {vlan vlan-id}}}
Syntax Description
|
mac-address
|
MAC
address of the destination MEP in the format abcd.abcd.abcd.
|
|
mpid
mpid
|
Specifies a MEP identifier (MPID) and value. Range: 1 to 8191.
|
|
multicast
|
Specifies a multicast loopback message.
|
|
domain
domain-name
|
Specifies the domain where the destination MEP resides. Maximum: 154
characters.
|
|
port
|
Specifies a port MEP.
|
|
service
|
Specifies the maintenance association (MA) within the domain.
|
|
short-ma-name
|
The
short-name identifier for the MA service. The domain name and short MA name
combined cannot exceed 48 bytes.
|
|
icc
icc-code
meg-id
|
ITU
Carrier Code (ICC) (maximum: 6 characters) and unique maintenance entity group
(MEG) ID Code (UMC) (maximum: 12 characters).
|
|
number
ma-number
|
The MA
number. Range: 0 to 65535.
|
|
vlan-id vlan-id
|
The
primary VLAN ID. Range: 1 to 4094.
|
|
vpn-id vpn-id
|
The VPN
ID. Range: 1 to 32767.
|
|
cos
cos-value
|
(Optional) Specifies a class of service (CoS) for a MEP that will be sent in
Ethernet CFM messages. CoS value range: 0 to 7.
-
ICC
(maximum: 6 characters) and UMC (maximum: 12 characters).
-
The
default is retrieved from the MEP identified by the MPID if the
cos keyword
is not configured. If the
mpid keyword
is not configured, the default is the highest priority on the egress interface.
|
|
source
source-mpid
|
(Optional) Specifies an MEP’s CoS that will be sent in Ethernet CFM messages.
Source MPID value range: 1 to 819.
|
|
de
|
(Optional) Specifies whether the packet is drop-eligible. The
de option is
platform-dependent.
|
|
pad
|
(Optional) Specifies padding data type, length, value (TLV) .
|
|
data-pattern
|
(Optional) The data pattern of data TLV in hexadecimal format.
|
|
test
|
(Optional) Specifies test TLV.
|
|
pattern-type
pattern-value
|
(Optional) Specifies a pattern type for loopback messages, allowing you to use
Test TLV in one-line command format. Pattern value for loopback messages:
-
0:
Null signal without CRC-32
-
1:
Null signal with CRC-32
-
2:
PRBS 2 (-31) without CRC-32
-
3:
PRBS 2 (-31) with CRC-32
|
|
validate
|
(Optional) Specifies that the reply data is validated.
|
|
level
|
Indicates that a maintenance level is specified.
|
|
level-id
|
Number
from 0 to 7 that indicates the maintenance level.
|
Command Default
A CFM ping
operation to the specified MEP and MIP is performed.
Command Modes
Privileged EXEC
(#)
Command History
|
Release
|
Modification
|
|
12.2(33)SXI2
|
This
command was introduced.
|
|
12.2(33)SRE
|
This
command was integrated into Cisco IOS Release 12.2(33)SRE.
|
|
15.1(1)T
|
This
command was integrated into Cisco IOS Release 15.1(1)T.
|
|
15.2(1)S
|
This
command was integrated into Cisco IOS Release 15.2(1)S. The
service icc keyword was added to provide support for the
ICC-based MEG identifier.
|
|
Cisco
IOS XE Release 3.5S
|
This
command was integrated into Cisco IOS XE Release 3.5S.
|
|
Cisco
IOS XE Release 3.7S
|
This
command was modified.
|
|
15.1(2)SNG
|
This
command was implemented on the Cisco ASR 901 Series Aggregation Services
Router.
|
|
Cisco IOS 15.4(3)S
|
This command was implemented on Cisco ME 2600X Series
Ethernet Access Switches.
|
Usage Guidelines
Use this command
to test connectivity between MEPs.
If the continuity
check database does not have entries for the specified MPID, an error message
is displayed notifying you to use the
ping
ethernet
mac-address command instead.
If a domain name
is more than 154 characters in length, a warning message is displayed notifying
you that the maintenance domain ID (MDID) will be truncated to 43 characters in
continuity check messages (CCMs) if “id <fmt> <MDID>” is not
configured.
This command can
be issued by specifying keywords and arguments as one command or as an extended
command in which you specify options line by line.
The CFM ping
(loopback) supports up to 1488 bytes.
In Cisco IOS XE
Release 3.7S and later releases, support for ITU-T Y.1731 CFM Test TLV allows
you to specify one of four pattern values for loopback messages:
-
0: Null
signal without 32-bit cyclic redundancy check codes (CRC-32)
-
1: Null
signal with CRC-32
-
2:
Pseudorandom bit sequences (PRBS) 2 (-31) without CRC-32
-
3: PRBS 2
(-31) with CRC-32
Null signal means
padding 0 for the payload of the Test TLV.
You can initiate
the loopback message with Test TLV either by specifying the
pad test
pattern-type
keyword in the one-line command format or using the extended
command format, as shown in the examples.
You can also use
Test TLV to validate the packet data on the initiator side.
For Cisco ASR 901
Series Aggregation Services Routers, if a domain name has more than 43
characters, a warning message is displayed notifying you that the maintenance
domain ID (MDID) will be truncated to 43 characters in continuity check
messages (CCMs) if “id <fmt> <MDID>” is not configured.
Examples
The following
example shows how to send an Ethernet CFM loopback message to a destination MEP
using the extended command format:
Device# ping
Protocol [ip]: ethernet
Multicast [n] :
Mac Address : 0015.6215.46d0
Maintenance Domain : vik-vfi-ofm
Use short-MA-name [n]: y
Short-MA-name format(text, vlan-id, number, vpn-id) [text]:
Short-MA-name: zzz
Source MPID [555]:
Repeat Count [5]:
Datagram Size [100]: 9000
% A decimal number between 64 and 1488.
Datagram Size [100]:
Timeout in seconds [5]:
Interval in seconds [0]:
Extended commands [n]:
Type escape sequence to abort.
Sending 5 Ethernet CFM loopback messages to 0015.6215.46d0, timeout is 5 seconds:!!!!!
Success rate is 100 percent (5/5), round-trip min/avg/max = 1/3/8 ms
Device# ping
Protocol [ip]: ethernet
Multicast [n] :
Mac Address : 0015.637b.4e00
Maintenance Domain : CUSTOMER
Use short-MA-name [n]: y
Short-MA-name format(text, vlan-id, number, vpn-id) [text]:
Short-MA-name: zzz
Source MPID [2345]:
Repeat Count [5]:
Datagram Size [100]: 9000
% A decimal number between 64 and 1488.
Datagram Size [100]:
Timeout in seconds [5]:
Interval in seconds [0]:
Extended commands [n]:
Type escape sequence to abort.
Sending 5 Ethernet CFM loopback messages to 0015.637b.4e00, timeout is 5 seconds:!!!!!
Success rate is 100 percent (5/5), round-trip min/avg/max = 1/2/4 ms
The table below
describes the significant fields in the display.
Table 1. ping ethernet Field Descriptions
|
Field
|
Description
|
|
Protocol
[ip]
|
Protocol
name. The value within the brackets indicates the default value. If no value is
specified, the default is considered.
|
|
Multicast
[n]
|
Specifies
a multipoint address. The value within the brackets indicates the default
value. If no value is specified, the default is considered.
|
|
MAC
Address
|
MAC
address of the interface.
|
|
Maintenance Domain
|
Specifies
the maintenance domain.
|
|
Short-MA-name
|
Specifies
the short MA name.
|
|
Source
MPID [555]
|
Specifies
a maintenance point identifier. The value within the brackets indicates the
default value (555).
|
|
Repeat
Count [5]
|
Number of
ping packets that are sent to the destination address. The value within the
brackets indicates the default value (5).
|
|
Datagram
Size [100]
|
Size of
the ping packet (in bytes). The value within the brackets indicates the default
value (100).
|
|
Timeout
in seconds [5]
|
Timeout
(in seconds). The ping is declared successful only if the ECHO REPLY packet is
received before the time interval. The value within the brackets indicates the
default value (5).
|
|
Interval
in seconds [0]
|
Timeout
interval (in seconds). The value within the brackets indicates the default
value (0).
|
|
Extended
commands
|
Specifies
whether a series of additional commands appears.
|
The following
example shows how to initiate a loopback message with Test TLV using a one-line
command that specifies pattern type 0: NULL signal without CRC-32:
Device# ping ethernet mpid 2 domain yyy service zzz pad test pattern-type 0
Type escape sequence to abort.
Packet sent with test TLV type 0: NULL signal without CRC-32
Sending 5 Ethernet CFM loopback messages to aabb.cc00.6500, timeout is 5 seconds:!!!!!
Success rate is 100 percent (5/5), round-trip min/avg/max = 1/1/1 ms
The following
example shows how to initiate a loopback message using the extended command
format and not specifying Test TLV:
Device# ping
Protocol [ip]: ethernet
Multicast [n]:
Mac Address: aabb.cc00.6500
Maintenance Domain: yyy
Use short-MA-name [n]: y
Short-MA-name format(text, vlan-id, number, vpn-id) [text]:
Short-MA-name: zzz
Source MPID [1]:
Repeat Count [5]:
Datagram Size [100]:
Timeout in seconds [5]:
Interval in seconds [0]:
Extended commands [n]: y
Class of Service [2]:
Set DE bit? [no]:
Validate reply data? [no]:
Test TLV? [no]:
Data pattern [0xABCD]:
Sweep range of sizes [n]:
Type escape sequence to abort.
Packet has data pattern 0xABCD
Sending 5 Ethernet CFM loopback messages to aabb.cc00.6500, timeout is 5 seconds:!!!!!
Success rate is 100 percent (5/5), round-trip min/avg/max = 1/1/1 ms
The following
example shows how to initiate a loopback message using the extended command
format and specifying Test TLV and pattern type 1: NULL signal with CRC-32:
Device# ping
Protocol [ip]: ethernet
Multicast [n]:
Mac Address: aabb.cc00.6500
Maintenance Domain: yyy
Use short-MA-name [n]: y
Short-MA-name format(text, vlan-id, number, vpn-id) [text]:
Short-MA-name: zzz
Source MPID [1]:
Repeat Count [5]:
Datagram Size [100]:
Timeout in seconds [5]:
Interval in seconds [0]:
Extended commands [n]: y
Class of Service [2]:
Set DE bit? [no]:
Validate reply data? [no]:
Test TLV? [no]: yes
Pattern Type (0: NULL, 1: PRBS) [0]: 0
Pattern Type with CRC? [no]: yes
Sweep range of sizes [n]:
Type escape sequence to abort.
Packet sent with test TLV type 1: NULL signal with CRC-32
Sending 5 Ethernet CFM loopback messages to aabb.cc00.6500, timeout is 5 seconds:!!!!!
Success rate is 100 percent (5/5), round-trip min/avg/max = 1/1/1 ms
The following
example shows how to initiate a loopback message using the extended command
format, specifying Test TLV and pattern type 3: PRBS 2(-31) with CRC-32, and
also specifying that the packet is validated:
Device# ping
Protocol [ip]: ethernet
Multicast [n]:
Mac Address: aabb.cc00.6500
Maintenance Domain: yyy
Use short-MA-name [n]: y
Short-MA-name format(text, vlan-id, number, vpn-id) [text]:
Short-MA-name: zzz
Source MPID [1]:
Repeat Count [5]:
Datagram Size [100]:
Timeout in seconds [5]:
Interval in seconds [0]:
Extended commands [n]: y
Class of Service [2]:
Set DE bit? [no]:
Validate reply data? [no]: yes
Test TLV? [no]: yes
Pattern Type (0: NULL, 1: PRBS) [0]: 1
Pattern Type with CRC? [no]: yes
Sweep range of sizes [n]:
Type escape sequence to abort.
Packet sent with test TLV type 3: PRBS 2^(-31) with CRC-32
Reply data will be validated
Sending 5 Ethernet CFM loopback messages to aabb.cc00.6500, timeout is 5 seconds:!!!!!
Success rate is 100 percent (5/5), round-trip min/avg/max = 1/1/1 ms
The following
examples show how to send an Ethernet CFM loopback message to a destination MEP
using the "extended ping" format for Cisco ASR 901 Series Aggregation Services
Routers:
Router# ping
Protocol [ip]: ethernet
Mac Address : aabb.cc03.bb99
Maintenance Domain : Domain_L5
VLAN [9]:
Source MPID [220]:
Repeat Count [5]:
Datagram Size [100]:
Timeout in seconds [5]:
Interval in seconds [0]:
Extended commands [n]:
Type escape sequence to abort.
Sending 5 Ethernet CFM loopback messages to aabb.cc03.bb99, timeout is 5 seconds:!!!!!
Success rate is 100 percent (5/5), round-trip min/avg/max = 1/2/4 ms
Router# ping
Protocol [ip]: ethernet
Multicast [n] : y
Maintenance Domain : Domain_L5
VLAN [9]:
Source MPID [220]:
Datagram Size [100]:
Timeout in seconds [5]:
Interval in seconds [0]:
Extended commands [n]:
Type escape sequence to abort.
Sending 5 Ethernet CFM loopback messages to 0180.c200.0035, timeout is 5 seconds:
Reply to Multicast request from aabb.cc03.bb99, 0 ms
Total Remote MEPs replied: 1
Feedback