iSCSI Digest - Tape (HBA)

  • Article

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 - Tape (HBA) test verifies that the host-bus adapter (HBA) supports header and data digests as negotiated during the logon phase.

Details

The iSCSI Digest - Tape (HBA) test completes the following steps:

  1. Prepare the system for iSCSI operations:

    • If the target that is used for testing is already logged on, the session information is saved so the session can be restored later.
    • The target tape device is added as a static iSCSI target.

  2. Perform iSCSI operations:

    • If the target that is used for testing is already logged on, the current session to the target is logged out.
    • The target is logged on by using the HBA under test with header digests enabled.
    • After logging on to the target, the test waits for the tape device to be enumerated on the test system.
    • The test will perform tape I/O operations b using the current target session.
    • The test repeats the preceding steps with data digests-only enabled and header and data digests enabled.
    • 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.

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, you need the latest version of the Microsoft iSCSI software initiator.

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:

  • Combination iSCSI tape and media changer device or iSCSI bridge with combination tape and media changer device attached

Processor

The test tool runs on the following processor architectures:

  • x86

  • x64

  • Itanium

Running iSCSI Digest - Tape (HBA)

To run this test, do the following:

  1. Log on to the tape target and format the target.

  2. Run the test as a Driver Test Manager (DTM) job.

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

Troubleshooting

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

  2. Verify that the iSCSI configuration information is entered correctly in the configuration dialog box when the job is scheduled from the Device Console window.

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-0002 Storage host controllers and adapters comply with 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 HBA must be able to log into the target successfully with digests enabled.

Test Assertion GUID: 7f102024-c42e-11da-94f4-00123f3a6b60

Windows Logo Program: STORAGE-0002 Storage host controllers and adapters comply with industry standards and Windows requirements

3.1 The HBA must successfully logout from target.

Test Assertion GUID: 7f102026-c42e-11da-94f4-00123f3a6b60

Windows Logo Program: STORAGE-0002 Storage host controllers and adapters comply with industry standards and Windows requirements

4.1 Cleaning up test, restoring sessions.

Test Assertion GUID: 7f102028-c42e-11da-94f4-00123f3a6b60

Windows Logo Program: STORAGE-0002 Storage host controllers and adapters comply with 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