Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Configuring an Iterator Profile

 

Use this topic to configure an iterator profile that periodically transmits SLA measurement packets for delay and loss measurement. You can also view and clear the iterator statistics, and configure a remote MEP with an iterator profile.

Configuring an Iterator Profile

You can create an iterator profile with its parameters to periodically transmit SLA measurement packets in the form of ITU-Y.1731-compliant frames for delay measurement or loss measurement.

To create an iterator profile:

  1. In configuration mode, go to the following hierarchy level:
  2. Configure the SLA measurement monitoring iterator:
  3. Configure an iterator profile—for example, i1:
  4. (Optional) Configure the cycle time, which is the amount of time (in milliseconds) between back-to-back transmission of SLA frames for one connection, with values from 10 through 3,600,000. The default value is 1000 ms.
  5. (Optional) Configure the iteration period, which indicates the maximum number of cycles per iteration (the number of connections registered to an iterator cannot exceed this value), with values from 1 through 2000. The default value is 2000.
  6. Configure the measurement type as loss measurement, statistical frame-loss measurement, or two-way delay measurement.
  7. (Optional) Configure the calculation weight for delay with values from 1 through 65,535. The default value is 1 (applicable only for two-way delay measurement).
  8. (Optional) Configure the calculation weight for delay variation with values from 1 through 65,535. The default value is 1 (applicable only for two-way delay measurement).
  9. (Optional) Configure the threshold value for average frame delay, in microseconds, for two-way Ethernet frame delay measurement (ETH-DM). When the configured threshold for average frame delay is exceeded, an SNMP trap is generated for ETH-DM. The range is from 1 through 4294967295 microseconds.
  10. (Optional) Configure the threshold value for average frame delay variation, in microseconds, for two-way Ethernet frame delay measurement (ETH-DM). When the configured threshold for average frame delay variationis exceeded, an SNMP trap is generated for ETH-DM. The range is from 1 through 4294967295 microseconds.
  11. (Optional) Configure the threshold value for average frame loss ratio, in milli-percent, in the upward or forward direction for Ethernet loss measurement (ETH-LM) and Ethernet synthetic loss measurement (ETH-SLM). When the configured threshold for average forward frame loss ratio is exceeded, an SNMP trap is generated for ETH-LM and ETH-SLM. The range is from 1 through 100000 milli-percent.
  12. (Optional) Configure the threshold value for average frame loss ratio, in milli-percent, in the backward or downstream direction for Ethernet loss measurement (ETH-LM) and Ethernet synthetic loss measurement (ETH-SLM). When the configured threshold for average backward frame loss ratio is exceeded, an SNMP trap is generated for ETH-LM and ETH-SLM. The range is from 1 through 100000 milli-percent.
  13. Configure the disable statement to stop the iterator (that is, disable the iterator profile).
  14. Verify the configuration.

Verifying the Configuration of an Iterator Profile

The following topics illustrate the configuration of an iterator profile for a two-way delay measurement, for loss measurement, and for a remote maintenance association end point (MEP). The topics also illustrate disabling an iterator profile with the disable statement for two-way measurement and deactivating an iterator profile with the deactivate command for a remote MEP.

Displaying the Configuration of an Iterator Profile for Two-way Delay Measurement

Purpose

Display the configuration of an iterator profile for two-way delay measurement as configured in the Configuring an Iterator Profile topic with the following values:

  • profile-namei1

  • cycle-time1000 milliseconds

  • iteration-period2000 cycles per second

  • delay1

  • delay-variation1:

Action

To display information about the iterator profile, run the show command at the [edit protocols oam ethernet connectivity-fault-management performance-monitoring sla-iterator-profiles] hierarchy level:

Meaning

The configuration for an iterator profile for two-way measurement is displayed as expected with set values.

Displaying the Configuration of an Iterator Profile for Loss Measurement

Purpose

Display the configuration of an iterator profile for loss measurement as configured in the Configuring an Iterator Profile topic with the following values:

  • profile-name12

  • cycle-time1000 milliseconds

  • iteration-period2000 cycles per second

Action

To display information about the iterator profile, run the show command at the [edit protocols oam ethernet connectivity-fault-management performance-monitoring sla-iterator-profiles] hierarchy level:

Meaning

The configuration for an iterator profile for loss measurement is displayed as expected with set values.

Displaying the Configuration of a Remote MEP with an Iterator Profile

Purpose

Display the configuration of a remoteMEP as configured in the Configuring a Remote MEP with an Iterator Profile topic with the following values:

  • profile-namei3

  • maintenance-domaindefault-1

  • maintenance-association1

  • short-name-format2octet

  • mep1

  • remote-mep1

  • data-tlv-size1

  • iteration-count1

  • priority1

Action

To display information about the remote MEP, run the show command at the [edit protocols oam ethernet connectivity-fault-management maintenance-domain default-1 maintenance association ma1 mep 1 remote-mep 1] hierarchy level:

Meaning

The configuration for a remote MEP for two-way measurement is displayed as expected with set values.

Disabling an Iterator Profile

Purpose

To disable an iterator profile for two-way delay measurement and for a remote MEP.

Action

  • To disable an iterator profile (for example, i1) with the disable configuration command for two-way measurement at the [edit protocols oam ethernet connectivity-fault-management performance-monitoring sla-iterator-profiles i1] hierarchy level:

  • To disable an iterator profile for a remote MEP (for example, i2) with the deactivate configuration command at the [edit protocols oam ethernet connectivity-fault-management maintenance-domain default-1 maintenance association ma1 mep 1 remote-mep 1] hierarchy level:

Managing Iterator Statistics

Displaying Iterator Statistics

Purpose

Retrieve and display iterator statistics.

Muliple iterators can be associated with a remote MEP. However, by default, only one result pertaining to one iterator profile is displayed.

Action

  • To display the iterator statistics for remote MEP 1 and iterator profile i1 with MEPs belonging to the maintenance association ma1 and within the maintenance domain default-1 (here, the iterator profile i1 is configured for two-way delay measurement):

    user@host> show oam ethernet connectivity-fault-management sla-iterator-statistics sla-iterator i1 maintenance-domain default-1 maintenance-association ma1 local-mep 1 remote-mep 1

    Output fields are listed in the approximate order in which they appear.

    Table 1: Displaying Iterator Statistics for Ethernet Delay Measurement Output Fields

    Output Field Name

    Output Field Description

    Maintenance domain

    Maintenance domain name.

    Level

    Maintenance domain level configured.

    Maintenance association

    Maintenance association name.

    Local MEP id

    Numeric identifier of the local MEP.

    Remote MEP id

    Numeric identifier of the remote MEP.

    Remote MAC address

    Unicast MAC address of the remote MEP.

    Iterator name

    Name of iterator.

    Iterator Id

    Numeric identifier of the iterator.

    Iterator cycle time

    Number of cycles (in milliseconds) taken between back-to-back transmission of SLA frames for this connection

    Iteration period

    Maximum number of cycles per iteration

    Iterator status

    Current status of iterator whether running or stopped.

    Infinite iterations

    Status of iteration as infinite or finite.

    Counter reset time

    Date and time when the counter was reset.

    Reset reason

    Reason to reset counter.

    Delay weight

    Calculation weight of delay.

    Delay variation weight

    Calculation weight of delay variation.

    DMM sent

    Delay measurement message (DMM) PDU frames sent to the peer MEP in this session.

    DMM skipped for threshold hit

    Number of DMM frames sent to the peer MEP in this session skipped during threshold hit.

    DMM skipped for threshold hit window

    Number of DMM frames sent to the peer MEP in this session skipped during the last threshold hit window.

    DMR received

    Number of delay measurement reply (DMR) frames received.

    DMR out of sequence

    Total number of DMR out of sequence packets received.

    DMR received with invalid time stamps

    Total number of DMR frames received with invalid timestamps.

    Average two-way delay

    Average two-way frame delay for the statistics displayed.

    Average two-way delay variation

    Average two-way “frame jitter” for the statistics displayed.

    Average one-way forward delay variation

    Average one-way forward delay variation for the statistics displayed in microseconds.

    Average one-way backward delay variation

    Average one-way backward delay variation for the statistics displayed in microseconds.

    Weighted average two-way delay

    Weighted average two-way delay for the statistics displayed in microseconds.

    Weighted average two-way delay variation

    Weighted average two-way delay variation for the statistics displayed in microseconds.

    Weighted average one-way forward delay variation

    Weighted average one-way forward delay variation for the statistics displayed in microseconds.

    Weighted average one-way backward delay variation

    Weighted average one-way backward delay variation for the statistics displayed in microseconds.

  • To display the iterator statistics for remote MEP 1 and iterator profile i2 with MEPs belonging to the maintenance association ma1 and within the maintenance domain default-1 (here, the iterator profile i1 is configured for loss measurement):

    user@host> show oam ethernet connectivity-fault-management sla-iterator-statistics sla-iterator i2 maintenance-domain default-1 maintenance-association ma1 local-mep 1 remote-mep 1

    Output fields are listed in the approximate order in which they appear.

    Table 2: Displaying Iterator Statistics for Ethernet Loss Measurement Output Fields

    Output Field Name

    Output Field Description

    Maintenance domain

    Maintenance domain name.

    Level

    Maintenance domain level configured.

    Maintenance association

    Maintenance association name.

    Local MEP id

    Numeric identifier of the local MEP.

    RemoteMEP identifier

    Numeric identifier of the remote MEP.

    Remote MAC address

    Unicast MAC address of the remote MEP.

    Iterator name

    Name of iterator.

    Iterator Id

    Numeric identifier of the iterator.

    Iterator cycle time

    Number of cycles (in milliseconds) taken between back-to-back transmission of SLA frames for this connection

    Iteration period

    Maximum number of cycles per iteration

    Iterator status

    Current status of iterator whether running or stopped.

    Infinite iterations

    Status of iteration as infinite or finite.

    Counter reset time

    Date and time when the counter was reset.

    Reset reason

    Reason to reset counter.

    LMM sent

    Number of loss measurement message (LMM) PDU frames sent to the peer MEP in this session.

    LMM skipped for threshold hit

    Number of LMM frames sent to the peer MEP in this session skipped during threshold hit.

    LMM skipped for threshold hit window

    Number of LMM frames sent to the peer MEP in this session skipped during the last threshold hit window.

    LMR received

    Number of LMRs frames received.

    LMR out of sequence

    Total number of LMR out of sequence packets received.

    Near-end (CIR)

    Frame loss associated with ingress data frames for the statistics displayed.

    Far-end (CIR)

    Frame loss associated with egress data frames for the statistics displayed.

    Near-end (EIR)

    Frame loss associated with ingress data frames for the statistics displayed.

    Far-end (EIR)

    Frame loss associated with egress data frames for the statistics displayed.

Clearing Iterator Statistics

Purpose

Clear iterator statistics.

Multiple iterators can be associated with remote MEP. However, by default, only one result pertaining to one iterator profile can be cleared.

Action

  • To clear the iterator statistics for remote MEP 1 and iterator profile i1 with MEPs belonging to the maintenance association  ma1 and within the maintenance domain default-1:

    user@host> clear oam ethernet connectivity-fault-management sla-iterator-statistics sla-iterator i1 maintenance-domain default-1 maintenance-association ma1 local-mep 1 remote-mep 1
  • To clear the iterator statistics for remote MEP 1 and iterator profile i2 with MEPs belonging to the maintenance association ma1 and within the maintenance domain default-1:

    user@host> clear oam ethernet connectivity-fault-management sla-iterator-statistics sla-iterator i2 maintenance-domain default-1 maintenance-association ma1 local-mep 1 remote-mep 1

Configuring a Remote MEP with an Iterator Profile

You can associate a remote maintenance association end point (MEP) with more than one iterator profile.

To configure a remote MEP with an iterator profile:

  1. In configuration mode, go to the following hierarchy level:
  2. Configure the remote MEP with values from 1 through 8191.
  3. Set the iterator profile.
  4. (Optional) Set the size of the data TLV portion of the Y.1731 data frame with values from 1 through 1400 bytes. The default value is 1.
  5. (Optional) Set the iteration count, which indicates the number of iterations for which this connection should partake in the iterator for acquiring SLA measurements, with values from 1 through 65,535. The default value is 0 (that is, infinite iterations).
  6. (Optional) Set the priority, which is the vlan-pcp value that is sent in the Y.1731 data frames, with values from 0 through 7. The default value is 0.
  7. Verify the configuration.