iSCSI Target Digest Test (Disk) (LOGO)

This test verifies that an iSCSI disk storage system supports header and data digests as negotiated during the logon phase.

Test details

 

Associated requirements

Device.Storage.Hd.Iscsi.BasicFunction

See the device hardware requirements.

Platforms

Windows 7 (x64)
Windows 7 (x86)
Windows 8 (x64)
Windows 8 (x86)
Windows Server 2012 (x64)
Windows Server 2008 R2 (x64)
Windows Server 2008 x64
Windows Server 2008 x86
Windows 8.1 x64
Windows 8.1 x86
Windows Server 2012 R2

Expected run time

~40 minutes

Categories

Certification
Functional

Type

Manual

Running the test

Before you run the test, complete the test setup as described in the test requirements: iSCSI Boot Component Testing Prerequisites.

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 HCK client, or if there is no iscsihctconfig.ini under [HCK Path]\JobsWorkingDir\ on the HCK 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 troubleshooting information, see Troubleshooting Device.Storage Testing.

This test returns Pass or Fail. To review test details, review the test log from the Windows HCK 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 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 target that you are testing must permit logon by using all three digest combinations and no I/O failures can be 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.

Parameters

 

Parameter Description

LogVerbosity

The verbosity of logging. There are three levels of output: 0, 1, and 2. 2 is the most verbose.

Default value: 1

TargetType

This parameter is either -disk or –tape.

Default value: -disk

TestType

This parameter is either -target or –hba.

Defaule value: -target

Command syntax

 

Command option Description

iscsi_digest.exe -hct [TestType] [TargetType] -cleanup -v [LogVerbosity]

Runs the test.

-hct [TestType]

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

[TargetType]

Runs the test against an iSCSI disc. The -disk parameter sets this option.

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

Runs the test with the digest type option set. The digest type 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. 2 is the most verbose.

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

File list

 

File Location

Iscsi_digest.exe

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

Show:
© 2015 Microsoft