test-oam commands

configure 
   —  test-oam 
      —  apply-groups reference
      —  apply-groups-exclude reference
      —  icmp 
         —  ipv6 
            —  apply-groups reference
            —  apply-groups-exclude reference
            —  length-field boolean
            —  maximum-original-datagram boolean
         —  ping-template string 
            —  apply-groups reference
            —  apply-groups-exclude reference
            —  description string
            —  dot1p number
            —  dscp keyword
            —  failure-threshold number
            —  interval number
            —  reactivation-failure-threshold number
            —  reactivation-interval number
            —  reactivation-threshold number
            —  reactivation-timeout number
            —  size number
            —  timeout number
            —  ttl number
      —  link-measurement 
         —  measurement-template string 
            —  admin-state keyword
            —  aggregate-sample-window 
               —  multiplier number
               —  threshold 
                  —  absolute number
                  —  relative number
               —  window-integrity number
            —  apply-groups reference
            —  apply-groups-exclude reference
            —  delay keyword
            —  description string
            —  interval number
            —  last-reported-delay-hold number
            —  reporting boolean
            —  sample-window 
               —  multiplier number
               —  threshold 
                  —  absolute number
                  —  relative number
               —  window-integrity number
            —  twamp-light 
               —  allow-egress-remark-dscp boolean
               —  allow-ipv6-udp-checksum-zero boolean
               —  dest-udp-port number
               —  dscp keyword
               —  fc keyword
               —  ipv6-destination-discovery 
                  —  admin-state keyword
                  —  discovery-interval number
                  —  discovery-timer number
                  —  update-interval number
               —  pad-tlv-size number
               —  profile keyword
               —  return-path 
                  —  link boolean
               —  src-udp-port number
               —  timestamp-format keyword
               —  ttl number
            —  unidirectional-measurement keyword
      —  mpls-dm 
         —  admin-state keyword
         —  apply-groups reference
         —  apply-groups-exclude reference
      —  twamp 
         —  apply-groups reference
         —  apply-groups-exclude reference
         —  server 
            —  admin-state keyword
            —  allow-ipv6-udp-checksum-zero boolean
            —  apply-groups reference
            —  apply-groups-exclude reference
            —  inactivity-timeout number
            —  max-connections number
            —  max-sessions number
            —  prefix (ipv4-prefix | ipv6-prefix) 
               —  apply-groups reference
               —  apply-groups-exclude reference
               —  description string
               —  max-connections number
               —  max-sessions number
         —  twamp-light 
            —  apply-groups reference
            —  apply-groups-exclude reference
            —  inactivity-timeout number
            —  source-udp-port-pools 
               —  port number 
                  —  apply-groups reference
                  —  apply-groups-exclude reference
                  —  pool-type keyword
Parent topic: Configuration commands

test-oam command descriptions

test-oam

  Synopsis Enter the test-oam context
  Context configure test-oam
  Tree test-oam
  Introduced 16.0.R4
 

Platforms

All

icmp

  Synopsis Enter the icmp context
  Context configure test-oam icmp
  Tree icmp
  Introduced 20.10.R1
 

Platforms

All
ipv6
  Synopsis Enter the ipv6 context
  Context configure test-oam icmp ipv6
  Tree ipv6
  Introduced 22.7.R1
 

Platforms

All
length-field boolean
  Synopsis Use length field in ICMPv6 responses
  Context configure test-oam icmp ipv6 length-field boolean
  Tree length-field
  Default false
  Introduced 22.7.R1
 

Platforms

All
maximum-original-datagram boolean
  Synopsis ICMPv6 traceroute responses with largest datagram
  Context configure test-oam icmp ipv6 maximum-original-datagram boolean
  Tree maximum-original-datagram
  Default false
  Introduced 22.7.R1
 

Platforms

All
ping-template [name] string
  Synopsis Enter the ping-template list instance
  Context configure test-oam icmp ping-template string
  Tree ping-template
 

Description

Commands in this context define ping timers and thresholds that verify connectivity and the the operational state of the IP interface.
  Introduced 20.10.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
[name] string
  Synopsis Ping template name
  Context configure test-oam icmp ping-template string
  String Length 1 to 64
 

Notes

This element is part of a list key.
  Introduced 20.10.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
description string
  Synopsis Text description
  Context configure test-oam icmp ping-template string description string
  Tree description
  String Length 1 to 80
  Introduced 20.10.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
dot1p number
  Synopsis Dot1p in Ethernet header of outgoing ping packets
  Context configure test-oam icmp ping-template string dot1p number
  Tree dot1p
  Range 0 to 7
  Default 7
  Introduced 20.10.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
dscp keyword
  Synopsis DSCP value used in the outgoing ping packet
  Context configure test-oam icmp ping-template string dscp keyword
  Tree dscp
  Default nc1
  Options be, cp1, cp2, cp3, cp4, cp5, cp6, cp7, cs1, cp9, af11, cp11, af12, cp13, af13, cp15, cs2, cp17, af21, cp19, af22, cp21, af23, cp23, cs3, cp25, af31, cp27, af32, cp29, af33, cp31, cs4, cp33, af41, cp35, af42, cp37, af43, cp39, cs5, cp41, cp42, cp43, cp44, cp45, ef, cp47, nc1, cp49, cp50, cp51, cp52, cp53, cp54, cp55, nc2, cp57, cp58, cp59, cp60, cp61, cp62, cp63
  Introduced 20.10.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
failure-threshold number
  Synopsis Failure threshold to declare inter-connectivity down
  Context configure test-oam icmp ping-template string failure-threshold number
  Tree failure-threshold
  Range 2 to 10
  Default 3
  Introduced 20.10.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
interval number
  Synopsis Packet transmit interval
  Context configure test-oam icmp ping-template string interval number
  Tree interval
  Range 1 to 60
  Default 60
  Units seconds
  Introduced 20.10.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
reactivation-failure-threshold number
  Synopsis Threshold of consecutive failures at reactivation
  Context configure test-oam icmp ping-template string reactivation-failure-threshold number
  Tree reactivation-failure-threshold
 

Description

This command configures the number of consecutive failures that must occur when transmitting at the reactivation interval without success before the transmission interval is changed to the standard interval.
  Range 1 to 10
  Default 4
  Introduced 20.10.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
reactivation-interval number
  Synopsis Ping reactivation interval
  Context configure test-oam icmp ping-template string reactivation-interval number
  Tree reactivation-interval
 

Description

This command configures the packet transmit interval used when the IP interface becomes operationally down because of a ping template failure after receiving a successful response to the previous ICMP echo request.
  Range 1 to 60
  Default 1
  Units seconds
  Introduced 20.10.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
reactivation-threshold number
  Synopsis Success threshold to declare inter-connectivity up
  Context configure test-oam icmp ping-template string reactivation-threshold number
  Tree reactivation-threshold
 

Description

This command configures the minimum number of consecutive successful responses of ICMP replies that must occur before the IP interface transitions from operationally down (due to ping validation failure) to operationally up. This value is a stability metric intended to prevent flapping.
  Range 1 to 10
  Default 3
  Introduced 20.10.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
reactivation-timeout number
  Synopsis Reactivation wait time before packet is declared lost
  Context configure test-oam icmp ping-template string reactivation-timeout number
  Tree reactivation-timeout
  Range 1 to 60
  Default 1
  Units seconds
  Introduced 20.10.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
size number
  Synopsis Data field size of the outgoing ICMP echo packet
  Context configure test-oam icmp ping-template string size number
  Tree size
  Range 12 to 9786
  Default 56
  Units octets
  Introduced 20.10.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
timeout number
  Synopsis Wait time before ICMP echo request is declared lost
  Context configure test-oam icmp ping-template string timeout number
  Tree timeout
  Range 1 to 60
  Default 5
  Units seconds
  Introduced 20.10.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
ttl number
  Synopsis TTL value for the outgoing ping packet
  Context configure test-oam icmp ping-template string ttl number
  Tree ttl
 

Description

This command configures the TTL value used in the outgoing ping packet. The tested interface must be directly connected on the same subnet.
  Range 1 to 255
  Default 1
  Introduced 20.10.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

link-measurement

  Synopsis Enter the link-measurement context
  Context configure test-oam link-measurement
  Tree link-measurement
 

Description

Commands in this context configure the link measurement template attributes that are inherited on associated IP interfaces for delay reporting to the routing engine.
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
measurement-template [template-name] string
  Synopsis Enter the measurement-template list instance
  Context configure test-oam link-measurement measurement-template string
  Tree measurement-template
 

Description

Commands in this context configure the attributes of the measurement template that can be assigned to an IP interface.

Changes can be made without disabling the template, although some modifications cause the test on associated IP interfaces to terminate and restart.

A measurement template can be removed if no interfaces reference it. 
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
[template-name] string
  Synopsis Measurement template name
  Context configure test-oam link-measurement measurement-template string
  String Length 1 to 64
 

Notes

This element is part of a list key.
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
admin-state keyword
  Synopsis Administrative state of the measurement template
  Context configure test-oam link-measurement measurement-template string admin-state keyword
  Tree admin-state
  Default disable
  Options enable, disable
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
aggregate-sample-window
  Synopsis Enter the aggregate-sample-window context
  Context configure test-oam link-measurement measurement-template string aggregate-sample-window
  Tree aggregate-sample-window
 

Description

Commands in this context configure the attributes of the aggregate sample window used with the measurement template assigned to an IP interface. The aggregate sample window is the collection of sample windows.
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
multiplier number
  Synopsis Number of sample windows in the aggregate sample window
  Context configure test-oam link-measurement measurement-template string aggregate-sample-window multiplier number
  Tree multiplier
  Range 1 to 12
  Default 12
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
threshold
  Synopsis Enter the threshold context
  Context configure test-oam link-measurement measurement-template string aggregate-sample-window threshold
  Tree threshold
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
absolute number
  Synopsis Absolute delta for delay measurement reporting
  Context configure test-oam link-measurement measurement-template string aggregate-sample-window threshold absolute number
  Tree absolute
 

Description

This command configures the absolute minimum delta by which a new delay measurement must differ from the previously reported measurement to be reported to the routing engine. 

If an absolute value is not configured the threshold is disabled.
  Range 1 to 100000
  Units microseconds
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
relative number
  Synopsis Relative delta for measurement reporting
  Context configure test-oam link-measurement measurement-template string aggregate-sample-window threshold relative number
  Tree relative
 

Description

This command configures the relative minimum delta by which a new delay measurement must differ from the previously reported measurement to be reported to the routing engine.  

If a relative value is not configured, the threshold is disabled.
  Range 1 to 100
  Units percent
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
window-integrity number
  Synopsis Sample percentage required for window integrity report
  Context configure test-oam link-measurement measurement-template string aggregate-sample-window window-integrity number
  Tree window-integrity
 

Description

This command configures the percentage value that is used to determine whether the aggregate sample window is integral, by comparing the number of samples received from the sample window to the percentage configured. 

The configured percentage translates to a required sample window count that must be included in the aggregate sample window. The number of samples is computed as follows: 

(window-integrity (%)) x (((aggregate-sample-window length (s)) / (sample-window length (s))) 

If the number of samples in the aggregate sample window is equal to or greater than the computed number of required samples, the sample window has integrity and the aggregate sample window result is compared to the configured sample window thresholds.

If the count is less than the computed number of required samples, the aggregate sample window does not have integrity and the value is not considered as representative. In this case the aggregate sample window results are not compared to the configured sample window thresholds. 

If this parameter is not configured, integrity checking is disabled and all results are compared to the configured thresholds.  
  Range 1 to 100
  Units percent
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
delay keyword
  Synopsis Delay measurement statistic type
  Context configure test-oam link-measurement measurement-template string delay keyword
  Tree delay
 

Description

This command configures the type of delay measurement statistic used in the sample window and aggregate sample window.
  Default min
  Options min, max, avg
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
description string
  Synopsis Text description
  Context configure test-oam link-measurement measurement-template string description string
  Tree description
  String Length 1 to 80
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
interval number
  Synopsis Interval between test packet transmissions
  Context configure test-oam link-measurement measurement-template string interval number
  Tree interval
  Range 1 to 10
  Default 1
  Units seconds
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
last-reported-delay-hold number
  Synopsis Time to wait to flush the last reported delay
  Context configure test-oam link-measurement measurement-template string last-reported-delay-hold number
  Tree last-reported-delay-hold
 

Description

This command configures the timer that specifies the wait time before the last reported delay measurement is flushed after a link measurement test enters the operationally down state.

The aging timer delays the flushing of the last reported delay metric to the routing engine. This timer starts a countdown to zero when an administrative function causes the operational state of the test on that specific interface to transition from up to down. If the timer expires before the operational state transitions to up, the previously reported value is flushed. The Delay Measurement Last Reported indicates “Cleared”. The timestamp indicates the time of the clear event. The Triggered By indicates “Expired”. If the administrative state recovers to operationally up before the expiration of the timer, the previous reported value is not flushed.

The aging timer does not apply to failure conditions that do not affect the administrative state of the interface, for example interface failure or routing changes.

  Range 0 | 1 to 86400
  Default 86400
  Units seconds
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
reporting boolean
  Synopsis Report behavior for values for the configured threshold
  Context configure test-oam link-measurement measurement-template string reporting boolean
  Tree reporting
  Default true
  Introduced 22.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
sample-window
  Synopsis Enter the sample-window context
  Context configure test-oam link-measurement measurement-template string sample-window
  Tree sample-window
 

Description

Commands in this context configure sample window attributes used when the measurement template is assigned to an IP interface. The sample window is the collection of individual probe results over a defined period.
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
multiplier number
  Synopsis Multiplier of interval used for sample window length
  Context configure test-oam link-measurement measurement-template string sample-window multiplier number
  Tree multiplier
 

Description

This command configures the number of probe results that should be in the sample window. For example, a multiplier of 10 and an interval of 5 equals 50 probes being transmitted from an individual sample window. Consequently, 50 probe results are expected within the 50 second duration that the sample window is “In-progress”.
  Range 1 to 900
  Default 10
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
threshold
  Synopsis Enter the threshold context
  Context configure test-oam link-measurement measurement-template string sample-window threshold
  Tree threshold
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
absolute number
  Synopsis Absolute delta for delay measurement reporting
  Context configure test-oam link-measurement measurement-template string sample-window threshold absolute number
  Tree absolute
 

Description

This command configures the absolute minimum delta by which a new delay measurement must differ from the previously reported measurement to be reported to the routing engine. 

If an absolute value is not configured the threshold is disabled.
  Range 1 to 100000
  Units microseconds
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
relative number
  Synopsis Relative delta for delay measurement reporting
  Context configure test-oam link-measurement measurement-template string sample-window threshold relative number
  Tree relative
 

Description

This command configures the relative minimum delta by which a new delay measurement must differ from the previously reported measurement to be reported to the routing engine.  

If a relative value is not configured, the threshold is disabled.
  Range 1 to 500
  Units percent
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
window-integrity number
  Synopsis Sample percentage required for window integrity report
  Context configure test-oam link-measurement measurement-template string sample-window window-integrity number
  Tree window-integrity
 

Description

This command configures the percentage value that is used to determine whether the sample window has enough samples to be considered representative for that window (integrity), by comparing the number of samples received from the sample window to the percentage configured. 

The configured percentage considers the interval of probes and the length of the sample window to determine the number of packets required in the sample:

(window-integrity (%)) x ((sample-window length (s)) / pps per test (interval))

If the count is less than the computed number of required samples, the sample window does not have integrity and the sample window results are not compared to configured sample window thresholds.

If the count is equal to or greater than the computed number of required samples, the sample window has integrity and the aggregate sample window result is compared to the configured sample window thresholds.

If the count is less than the computed number of required samples, the sample window does not have integrity and the value is not considered as representative. In this case the sample window results are not compared to the configured sample window thresholds.  

If this parameter is not configured, integrity checking is disabled and all results are compared to the configured thresholds.
  Range 1 to 100
  Units percent
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
twamp-light
  Synopsis Enter the twamp-light context
  Context configure test-oam link-measurement measurement-template string twamp-light
  Tree twamp-light
 

Description

Commands in this context configure TWAMP Light attributes that are used with the measurement template when assigned to IP interfaces.
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
allow-egress-remark-dscp boolean
  Synopsis Allow overwrite of DSCP value by the egress QoS policy
  Context configure test-oam link-measurement measurement-template string twamp-light allow-egress-remark-dscp boolean
  Tree allow-egress-remark-dscp
 

Description

When configured to true, the egress QoS process is able to modify the DSCP based on the egress QoS configuration and expose the DSCP to egress DSCP processing rules. 

When configured to false, the egress QoS process uses the DSCP as configured and bypasses egress QoS DSCP marking.

If the configure qos network egress remark-trusted force-egress-marking command is configured for the network egress QoS profile, the egress QoS process is applied and the DSCP can be overwritten regardless of the allow-egress-remark-dscp configuration.  
  Default false
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
allow-ipv6-udp-checksum-zero boolean
  Synopsis Process IPv6 packets with UDP check sum zero
  Context configure test-oam link-measurement measurement-template string twamp-light allow-ipv6-udp-checksum-zero boolean
  Tree allow-ipv6-udp-checksum-zero
 

Description

When configured to true, processing of IPv6 packets that arrive with a UDP checksum of zero is allowed. The destination UDP ports that are registered as TWAMP Test packets in the template allow this behavior. 

When configured to false, IPv6 packets that arrive with a UDP checksum of zero are discarded.
  Default false
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
dest-udp-port number
  Synopsis Destination UDP port used by link measurement tests
  Context configure test-oam link-measurement measurement-template string twamp-light dest-udp-port number
  Tree dest-udp-port
 

Description

This command configures the destination UDP port on outbound TWAMP Light measurement packets sent from the session controller. The destination UDP port must match the UDP port value configured on the TWAMP Light reflector that responds to this specific TWAMP Light test.
  Range 1 to 65535
  Default 862
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
dscp keyword
  Synopsis DSCP copied to TWAMP Light echo request packet header
  Context configure test-oam link-measurement measurement-template string twamp-light dscp keyword
  Tree dscp
 

Description

This command configures the DSCP to be copied into the IP header of each TWAMP Light echo request packet launched for the test.
  Default nc1
  Options be, cp1, cp2, cp3, cp4, cp5, cp6, cp7, cs1, cp9, af11, cp11, af12, cp13, af13, cp15, cs2, cp17, af21, cp19, af22, cp21, af23, cp23, cs3, cp25, af31, cp27, af32, cp29, af33, cp31, cs4, cp33, af41, cp35, af42, cp37, af43, cp39, cs5, cp41, cp42, cp43, cp44, cp45, ef, cp47, nc1, cp49, cp50, cp51, cp52, cp53, cp54, cp55, nc2, cp57, cp58, cp59, cp60, cp61, cp62, cp63
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
fc keyword
  Synopsis Forwarding class name for the TWAMP Light packets
  Context configure test-oam link-measurement measurement-template string twamp-light fc keyword
  Tree fc
  Default h1
  Options be, l2, af, l1, h2, ef, h1, nc
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
ipv6-destination-discovery
  Synopsis Enter the ipv6-destination-discovery context
  Context configure test-oam link-measurement measurement-template string twamp-light ipv6-destination-discovery
  Tree ipv6-destination-discovery
 

Description

Commands in this context configure IPv6 discovery of a directly-connected IPv6 peer address.
  Introduced 22.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
admin-state keyword
  Synopsis Administrative state of IPv6 auto destination discovery
  Context configure test-oam link-measurement measurement-template string twamp-light ipv6-destination-discovery admin-state keyword
  Tree admin-state
  Default disable
  Options enable, disable
  Introduced 22.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
discovery-interval number
  Synopsis Transmission frequency for discovery packets
  Context configure test-oam link-measurement measurement-template string twamp-light ipv6-destination-discovery discovery-interval number
  Tree discovery-interval
  Range 1 to 10
  Default 10
  Units seconds
  Introduced 22.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
discovery-timer number
  Synopsis Maximum time to remain in the discovery phase
  Context configure test-oam link-measurement measurement-template string twamp-light ipv6-destination-discovery discovery-timer number
  Tree discovery-timer
  Range 1 to 1800
  Default 60
  Units seconds
  Introduced 22.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
update-interval number
  Synopsis Transmission frequency to maintain the peer address
  Context configure test-oam link-measurement measurement-template string twamp-light ipv6-destination-discovery update-interval number
  Tree update-interval
  Range 0 | 1 to 3600
  Default 600
  Units seconds
  Introduced 22.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
pad-tlv-size number
  Synopsis Optional PAD TLV size
  Context configure test-oam link-measurement measurement-template string twamp-light pad-tlv-size number
  Tree pad-tlv-size
  Range 4 to 9714
  Units bytes
  Introduced 22.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
profile keyword
  Synopsis QoS profile for packet treatment in local node
  Context configure test-oam link-measurement measurement-template string twamp-light profile keyword
  Tree profile
 

Description

This command specifies if the packets should be treated as in or out of profile as they move through the local node.
  Default in
  Options in, out
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
return-path
  Synopsis Enter the return-path context
  Context configure test-oam link-measurement measurement-template string twamp-light return-path
  Tree return-path
  Introduced 22.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
link boolean
  Synopsis The Return Path sub-TLV specifying link
  Context configure test-oam link-measurement measurement-template string twamp-light return-path link boolean
  Tree link
  Default false
  Introduced 22.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
src-udp-port number
  Synopsis Fixed source UDP port for link measurement tests
  Context configure test-oam link-measurement measurement-template string twamp-light src-udp-port number
  Tree src-udp-port
  Range 64374 to 64383
  Introduced 22.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
timestamp-format keyword
  Synopsis Format of the timestamp used in TWAMP Light PDU
  Context configure test-oam link-measurement measurement-template string twamp-light timestamp-format keyword
  Tree timestamp-format
 

Description

This command configures the format of the timestamp used in the TWAMP Light PDU and places the requested timestamp format in the packet using the appropriate epoch. This is unrelated to any time distribution protocol used to synchronize time between clocks.
  Default ntp
  Options ntp, ptp
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
ttl number
  Synopsis Time to live value used in the TWAMP Light test packet
  Context configure test-oam link-measurement measurement-template string twamp-light ttl number
  Tree ttl
  Range 1 to 255
  Default 1
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
unidirectional-measurement keyword
  Synopsis Method used to compute the unidirectional delay value
  Context configure test-oam link-measurement measurement-template string unidirectional-measurement keyword
  Tree unidirectional-measurement
 

Description

This command specifies the unidirectional delay computation method as the actual forward delay (calculated using T2-T1 timestamps) or as derived using the round-trip delay divided by two (required if nodal clocks are not synchronized using an accurate time-synchronization method or protocol such as PTP).
  Default derived
  Options derived, actual
  Introduced 21.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

mpls-dm

  Synopsis Enter the mpls-dm context
  Context configure test-oam mpls-dm
  Tree mpls-dm
  Introduced 16.0.R6
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
admin-state keyword
  Synopsis Administrative state of MPLS DM packet processing
  Context configure test-oam mpls-dm admin-state keyword
  Tree admin-state
  Default disable
  Options enable, disable
  Introduced 16.0.R6
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

twamp

  Synopsis Enter the twamp context
  Context configure test-oam twamp
  Tree twamp
  Introduced 16.0.R4
 

Platforms

All
server
  Synopsis Enter the server context
  Context configure test-oam twamp server
  Tree server
  Introduced 16.0.R4
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
admin-state keyword
  Synopsis Administrative state of the TWAMP server
  Context configure test-oam twamp server admin-state keyword
  Tree admin-state
  Default disable
  Options enable, disable
  Introduced 16.0.R4
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
allow-ipv6-udp-checksum-zero boolean
  Synopsis Process IPv6 packets with a zero UDP checksum
  Context configure test-oam twamp server allow-ipv6-udp-checksum-zero boolean
  Tree allow-ipv6-udp-checksum-zero
 

Description

When configured to true, this command configures the acceptance of IPv6 packets with UDP checksums of 0. This optional configuration allows the router to process arriving IPv6 TWAMP Test packets that contain IPv6 UDP checksum of 0x0000. The UDP port specific to this TWAMP Light test bypasses the default discard IPv6 UDP checksum 0x0000. If this optional command is not configured, IPv6 UDP checksum 0x000 arriving packets are discarded.

When configured to false, packets that arrive with an IPv6 UDP checksum of 0x0000 are discarded.
  Default false
  Introduced 22.2.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
inactivity-timeout number
WARNING:

Modifying this element toggles the admin-state of the parent element automatically for the new value to take effect.
  Synopsis Inactivity timeout for TWAMP control connections
  Context configure test-oam twamp server inactivity-timeout number
  Tree inactivity-timeout
  Range 60 to 3600
  Default 900
  Units seconds
  Introduced 16.0.R4
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
max-connections number
WARNING:

Modifying this element toggles the admin-state of the parent element automatically for the new value to take effect.
  Synopsis Limit of concurrent TWAMP server control connections
  Context configure test-oam twamp server max-connections number
  Tree max-connections
  Range 0 to 64
  Default 32
  Introduced 16.0.R4
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
max-sessions number
WARNING:

Modifying this element toggles the admin-state of the parent element automatically for the new value to take effect.
  Synopsis Maximum number of concurrent TWAMP server test sessions
  Context configure test-oam twamp server max-sessions number
  Tree max-sessions
  Range 0 to 128
  Default 32
  Introduced 16.0.R4
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
prefix [ip-prefix] (ipv4-prefix | ipv6-prefix)
  Synopsis Enter the prefix list instance
  Context configure test-oam twamp server prefix (ipv4-prefix | ipv6-prefix)
  Tree prefix
  Max. Instances 100
  Introduced 16.0.R4
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
[ip-prefix] (ipv4-prefix | ipv6-prefix)
  Synopsis Prefix to match against TWAMP client address
  Context configure test-oam twamp server prefix (ipv4-prefix | ipv6-prefix)
 

Notes

This element is part of a list key.
  Introduced 16.0.R4
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
description string
  Synopsis Text description
  Context configure test-oam twamp server prefix (ipv4-prefix | ipv6-prefix) description string
  Tree description
  String Length 1 to 80
  Introduced 16.0.R4
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
max-connections number
  Synopsis Maximum number of control connections for TWAMP prefix
  Context configure test-oam twamp server prefix (ipv4-prefix | ipv6-prefix) max-connections number
  Tree max-connections
  Range 0 to 64
  Default 32
  Introduced 16.0.R4
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
max-sessions number
  Synopsis Maximum concurrent TWAMP test sessions based on prefix
  Context configure test-oam twamp server prefix (ipv4-prefix | ipv6-prefix) max-sessions number
  Tree max-sessions
  Range 0 to 128
  Default 32
  Introduced 16.0.R4
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
twamp-light
  Synopsis Enter the twamp-light context
  Context configure test-oam twamp twamp-light
  Tree twamp-light
  Introduced 16.0.R4
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
inactivity-timeout number
  Synopsis Time to maintain stale state on the session reflector
  Context configure test-oam twamp twamp-light inactivity-timeout number
  Tree inactivity-timeout
  Range 10 to 100
  Default 100
  Units seconds
  Introduced 16.0.R4
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
source-udp-port-pools
  Synopsis Enter the source-udp-port-pools context
  Context configure test-oam twamp twamp-light source-udp-port-pools
  Tree source-udp-port-pools
  Introduced 22.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
port [port-number] number
  Synopsis Enter the port list instance
  Context configure test-oam twamp twamp-light source-udp-port-pools port number
  Tree port
  Introduced 22.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
[port-number] number
  Synopsis Source UDP port pools port number
  Context configure test-oam twamp twamp-light source-udp-port-pools port number
  Range 64374 to 64383
 

Notes

This element is part of a list key.
  Introduced 22.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
pool-type keyword
  Synopsis Pool type of an application pool
  Context configure test-oam twamp twamp-light source-udp-port-pools port number pool-type keyword
  Tree pool-type
  Default oam-pm
  Options oam-pm, link-measurement
  Introduced 22.7.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS