Enter the test-oam context

configure test-oam

test-oam

16.0.R4

All

Enter the icmp context

configure test-oam icmp

icmp

20.10.R1

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

Enter the ping-template list instance

configure test-oam icmp ping-template string

ping-template

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

20.10.R1

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

Ping template name

configure test-oam icmp ping-template string

1 to 64

This element is part of a list key.

20.10.R1

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

Text description

configure test-oam icmp ping-template string description string

description

1 to 80

20.10.R1

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

Dot1p in Ethernet header of outgoing ping packets

configure test-oam icmp ping-template string dot1p number

dot1p

0 to 7

7

20.10.R1

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

DSCP value used in the outgoing ping packet

configure test-oam icmp ping-template string dscp keyword

dscp

nc1

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

20.10.R1

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

Failure threshold to declare inter-connectivity down

configure test-oam icmp ping-template string failure-threshold number

failure-threshold

2 to 10

3

20.10.R1

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

Packet transmit interval

configure test-oam icmp ping-template string interval number

interval

1 to 60

60

seconds

20.10.R1

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

Threshold of consecutive failures at reactivation

configure test-oam icmp ping-template string reactivation-failure-threshold number

reactivation-failure-threshold

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.

1 to 10

4

20.10.R1

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

Ping reactivation interval

configure test-oam icmp ping-template string reactivation-interval number

reactivation-interval

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.

1 to 60

1

seconds

20.10.R1

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

Success threshold to declare inter-connectivity up

configure test-oam icmp ping-template string reactivation-threshold number

reactivation-threshold

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.

1 to 10

3

20.10.R1

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

Reactivation wait time before packet is declared lost

configure test-oam icmp ping-template string reactivation-timeout number

reactivation-timeout

1 to 60

1

seconds

20.10.R1

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

Data field size of the outgoing ICMP echo packet

configure test-oam icmp ping-template string size number

size

12 to 9786

56

octets

20.10.R1

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

Wait time before ICMP echo request is declared lost

configure test-oam icmp ping-template string timeout number

timeout

1 to 60

5

seconds

20.10.R1

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

TTL value for the outgoing ping packet

configure test-oam icmp ping-template string ttl number

ttl

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

1 to 255

1

20.10.R1

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

Enter the link-measurement context

configure test-oam link-measurement

link-measurement

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

21.7.R1

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

Enter the measurement-template list instance

configure test-oam link-measurement measurement-template string

measurement-template

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. 

21.7.R1

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

Measurement template name

configure test-oam link-measurement measurement-template string

1 to 64

This element is part of a list key.

21.7.R1

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

Administrative state of the measurement template

configure test-oam link-measurement measurement-template string admin-state keyword

admin-state

disable

enable, disable

21.7.R1

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

Enter the aggregate-sample-window context

configure test-oam link-measurement measurement-template string aggregate-sample-window

aggregate-sample-window

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.

21.7.R1

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

Number of sample windows in the aggregate sample window

configure test-oam link-measurement measurement-template string aggregate-sample-window multiplier number

multiplier

1 to 12

12

21.7.R1

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

Enter the threshold context

configure test-oam link-measurement measurement-template string aggregate-sample-window threshold

threshold

21.7.R1

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

Absolute delta for delay measurement reporting

configure test-oam link-measurement measurement-template string aggregate-sample-window threshold absolute number

absolute

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.

1 to 100000

microseconds

21.7.R1

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

Relative delta for measurement reporting

configure test-oam link-measurement measurement-template string aggregate-sample-window threshold relative number

relative

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.

1 to 100

percent

21.7.R1

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

Sample percentage required for window integrity report

configure test-oam link-measurement measurement-template string aggregate-sample-window window-integrity number

window-integrity

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.  

1 to 100

percent

21.7.R1

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

Delay measurement statistic type

configure test-oam link-measurement measurement-template string delay keyword

delay

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

min

min, max, avg

21.7.R1

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

Text description

configure test-oam link-measurement measurement-template string description string

description

1 to 80

21.7.R1

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

Interval between test packet transmissions

configure test-oam link-measurement measurement-template string interval number

interval

1 to 10

1

seconds

21.7.R1

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

Time to wait to flush the last reported delay

configure test-oam link-measurement measurement-template string last-reported-delay-hold number

last-reported-delay-hold

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.

0 | 1 to 86400

86400

seconds

21.7.R1

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

Enter the sample-window context

configure test-oam link-measurement measurement-template string sample-window

sample-window

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.

21.7.R1

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

Multiplier of interval used for sample window length

configure test-oam link-measurement measurement-template string sample-window multiplier number

multiplier

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

1 to 900

10

21.7.R1

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

Enter the threshold context

configure test-oam link-measurement measurement-template string sample-window threshold

threshold

21.7.R1

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

Absolute delta for delay measurement reporting

configure test-oam link-measurement measurement-template string sample-window threshold absolute number

absolute

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.

1 to 100000

microseconds

21.7.R1

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

Relative delta for delay measurement reporting

configure test-oam link-measurement measurement-template string sample-window threshold relative number

relative

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.

1 to 500

percent

21.7.R1

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

Sample percentage required for window integrity report

configure test-oam link-measurement measurement-template string sample-window window-integrity number

window-integrity

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.

1 to 100

percent

21.7.R1

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

Enter the twamp-light context

configure test-oam link-measurement measurement-template string twamp-light

twamp-light

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

21.7.R1

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

Allow overwrite of DSCP value by the egress QoS policy

configure test-oam link-measurement measurement-template string twamp-light allow-egress-remark-dscp boolean

allow-egress-remark-dscp

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.  

false

21.7.R1

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

Process IPv6 packets with UDP check sum zero

configure test-oam link-measurement measurement-template string twamp-light allow-ipv6-udp-checksum-zero boolean

allow-ipv6-udp-checksum-zero

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.

false

21.7.R1

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

Destination UDP port used by link measurement tests

configure test-oam link-measurement measurement-template string twamp-light dest-udp-port number

dest-udp-port

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.

1 to 65535

862

21.7.R1

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

DSCP copied to TWAMP Light echo request packet header

configure test-oam link-measurement measurement-template string twamp-light dscp keyword

dscp

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

nc1

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

21.7.R1

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

Forwarding class name for the TWAMP Light packets

configure test-oam link-measurement measurement-template string twamp-light fc keyword

fc

h1

be, l2, af, l1, h2, ef, h1, nc

21.7.R1

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

QoS profile for packet treatment in local node

configure test-oam link-measurement measurement-template string twamp-light profile keyword

profile

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

in

in, out

21.7.R1

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

Format of the timestamp used in TWAMP Light PDU

configure test-oam link-measurement measurement-template string twamp-light timestamp-format keyword

timestamp-format

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.

ntp

ntp, ptp

21.7.R1

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

Time to live value used in the TWAMP Light test packet

configure test-oam link-measurement measurement-template string twamp-light ttl number

ttl

1 to 255

1

21.7.R1

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

Method used to compute the unidirectional delay value

configure test-oam link-measurement measurement-template string unidirectional-measurement keyword

unidirectional-measurement

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

derived

derived, actual

21.7.R1

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

Enter the mpls-dm context

configure test-oam mpls-dm

mpls-dm

16.0.R6

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

Administrative state of MPLS DM packet processing

configure test-oam mpls-dm admin-state keyword

admin-state

disable

enable, disable

16.0.R6

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

Enter the twamp context

configure test-oam twamp

twamp

16.0.R4

All

Enter the server context

configure test-oam twamp server

server

16.0.R4

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

Administrative state of the TWAMP server

configure test-oam twamp server admin-state keyword

admin-state

disable

enable, disable

16.0.R4

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

Process IPv6 packets with a zero UDP checksum

configure test-oam twamp server allow-ipv6-udp-checksum-zero boolean

allow-ipv6-udp-checksum-zero

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.

false

22.2.R1

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

System wide inactivity timeout for each TWAMP server control connection

configure test-oam twamp server inactivity-timeout number

inactivity-timeout

60 to 3600

900

seconds

16.0.R4

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

System wide maximum number of concurrent TWAMP server control connections

configure test-oam twamp server max-connections number

max-connections

0 to 64

32

16.0.R4

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

System wide maximum number of concurrent TWAMP server test sessions

configure test-oam twamp server max-sessions number

max-sessions

0 to 128

32

16.0.R4

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

Enter the prefix list instance

configure test-oam twamp server prefix (ipv4-prefix | ipv6-prefix)

prefix

100

16.0.R4

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

Prefix to match against TWAMP client address

configure test-oam twamp server prefix (ipv4-prefix | ipv6-prefix)

This element is part of a list key.

16.0.R4

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

Text description

configure test-oam twamp server prefix (ipv4-prefix | ipv6-prefix) description string

description

1 to 80

16.0.R4

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

Maximum number of control connections for TWAMP prefix

configure test-oam twamp server prefix (ipv4-prefix | ipv6-prefix) max-connections number

max-connections

0 to 64

32

16.0.R4

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

Maximum concurrent TWAMP test sessions based on prefix

configure test-oam twamp server prefix (ipv4-prefix | ipv6-prefix) max-sessions number

max-sessions

0 to 128

32

16.0.R4

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

Enter the twamp-light context

configure test-oam twamp twamp-light

twamp-light

16.0.R4

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

Time to maintain stale state on the session reflector

configure test-oam twamp twamp-light inactivity-timeout number

inactivity-timeout

10 to 100

100

seconds

16.0.R4

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