iSCSI Boot

  • 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 Boot test verifies that the host-bus adapter (HBA) properly reports the presence of a boot session to the Microsoft iSCSI initiator service.

Details

The iSCSI Boot test performs the following algorithm:

  1. Determine the current system boot drive.

  2. Retrieve the currently active iSCSI sessions on the system by using the ISCSI_SessionStaticInfo Microsoft Windows Management Instrumentation (WMI) class.

  3. For every active iSCSI session that is found, do the following:

    • Check the Type field of the session class to determine if it is a boot session.
    • If the iSCSI session is a boot session, determine the drive letter that is associated with that session.
    • If the associated drive letter matches the system boot drive letter, start up from the iSCSI device.

System Restart Required: No

Supported operating systems for Logo or Signature testing:

  • Windows Vista

  • Windows Server 2003

  • Windows XP

Requirements

Software Requirements

The test tool requires the following software:

Hardware Requirements

The test tool requires the following hardware:

Processor

The test tool runs on the following processor architectures:

Running iSCSI Boot

  1. Install the operating system on a target disk device.

  2. Run the test as a 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_boot_test

 

Troubleshooting

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

  2. Check if the target has a drive letter

  3. Verify the data entered in the configuration dialog (Popup Dialog box when the job is scheduled from device console)

Code Tour

File Manifest

File Location

iscsi_boot_test.exe

...\tests\%ARCHITECTURE%\nttest\driverstest\storage\wdk\iscsi

 

Test Assertions

1.1 At least one iSCSI session must be active on this system.

Test Assertion GUID: f1283af2-c428-11da-94f4-00123f3a6b60

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

Additional Information: The iSCSI Boot test validates that at least one active iSCSI session has been established on the system. The test expects one or more active iSCSI sessions on the system.

1.2 There must be one and only one iSCSI session with the boot flag set and the system must be booted from this session.

Test Assertion GUID: f1283af3-c428-11da-94f4-00123f3a6b60

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

Additional Information: The iSCSI Boot test validates that only one active iSCSI session has the boot flag set. The test expects only one active iSCSI session has the boot flag set The iSCSI Boot test validates that the system was started up through the volume that is associated with the iSCSI session that is marked as bootable. The test expects the system was booted through the volume that is associated with the iSCSI session that is marked as bootable

The HBA is not required to support boot.

Test Assertion GUID: e78bca89-977c-47bd-981a-4aa2303344f4

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

 

 

Build date: 9/14/2012