Offload scenario test (LOGO)

This test verifies behavior of offload capable devices when offload related commands are exercised. The test exercises Offload Reads and Offload Writes between LUNs of the same target (such as an adapter) and between LUNs of different adapters.

Test details

   
Specifications
  • Device.Storage.Hd.OffloadedDataTransfer.CopyOffload
Platforms
  • 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) 10
Category Scenario
Timeout (in minutes) 600
Requires reboot false
Requires special configuration false
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: Hard Disk Drive Testing Prerequisites.

Attach the following to the HLK test machine: Storage adapter 1, LUNs 1 and 2 & Storage Adapter 2, LUN 3. LUNs 1, 2 and 3 should be a minimum of 21 GB in size.

Format and mount file system on LUNs 1, 2 and 3. When you schedule the test on the HLK controller, there is a run time parameter called "RemoteShareODXStorageDriveLetter". Provide the drive letter associated with LUN3 for the run-time parameter. For example, if LUNs 1, 2 and 3 have drive Letters X, Y and Z, type Z for the run-time parameter and schedule test.

When running the offload scenario test in conjunction with other storage tests, the drive configuration must be maintained for the tests in the same project.

Troubleshooting

For generic troubleshooting of HLK test failures, see Troubleshooting Windows HLK Test Failures.

For troubleshooting information, see Troubleshooting Device.Storage Testing.

More information

The following Scenarios are exercised:

  • Copy Offload between LUNs from the same adapter

    • Single HBA push scenario

    • Single HBA pull scenario

  • Copy Offload between LUNs from different adapters

    • Multiple HBA push scenario

    • Multiple HBA pull scenario

Command syntax

Command Description

Copyoffload.exe

The options for the test are listed below

/regression:[Scenarios]

Scenarios to run, scenarios are from 2 to 21, ranging in transfer sizes

/stp

Source test path

/dtp

Destination test path

Note

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

 

File list

File Location

Copyoffload.exe

<[testbinroot]>\nttest\BASETEST\core_file_services\ntfs\copyoffload\

Scattermultithread.exe

<[testbinroot]>\nttest\BASETEST\core_file_services\ntfs\scattergather\

 

Parameters

Parameter name Parameter description
StorageDriveLetter Storage Drive Letter
WDKDeviceID Instance path of device to test
LLU_NetAccessOnly User account for accessing test fileshare.
LLU_LclAdminUsr User account for running the test.
ODXStorageDriveLetter Disk's ODX cousin
RemoteShareODXStorageDriveLetter Disk's remote cousin
DiskDeviceObjLink Assigned by Create Storage Parameters