iSCSI HBA Digest Test (Disk) (LOGO)

This test verifies that the host-bus adapter (HBA) supports header and data digests as negotiated during the log on phase.

Test details

   
Specifications
  • Device.Storage.Controller.Iscsi.Interface
Platforms
  • Windows 10, client editions (x86)
  • Windows 10, client editions (x64)
  • Windows Server 2016 (x64)
Supported Releases
  • Windows 10
  • Windows 10, version 1511
  • Windows 10, version 1607
  • Windows 10, version 1703
  • Windows 10, version 1709
  • Windows 10, version 1803
  • Windows 10, version 1809
  • Windows 10, version 1903
  • Next update to Windows 10
Expected run time (in minutes) 90
Category Development
Timeout (in minutes) 5400
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.

Before starting the test, you must ensure that the test adapter is the boot adapter in the system. This system does not need to be the only system in your machine pool. You can use a secondary system that does not meet the setup requirements for certification program for this test, if necessary.

In addition, this test requires the following software and hardware:

  • iSCSI disk storage system or iSCSI bridge with disk storage system attached

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.

This test returns Pass or Fail. To review test details, review the test log from the Windows HLK Manager.

In addition:

  1. Look at the job results log file for test failures

  2. Verify the target has been formatted and assigned a drive letter.

  3. 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).

More information

The test performs the following algorithm:

  1. Prepares the system for iSCSI operations:

    1. If the target that is used for testing is already logged on, the session information is saved so the session can be restored later.

    2. The target disk device is added as a static iSCSI target.

  2. Perform iSCSI operations

    1. If the target that is used for testing is already logged on, the current session to the target is logged out

    2. The target is logged on by using the HBA that you are testing with header digests enabled.

    3. After logging on to the target, the test waits for all disk devices to be enumerated on the test system.

    4. The test will perform I/O read and write operations with the current target session.

    5. The test repeats the preceding steps with data digests only enabled and header and data digests enabled.

    6. The HBA under test must properly log on by using all three digest combinations with no I/O failures detected during I/O operations.

  3. Restore any previous iSCSI target sessions.

To run this test:

  1. Log on to the disk target and format the drive. The disk target should have a drive letter before you run the test.

  2. Run the test as DTM job from the Device Console window.

  3. Enter the required data in the configuration dialog box that appears when this job is scheduled.

Command syntax

Command option Description

Iscsi_digest.exe

Runs the test.

-hct [TestType]

The options that can be set are -target or -hba.

[TargetType]

This -disk parameter sets this option.

-setup or -login [DigestType] or -logout [DigestType]

Runs the test. This option values are header, data, or both.

-v [LogVerbosity]

Sets the test result logging level. This option sets the verbosity of the logging. There are three levels of output (0, 1, and 2) where 2 is the most verbose.

Note

   For command-line help for this test binary, type /h.

 

File list

File Location

Iscsi_digest.exe

<[testbinroot]>\nttest\driverstest\storage\wdk\iscsi\

Logtest.vbs

<[testbinroot]>\nttest\driverstest\storage\wdk\

 

Parameters

Parameter name Parameter description
TestType hba or target
TargetType tape or disk
LLU_LclAdminUsr User account for running the test.
StorageDriveLetter Drive letter of a volume on the target disk
WDKDeviceID Device instance path to test
LogVerbosity Vebosity of logging. There are three levels of output 0,1,2 where 2 is the most verbose.