iSCSI HBA Mutual CHAP Test (LOGO)
This test verifies that the iSCSI initiator can use the Challenge Handshake Authentication Protocol (CHAP) authentication mechanism. The test verifies mutual CHAP.
Test details
Specifications |
|
Platforms |
|
Supported Releases |
|
Expected run time (in minutes) | 5 |
Category | Development |
Timeout (in minutes) | 300 |
Requires reboot | false |
Requires special configuration | true |
Type | automatic |
Additional documentation
Tests in this feature area might have additional documentation, including prerequisites, setup, and troubleshooting information, that can be found in the following topic(s):
Running the test
Before you run the test, complete the test setup as described in the test requirements: iSCSI HBA Testing Prerequisites.
In addition, this test requires the following software and hardware:
- 1 GB network adapter
If this is the first time you are running an iSCSI HBA test, iSCSI Target test, or MPIO test over iSCSI bus type on the HLK client, or if there is no iscsihctconfig.ini under [HLK Path]\JobsWorkingDir\ on the HLK client, you will receive a pop-up dialog box to input iSCSI configuration information and/or HBA information. For more information about this dialog box, see "Running the test" in iSCSI HBA Boot Test (LOGO).
Troubleshooting
For generic troubleshooting of HLK test failures, see Troubleshooting Windows HLK Test Failures.
For troubleshooting information, see Troubleshooting Device.Storage Testing.
In addition:
Look at the job results log file for test failures
Enter the required data in the configuration dialog box that appears when this job is scheduled. For more information, go to iSCSI HBA Boot Test (LOGO).
This test returns Pass or Fail. To review test details, review the test log from the Windows HLK Manager.
More information
The test implements a simple test target and does not require a separate iSCSI target device. The test initiates a login to the test target specifying mutual CHAP. The target verifies that the initiator follows the CHAP protocol specifics detailed in the iSCSI specification. Different test variations will use different encodings (Base16 or Base64) for CHAP responses. In addition, the test returns both valid and invalid responses to the initiator's challenge in order to verify that the HBA properly authenticates the target and returns the appropriate status to the user.
To run this test:
Run the test as an HLK Studio job.
Fill the required data in the configuration UI that pops up when this job is scheduled.
Command syntax
Command | Description |
---|---|
iscsi_initchap.exe -mutual -hct -v [LogVerbosity] |
Runs the test. The -v option controls the verbosity of the logging. There are three levels of output: 0, 1, and 2. 2 is the most verbose. |
Note
For command-line help for this test binary, type /h.
File list
File | Location |
---|---|
iscsi_initchap.exe |
<[testbinroot]>\nttest\driverstest\storage\wdk\iscsi\ |
Parameters
Parameter name | Parameter description |
---|---|
LLU_NetAccessOnly | User account for accessing test fileshare. |
LLU_LclAdminUsr | User account for running the test. |
LogVerbosity | Vebosity of logging. There are three levels of output 0,1,2 where 2 is the most verbose. |