testhead test-name [owner test-owner] testhead-profile profile-id [frame-payload frame-payload-id] sap sap-id [acceptance-criteria acceptance-criteria-id [color-aware {enable | disable}] [performance-monitoring {enable | disable}]
testhead test-name owner test-owner stop
oam
This command initiates an ITU-T Y.1564 test for throughput and bandwidth testing of Ethernet point-to-point virtual circuits. The test is run using sets of threshold and payload values that are configured under testhead-profile and frame-payload. You can run tests with up to four parallel flows by specifying up to four frame payload IDs in order to create IMIX-type traffic patterns. After a test is complete, the system raises an SNMP trap.
Before initiating a test, you must also enable an Ethernet loopback with the loopback command, in order to send the test packets back to the source for measuring and analyzing. No checks are performed to verify that a remote SAP loopback is enabled
the Y.1564 test name, up to 32 characters in length
the owner of a Y.1564 test, up to 32 characters in length
the test head profile to be used for this test
a list of up to four frame-payload-ids defined under one testhead-profile template; For example, 1-2, 4
the local SAP identifier to associate with the Y.1564 test head
specifies which acceptance criteria group to include with the test head
configures the Y.1564 test to be color-aware. If enabled, the test compares the packet, jitter, and loss results to the in-profile and out-of-profile threshold settings. If disabled, the test compares packet, jitter, and loss results to their respective generic threshold values.
enables or disables performance monitoring tests. The test head generates time-stamped marker packets for measuring end-to-end, round-trip delay and jitter. These packets are injected along with standard filler packets used for throughput testing and can drastically skew test results, especially in tests with low bandwidth and large frame sizes.
ends an ITU-T Y.1564 test before it is complete
testhead-marker-packet-src-mac mac-address
config>test-oam
This command configures the source MAC address for Y.1564 test head marker packets.
The default value is all zeros. It is recommended that users provision this values to a unique value for the tested network, since the packet will not traverse Layer 2 networks.
a unicast destination MAC address
testhead-profile profile-id [create]
config>test-oam
This command creates an ITU-T Y.1564 test head profile. The test head acts like a template that can be configured with groupings of threshold and frame payload values in order to create a variety of IYU-T Y.1564 tests.
On adapter cards, one test head is supported per card. On the 7705 SAR-A, 7705 SAR-Ax, 7705 SAR-H, 7705 SAR-Hc, 7705 SAR-M, and 7705 SAR-Wx, one test head is supported per node. On the 7705 SAR-X, one test head is supported on MDA 2 and one on MDA 3.
1 to 32
acceptance-criteria acceptance-criteria-id [create]
no acceptance-criteria
config>test-oam>testhead-profile
This command configures a group of acceptance criteria thresholds, such as packet loss and jitter, to be associated with an ITU-T Y.1564 test head.
The no form of this command deletes the acceptance criteria group and all threshold values configured under it.
assigns an ID number to a group of acceptance criteria
cir-threshold cir-threshold
no cir-threshold
config>test-oam>testhead-profile>acceptance-criteria
This command configures the CIR threshold associated with the ITU-T Y.1564 test head.
no cir-threshold
the CIR threshold in kilobits per second
jitter-rising-threshold threshold
no jitter-rising-threshold
config>test-oam>testhead-profile>acceptance-criteria
This command configures the jitter rising threshold value. The threshold value is compared to the jitter rising value reported by a Y.1564 test and a failure is reported if the jitter rising value is greater than or equal to the configured threshold.
If an in-profile or out-of-profile jitter rising threshold is configured, that threshold value is used instead for comparison when an ITU-T Y.1564 test head color-aware test is run.
The no form of the command disables jitter rising threshold comparison after a Y.1564 test.
no jitter-rising-threshold
the jitter rising threshold, in microseconds
jitter-rising-threshold-in in-profile-threshold
no jitter-rising-threshold-in
config>test-oam>testhead-profile>acceptance-criteria
This command configures the in-profile jitter rising threshold value. If an in-profile or out-of-profile jitter rising threshold is configured, that threshold value is used for comparison when a Y.1564 test head color-aware test is run, instead of the jitter-rising-threshold value. When a non-color-aware test is performed, these values are ignored.
The no form of this command disables jitter rising threshold comparison after a Y.1564 test.
no jitter-rising-threshold-in
the in-profile rising threshold jitter value, in microseconds
jitter-rising-threshold-out out-profile-threshold
no jitter-rising-threshold-out
config>test-oam>testhead-profile>acceptance-criteria
This command configures the out-of-profile jitter rising threshold value. If an in-profile or out-of-profile jitter rising threshold is configured, that threshold value is used for comparison when a Y.1564 test head color-aware test is run, instead of the jitter-rising-threshold value. When a non-color-aware test is performed, these values are ignored.
The no form of this command disables jitter rising threshold comparison after a Y.1564 test.
no jitter-rising-threshold-out
the out-of-profile rising threshold jitter value, in microseconds
latency-rising-threshold threshold
no latency-rising-threshold
config>test-oam>testhead-profile>acceptance-criteria
This command configures the latency rising threshold value. The threshold value is compared to the latency rising value reported by a Y.1564 test, and a failure is reported if the latency rising value is greater than or equal to the configured threshold.
If an inbound or outbound latency rising threshold is configured, that threshold value is used instead for comparison when a Y.1564 test head color-aware test is run.
The no form of this command disables latency rising threshold comparison after a Y.1564 test.
no latency-rising-threshold
the latency rising threshold, in microseconds
latency-rising-threshold-in in-profile-threshold
no latency-rising-threshold-in
config>test-oam>testhead-profile>acceptance-criteria
This command configures the in-profile latency rising threshold value. If an in-profile or out-of-profile latency rising threshold is configured, that threshold value is used for comparison when a Y.1564 test head color-aware test is run, instead of the latency-rising-threshold value. When a non-color-aware test is performed, these values are ignored.
The no form of this command disables latency rising threshold comparison after a Y.1564 test.
no latency-rising-threshold-in
the in-profile latency rising threshold, in microseconds
latency-rising-threshold-out out-profile-threshold
no latency-rising-threshold-out
config>test-oam>testhead-profile>acceptance-criteria
This command configures the out-of-profile latency rising threshold value. If an in-profile or out-of-profile latency rising threshold is configured, their threshold value is used for comparison when a Y.1564 test head color-aware test is run, instead of the latency-rising-threshold value. When a non-color-aware test is performed, these values are ignored.
The no form of this command disables latency rising threshold comparison after a Y.1564 test.
no latency-rising-threshold-out
the out-of-profile latency rising threshold, in microseconds
loss-rising-threshold threshold
no loss-rising-threshold
config>test-oam>testhead-profile>acceptance-criteria
This command configures the loss rising threshold value. The threshold value is compared to the loss rising value reported by a Y.1564 test, and a failure is reported if the loss rising value is greater than or equal to the configured threshold.
If an in-profile or out-of-profile loss rising threshold is configured, that threshold value is used instead for comparison when a Y.1564 test head color-aware test is run.
The no form of this command disables loss rising threshold comparison after a Y.1564 test.
no loss-rising-threshold
the loss rising threshold, in increments of 0.0001%
loss-rising-threshold-in in-profile-threshold
no loss-rising-threshold-in
config>test-oam>testhead-profile>acceptance-criteria
This command configures the in-profile loss rising threshold value. If an in-profile or out-of-profile loss rising threshold is configured, that threshold value is used for comparison when a Y.1564 test head color-aware test is run, instead of the loss-rising-threshold value. When a non-color-aware test is performed, these values are ignored.
The no form of this command disables loss rising threshold comparison after a Y.1564 test.
no loss-rising-threshold-in
the in-profile loss rising threshold, in increments of 0.0001%
loss-rising-threshold-out out-profile-threshold
no loss-rising-threshold-out
config>test-oam>testhead-profile>acceptance-criteria
This command configures the out-of-profile loss rising threshold value. If an in-profile or out-of-profile loss rising threshold is configured, that threshold value is used for comparison when a Y.1564 test head color-aware test is run. When a non-color-aware test is performed, these values are ignored.
The no form of this command disables loss rising threshold comparison after a Y.1564 test.
no loss-rising-threshold-out
the out-of-profile loss rising threshold, in increments of 0.0001%
pir-threshold pir-threshold
no pir-threshold
config>test-oam>testhead-profile>acceptance-criteria
This command configures the PIR threshold associated with the ITU-T Y.1564 test head.
no pir-threshold
the PIR threshold in kilobits per second
description description-string
no description
config>test-oam>testhead-profile
This command creates a text description of a Y.1564 test head.
The no form of this command removes the text description.
n/a
the description character string. Allowed values are any string up to 80 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.
frame-payload payload-id [payload-type [l2 | tcp-ipv4 | udp-ipv4 | ipv4] [create]
no frame-payload payload-id
config>test-oam>testhead-profile
This command configures a frame payload profile for an ITU-T Y.1564 test head and assigns it a payload ID and payload type.
The no form of this command removes a payload from the test head.
n/a
1 to 8
applies a template that defines the test packet format
data-pattern hex-string
no data-pattern
config>test-oam>testhead-profile>frame-payload
This command configures the data pattern for an ITU-T Y.1564 frame payload profile.
The data-pattern defines the packet PDU, and is used to fill the packet PDU with repeating numbers of patterns up to the max PDU supported by the packet type as defined by the .
The no form of this command removes the data pattern specification from the frame payload profile.
no data-pattern
specifies the data pattern for the frame payload, maximum 64 hexadecimal nibbles
description description-string
no description
config>test-oam>testhead-profile>frame-payload
This command creates a text description for a Y.1564 frame payload profile.
The no form of this command removes the text description.
n/a
the description character string. Allowed values are any string up to 80 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.
[no] dscp dscp-name
config>test-oam>testhead-profile>frame-payload
This command configures the ITU-T Y.1564 frame payload profile DSCP name.
The no form of this command removes the DSCP name.
n/a
a text string of up to 80 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.
dst-ip ipv4 ipv4-address
no dst-ip
config>test-oam>testhead-profile>frame-payload
This command configures a destination IPv4 address for the ITU-T Y.1564 frame payload profile.
The no form of this command removes the IPv4 address.
no dst-ip
the destination IPv4 address for the Y.1564 packets
dst-mac ieee-address
no dst-mac
config>test-oam>testhead-profile>frame-payload
This command configures a destination MAC address for the ITU-T Y.1564 frame payload profile.
The no form of this command removes the MAC address.
no dst-mac
the destination MAC address for the Y.1564 packets
dst-port dst-port-number
no dst-port
config>test-oam>testhead-profile>frame-payload
This command configures a destination port number for the ITU-T Y.1564 frame payload profile.
The no form of this command removes the port number.
no dst-port
the destination port number for the Y.1564 packets, expressed in decimal, hexadecimal, or binary notation
ethertype 0x0600..0xffff
no ethertype
config>test-oam>testhead-profile>frame-payload
This command configures the expected Ethertype for the ITU-T Y.1564 frame payload profile.
The no form of this command removes the configured Ethertype.
no ethertype
specifies the Ethertype to expect
frame-size frame-size
no frame-size
config>test-oam>testhead-profile>frame-payload
This command configures the frame size to be used for the ITU-T Y.1564 frame payload profile.
The no form of this command removes the frame size restriction.
no frame-size
the frame size, in bytes
ip-proto ip-protocol-number
no ip-proto
config>test-oam>testhead-profile>frame-payload
This command adds an IP protocol to an ITU-T Y.1564 frame payload profile.
When a payload type is specified as IPv4, this command allows you to specify the upper layer protocol that the frame carries.
The no form of this command removes the IP protocol from the ITU-T Y.1564 test head frame payload.
no ip-proto
the IP protocol number
ip-tos type-of-service
no ip-tos
config>test-oam>testhead-profile>frame-payload
This command specifies an IP service type for an ITU-T Y.1564 frame payload profile.
The no form of this command removes the configured service type.
no ip-tos
the type of service
ip-ttl ttl-value
no ip-ttl
config>test-oam>testhead-profile>frame-payload
This command configures a time-to-live value for an ITU-T Y.1564 frame payload profile.
The no form of this command removes the time-to-live value.
no ip-ttl
the time-to-live value for the ITU-T Y.1564 test head frame, expressed as a decimal integer
rate rate-in-kbs
no rate
config>test-oam>testhead-profile>frame-payload
This command configures the frame rate for an ITU-T Y.1564 frame payload profile.
When configure the rate values, you must take into account the fabric overhead as per the SAP ingress | egress-queue provisioning rules.
The no form of this command removes the configured rate value.
no rate
the ITU-T Y.1564 frame rate, in kilobits per second
src-ip ipv4 ipv4-address
no src-ip
config>test-oam>testhead-profile>frame-payload
This command configures the source IP address for an ITU-T Y.1564 frame payload profile.
The no form of this command removes the source IP address.
no src-ip
the source IP address of the frame payload
src-mac ieee-address
no src-mac
config>test-oam>testhead-profile>frame-payload
This command configures the source MAC address for an ITU-T Y.1564 frame payload profile.
The no form of this command removes the source MAC address.
no src-mac
the source MAC address for the ITU-T Y.1564 packets
src-port src-port-number
no src-port
config>test-oam>testhead-profile>frame-payload
This command configures the source port number for an ITU-T Y.1564 frame payload profile.
The no form of this command removes the port number.
no src-port
the source port number of the ITU-T Y.1564 frame payload, expressed as a decimal, hexadecimal, or binary notation
vlan-tag-1 vlan-id vlan-id [tpid tpid] [dot1p dot1p-value]
no vlan-tag-1
config>test-oam>testhead-profile>frame-payload
This command configures the first VLAN associated with the ITU-T Y.1564 frame payload profile.
The no form of this command removes the VLAN.
no vlan-tag-1
the associated VLAN ID
the Tag Protocol Identifier expressed in decimal or hexadecimal notation
the dot1p priority bits value for the ITU-T Y.1564 test head frame payload. Setting the value to 0 is equivalent to removing the dot1p value.
vlan-tag-2 vlan-id vlan-id [tpid tpid] [dot1p dot1p-value]
no vlan-tag-2
config>test-oam>testhead-profile>frame-payload
This command configures the second VLAN associated with the ITU-T Y.1564 frame payload profile.
The no form of this command removes the VLAN.
no vlan-tag-2
the associated VLAN ID
the Tag Protocol Identifier expressed in decimal or hexadecimal notation
the dot1p priority bits value for the ITU-T Y.1564 test head frame payload. Setting the value to 0 is equivalent to removing the dot1p value.
rate cir cir-rate-in-kbs [pir pir-rate-in-kbs]
no rate
config>test-oam>testhead-profile
This command enables the CIR and PIR rates for an ITU-T Y.1564 test head profile.
When no acceptance criteria are configured, the CIR and PIR values are used to determine if the test passes or fails. In order for the test to pass, the measured throughput must be within 1% of the configured PIR value (for color-aware tests) or CIR value (for non-color-aware tests).
The no form of this command removes the configured rate values.
no rate
The CIR throughput value for color-aware tests, in kilobits per second
The PIR throughput value for non-color-aware tests, in kilobits per second
[no] test-completion-trap-enable
config>test-oam>testhead-profile
This command enables a trap that is sent to the operator when the ITU-T Y.1564 test is complete. By default, the system raises an SNMP trap after an ITU-T Y.1564 test.
The no form of this command disables the trap.
test-completion-trap-enable
test-duration {[hours hours] [minutes minutes] [seconds seconds]}
no test-duration
config>test-oam>testhead-profile
This command configures the duration of the ITU-T Y.1564 test.
The no form of this command removes the duration limitation from the test head.
no test-duration
the test duration in hours
the test duration in minutes
the test duration in seconds
loopback {line | internal} {timer seconds | persistent} [swap-src-dst-mac]
no loopback
config>service>epipe>sap
This command configures a timed loopback on an Ethernet pseudowire SAP and is required to complete an ITU-T Y.1564 test.
The no form of this command disables the loopback.
no loopback
places the associated Ethernet pseudowire SAP into line loopback mode
places the associated Ethernet pseudowire SAP into internal loopback mode
the loopback time, in seconds
configures the loopback as persistent, or latched, and enables it indefinitely until deactivated by a user
swaps source and destination MAC addresses for Ethernet line loopbacks