testhead test-name [owner owner-name] testhead-profile profile-id [frame-payload frame-payload-id] [acceptance-criteria acceptance-criteria-id [color-aware enable | disable]] sap sap-id [fc fc-name] [enforce-fc-check enable | disable]
testhead test-name [owner owner-name] testhead-profile profile-id [frame-payload frame-payload-id] sap sap-id [fc fc-name] [acceptance-criteria acceptance-criteria-id]
testhead test-name [owner owner-name] stop
oam
7210 SAS-D, 7210 SAS-Dxp, 7210 SAS-K 2F1C2T, and 7210 SAS-K 2F6C4T
This command executes the throughput test by generating traffic up to the configured rate and measuring the delay, delay-variation, and frame-loss ratio. At the end of the test run, the testhead command compares the measured values against the test acceptance criteria that is specified to determine whether the service is within bounds of the acceptance criteria. It reports a pass if the configured rate thresholds are achieved and the measured performance parameter (that is, latency, jitter, and FLR) values are less than the thresholds configured in the acceptance criteria. It reports a failure if the configured rate thresholds are not achieved or if any of the measured values for the performance parameters exceeds the thresholds configured in the acceptance criteria. For the 7210 SAS-D and 7210 SAS-Dxp, both the CIR and PIR can be specified. For the 7210 SAS-K 2F1C2T and 7210 SAS-K 2F6C4T, only the CIR can be specified (the PIR is not supported).
The user must specify the testhead-profile parameter, which determines traffic generation rate and the content of the frames used for traffic generation. If both the CIR and PIR is specified, or if only the PIR is specified (by setting CIR to zero), the tool generates traffic up to the configured PIR. If only the CIR is specified, the tool generates traffic up to the configured CIR.
If the acceptance-criteria parameter is not specified and color-aware is set to disable by default, the software displays the test result as ‟PASS” if the frame loss is zero and desired rate is achieved. For comparison with the measured rate, the test uses the configured CIR. Measured values of latency, jitter, and delay variation are not compared.
If the acceptance-criteria parameter is not specified and color-aware is set to enable, the software displays the test result as ‟PASS” if the measured CIR and PIR match the configured CIR and PIR values and frame loss is zero, or if one of the following is true:
the measured throughput rate (CIR + PIR) is equal to the configured CIR rate and if no PIR rate is configured
the measured throughput rate (CIR + PIR) is equal to the configured PIR rate and if either no CIR rate is configured or if the CIR rate is configured
Otherwise, the test is declared failed. Measured values of latency, jitter, and delay variation are not compared.
If acceptance-criteria is specified and color-aware is set to enable, the test uses the configured packet header marking values (dot1p) to identify the color of the packet and classify it as green (in-profile) or yellow (out-of-profile). It measures the green packet (CIR) and the green/in-profile packet performance parameter values and the yellow packet rate (PIR) and the yellow/out-of-profile packet performance parameter values individually based on the packet markings. In addition to comparing the measured performance parameter values against the normal performance parameter threshold values (if enabled), if the user has enabled in/out thresholds for performance parameters in the acceptance criteria, the tool uses these values to compare against the measured values and declare a pass or fail result. The tool uses the cir-threshold and pir-threshold to compare against the measured CIR and PIR throughput rates and declare pass or fail if the thresholds specified by the cir-threshold and pir-threshold are achieved.
When color-aware mode is set to enable, the marking values used to identify both in-profile/green packet and out-of-profile/yellow packet must be configured. If either of the packet header marking values (for example, dot1p) is not configured by the user, the CLI displays an error.
If acceptance-criteria is specified and color-aware is set to disable, the tests are color blind (not color-aware). The tool does not use the configured packet header marking values to identify the color of the packet and treats all packets the same. The tool uses the normal thresholds configured in the acceptance-criteria (that is, the threshold values other than the in/out profile thresholds) to compare the measured values and declare a pass or fail result. The tool does not make any attempt to compare the in/out thresholds against measured values. The tool uses the cir-threshold as follows:
If the measured throughput rate is equal to the configured cir-threshold rate, the desired rate is said to have been achieved and the tests continue to compare the measured performance parameter thresholds with the configured performance parameter thresholds (if any).
The test-name and owner-name together uniquely identify a particular testhead invocation or session. The results of the testhead session are associated with the test-name and owner-name. Use these parameters to display the results of the testhead tool and to clear the results of a completed run. Multiple invocations of the testhead tool with the same test-name and owner-name is not allowed if the results of the old run using the same pair of test-name and owner-name are present. That is, the results are not overwritten when the testhead is invoked again with the same values for test-name and owner-name. The results must be cleared explicitly using the clear command before invoking the testhead tool with the same test-name and owner-name. Results for up to 100 unique sessions, each using a different test-name and owner-name, are saved in memory (that is, the results are not available for use after a reboot).
The testhead command is not saved in the configuration file after a reboot.
The 7210 SAS-K 2F1C2T and 7210 SAS-K 2F6C4T support the generation of multiple streams of traffic using the testhead OAM tool. The user can run multiple testhead sessions on 7210 SAS-K 2F1C2T or 7210 SAS-K 2F6C4T devices simultaneously to validate multiple SAPs. The total throughput that can be generated is up to about 1Gb/s. In other words, the total traffic generated across all the streams is about 1Gb/s.
The 7210 SAS-K 2F1C2T and 7210 SAS-K 2F6C4T do not support color-aware mode. That is, it is assumed that the color-aware mode parameter value is set to disable.
See Prerequisites for using the testhead tool for more information.
Specifies the test name as an ASCII string up to 32 characters.
Specifies the testhead operation owner as an ASCII string up to 32 characters.
Specifies the testhead profile ID to use with this run or session of testhead invocation. The user must configure the testhead profile beforehand using the commands in config>test-oam>testhead-profile context.
Specifies the frame payload ID to use for this run. It configures the parameters used to construct the frame generated by the testhead tool.If this parameter is not specified, the run, by default, uses parameters configured under frame-payload-id 1.
Specifies the test acceptance criteria parameters to use for this run. It identifies the parameters used to compare the measured performance values against the configured thresholds configured in the acceptance criteria. If this parameter is not specified, the run is declared pass if the throughput configured in the testhead-profile is achieved without any loss.
Keyword to execute color-aware tests. If set to enable, the color-aware test is enabled. If set to disable, the non-color-ware test is enabled. On the 7210 SAS-K 2F1C2T or 7210 SAS-K 2F6C4T, this parameter is set to disable by default and cannot be configured.
Specifies the test SAP. This parameter must be specified by the user.
See Configuration guidelines for more information.
Specifies the forwarding class (FC) to use to send the frames generated by the testhead tool.
Keyword to stop the currently running test, if there is one. All performance results based on the data available up to the time the test is stopped are used to determine the pass or fail criteria. Additionally, the test-status displays ‟Stopped” and test completion status is marked ‟Incomplete” or ‟No”.
Keyword to enable or disable a check on the local node where the testhead OAM tool is run. The check ensures that the traffic generated by the testhead tool is received in the queue corresponding to the FC specified by the fc fc-name parameter. This parameter is only supported on the 7210 SAS-D and 7210 SAS-Dxp.