The 7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, and 7210 SAS-K 3SFP+ 8C support the service test framework through the use of the service test testhead OAM tool. This tool allows for configuration of multiple streams (also called flows) for which service performance metrics can be obtained. See the Platform Scaling Guide to know the number of streams supported by the various platforms. With multiple streams, it is possible to potentially configure two service tests to validate two services each with two forwarding classes (FCs), or validate a single service with four FCs, or validate a mix of services and FCs as long as the number of streams are within the limit supported by the platform.
A set of streams under a single service test can be grouped together using the service-stream configuration commands and each stream can be configured with the options listed as follows:
The CIR and/or PIR can be configured for each of the streams, along with the frame payload contents and the frame size.
Different acceptance criteria per stream can be configured and used to determine pass/fail criteria for the stream, along with the ability to monitor the streams that are in progress.
For each stream, it is possible to use a single command to run a service configuration test, CIR test, PIR test, and service performance test concurrently instead of running each test individually.
Instead of using threshold parameters to determine the pass/fail criteria for a test, it is possible configure the margin by which the measured throughput is off from the configured throughput to determine pass/fail criteria. The margin is configured using the use-m-factor CLI command.
The test results can be stored in an accounting record in XML format. The XML file contains the keywords and MIB references listed in the following table.
XML file keyword |
Description |
TIMETRA-SAS-OAM-Y1564-MIB |
|---|---|---|
acceptanceCriteriaId |
Provides the ID of the acceptance criteria policy used to compare the measured results |
tmnxY1564StreamAccCritId |
accountingPolicy |
Provides the ID of the accounting policy, which determines the properties of the accounting record generated, such as how frequently to write records, rollover interval, and so on |
tmnxY1564ServTestAccPolicy |
achievedThroughput |
The throughput measured by the tool, as observed by measuring the rate of testhead packets received by the tool |
tmnxY1564StreamResAchvdThruput |
cirAdaptRule |
The adaptation rule to apply to the configured CIR rate to match it to hardware-supported rates |
tmnxY1564StreamCIRAdaptation |
cirRate |
The user-configured CIR rate |
tmnxY1564StreamAdminCIR |
cirTestDur |
The duration, in seconds, of the CIR configuration test |
tmnxY1564ServTestCirTestDuration |
cirThreshold |
The CIR rate threshold to compare with the measured value |
tmnxY1564AccCritCirThres |
dataPattern |
The data pattern to include in the packet generated by the service testhead tool |
tmnxY1564PayLddataPattrn |
description |
The user-configured description for the test |
tmnxY1564ServTestDescription |
desiredThroughput |
The user-configured rate that is the target to achieve. The desired throughput value is either the user-configured CIR rate or PIR rate, based on the test type. |
tmnxY1564StreamResDesiredThruput |
dstIp |
The destination IP address to use in the packet generated by the tool |
tmnxY1564PayLdDstIpv4Addr |
dstMac |
The destination MAC address to use in the packet generated by the tool |
tmnxY1564PayLdDstMac |
dstPort |
The destination TCP/UDP port to use in the packet generated by the tool |
tmnxY1564PayLdDstPort |
endTime |
The time (wall-clock time) the test was completed |
tmnxY1564ServTestCompletionTime |
etherType |
The Ethertype value to use in the packet generated by the tool |
tmnxY1564PayLdEthertype |
fc |
The forwarding class for which the tool is being used to measure the performance metrics |
tmnxY1564StreamFc |
fixedFrameSize |
The frame size to use for the generated packet; used to specify a single value for all frames generated by the tool |
tmnxY1564StreamFrameSize |
flr |
The measured frame loss ratio |
tmnxY1564StreamResMeasuredFLR |
flrAcceptance |
Indicates whether the measured FLR is within the configured loss threshold |
tmnxY1564StreamResFLRAcceptanceResult |
frameLossThreshold |
The loss threshold configured in the acceptance criteria |
tmnxY1564AccCritLossRiseThres |
frameMixId |
The ID of the frame-mix policy. The testhead tool generates packets sizes as specified in the frame-mix policy. This is used to specify a mix of frames with different sizes to be generated by the tool. |
tmnxY1564StreamFrameMixId |
framePayloadId |
The ID of the frame payload. The frame payload defines the format of the payload and provides the frame/packet header values and data pattern to use for the payload. |
tmnxY1564StreamPayLdId |
id |
Provides information about either the frame mix policy ID, acceptance criteria policy ID, or frame payload ID to use for the service test, depending on the context it appears in |
tmnxY1564StreamFrameMixId tmnxY1564StreamAccCritId tmnxY1564StreamPayLdId |
ipDscp |
The IP DSCP value used in the frame payload |
tmnxY1564PayLdDSCP |
ipProto |
The IP protocol value used in the frame payload |
tmnxY1564PayLdIpProto |
ipTos |
The IP ToS bits value used in the frame payload |
tmnxY1564PayLdIpTos |
ipTtl |
The IP TTL value used in the frame payload |
tmnxY1564PayLdIpTTL |
jitter |
The measured jitter value |
tmnxY1564StreamResMeasuredJitter |
jitterAcceptance |
Indicates whether the measured jitter is within the configured jitter threshold |
tmnxY1564StreamResJitterAcceptanceResult |
jitterThreshold |
The jitter threshold configured in the acceptance criteria |
tmnxY1564AccCritJittrRiseThres |
latencyAcceptance |
Indicates whether the measured FLR is within configured loss threshold. |
tmnxY1564StreamResLatencyAcceptanceResult |
latencyAvg |
The average of latency values computed for the test stream |
tmnxY1564StreamResMeasuredLatency |
latencyMax |
The maximum value of latency measured by the tool |
tmnxY1564StreamResMaxLatency |
latencyMin |
The minimum value of latency measured by the tool |
tmnxY1564StreamResMinLatency |
latencyThreshold |
The latency threshold configured in the acceptance criteria |
tmnxY1564AccCritLatRiseThres |
measuredCir |
The measured CIR rate |
tmnxY1564StreamResMeasuredCIR |
measuredpir |
The measured PIR rate |
tmnxY1564StreamResMeasuredPIR |
measuredThroughput |
The measured throughput |
tmnxY1564StreamResMeasuredThruput |
mfactor |
A factor to use as a margin by which the observed throughput is off from the configured throughput to determine whether a service test passes or fails |
tmnxY1564AccCritUseMFactor |
perfTestDur |
The duration, in seconds, of the performance test |
tmnxY1564ServTestPerformanceTestDuration |
pirAdaptRule |
The PIR adaptation rule used |
tmnxY1564StreamPIRAdaptation |
pirRate |
The PIR rate configured |
tmnxY1564StreamAdminPIR |
pirTestDur |
The PIR test duration, in seconds |
tmnxY1564ServTestCirPirTestDuration |
pirThreshold |
The PIR threshold configured in the acceptance criteria |
tmnxY1564AccCritPirThres |
pktCountRx |
The received packet count |
tmnxY1564StreamResRecvCount |
pktCountTx |
The transmitted packet count |
tmnxY1564StreamResTransCount |
policingTestDur |
The policing test duration, in seconds |
tmnxY1564ServTestPolicingTestDuration |
resultStatus |
Indicates whether the stream has passed or failed |
tmnxY1564StreamResStatus |
runningInstance |
A counter used to indicate the run instance of the test |
tmnxY1564ServTestRunningInstance |
sap |
The SAP used as the test endpoint |
tmnxY1564StreamSapPortId tmnxY1564StreamSapEncapValue |
sequence |
The sequence of payload sizes specified in the frame-mix policy |
tmnxY1564StreamFrameMixSeq |
serviceTest |
A tag to indicate the start of the service test in the accounting record |
None |
sizeA |
A frame sequence can be configured by the user to indicate the sequence of frame sizes to be generated by the tool. The sequence of frames is specified using letters a to h and u. sizeA specifies the frame size for the packet identified with the letter ‛a’ in the frame sequence. |
tmnxY1564FrameMixSizeA |
sizeB |
A frame sequence can be configured by the user to indicate the sequence of frame sizes to be generated by the tool. The sequence of frames is specified using letters a to h and u. sizeB specifies the frame size for the packet identified with the letter ‛b’ in the frame sequence. |
tmnxY1564FrameMixSizeB |
sizeC |
A frame sequence can be configured by the user to indicate the sequence of frame sizes to be generated by the tool. The sequence of frames is specified using letters a to h and u. sizeC specifies the frame size for the packet identified with the letter ‛c’ in the frame sequence. |
tmnxY1564FrameMixSizeC |
sizeD |
A frame sequence can be configured by the user to indicate the sequence of frame sizes to be generated by the tool. The sequence of frames is specified using letters a to h and u. sizeD specifies the frame size for the packet identified with the letter ‛d’ in the frame sequence. |
tmnxY1564FrameMixSizeD |
sizeE |
A frame sequence can be configured by the user to indicate the sequence of frame sizes to be generated by the tool. The sequence of frames is specified using letters a to h and u. sizeE specifies the frame size for the packet identified with the letter ‛e’ in the frame sequence. |
tmnxY1564FrameMixSizeE |
sizeF |
A frame sequence can be configured by user to indicate the sequence of frame-sizes to be generated by the tool. The sequence of frames is specified using letters a-h and u. sizeF specifies the frame-size for packet identified with letter ‛f’ in the frame-sequence. |
tmnxY1564FrameMixSizeF |
sizeG |
A frame sequence can be configured by the user to indicate the sequence of frame sizes to be generated by the tool. The sequence of frames is specified using letters a to h and u. sizeG specifies the frame size for the packet identified with the letter ‛g’ in the frame sequence. |
tmnxY1564FrameMixSizeG |
sizeH |
A frame sequence can be configured by the user to indicate the sequence of frame sizes to be generated by the tool. The sequence of frames is specified using letters a to h and u. sizeH specifies the frame size for the packet identified with the letter ‛h’ in the frame sequence. |
tmnxY1564FrameMixSizeH |
sizeU |
A frame sequence can be configured by the user to indicate the sequence of frame sizes to be generated by the tool. The sequence of frames is specified using letters a to h and u. sizeU specifies the frame size for the packet identified with the letter ‛u’ in the frame sequence. sizeU is the user-defined packet size. |
tmnxY1564FrameMixSizeU |
srcIp |
The source IP address in the frame payload generated by the tool |
tmnxY1564PayLdSrcIpv4Addr |
srcMac |
The source MAC address in the frame payload generated by the tool |
tmnxY1564PayLdSrcMac |
srcPort |
The source TCP/UDP port in the frame payload generated by the tool |
tmnxY1564PayLdSrcPort |
startTime |
The time at which the test was started (wall clock time) |
tmnxY1564ServTestStartTime |
streamId |
The stream identifier |
tmnxY1564StreamId |
streamOrdered |
Indicates if the streams configured for the service test were run one after another or run in parallel |
tmnxY1564ServTestStreamOrder |
testCompleted |
Indicates if the test was completed or not |
tmnxY1564StreamResCompleted |
testCompletion |
The execution status of the test (either completed or running) |
tmnxY1564ServTestCompletion |
testDuration |
The duration of the entire test (including all test types) |
tmnxY1564ServTestTime |
testIndex |
The service test index configured |
tmnxY1564ServTestIndex |
testResult |
Indicates the result of the test |
tmnxY1564ServTestTestResult |
testStopped |
Indicates if the test was stopped and did not complete |
tmnxY1564ServTestStopped |
testTime |
The time taken for each stream. If the test is stopped, the time given is the execution time of the stream up until it was stopped. |
tmnxY1564StreamResTestTime |
testTypeCir |
The CIR configuration test |
tmnxY1564StreamTests |
testTypeCirPir |
The CIR-PIR configuration test |
tmnxY1564StreamTests |
testTypePerf |
The performance test |
tmnxY1564StreamTests |
testTypePolicing |
The policing test |
tmnxY1564StreamTests |
throughputAcceptance |
Indicates whether the measured throughput matches the configure CIR/PIR rate |
tmnxY1564StreamResThruputAcceptanceResult |
trapEnabled |
Indicates if the trap needs to be sent in completion of the test |
tmnxY1564ServTestTrapEnable |
type |
The test type configured for the stream ID |
tmnxY1564PayLdType |
vlanTag1Dei |
The DEI value set for VLAN Tag #1 (outer most VLAN tag) in the frame payload generated by the tool |
tmnxY1564PayLdVTagOneDei |
vlanTag1Id |
The VLAN ID value set for VLAN Tag #1 (outer most VLAN tag) in the frame payload generated by the tool |
tmnxY1564PayLdVTagOne |
vlanTag1Tpid |
The VLAN Tag TPID value set for VLAN Tag #1 (outer most VLAN tag) in the frame payload generated by the tool |
tmnxY1564PayLdVTagOneTpid |
vlanTag2Dei |
The DEI value set for VLAN Tag #2 (inner VLAN tag) in the frame payload generated by the tool |
tmnxY1564PayLdVTagTwoDei |
vlanTag2Dot1p |
The Dot1p value set for VLAN Tag #2 (inner VLAN tag) in the frame payload generated by the tool |
tmnxY1564PayLdVTagTwoDot1p |
vlanTag2Id |
The VLAN ID value set for VLAN Tag #2 (inner VLAN tag) in the frame payload generated by the tool |
tmnxY1564PayLdVTagTwo |
vlanTag2Tpid |
The VLAN tag TPID value set for VLAN Tag #2 (inner VLAN tag) in the frame payload generated by the tool |
tmnxY1564PayLdVTagTwoTpid |
vlanTag1Dot1p |
ThenDot1p value set for VLAN Tag #1 (outermost VLAN tag) in the frame payload generated by the tool |
tmnxY1564PayLdVTagOneDot1p |