acceptance-criteria acceptance-criteria-id [create]
no acceptance-criteria acceptance-criteria-id
configure>test-oam
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the test acceptance criteria policy to be used by the service test testhead OAM tool for determining the test result upon test completion.
By default, acceptance-criteria 1 is created and associated with all streams that do not have an explicit acceptance-criteria policy already associated by the user. This acceptance criteria is attached to every service-stream created under the service-test context, for which no explicit acceptance-criteria policy is configured by the user. Changes cannot be made to the default.
The no form of this command removes the currently associated acceptance-criteria policy and associates the default policy.
acceptance criteria 1
Specifies a decimal number used to identify the test acceptance criteria and to use when starting the throughput test.
cir-threshold cir-threshold
no cir-threshold
configure>test-oam>acceptance-criteria
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures a CIR value that is compared to the measured results for the cir and policing test types. If the measured value is greater than the configured value, the test passes; otherwise, it fails. For more information, see the use-m-factor command.
The no form of this command disables the comparison of the parameter with the measured value so that the CIR threshold value is ignored for declaring the test result.
no cir-threshold
The CIR value for comparison with the measured value.
jitter-rising-threshold threshold
no jitter-rising-threshold
configure>test-oam>acceptance-criteria
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures a jitter value that is compared to the measured jitter at the end of the test in order to declare the test result. If the measured value is greater than the configured value, the test fails; otherwise, it passes.
The no form of this command disables the comparison of the parameter with the measured value so that the threshold value is ignored for declaring the test result.
no jitter-rising-threshold
The jitter value for comparison with measured value.
latency-rising-threshold threshold
no latency-rising-threshold
configure>test-oam>acceptance-criteria
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures a latency value that is compared to the measured latency at the end of the test to declare the test result. If the measured value is greater than the configured value, the test fails; otherwise, it passes. A measured latency value of zero also causes the test to fail.
The no form of this command disables the comparison of the parameter with the measured value so that the threshold value is ignored for declaring the test result.
no latency-rising-threshold
Specifies the latency value for comparison with the measured value.
loss-rising-threshold threshold
no loss-rising-threshold
configure>test-oam>acceptance-criteria
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures a frame loss ratio (FLR) value that is compared to the measured FLR at the end of the test to determine the test result. If the measured value is greater than the configured value, the test fails; otherwise, it passes. If the loss-rising-threshold is not configured explicitly, any non-zero value of loss causes the test to fail.
The FLR is computed as a ratio of the difference of the number of received frames to the number of injected or sent frames divided by the number of sent frames.
The no form of this command disables the comparison of the parameter with the measured value so that the threshold value is ignored for declaring the test result.
no loss-rising-threshold
Specifies the threshold value for comparison with the measured value, specified as a number which denotes one ten-thousandth (1/10000) of a percent. For example, specifying a value of 1 is equivalent to 0.0001%, and specifying a value of 10000 is equivalent to 1%.
pir-threshold threshold
no pir-threshold
configure>test-oam>acceptance-criteria
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures a PIR value that is compared to the measured results for the cir-pir, policing, and performance test types. If the measured value is greater than the configured value, the test passes; otherwise, it fails. For more information, see the use-m-factor command.
The no form of this command disables the comparison of the parameter with the measured value so that the threshold value is ignored for declaring the test result.
no pir-threshold
Specifies the value for comparison with the measured value.
use-m-factor use-m-factor
no use-m-factor
configure>test-oam>acceptance-criteria
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the margin by which the observed throughput is off from the configured throughput to determine whether a service test passes or fails.
The list below describes how the M factor is used with cir-threshold and pir-threshold values for different test types to determine whether a test passes or fails.
For test-type cir, if the measured throughout is less than the difference of the configured CIR threshold and the M factor, the test fails
For test-type cir-pir, if the measured throughput is less than the difference of the configured PIR threshold and the M factor, the test fails
For test-type policing:
if the measured throughput is less than the difference of the configured PIR threshold and the M factor, the test fails
if the measured throughput is greater than the sum of the configured PIR threshold and the M factor, the test fails
For test-type performance, if the measured throughput is less than the difference of the configured PIR threshold and the M factor, the test fails
The no form of this command removes the M factor.
no use-m-factor
Specifies the value to use for the M factor.
frame-mix frame-mix-id [create]
no frame-mix
configure>test-oam
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command creates a policy for configuring frames of different sizes for use with a test stream configured under service test testhead OAM tool. The ITU-T Y.1564 standard designates the letters a to h with a default frame size. Users can order a sequence of letters to specify the frame sizes that configured streams can use for frame generation. The 7210 SAS offers the flexibility of assigning a different frame size to each of the letters.
The no form of this command deletes the specified frame-mix template.
Specifies the identifier for a test flow with a given frame mix.
size-a size
no size-a
configure>test-oam>frame-mix
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures Ethernet frame size to be associated with the letter ‟a”.
The no form of this command restores the default frame size associated with the letter ‟a”.
64 bytes
Specifies the value for Ethernet frame size to be associated with the letter ‟a”.
size-b size
no size-b
configure>test-oam>frame-mix
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures Ethernet frame size to be associated with the letter ‟b”.
The no form of this command restores the default frame size associated with the letter ‟b”.
128 bytes
Specifies the value for Ethernet frame size to be associated with the letter ‟b”.
size-c size
no size-c
configure>test-oam>frame-mix
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures Ethernet frame size to be associated with the letter ‟c”.
The no form of this command restores the default frame size associated with the letter ‟c”.
256 bytes
Specifies the value for Ethernet frame size to be associated with the letter ‟c”.
size-d size
no size-d
configure>test-oam>frame-mix
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures Ethernet frame size to be associated with the letter ‟d”.
The no form of this command restores the default frame size associated with the letter ‟d”.
512 bytes
Specifies the value for Ethernet frame size to be associated with the letter ‟d”.
size-e size
no size-e
configure>test-oam>frame-mix
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures Ethernet frame size to be associated with the letter ‟e”.
The no form of this command restores the default frame size associated with the letter ‟e”.
1024 bytes
Specifies the value for Ethernet frame size to be associated with the letter ‟e”.
size-f size
no size-f
configure>test-oam>frame-mix
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures Ethernet frame size to be associated with the letter ‟f”.
The no form of this command restores the default frame size associated with the letter ‟f”.
1280 bytes
Specifies the value for Ethernet frame size to be associated with the letter ‟f”.
size-g size
no size-g
configure>test-oam>frame-mix
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures Ethernet frame size to be associated with the letter ‟g”.
The no form of this command restores the default frame size associated with the letter ‟g”.
1518 bytes
Specifies the value for Ethernet frame size to be associated with the letter ‟g”.
size-h size
no size-h
configure>test-oam>frame-mix
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures Ethernet frame size to be associated with the letter ‟h”.
The no form of this command restores the default frame size associated with the letter ‟h”.
9212 bytes
Specifies the value for Ethernet frame size to be associated with the letter ‟h”.
size-u size
no size-u
configure>test-oam>frame-mix
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures Ethernet frame size to be associated with the letter ‟u”, which is user defined.
The no form of this command sets the value to the default.
0 bytes
Specifies the value for Ethernet frame size to be associated with the letter ‟u”.
frame-payload frame-payload-id [payload-type [l2 | tcp-ipv4 | udp-ipv4 | ipv4] [create]
no frame-payload frame-payload
configure>test-oam
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command specifies the packet header values to be used in frames generated by the service test testhead tool.
One of four types of frame payload, representing different kinds of traffic, can be selected when starting the throughput test.
The payload-type parameter determines the packet header fields that are used to populate the frames generated by the tool. The packet header fields use the parameters configured under the frame-payload. For example, when the payload-type is configured as l2, software uses the parameters src-mac, dst-mac, vlan-tag-1 (if configured), vlan-tag-2 (if configured), ethertype, and data-pattern. The parameter description below describe the parameters to be used when other values are specified with payload-type.
The no form of this command removes the frame payload context.
Identifies the frame payload, it is an integer used to identify the frame type to use when starting the throughput test.
Identifies whether the frame payload is Layer 2 traffic, IP traffic, TCP/IP traffic or UDP/IP traffic and uses appropriate parameters to build the frame generated by the service test testhead OAM tool. If no frame payload type value is specified during creation of the new frame payload, the default is tcp-ipv4.
data-pattern data-pattern
no data-pattern
configure>test-oam>frame-payload
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the data pattern to populate the payload portion of the frame generated by the service test testhead OAM tool.
This value can be specified when the payload-type is configured as l2, ipv4, tcp-ipv4 or udp-ipv4. For all these payload types, the frame with the appropriate headers is created and the payload portion of the frame is filled up with the data pattern value specified with this command, repeating it as many times as required to fill up the remaining length of the payload.
The no form of this command uses the default data pattern value of 0xa1b2c3d4e5f6.
0xa1b2c3d4e5f6
Specifies the data pattern to fill the payload data.
description frame-description
no description
configure>test-oam>frame-payload
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command creates a text description for a frame generated by the service test testhead OAM tool.
The no form of this command removes the description.
no description
An ASCII string used to describe the frame.
dscp dscp-name
no dscp
configure>test-oam>frame-payload
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the IP DSCP value to use in the IP header for the frame generated by the service test testhead OAM tool.
This value can be specified when the payload-type is configured as ipv4, tcp-ipv4, or udp-ipv4. When the payload-type is set to ipv4, tcp-ipv4, or udp-ipv4 but this command is not configured, the DSCP value defaults to be. The tool does not use the value specified with this command if the payload-type is l2.
If both IP DSCP and IP ToS are configured, IP DSCP take precedence.
If IP DSCP is not configured but IP ToS is configured, the IP ToS value is used
The no form of this command indicates that the field is not to be used in the frame generated by the tool.
be
Specifies the IPv4 DSCP value to use in the IP header.
dst-ip ipv4 ipv4-address
no dst-ip ipv4
configure>test-oam>frame-payload
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the destination IPv4 address to use in the IP header of the frame generated by the service test testhead OAM tool.
This value must be specified if the payload-type is configured as ipv4, tcp-ipv4, or udp-ipv4. The tool does not use the value specified with this command if the payload-type is l2.
The no form of this command indicates that the field is not to be used in the frame generated by the tool.
no dst-ip ipv4 if the payload-type is set to ipv4, tcp-ipv4 or udp-ipv4
The IPv4 destination IP address to use in the IP header.
dst-mac ieee-address [ieee-address-mask]
no dst-mac
configure>test-oam>frame-payload
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the destination MAC address to use in the frame generated by the service test testhead OAM tool. Only unicast MAC address must be specified.
This value must be specified for all possible values of payload-type.
The no form of this command indicates that the field is not to be used in the frame generated by the tool.
no dst-mac
Specifies the unicast destination MAC address for Y1564 packets.
dst-port dst-port-number
no dst-port
configure>test-oam>frame-payload
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the destination port to use in the TCP header of the frame generated by the service test testhead OAM tool.
This value must be specified if the payload-type is configured as tcp-ipv4 or udp-ipv4. The tool does not use the value specified with this command if the payload-type is l2 or ipv4.
The no form of this command indicates that the field is not to be used in the frame generated by the tool.
no dst-port, if the payload-type is set to tcp-ipv4 or udp-ipv4
Specifies the destination TCP/UDP port number to use in the frame’s TCP/UDP header.
ethertype 0x0600..0xffff
no ethertype
configure>test-oam>frame-payload
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the Ethertype for the frame generated by the service test testhead OAM tool.
This value must be specified when the payload-type is l2. The tool uses the value specified with this command only if the payload-type is l2. See the frame-payload command description for information when the payload-type is configured with an option other than l2.
The no form of this command indicates that the field is not to be used in the frame generated by the tool.
0x0800
An Ethertype value specified as a hexadecimal string in the range 0x0600 to 0xffff.
ip-proto ip-protocol-number
no ip-proto
configure>test-oam>frame-payload
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the IP protocol to use in the IP header of the frame payload generated by the service test testheadOAM tool.
This value must be specified when the payload-type is configured as ipv4. If the payload-type is configured as tcp-ipv4 or udp-ipv4, the appropriate standard-defined values are used. The tool does not use the value specified with this command when the payload-type is l2.
The no form of this command indicates that the field is not to be used in the frame generated by the tool.
no ip-proto
Specifies the IP protocol number to use in the IP header of Y.1564 packets.
ip-tos type-of-service
no ip-tos
configure>test-oam>frame-payload
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the IP TOS (Type of Service) value to use in the IP header of the frame generated by the service test testhead OAM tool.
This value can be specified when the payload-type is configured as ipv4, tcp-ipv4, or udp-ipv4. If this command is not configured and the payload-type is set to ipv4, tcp-ipv4, or udp-ipv4, the ToS value defaults to 0. The tool does not use the value specified with this command when the payload-type is l2.
If both IP DSCP and IP ToS are configured, the IP DSCP value is used. If IP DSCP is not configured, but IP ToS is configured, the IP ToS value is used.
The no form of this command indicates that the field is not to be used in the frame generated by the tool.
no ip-tos
Specifies ToS bits to use in the IP header.
ip-ttl ttl-value
no ip-ttl
configure>test-oam>frame-payload
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the IP TTL (Time-to-Live) value to use in the IP header of the frame generated by the service test testhead OAM tool.
This value can be specified if the payload-type is configured as ipv4, tcp-ipv4, or udp-ipv4. If this command is not configured and the payload-type is set to ipv4, tcp-ipv4, or udp-ipv4, the TTL value defaults to 0. The tool does not use the value specified with this command when the payload-type is l2.
The no form of this command indicates that the field is not to be used in the frame generated by the tool.
255
Specifies the IP TTL value to use in the IP header.
src-ip ipv4 ipv4-address
no src-ip ipv4
configure>test-oam>frame-payload
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the source IPv4 address to use in the IP header of the frame generated by the service test testhead OAM tool.
This value must be specified when the payload-type is configured as ipv4, tcp-ipv4, or udp-ipv4. The tool does not use the value specified with this command when the payload-type is l2.
The no form of this command indicates that the field is not to be used in the frame generated by the tool.
no src-ip, if the payload-type is set to ipv4, tcp-ipv4, udp-ipv4.
Specifies the IPv4 source IP address to use in the IP header.
src-mac ieee-address [ieee-address-mask]
no src-mac
configure>test-oam>frame-payload
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the source MAC address to use in the frame generated by the service test testhead OAM tool. Only unicast MAC address must be specified.
This value must be specified for all possible values of payload-type.
The no form of this command indicates that the field is not to be used in the frame generated by the tool.
no src-mac
Specifies the unicast source MAC address.
src-port src-port-number
no src-port
configure>test-oam>frame-payload
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the source port to use in the TCP header of the frame generated by the service test testhead OAM tool.
This value must be specified when the payload-type is configured as tcp-ipv4 or udp-ipv4. The tool does not use the value specified with this command if the payload-type is set to l2 or ipv4.
The no form of this command indicates that the field is not to be used in the frame generated by the tool.
no src-port, if the payload-type is set to tcp-ipv4 or udp-ipv4
The source TCP/UDP port number to use in the frame’s TCP/UDP header.
vlan-tag-1 vlan-id vlan-id-value [tpid tpid value] [dot1p dot1p-value] [dei [0..1]]
no vlan-tag-1
configure>test-oam>frame-payload
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the VLAN ID, dot1p bit, and TPID value to be used for the outermost VLAN tag (often called the outer VLAN) in the frame generated by the service test testhead OAM tool.
Configuration of this parameter is optional and it is used for all possible values of payload-type, if configured.
The no form of this command indicates that the field is not to be used in the frame generated by the tool.
For the frame generated by the tool to be processed successfully on SAP ingress, the TPID value configured with this command must match either the QinQ Ethertype value in use on the port on which the test SAP is configured or it must match 0x8100 if the test SAP is configured on a dot1q encapsulation port. If this value does not match the value configured under the port, frames generated by the tool are dropped by the node on SAP ingress due to an Ethertype mismatch.
For the frame generated by the tool to be processed successfully on SAP ingress, the VLAN ID configured with this command must match the outermost VLAN tag of the QinQ SAP or the Dot1q SAP used for the test SAP. If this value does not match the value configured for the SAP, frames generated by the tool are dropped by the node on SAP ingress due to a VLAN ID mismatch.
The dot1p bits specified for the outermost tag can be used for SAP ingress QoS classification.
no vlan-tag-1
Specifies the VLAN ID used for the VLAN tag. A value must be specified if this command is configured; there is no default value.
Specifies the TPID (also known as Ethertype) to use for the VLAN tag addition. If no value is specified, the TPID defaults to 0x8100.
Specifies the value used to populate the dot1p bits in the VLAN tag. If no value is specified, the dot1p setting defaults to 0.
Specifies the a 1-bit field inside the VLAN header.
vlan-tag-2 vlan-id vlan-id-value [tpid tpid value] [dot1p dot1p-value] [dei [0..1]]
no vlan-tag-2 vlan-id
configure>test-oam>frame-payload
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the VLAN ID, dot1p bit, and TPID value to be used for the second VLAN tag (often called the inner VLAN or the C-VLAN) in the frame generated by the service test testhead OAM tool.
Configuration of this parameter is optional and it is used for all possible values of payload-type, if configured.
The no form of this command indicates that the field is not to be used in the frame generated by the tool.
For the frame generated by the tool to be processed successfully on SAP ingress, the TPID value configured with this command must be 0x8100. If this value does not match 0x8100, frames generated by the tool are dropped by the node on SAP ingress due to an Ethertype mismatch (7210 SAS supports only 0x8100 as the Ethertype value for the inner VLAN tag).
For the frames generated by the tool to be processed successfully on SAP ingress, the VLAN ID configured with this command must match the outermost VLAN tag of the QinQ SAP or the dot1q SAP used for the test SAP. If this value does not match the value configured for the SAP, frames generated by the tool are dropped by the node on SAP ingress due to a VLAN ID mismatch.
The dot1p bits specified for the outermost tag can be used for SAP ingress QoS classification.
no vlan-tag-2
Specifies the VLAN ID used for the VLAN tag. A value must be specified if this command is configured; there is no default value.
Specifies the TPID (also knows as Ethertype) to use for the VLAN tag addition. If no value is specified, the TPID defaults to 0x8100.
Specifies the value used to populate the dot1p bits in the VLAN tag. If no value is specified, the dot1p setting defaults to 0.
Specifies the a 1-bit field inside the VLAN header.
service-test test-id [create]
no service-test
config>test-oam
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures a service test. The no form of this command removes the service test.
The service test must be in the shutdown state in order for any commands under the service-test context to be configured or modified. If the service test is in the no shutdown state, no command parameters can be changed.
Specifies an identifier for the service test profile.
accounting-policy acct-policy-id
no accounting-policy
config>test-oam>service-test
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command creates an accounting policy for the specified service test. The no form of this command removes the policy.
Specifies an identifier for the service test accounting policy.
description description-string
no description
config>test-oam>service-test
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures a description for the specified service test. The no form of this command removes the description.
Specifies a description for the service test, up to 80 characters.
service-stream stream-id [create]
no service-stream stream-id
config>test-oam>service-test
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures an OAM service stream profile for the specified service test. A service test must be in a shutdown state before a new service stream can be configured or before parameters can be modified on an existing stream. Any tests currently running that reference the specified service test must be stopped before executing the shutdown command.
The no form of this command removes the specified profile.
Specifies an identifier for the service stream profile.
acceptance-criteria acceptance-criteria-id
no acceptance-criteria
config>test-oam>service-test>service-stream
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the acceptance criteria for the specified service stream. The no form of this command removes the acceptance criteria and configures back acceptance-criteria 1.
acceptance-criteria 1
Specifies an identifier for the acceptance criteria.
description description-string
no description
config>test-oam>service-test>service-stream
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures a description for the specified service stream. The no form of this command removes the description.
Specifies a description for the service stream, up to 80 characters.
fc fc-name
no fc
config>test-oam>service-test>service-stream
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command specifies the forwarding class that is validated for the service stream. The frames generated by the testhead go through the classification entries in the SAP ingress QoS policy applied to the test SAP, and a forwarding class is assigned. The fc-name specified in this command must match the FC configured in the QoS entries. On receiving the testhead packets from the peer-side after loopback, if the FC name received, matches the configured service-stream, the software obtains the counters required to determine throughput and loss metrics for the test.
The no form of this command removes the forwarding class association and sets it to the default value.
be
Specifies the name of the forwarding class.
frame-payload frame-payload-id
no frame-payload
config>test-oam>service-test>service-stream
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the frame payload for the specified service stream.
The no form of this command removes the frame payload from the service stream.
Specifies the frame payload identifier.
frame-size [frame-mix frame-mix-id] [frame-sequence]
frame-size [fixed-size frame-size]
no frame-size
config>test-oam>service-test>service-stream
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the frame size for the specified service stream. Users have the option to configure frames to have a fixed size or a mix of frames of different sizes. When configuring a mix of frame sizes, Ethernet frame sizes can be configured based on the size designations in Recommendation ITU-T Y.1564. When using the Y.1564 designations, it is possible to configure the order in which the frames are generated by the test tool by using the frame-sequence variable. Ethernet frame sizes can also be specified with the fixed-size parameter so that all frames generated by the tool have the same size payload.
The no form of this command sets the frame size in the service stream to the default value. Frames configured with fixed-size parameter have a default value of 1514 bytes.
Specifies the frame mix identifier for the specified service stream.
Specifies a string of 16 characters denoting the sequence of frames of different sizes to be generated by the testhead tool.
Specifies the frame size of the packets to be generated by the service test testhead OAM tool.
rate cir cir-rate-in-kbps [cir-adaptation-rule cir-adaptation-rule] [pir pir-rate-in-kbps] [pir-adaptation-rule pir-adaptation-rule]
no rate
config>test-oam>service-test>service-stream
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the CIR that must be validated for the specified stream. If specified, the PIR value must be greater than or equal to the CIR value. The service test testhead OAM tool generates traffic up to the specified rate based on the test-type command, as follows.
For test-type cir, traffic is generated at a rate up to the configured CIR.
For test-type cir-pir, traffic is generated at a rate up to the configured PIR.
For test-type policing, traffic is generated at a rate up to 125% of the configured PIR.
For test-type performance, traffic is generated at a rate up to the configured PIR.
The testhead uses the Layer 2 rate, which is calculated by subtracting the Layer 1 overhead that is caused when the IFG and Preamble are added to every Ethernet frame (typically about 20 bytes (IFG = 12 bytes and Preamble = 8 bytes)). The testhead tool uses the user-configured frame size to compute the Layer 2 rate and does not allow the user to configure a value greater than that rate. For 512-byte Ethernet frames, the L2 rate is 962406 Kb/s and the Layer 1 rate is 1 Gb/s.
Configure the adaptation-rule parameter to derive the operational hardware rate for both the CIR and PIR. The software finds the best operational rate based on the user-specified constraint and the hardware-based rate supported on the platform.
The no form of this command sets the CIR value to the default; the PIR value is not set. Consequently, if the testhead tool is run after the no rate command is run, the test generates traffic up to the configured CIR rate.
Specifies the cir parameter, in kilobits per second (Kb/s), which overrides the default CIR value. The configured value must be a positive integer; fractional values are not allowed. The actual CIR rate depends on the meter adaptation-rule parameters and the hardware. If the rate command is not executed or the CIR parameter is not explicitly specified, the default CIR value applies.
Specifies the constraints enforced when adapting the CIR and PIR, defined using the rate command, to the hardware rates supported by the platform. The adaptation-rule parameter requires a qualifier that defines the constraint used to derive the operational CIR and PIR. If the adaptation-rule is not specified, the default of closest applies. The max (maximum), min (minimum), and closest qualifiers are mutually exclusive.
Specifies the PIR rate in kilobits per second (Kb/s), which overrides the default administrative PIR value. The configured value must be a positive integer; fractional values are not allowed. The actual PIR rate depends on the meter adaptation-rule parameters and the hardware. If the rate command is not executed or the PIR parameter is not explicitly specified, the default PIR value is used.
sap sap-id
no sap
config>test-oam>service-test>service-stream
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures th test SAP to use for the specified stream.
The no form of this command removes the SAP.
Specifies the identifier for the SAP. See SAP syntax in Common CLI command descriptions for information about parameter format options.
[no] shutdown
config>test-oam>service-test>service-stream
config>test-oam>service-test
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command enables or disables the specified service test or stream.
The service test must be in the shutdown state in order for any commands under the service-test context to be configured or modified. If the service test is in the no shutdown state, no command parameters can be changed.
shutdown
test-type [[cir] [cir-pir] [policing] [performance]]
no test-type
config>test-oam>service-test>service-stream
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the types of tests to perform on the specified service stream.
The no form of this command removes the configured test type.
Specifies the CIR on the service stream.
Specifies both the CIR and PIR on the service stream.
Specifies the policing function on the service stream.
Specifies performance of the service stream.
stream-run-type {ordered | parallel}
no stream-run-type
config>test-oam>service-test
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the sequence in which service streams are executed during the specified service test.
The no form of this command removes the run type.
ordered
Specifies that the streams run consecutively, in order of service stream ID.
Specifies that the streams run concurrently.
[no] test-completion-trap-enable
config>test-oam>service-test
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command enables the test completion SNMP trap. The no form of this command disables the trap.
test-duration [[cir] [cir-pir] [policing] [performance {[hours hours]}]] {[minutes minutes] [seconds seconds]}
no test-duration
config>test-oam>service-test
7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C
This command configures the duration for the specified test type. Default test duration values are based on the test type.
The no form of this command returns the duration value to its default setting for all test types.
Specifies the test duration is for the CIR test. The default duration for this test is 300 seconds.
Specifies the test duration is for the CIR and PIR test. The default duration for this test is 600 seconds.
Specifies the test duration is for the policing test. The default duration for this test is 600 seconds.
Specifies the test duration is for the performance test. The default duration for this test is 900 seconds.
Specifies the number of hours to run the test. This parameter only applies to the performance test type.
Specifies the number of minutes to run the test. This parameter applies to all test types.
Specifies the number of seconds to run the test. This parameter applies to all test types.