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
test-oam command descriptions
test-oam
icmp
ipv6
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 | |
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. | |
| 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 | |
| Tree | ping-template | |
| 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 | |
| Options | ||
| Default | nc1 | |
| 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 | |
| Units | seconds | |
| Default | 60 | |
| 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 | |
| Units | seconds | |
| Default | 1 | |
| 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 | |
| Units | seconds | |
| Default | 1 | |
| 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 | |
| Units | octets | |
| Default | 56 | |
| 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 | |
| Units | seconds | |
| Default | 5 | |
| 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 | |
| Tree | measurement-template | |
| 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 | |
| Options | ||
| Default | 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. | |
| Options | ||
| Default | min | |
| 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 | |
| Units | seconds | |
| Default | 1 | |
| 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 | |
| Units | seconds | |
| Default | 86400 | |
| 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 | |
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. | |
| 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. | |
| Options | ||
| Default | nc1 | |
| 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 | |
| Options | ||
| Default | h1 | |
| 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 | |
| Options | ||
| Default | 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 | |
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. | |
| Range | 1 to 10 | |
| Units | seconds | |
| Default | 10 | |
| 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 | |
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. | |
| Range | 1 to 1800 | |
| Units | seconds | |
| Default | 60 | |
| 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 | |
| Units | seconds | |
| Default | 600 | |
| 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 | |
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. | |
| 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. | |
| Options | ||
| Default | in | |
| 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 | |
Description | Commands in this context configure the return-path TLV carried in the STAMP PDU. | |
| 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 | |
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. | |
| 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 | |
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. | |
| 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. | |
| Options | ||
| Default | ntp | |
| 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). | |
| Options | ||
| Default | derived | |
| Introduced | 21.7.R1 | |
Platforms | 7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS |
mpls-dm
admin-state keyword
| Synopsis | Administrative state of MPLS DM packet processing | |
| Context | configure test-oam mpls-dm admin-state keyword | |
| Tree | admin-state | |
| Options | ||
| Default | disable | |
| Introduced | 16.0.R6 | |
Platforms | 7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS |
twamp
server
admin-state keyword
| Synopsis | Administrative state of the TWAMP server | |
| Context | configure test-oam twamp server admin-state keyword | |
| Tree | admin-state | |
| Options | ||
| Default | 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 | |
| Units | seconds | |
| Default | 900 | |
| 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)
[ip-prefix] (ipv4-prefix | ipv6-prefix)
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 | |
| Units | seconds | |
| Default | 100 | |
| 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 | |
| Tree | port | |
| 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 | |
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. | |
| Options | ||
| Default | oam-pm | |
| Introduced | 22.7.R1 | |
Platforms |
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS |