Prerequisites for ITU-T Y.1731 Operations
Note |
Y1731 is supported on Port Channel interfaces. |
The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This module describes how to configure an IP SLAs Metro-Ethernet 3.0 (ITU-T Y.1731) operation to gather the following performance measurements for Ethernet service:
Ethernet Delay
Ethernet Delay Variation
Ethernet Frame Loss Ratio
Note |
Y1731 is supported on Port Channel interfaces. |
SNMP is not supported for reporting threshold events or collecting performance statistics for IP SLAs Metro-Ethernet 3.0 (ITU-T Y.1731) operations.
SNMP is partially supported; the results for DM/LM can be polled for some attributes. However MIB support for all parameters is not supported.
Continuity Check Message (CCM)-based dual-ended Ethernet frame loss operations are not supported.
In a single-ended Ethernet operation, performance measurement statistics can be retrieved only at the device on which the sender Ethernet Connectivity Fault Management (CFM) Maintenance End Point (MEP) is configured.
To avoid losing the CoS value configured on the frames, do not configure rewrite on the EFPs throughout the Layer2 circuit. The CoS value is preserved, if the Y.1731 frames are marked with specific CoS value.
CFM over cross-connect on the routers works only if the control-word is configured. To start DM timestamping, switch ON the control-word if the remote end is not switched ON.
Note |
RSP3 module does not support Y1731 DMM when all the below configurations are enabled together on the router:
|
To avoid errors in RX and TX timestamping, ensure to have Y1731 sender as primary PTP, and the Y1731 responder as subordinate PTP.
Reconfigure IP SLA Y1731 while doing online insertion removal (OIR) of IM or router reload because local MEP is deleted during the course.
A delay may be observed after issuing the ip sla schedule command after a reload of the router is performed, to populate with the Y.1731 PM measurements.
The dot1q tag contains class of service (CoS) bits, which are used by IPSLA Y.1731 PM session to test delay or loss of packets with a specific CoS. This CoS cannot be a non-zero value when using EPM over untagged EFPs.
Perform the tasks for configuring a dual-ended operation in the order presented.
Note |
To remove the MEP configurations in an already-configured dual-ended operation, always remove the MEPs in the reverse order in which they were configured. That is, remove the scheduler first, then the threshold monitoring configuration, and then the sender MEP configuration on the source device before removing the scheduler, proactive threshold monitoring, and receiver MEP configuration on the destination device. |
Time synchronization is required between the source and destination devices in order to provide accurate one-way delay (latency) or delay-variation measurements. Configure either Precision Time Protocol (PTP) or Network Time Protocol (NTP) on both the source and destination devices.
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 |
enable Example:
|
Enables privileged EXEC mode.
|
||
Step 2 |
configure terminal Example:
|
Enters global configuration mode. |
||
Step 3 |
ip sla operation-number Example:
|
Begins configuring an IP SLAs operation and enters IP SLA configuration mode. |
||
Step 4 |
ethernet y1731 delay receive 1DM domain domain-name {evc evc-id | vlan vlan-id} cos cos {mpid source-mp-id | mac-address source-address} Example:
|
|
||
Step 5 |
aggregate interval seconds Example:
|
(Optional) Configures the length of time during which the performance measurements are conducted and the results stored. |
||
Step 6 |
distribution {delay | delay-variation} one-way number-of-bins boundary[,...,boundary] Example:
|
(Optional) Specifies measurement type and configures bins for statistics distributions kept. Allowed number of bin upper boundaries : 9. This is applicable only for NCS 4202. |
||
Step 7 |
frame offset offset-value Example:
|
(Optional) Sets the value for calculating delay variation rates. |
||
Step 8 |
history interval intervals-stored Example:
|
(Optional) Sets the number of statistics distributions kept during the lifetime of an IP SLAs Ethernet operation. |
||
Step 9 |
max-delay milliseconds Example:
|
(Optional) Sets the amount of time an MEP waits for a frame. |
||
Step 10 |
owner owner-id Example:
|
(Optional) Configures the owner of an IP SLAs operation. |
||
Step 11 |
end Example:
|
Exits to privileged EXEC mode. |
To add proactive threshold conditions and reactive triggering for generating traps, see the "Configuring Proactive Threshold Monitoring" module of the IP SLAs Configuration Guide.
When you are finished configuring proactive threshold monitoring for this MEP, see the "Scheduling IP SLAs Operations" section to schedule the operation.
Time synchronization is required between the source and destination devices in order to provide accurate one-way delay (latency) or delay-variation measurements. Configure either Precision Time Protocol (PTP) or Network Time Protocol (NTP) on both the source and destination devices.
The receiver MEP must be configured, including proacive threshold monitoring, and scheduled before you configure the sender MEP.
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 |
enable Example:
|
Enables privileged EXEC mode.
|
||
Step 2 |
configure terminal Example:
|
Enters global configuration mode. |
||
Step 3 |
ip sla operation-number Example:
|
Begins configuring an IP SLAs operation and enters IP SLA configuration mode. |
||
Step 4 |
ethernet y1731 delay 1DM domain domain-name {evc evc-id | vlan vlan-id} {mpid target-mp-id | mac-address target-address} cos cos {source {mpid source-mp-id | mac-address source-address}} Example:
|
Begins configuring a dual-ended Ethernet delay operation and enters IP SLA Y.1731 delay configuration mode.
|
||
Step 5 |
aggregate interval seconds Example:
|
(Optional) Configures the length of time during which the performance measurements are conducted and the results stored. |
||
Step 6 |
frame interval milliseconds Example:
|
(Optional) Sets the gap between successive frames. |
||
Step 7 |
frame size bytes Example:
|
(Optional) Sets the padding size for frames. |
||
Step 8 |
history interval intervals-stored Example:
|
(Optional) Sets the number of statistics distributions kept during the lifetime of an IP SLAs Ethernet operation. |
||
Step 9 |
owner owner-id Example:
|
(Optional) Configures the owner of an IP SLAs operation. |
||
Step 10 |
end Example:
|
Exits to privileged EXEC mode. |
To add proactive threshold conditions and reactive triggering for generating traps, see the "Configuring Proactive Threshold Monitoring" module of the IP SLAs Configuration Guide.
When you are finished configuring proactive threshold monitoring for this MEP, see the "Scheduling IP SLAs Operations" section to schedule the operation.
Perform this task to configure a sender MEP on the source device.
Time synchronization is required between the source and destination devices in order to provide accurate one-way delay (latency) or delay-variation measurements. Configure either Precision Time Protocol (PTP) or Network Time Protocol (NTP) on both the source and destination devices.
Note |
To display information about remote (target) MEPs on destination devices, use the show ethernet cfm maintenance-points remote command. |
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 |
enable Example:
|
Enables privileged EXEC mode.
|
||
Step 2 |
configure terminal Example:
|
Enters global configuration mode. |
||
Step 3 |
ip sla operation-number Example:
|
Begins configuring an IP SLAs operation and enters IP SLA configuration mode. |
||
Step 4 |
ethernet y1731 delay {DMM | DMMv1} [burst] domain domain-name {evc evc-id | vlan vlan-id} {mpid target-mp-id | mac-address target-address} cos cos {source {mpid source-mp-id | mac-address source-address}} Example:
|
Begins configuring a single-ended Ethernet delay operation and enters IP SLA Y.1731 delay configuration mode.
|
||
Step 5 |
clock sync Example:
|
(Optional) Indicates that the end points are synchronized and thus allows the operation to calculate one-way delay measurements. |
||
Step 6 |
aggregate interval seconds Example:
|
(Optional) Configures the length of time during which the performance measurements are conducted and the results stored.
|
||
Step 7 |
distribution {delay | delay-variation} one-way number-of-bins boundary[,...,boundary] Example:
|
(Optional) Specifies measurement type and configures bins for statistics distributions kept. Allowed number of bin upper boundaries : 9. This is applicable only for NCS 4202. |
||
Step 8 |
frame interval milliseconds Example:
|
(Optional) Sets the gap between successive frames. |
||
Step 9 |
frame offset offset-value Example:
|
(Optional) Sets value for calculating delay variation values. |
||
Step 10 |
frame size bytes Example:
|
(Optional) Configures padding size for frames. |
||
Step 11 |
history interval intervals-stored Example:
|
(Optional) Sets the number of statistics distributions kept during the lifetime of an IP SLAs Ethernet operation. |
||
Step 12 |
max-delay milliseconds Example:
|
(Optional) Sets the amount of time an MEP waits for a frame. |
||
Step 13 |
owner owner-id Example:
|
(Optional) Configures the owner of an IP SLAs operation. |
||
Step 14 |
end Example:
|
Exits to privileged EXEC mode. |
To add proactive threshold conditions and reactive triggering for generating traps, see the "Configuring Proactive Threshold Monitoring" module of the IP SLAs Configuration Guide.
When you are finished configuring proactive threshold monitoring for this operation, see the "Scheduling IP SLAs Operations" section to schedule the operation.
Note |
To display information about remote (target) MEPs on destination devices, use the show ethernet cfm maintenance-points remote command. |
Perform this task to configure a sender MEP on the source device.
Class of Service (CoS)-level monitoring must be enabled on MEPs associated to the Ethernet frame loss operation by using the monitor loss counter command on the devices at both ends of the operation. See the Cisco IOS Carrier Ethernet Command Reference for command information. See the "Configuration Examples for IP SLAs Metro-Ethernet 3.0 (ITU-T Y.1731) Operations" section for configuration information.
Note |
Cisco IOS Y.1731 implementation allows monitoring of frame loss for frames on an EVC regardless of the CoS value (any CoS or Aggregate CoS cases). See the "Configuration Examples for IP SLAs Metro-Ethernet 3.0 (ITU-T Y.1731) Operations" section for configuration information. |
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 |
enable Example:
|
Enables privileged EXEC mode.
|
||
Step 2 |
configure terminal Example:
|
Enters global configuration mode. |
||
Step 3 |
ip sla operation-number Example:
|
Begins configuring an IP SLAs operation and enters IP SLA configuration mode. |
||
Step 4 |
ethernet y1731 loss {LMM | SLM} [burst] domain domain-name {evc evc-id | vlan vlan-id} {mpid target-mp-id | mac-address target-address} CoS CoS {source {mpid source-mp-id | mac-address source-address}} Example:
|
Begins configuring a single-ended Ethernet frame loss ratio operation and enters IP SLA Y.1731 loss configuration mode.
|
||
Step 5 |
aggregate interval seconds Example:
|
(Optional) Configures the length of time during which performance measurements are conducted and the results stored. |
||
Step 6 |
availability algorithm {sliding-window | static-window} Example:
|
(Optional) Specifies availability algorithm used. |
||
Step 7 |
frame consecutive value Example:
|
(Optional) Specifies number of consecutive measurements to be used to determine availability or unavailability status. |
||
Step 8 |
frame interval milliseconds Example:
|
(Optional) Sets the gap between successive frames. |
||
Step 9 |
history interval intervals-stored Example:
|
(Optional) Sets the number of statistics distributions kept during the lifetime of an IP SLAs Ethernet operation. |
||
Step 10 |
owner owner-id Example:
|
(Optional) Configures the owner of an IP SLAs operation. |
||
Step 11 |
exit Example:
|
Exits to IP SLA configuration mode. |
||
Step 12 |
exit Example:
|
Exits to global configuration mode. |
||
Step 13 |
exit Example:
|
Exits to privileged EXEC mode. |
When you are finished configuring this MEP, see the "Scheduling IP SLAs Operations" section to schedule the operation.
Command or Action | Purpose | |
---|---|---|
Step 1 |
enable Example:
|
Enables privileged EXEC mode.
|
Step 2 |
configure terminal Example:
|
Enters global configuration mode. |
Step 3 |
Enter one of the following commands:
Example:
|
|
Step 4 |
end Example:
|
Exits global configuration mode and returns to privileged EXEC mode. |
Step 5 |
show ip sla group schedule Example:
|
(Optional) Displays IP SLAs group schedule details. |
Step 6 |
show ip sla configuration Example:
|
(Optional) Displays IP SLAs configuration details. |
Perform additional NTP Time Of Day synchronization configuration when NTP is chosen for time synchronization for one-way delay or delay-variation measurements on source and destination devices.
Note |
PTP should not be configured when NTP Time Of Day synchronization is used as they are mutually-exclusive configuration options for time synchronization. |
For information on configuring NTP, see Configuring NTP section in Cisco IOS Network Management Configuration Guide.
Command or Action | Purpose | |
---|---|---|
Step 1 |
enable Example:
|
Enables privileged EXEC mode.
|
Step 2 |
configure terminal Example:
|
Enters global configuration mode. |
Step 3 |
platfrom time-source ntp Example:
|
Initiates Time of Day (ToD) synchronization on the ethernet ports. |
Step 4 |
exit Example:
|
|
The following sample output shows the configuration, including default values, of a receiver MEP on the responder device for a dual-ended Ethernet delay or delay variation operation:
Device# show ip sla configuration 501
IP SLAs Infrastructure Engine-III
Entry number: 501
Owner: admin
Tag:
Operation timeout (milliseconds): 5000
Ethernet Y1731 Delay Operation
Frame Type: 1DM
Domain: xxx
ReceiveOnly: TRUE
Evc: yyy
Local Mpid: 101
CoS: 3
Max Delay: 5000
Threshold (milliseconds): 5000
.
.
.
Statistics Parameters
Aggregation Period: 900
Frame offset: 1
Distribution Delay One-Way:
Number of Bins 10
Bin Boundaries: 5000,10000,15000,20000,25000,30000,35000,40000,45000,-1
Distribution Delay-Variation One-Way:
Number of Bins 10
Bin Boundaries: 5000,10000,15000,20000,25000,30000,35000,40000,45000,-1
History
Number of intervals: 2
The following sample output shows the configuration, including default values, of the sender MEP for a dual-ended IP SLAs Ethernet delay or delay variation operation:
Device# show ip sla configuration 500
IP SLAs Infrastructure Engine-III
Entry number: 500
Owner:
Tag:
Operation timeout (milliseconds): 5000
Ethernet Y1731 Delay Operation
Frame Type: 1DM
Domain: yyy
ReceiveOnly: FALSE
Evc: xxx
Target Mpid: 101
Source Mpid: 100
CoS: 3
Request size (Padding portion): 64
Frame Interval: 1000
Threshold (milliseconds): 5000
.
.
.
Statistics Parameters
Aggregation Period: 900
Frame offset: 1
History
Number of intervals: 22
The following sample output shows the performance monitoring session summary:
Device# show ethernet cfm pm session summary
Number of Configured Session : 2
Number of Active Session: 2
Number of Inactive Session: 0
The following sample output shows the active performance monitoring session:
Device# show ethernet cfm pm session active
Display of Active Session
--------------------------------------------------------------------------------
EPM-ID SLA-ID Lvl/Type/ID/Cos/Dir Src-Mac-address Dst-Mac-address
--------------------------------------------------------------------------------
0 10 3/BD-V/10/2/Down d0c2.8216.c9d7 d0c2.8216.27a3
1 11 3/BD-V/10/3/Down d0c2.8216.c9d7 d0c2.8216.27a3
Total number of Active Session: 2
Device# show ethernet cfm pm session db 0
----------------------------------------------------------------------------
TX Time FWD RX Time FWD
TX Time BWD RX Time BWD Frame Delay
Sec:nSec Sec:nSec Sec:nSec
----------------------------------------------------------------------------
Session ID: 0
****************************************************************************
234:526163572 245:305791416
245:306761904 234:527134653 0:593
****************************************************************************
235:528900628 246:308528744
246:309452848 235:529825333 0:601
****************************************************************************
236:528882716 247:308511128
247:309450224 236:529822413 0:601
****************************************************************************
237:526578788 248:306207432
248:307157936 237:527529885 0:593
****************************************************************************
238:527052156 249:306681064
249:307588016 238:527959717 0:609
****************************************************************************
239:526625044 250:306254200
250:307091888 239:527463325 0:593
****************************************************************************
240:528243204 251:307872648
251:308856880 240:529228021 0:585
The following sample output shows the configuration, including default values, of the sender MEP for a single-ended IP SLAs Ethernet delay operation:
Router# show ip sla configuration 10
IP SLAs Infrastructure Engine-III
Entry number: 10
Owner:
Tag:
Operation timeout (milliseconds): 5000
Ethernet Y1731 Delay Operation
Frame Type: DMM
Domain: xxx
Vlan: yyy
Target Mpid: 101
Source Mpid: 100
CoS: 4
Max Delay: 5000
Request size (Padding portion): 64
Frame Interval: 1000
Clock: Not In Sync
Threshold (milliseconds): 5000
.
.
.
Statistics Parameters
Aggregation Period: 900
Frame offset: 1
Distribution Delay Two-Way:
Number of Bins 10
Bin Boundaries: 5000,10000,15000,20000,25000,30000,35000,40000,45000,-1
Distribution Delay-Variation Two-Way:
Number of Bins 10
Bin Boundaries: 5000,10000,15000,20000,25000,30000,35000,40000,45000,-1
History
Number of intervals: 2
The following output shows the configuration, including default values, of the sender MEP in a basic single-ended IP SLAs Ethernet frame loss ratio operation with a start-time of now:
Router# show ip sla configuration 11
IP SLAs Infrastructure Engine-III
Entry number: 11
Owner:
Tag:
Operation timeout (milliseconds): 5000
Ethernet Y1731 Loss Operation
Frame Type: LMM
Domain: xxx
Vlan: 12
Target Mpid: 34
Source Mpid: 23
CoS: 4
Request size (Padding portion): 0
Frame Interval: 1000
Schedule:
Operation frequency (seconds): 60 (not considered if randomly scheduled)
Next Scheduled Start Time: Start Time already passed
Group Scheduled : FALSE
Randomly Scheduled : FALSE
Life (seconds): 3600
Entry Ageout (seconds): never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): ActiveThreshold (milliseconds): 5000
Statistics Parameters
Aggregation Period: 900
Frame consecutive: 10
Availability algorithm: static-window
History
Number of intervals: 2
Use the show platform time-source command to display information on the time source.
Router# show platform time-source
Time Source mode : NTP not Configured
Router# show platform time-source
Time Source mode : NTP
NTP State : Not Synchronized
Router# show platform time-source
Time Source mode : NTP
NTP State : Synchronized
Related Topic |
Document Title |
---|---|
Cisco IOS Carrier Ethernet commands |
|
Cisco IOS IP SLAs commands |
|
Ethernet CFM |
“Configuring Ethernet Connectivity Fault Management in a Service Provider Network” module of the Cisco IOS Carrier Ethernet Configuration Guide |
Network Time Protocol (NTP) |
“Configuring NTP” module of the Cisco IOS Network Management Configuration Guide |
Proactive threshold monitoring for Cisco IOS IP SLAs |
“Configuring Proactive Threshold Monitoring of IP SLAs Operations” module of the Cisco IOS IP SLAs Configuration Guide |
Standard/RFC |
Title |
---|---|
ITU-T Y.1731 |
OAM functions and mechanisms for Ethernet-based networks |
No specific RFCs are supported by the features in this document. |
-- |
MIB |
MIBs Link |
---|---|
|
To locate and download MIBs for selected platforms, Cisco software releases, and feature sets, use Cisco MIB Locator found at the following URL: |
Description |
Link |
---|---|
The Cisco Support and Documentation website provides online resources to download documentation, software, and tools. Use these resources to install and configure the software and to troubleshoot and resolve technical issues with Cisco products and technologies. Access to most tools on the Cisco Support and Documentation website requires a Cisco.com user ID and password. |