IP SLAs for MPLS Psuedo Wire via VCCV

This module describes how to configure IP Service Level Agreements (SLAs) for MPLS Pseudo Wire (PWE3) via Virtual Circuit Connectivity Verification (VCCV) to schedule pseudo-wire ping operations and provide monitoring and alerts for round trip time (RTT), failure, and connection threshold violations via SNMP Traps.

Finding Feature Information

Your software release may not support all the features documented in this module. For the latest caveats and feature information, see Bug Search Tool and the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the feature information table.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/​go/​cfn. An account on Cisco.com is not required.

Restrictions for IP SLAs for MPLS Pseudo Wire via VCCV

LSP discovery is not supported for IP SLAs VCCV operations.

Information About IP SLAs for MPLS Pseudo Wire via VCCV

IP SLAs VCCV Operation

The IP SLAs VCCV operation supports Virtual Circuit Connectivity Verification (VCCV) for Pseudo-Wire Emulation Edge-to-Edge (PWE3) services across MPLS networks. The IP SLAs VCCV operation type is based on the ping mpls pseudowire command, which checks MPLS LSP connectivity across an Any Transport over MPLS (AToM) virtual circuit (VC) by sending a series of pseudo-wire ping operations to the specified destination PE router.

When MPLS LSP connectivity checking is performed through an IP SLAs VCCV operation (rather than through the ping mpls command with the pseudowire keyword), you can use the IP SLA proactive threshold monitoring and multioperation scheduling capabilities:

The LSP discovery option does not support the IP SLAs VCCV operation.

Proactive Threshold Monitoring for the LSP Health Monitor

Proactive threshold monitoring support for the LSP Health Monitor feature provides the capability for triggering SNMP trap notifications and syslog messages when user-defined reaction conditions (such as a connection loss or timeout) are met. Configuring threshold monitoring for an LSP Health Monitor operation is similar to configuring threshold monitoring for a standard IP SLAs operation.

LSP Discovery Option Enabled

If the LSP discovery option for an LSP Health Monitor operation is enabled, SNMP trap notifications can be generated when one of the following events occurs:

  • LSP discovery for a particular BGP next hop neighbor fails.

  • Operational status of an LSP discovery group changes.

Possible reasons for which LSP discovery can fail for a particular BGP next hop neighbor are as follows:

  • Expiration of time allowed for a BGP next hop neighbor to respond to an LSP discovery request.

  • Return code is “Broken” or “Unexplorable” for all paths leading to the BGP next hop neighbor.

The table below describes the conditions for which the operational status of an LSP discovery group can change. Whenever an individual IP SLAs LSP ping operation of an LSP discovery group is executed, a return code is generated. Depending on the value of the return code and the current status of the LSP discovery group, the group status can change.

Table 1 Conditions for Which an LSP Discovery Group Status Changes

Individual IP SLAs Operation Return Code

Current Group Status = UP

Current Group Status = PARTIAL

Current Group Status = DOWN

OK

No group status change.

If return codes for all paths in the group are OK, then the group status changes to UP.

Group status changes to PARTIAL.

Broken or Unexplorable

Group status changes to PARTIAL.

If return codes for all paths in the group are Broken or Unexplorable, then the group status changes to DOWN.

No group status change.

The return code for an individual IP SLAs LSP ping operation can be one of the following:

  • OK--Indicates that the LSP is working properly. The customer VPN traffic will be sent across this path.

  • Broken--Indicates that the LSP is broken. Customer VPN traffic will not be sent across this path and may be discarded.

  • Unexplorable--Indicates that not all the paths to this PE neighbor have been discovered. This may be due to a disruption along the LSP or because the number of 127/8 IP addresses used for LSP selection has been exhausted.

The status of an LSP discovery group can be one of the following:

  • UNKNOWN--Indicates that group status has not yet been determined and that the paths belonging to the group are in the process of being tested for the first time. Once this initial test is complete, the group status will change to UP, PARTIAL, or DOWN.

  • UP--Indicates that all the paths within the group are active and no operation failures have been detected.

  • PARTIAL--Indicates that an operation failure has been detected for one or more, but not all, of the paths within the group.

  • DOWN--Indicates that an operation failure has been detected for all the paths within the group.

Secondary Frequency Option

With the introduction of the LSP Health Monitor feature, a new threshold monitoring parameter has been added that allows you to specify a secondary frequency. If the secondary frequency option is configured and a failure (such as a connection loss or timeout) is detected for a particular path, the frequency at which the path is remeasured will increase to the secondary frequency value (testing at a faster rate). When the configured reaction condition is met (such as N consecutive connection losses or N consecutive timeouts), an SNMP trap and syslog message can be sent and the measurement frequency will return to its original frequency value.

How to Configure IP SLAs for MPLS Pseudo Wire via VCCM

Manually Configuring and Scheduling an IP SLAs VCCV Operation

SUMMARY STEPS

    1.    enable

    2.    configure terminal

    3.    ip sla operation-number

    4.    mpls lsp ping pseudowire peer-ipaddr vc-id [source-ipaddr source-ipaddr]

    5.    exp exp-bits

    6.    frequency seconds

    7.    request-data-size bytes

    8.    secondary-frequency {both | connection-loss | timeout} frequency

    9.    tag text

    10.    threshold milliseconds

    11.    timeout milliseconds

    12.    exit

    13.    ip sla reaction-configuration operation-number [react monitored-element] [threshold-type {never | immediate | consecutive [consecutive-occurrences] | xofy [x-value y-value] | average [number-of-probes]}] [threshold-value upper-threshold lower-threshold] [action-type {none | trapOnly | triggerOnly | trapAndTrigger}]

    14.    ip sla logging traps

    15.    ip sla schedule operation-number [life {forever | seconds}] [start-time {hh : mm[: ss] [month day | day month] | pending | now | after hh : mm : ss}] [ageout seconds] [recurring]

    16.    exit


DETAILED STEPS
     Command or ActionPurpose
    Step 1 enable


    Example:
    Router> enable
     

    Enables privileged EXEC mode.

    • Enter your password if prompted.

     
    Step 2 configure terminal


    Example:
    Router# configure terminal
     

    Enters global configuration mode.

     
    Step 3 ip sla operation-number


    Example:
    Router(config)# ip sla 777 
     

    Begins configuring an IP SLAs operation and enters IP SLA configuration mode.

     
    Step 4 mpls lsp ping pseudowire peer-ipaddr vc-id [source-ipaddr source-ipaddr]


    Example:
    Router(config-ip-sla)# mpls lsp ping 
    pseudowire 192.168.1.103 123 source-ipaddr 192.168.1.102
     

    Configures the IP SLAs operation as an LSP pseudo-wire ping and enters VCCV configuration mode.

     
    Step 5 exp exp-bits


    Example:
    
    
            


    Example:
    Router(config-sla-vccv)# exp 5
     

    (Optional) Specifies the experimental field value in the header for an echo request packet of an IP SLAs operation.

     
    Step 6 frequency seconds


    Example:
    Router(config-sla-vccv)# frequency 120 
     

    (Optional) Specifies the rate at which a specified IP SLAs operation repeats.

     
    Step 7 request-data-size bytes


    Example:
    Router(config-sla-vccv)# request-data-size 200
     

    (Optional) Specifies the protocol data size for a request packet of an IP SLAs operation.

     
    Step 8 secondary-frequency {both | connection-loss | timeout} frequency


    Example:
    Router(config-sla-vccv)# secondary-frequency connection-loss 10
     

    (Optional) Sets the faster measurement frequency (secondary frequency) to which an IP SLAs operation should change when a reaction condition occurs.

     
    Step 9 tag text


    Example:
    Router(config-sla-vccv)# tag testgroup
     

    (Optional) Creates a user-specified identifier for an IP SLAs operation.

     
    Step 10 threshold milliseconds


    Example:
    
    
            


    Example:
    Router(config-sla-vccv)# threshold 6000
     

    (Optional) Sets the upper threshold value for calculating network monitoring statistics created by an IP SLAs operation.

     
    Step 11 timeout milliseconds


    Example:
    Router(config-sla-vccv)# timeout 7000
     

    (Optional) Specifies the amount of time the IP SLAs operation waits for a response from its request packet.

     
    Step 12 exit


    Example:
    Router(config-sla-vccv)# exit
     

    Exits VCCV configuration mode and returns to global configuration mode.

     
    Step 13 ip sla reaction-configuration operation-number [react monitored-element] [threshold-type {never | immediate | consecutive [consecutive-occurrences] | xofy [x-value y-value] | average [number-of-probes]}] [threshold-value upper-threshold lower-threshold] [action-type {none | trapOnly | triggerOnly | trapAndTrigger}]


    Example:
    Router(config)# ip sla reaction-configuration 777 react connectionLoss threshold-type consecutive 3 action-type traponly
     

    (Optional) Configures certain actions to occur based on events under the control of Cisco IOS IP SLAs.

     
    Step 14 ip sla logging traps


    Example:
    Router(config)# ip sla logging traps
     

    (Optional) Enables the generation of SNMP system logging messages specific to IP SLAs trap notifications.

     
    Step 15 ip sla schedule operation-number [life {forever | seconds}] [start-time {hh : mm[: ss] [month day | day month] | pending | now | after hh : mm : ss}] [ageout seconds] [recurring]


    Example:
    Router(config)# ip sla schedule 777 life forever start-time now
     

    Configures the scheduling parameters for an IP SLAs operation.

     
    Step 16 exit


    Example:
    Router(config)# exit
     

    Exits global configuration submode and returns to privileged EXEC mode.

     

    Troubleshooting Tips

    Use the debug ip sla trace and debug ip sla error commands to help troubleshoot issues with an individual IP SLAs PWE3 service via VCCV operation.

    What to Do Next

    To display the results of an individual IP SLAs operation use the show ip sla statistics and show ip sla statistics aggregated commands. Checking the output for fields that correspond to criteria in your service level agreement will help you determine whether the service metrics are acceptable.

    Configuration Examples for IP SLAs for MPLS Pseudo Wire via VCCM

    Example Manually Configuring an IP SLAs VCCV Operation

    The following example shows how to manually configure an IP SLAs VCCV operation in conjunction with the proactive threshold monitoring and multioperation scheduling capabilities of the LSP Health Monitor.

    In this example, a VC with the identifier 123 has already been established between the PE device and its peer at IP address 192.168.1.103.

    IP SLAs VCCV operation 777 is configured with operation parameters and reaction conditions, and it is scheduled to begin immediately and run indefinitely.

    ip sla 777
     mpls lsp ping pseudowire 192.168.1.103 123 
      exp 5
      frequency 120
      secondary-frequency timeout 30
      tag testgroup
      threshold 6000
      timeout 7000
      exit
    !
     ip sla reaction-configuration 777 react rtt threshold-value 6000 3000 threshold-type immediate 3 action-type traponly 
     ip sla reaction-configuration 777 react connectionLoss threshold-type immediate action-type traponly
     ip sla reaction-configuration 777 react timeout threshold-type consecutive 3 action-type traponly
     ip sla logging traps
    !
     ip sla schedule 777 life forever start-time now
     exit

    RTT Thresholds

    The threshold command configures 6000 milliseconds as the amount of time for a rising threshold to be declared on the monitored pseudo-wire. The first ip sla reaction-configuration command specifies that an SNMP logging trap is to be sent immediately if the round-trip time violates the upper threshold of 6000 milliseconds or the lower threshold of 3000 milliseconds.

    Connection Loss

    The second ip sla reaction-configuration command specifies that an SNMP logging trap is to be sent immediately if a connection loss occurs for the monitored pseudo-wire.

    Response Timeout

    The timeout command configures 7000 seconds as the amount of time that VCCV operation 777 waits for a response from its request packet before a timeout is declared. The secondary-frequency command specifies that, if a timeout occurs, the measurement frequency of the operation repeats is to be increased from 120 seconds (the initial measurement frequency specified using the frequency command) to a faster rate of 30 seconds. The third ip sla reaction-configuration command specifies that an SNMP logging trap is to be sent if three consecutive timeouts occur.

    Additional References

    Related Documents

    Related Topic

    Document Title

    MPLS LSP discovery management tool

    "MPLS EM-MPLS LSP Multipath Tree Trace" chapter of the Multiprotocol Label Switching Configuration Guide

    Configuring standard IP access lists

    "Access Control Lists" chapter of the Security Configuration Guide: Securing the Data Plane guide

    Multioperation scheduling for IP SLAs

    "Configuring Multioperation Scheduling of IP SLAs Operations" chapter of the Cisco IOS P SLAs Configuration Guide

    Proactive threshold monitoring for IP SLAs

    " Configuring Proactive Threshold Monitoring of IP SLAs Operations" chapter of the Cisco IOS IP SLAs Configuration Guide

    Cisco IOS commands

    Cisco IOS Master Commands List, All Releases

    Cisco IOS IP SLAs commands

    Cisco IOS IP SLAs Command Reference

    Standards

    Standard

    Title

    draft-ietf-mpls-lsp-ping-09.txt

    Detecting MPLS Data Plane Failures

    draft-ietf-mpls-oam-frmwk-03.txt

    A Framework for MPLS Operations and Management (OAM)

    draft-ietf-mpls-oam-requirements-06.txt

    OAM Requirements for MPLS Networks

    MIBs

    MIB

    MIBs Link

    CISCO-RTTMON-MIB

    To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL:

    http:/​/​www.cisco.com/​go/​mibs

    RFCs

    RFC

    Title

    No new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature.

    --

    Technical Assistance

    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.

    http:/​/​www.cisco.com/​cisco/​web/​support/​index.html

    Related Information

    Feature Information for IP SLAs for MPLS PWE3 via VCCM

    The following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.

    Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/​go/​cfn. An account on Cisco.com is not required.
    Table 2 IP SLAs for MPLS PWE3 via VCCM

    Feature Name

    Releases

    Feature Information

    IP SLAs for MPLS Pseudo Wire (PWE3) via VCCM

    12(33)SB

    12.2(33)SRC

    15.0(1)S

    Cisco IOS XE 3.1.0SG

    The IP SLAs VCCV operation was added to support Virtual Circuit Connectivity Verification (VCCV) for Pseudo-Wire Emulation Edge-to-Edge (PWE3) services across MPLS networks.