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
enforce-test-session-start-time boolean
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

test-oam command descriptions

test-oam

Synopsis Enter the test-oam context
Context configure test-oam
Treetest-oam
Introduced16.0.R4

Platforms

All

icmp

Synopsis Enter the icmp context
Context configure test-oam icmp
Treeicmp
Introduced20.10.R1

Platforms

All

ipv6
Synopsis Enter the ipv6 context
Context configure test-oam icmp ipv6
Treeipv6
Introduced22.7.R1

Platforms

All

maximum-original-datagram boolean
Synopsis ICMPv6 traceroute responses with largest datagram
Contextconfigure test-oam icmp ipv6 maximum-original-datagram boolean
Treemaximum-original-datagram

Description

When configured to true, this command enables the original datagram field of the ICMPv6 error message to be a maximum of 1232 bytes.

When configured to false, the original datagram field of the ICMPv6 error message smaller than 1232 bytes be built smaller.

Defaultfalse
Introduced22.7.R1

Platforms

All

ping-template [name] string
Synopsis Enter the ping-template list instance
Contextconfigure test-oam icmp ping-template string
Treeping-template

Description

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

Introduced20.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
Treeping-template
String Length1 to 64

Notes

This element is part of a list key.

Introduced20.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
Treedescription
String Length1 to 80
Introduced20.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
Contextconfigure test-oam icmp ping-template string dot1p number
Treedot1p
Range0 to 7
Default7
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
Contextconfigure test-oam icmp ping-template string dscp keyword
Treedscp
Defaultnc1
Optionsbe, 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
Introduced20.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
Contextconfigure test-oam icmp ping-template string failure-threshold number
Treefailure-threshold
Range2 to 10
Default3
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
Treeinterval
Range1 to 60
Default60
Units seconds
Introduced20.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
Contextconfigure test-oam icmp ping-template string reactivation-failure-threshold number
Treereactivation-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.

Range1 to 10
Default4
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
Treereactivation-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.

Range1 to 60
Default1
Units seconds
Introduced20.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
Contextconfigure test-oam icmp ping-template string reactivation-threshold number
Treereactivation-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.

Range1 to 10
Default3
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
Contextconfigure test-oam icmp ping-template string size number
Treesize
Range12 to 9786
Default56
Units octets
Introduced20.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
Contextconfigure test-oam icmp ping-template string timeout number
Treetimeout
Range1 to 60
Default5
Units seconds
Introduced20.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
Contextconfigure test-oam icmp ping-template string ttl number
Treettl

Description

This command configures the TTL value used in the outgoing ping packet. The tested interface must be directly connected on the same subnet.

Range1 to 255
Default1
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
Contextconfigure test-oam link-measurement
Treelink-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.

Introduced21.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
Contextconfigure test-oam link-measurement measurement-template string
Treemeasurement-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. 

Introduced21.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
Contextconfigure test-oam link-measurement measurement-template string aggregate-sample-window
Treeaggregate-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.

Introduced21.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
Treethreshold
Introduced21.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
Contextconfigure test-oam link-measurement measurement-template string aggregate-sample-window threshold absolute number
Treeabsolute

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.

Range1 to 100000
Unitsmicroseconds
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
Contextconfigure test-oam link-measurement measurement-template string aggregate-sample-window threshold relative number
Treerelative

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.

Range1 to 100
Unitspercent
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
Contextconfigure test-oam link-measurement measurement-template string aggregate-sample-window window-integrity number
Treewindow-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.  

Range1 to 100
Unitspercent
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
Treedelay

Description

This command configures the type of delay measurement statistic used in the sample window and aggregate sample window.

Defaultmin
Optionsmin, max, avg
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
Contextconfigure test-oam link-measurement measurement-template string last-reported-delay-hold number
Treelast-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.

Range0 | 1 to 86400
Default86400
Units seconds
Introduced21.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
Contextconfigure test-oam link-measurement measurement-template string reporting boolean
Treereporting

Description

When configured to true, the system reports a reached threshold to the routing engine.Reaching a configured sample-window or aggregate-sample-window indicates a value of interest.

When configured to false, values reaching thresholds are not reported to the routing engine. In both enabled and disabled cases, the sample-window and aggregate-sample-window information and computed values are stored on the node until overwriting occurs.

Defaulttrue
Introduced22.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
Contextconfigure test-oam link-measurement measurement-template string sample-window
Treesample-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.

Introduced21.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
Contextconfigure test-oam link-measurement measurement-template string sample-window multiplier number
Treemultiplier

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”.

Range1 to 900
Default10
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
Treethreshold
Introduced21.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
Contextconfigure test-oam link-measurement measurement-template string sample-window threshold absolute number
Treeabsolute

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.

Range1 to 100000
Unitsmicroseconds
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
Contextconfigure test-oam link-measurement measurement-template string sample-window threshold relative number
Treerelative

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.

Range1 to 500
Unitspercent
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
Contextconfigure test-oam link-measurement measurement-template string sample-window window-integrity number
Treewindow-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.

Range1 to 100
Unitspercent
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
Treetwamp-light

Description

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

Introduced21.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
Contextconfigure test-oam link-measurement measurement-template string twamp-light allow-egress-remark-dscp boolean
Treeallow-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.  

Defaultfalse
Introduced21.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
Contextconfigure test-oam link-measurement measurement-template string twamp-light allow-ipv6-udp-checksum-zero boolean
Treeallow-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.

Defaultfalse
Introduced21.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
Contextconfigure test-oam link-measurement measurement-template string twamp-light dest-udp-port number
Treedest-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.

Range1 to 65535
Default862
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
Contextconfigure test-oam link-measurement measurement-template string twamp-light dscp keyword
Treedscp

Description

This command configures the DSCP to be copied into the IP header of each TWAMP Light echo request packet launched for the test.

Defaultnc1
Optionsbe, 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
Introduced21.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
Contextconfigure test-oam link-measurement measurement-template string twamp-light fc keyword
Treefc
Defaulth1
Optionsbe, l2, af, l1, h2, ef, h1, nc
Introduced21.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
Contextconfigure test-oam link-measurement measurement-template string twamp-light ipv6-destination-discovery
Treeipv6-destination-discovery

Description

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

Introduced22.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
Contextconfigure test-oam link-measurement measurement-template string twamp-light ipv6-destination-discovery discovery-interval number
Treediscovery-interval

Description

This command configures transmission frequency of the discovery packet to the all-routers multicast group (ff02::2) to discover the link-local address of the peer. This frequency is used during the discover-timer interval.

Range1 to 10
Default10
Units seconds
Introduced22.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
Contextconfigure test-oam link-measurement measurement-template string twamp-light ipv6-destination-discovery discovery-timer number
Treediscovery-timer

Description

This command configures the amount of time to transmit peer discovery packets at the discovery-interval.

The timer starts when the IPv6 protocols is enabled under the configure router interface if-attribute delay dynamic twamp-light ipv6 context. At the expiration of the discovery-interval or when a peer is discovered, whichever comes first, the probe interval changes to the value configured for the update-interval.

Range1 to 1800
Default60
Units seconds
Introduced22.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
Treepad-tlv-size

Description

This command enables a STAMP PDU to include the PAD TLV. This increases the size of the STAMP PDU by the size of the added TLV. The PAD TLV includes an all zeros pattern.

Range4 to 9714
Unitsbytes
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
Contextconfigure test-oam link-measurement measurement-template string twamp-light profile keyword
Treeprofile

Description

This command specifies if the packets should be treated as in or out of profile as they move through the local node.

Defaultin
Optionsin, out
Introduced21.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
Treereturn-path

Description

Commands in this context configure the return-path TLV carried in the STAMP PDU.  

Introduced22.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
Contextconfigure test-oam link-measurement measurement-template string twamp-light return-path link boolean
Treelink

Description

When configured to true, the system includes the return-path TLV link. The link sub-tlv instructs a Session-Reflector configured for type stamp to use the receiving logical IP interface for the transmission of the response packet from the reflector to the session-sender. The destination of the reflected packet must be installed in the forwarding table and reachable out the IP interface or the packet is dropped by the Session-Reflector. When there are parallel non-equal cost return paths between the Session-Reflector and the Session-Sender the response packet can only be returned on the lowest cost path.

When configured to false, the Return Path TLV carried in the STAMP PDU is not included with the test packet.

Defaultfalse
Introduced22.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
Contextconfigure test-oam link-measurement measurement-template string twamp-light src-udp-port number
Treesrc-udp-port

Description

This command specifies a source UDP port for link measurement tests.

Unless required, Nokia suggests that the link measurement dynamically select an available source UDP port from the dynamic range. Before a UDP port in the configurable range can be configured as a source it must be owned by the application. Use the configure test-oam twamp twamp-light source-udp-port-pools port pool-type command to map the port range to the application.

By default a source UDP port allocates from the dynamic range. The configuration of the source port should only be configured when required for interoperability. When the source IP, destination IP, and destination UPD port are the same for a test, the source UDP port must be different in order to uniquely identify the session.

Range64374 to 64383
Introduced22.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
Contextconfigure test-oam link-measurement measurement-template string twamp-light timestamp-format keyword
Treetimestamp-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.

Defaultntp
Optionsntp, ptp
Introduced21.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
Contextconfigure test-oam link-measurement measurement-template string unidirectional-measurement keyword
Treeunidirectional-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).

Defaultderived
Optionsderived, actual
Introduced21.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
Treempls-dm
Introduced16.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
Contextconfigure test-oam mpls-dm admin-state keyword
Treeadmin-state
Defaultdisable
Optionsenable, disable
Introduced16.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
Treetwamp
Introduced16.0.R4

Platforms

All

server
Synopsis Enter the server context
Context configure test-oam twamp server
Treeserver
Introduced16.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
Contextconfigure test-oam twamp server admin-state keyword
Treeadmin-state
Defaultdisable
Optionsenable, disable
Introduced16.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
Contextconfigure test-oam twamp server allow-ipv6-udp-checksum-zero boolean
Treeallow-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.

Defaultfalse
Introduced22.2.R1

Platforms

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

enforce-test-session-start-time boolean
Synopsis Discard TWAMP packets before test-session start time
Contextconfigure test-oam twamp server enforce-test-session-start-time boolean
Treeenforce-test-session-start-time

Description

When configured to true, the router checks the signalled test-session start time against the server time and discards TWAMP test packets that arrive before the negotiated test-session start time.

When configured to false, the router processes all TWAMP test packets without checking the test-session start time against the server time.

Defaulttrue
Introduced23.3.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.

SynopsisInactivity timeout for TWAMP control connections
Contextconfigure test-oam twamp server inactivity-timeout number
Treeinactivity-timeout
Range60 to 3600
Default900
Units seconds
Introduced16.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.

SynopsisLimit of concurrent TWAMP server control connections
Contextconfigure test-oam twamp server max-connections number
Treemax-connections
Range0 to 64
Default32
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.

SynopsisMaximum number of concurrent TWAMP server test sessions
Contextconfigure test-oam twamp server max-sessions number
Treemax-sessions
Range0 to 128
Default32
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
Contextconfigure test-oam twamp server prefix (ipv4-prefix | ipv6-prefix)
Treeprefix
Max. Instances100
Introduced16.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
Contextconfigure test-oam twamp server prefix (ipv4-prefix | ipv6-prefix)
Treeprefix

Notes

This element is part of a list key.

Introduced16.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
Treedescription
String Length1 to 80
Introduced16.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
Contextconfigure test-oam twamp server prefix (ipv4-prefix | ipv6-prefix) max-connections number
Treemax-connections
Range0 to 64
Default32
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
Contextconfigure test-oam twamp server prefix (ipv4-prefix | ipv6-prefix) max-sessions number
Treemax-sessions
Range0 to 128
Default32
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
Treetwamp-light
Introduced16.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
Contextconfigure test-oam twamp twamp-light inactivity-timeout number
Treeinactivity-timeout
Range10 to 100
Default100
Units seconds
Introduced16.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
Contextconfigure test-oam twamp twamp-light source-udp-port-pools
Treesource-udp-port-pools
Introduced22.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
Treeport
Introduced22.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
Treeport
Range64374 to 64383

Notes

This element is part of a list key.

Introduced22.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
Treepool-type

Description

This command maps the specified source UDP port to the TWAMP Light application allowed to configure the source UDP port. OAM-PM IP tests can only configure the source UDP port when the port pool UDP source port is configured with a pool-type oam-pm. The test-oam link-measurement measurement-template can only configure the src-udp-port when the port pool UDP source port is configured with pool-type link-measurement.

This command maps the specified source UDP port to the application allowed to configure the source UDP port. The OAM-PM IP family of tests can only configure the source UDP port when the port pool UDP source port is configured with a pool-type oam-pm. The test-oam link-measurement measurement-template can only configure the src-udp-port when the port pool UDP source port is configured with a pool-type link-measurement. A pool-type cannot be changed if its current application is a test (either an oam-pm session or link-measurement template) and is configured to use the specified port, regardless of the administrative or operational state. The configuration reference linking to the source UDP prevents the change.

Defaultoam-pm
Optionsoam-pm, link-measurement
Introduced22.7.R1

Platforms

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