iSCSI Digest - Disk (Target)
Note This content applies to the Windows Logo Kit (WLK). For the latest information using the new Windows Hardware Certification Kit (HCK), see Windows HCK User's Guide on the Windows Hardware Dev Center.
Type: Automated Test
Overview
The iSCSI Digest - Disk (Target) test verifies that an iSCSI disk storage system supports header and data digests as negotiated during the logon phase.
Details
The iSCSI Digest - Disk (Target) test performs the following algorithm:
Prepare the system for iSCSI operations:
- If the target that you are testing is already logged on, the session information is saved so the session can be restored later.
- The target disk device is added as a static iSCSI target.
Perform iSCSI operations:
- If the target that you are testing is already logged on, the current session to the target is logged out.
- The target is logged on with header digests enabled.
- After logging on to the target, the test waits for all disk devices to be enumerated on the test system.
- The test will perform I/O read and write operations with the current target session.
- The test repeats the preceding steps with data digest only enabled and header and data digests enabled.
- 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.
Restore any previous iSCSI target sessions.
Run Time:
Log File:
System Restart Required: No
Test Category:
Supported operating systems for Logo or Signature testing:
Windows Vista
Windows Server 2003
Windows XP
Program:
Requirements
Software Requirements
The test tool requires the following software:
Supported operating system (see list above)
Software components included with the device that is being tested
On Windows XP and Windows Server 2003, the latest version of the Microsoft iSCSI software initiator is needed.
Hardware Requirements
The test tool requires the following hardware:
Device to be tested
Computer that meets the minimum software requirements
Windows keyboard
Two-button pointing device
Color display monitor capable of at least 1024 by 768 resolution, 32-bits per pixel, 60 Hz
Hard drive with a minimum of 20 GB available on partition C:
Processor
The test tool runs on the following processor architectures:
x86
x64
Itanium
Running iSCSI Digest - Disk (Target)
Log on to the disk target and format the drive. The disk target should have a drive letter before you run the test.
Run the test as DTM job from the Device Console window.
Enter the required data in the configuration dialog box that appears when this job is scheduled.
Troubleshooting
Look at the job results log file for test failures.
Verify the target has been formatted and assigned a drive letter.
Verify the iSCSI configuration information is entered correctly in the configuration dialog box when the job is scheduled from Device Console.
Code Tour
File Manifest
File | Location |
---|---|
iscsi_digest.exe |
...\tests\%ARCHITECTURE%\nttest\driverstest\storage\wdk\iscsi |
Test Assertions
1.1 Setting up test, and saving open sessions.
Test Assertion GUID: 0df19e9d-c42e-11da-94f4-00123f3a6b60
Windows Logo Program: STORAGE-0001 Storage devices meet industry standards and Windows requirements
Additional Information: The setup stage must get the current sessions to the target and then persist that information so it can be used to reestablish these sessions during the cleanup stage.
2.1 The MS Initiator must be able to log into the target successfully with digests enabled
Test Assertion GUID: 7f102025-c42e-11da-94f4-00123f3a6b60
Windows Logo Program: STORAGE-0001 Storage devices meet industry standards and Windows requirements
3.1 The MS Initiator must be able to successfully logout from target
Test Assertion GUID: 7f102027-c42e-11da-94f4-00123f3a6b60
Windows Logo Program: STORAGE-0001 Storage devices meet industry standards and Windows requirements
4.1 Cleaning up test, restoring sessions.
Test Assertion GUID: 7f102028-c42e-11da-94f4-00123f3a6b60
Windows Logo Program: STORAGE-0001 Storage devices meet industry standards and Windows requirements
Additional Information: The cleanup stage must restore the sessions that were persisted during the setup stage.
Build date: 9/14/2012