Thin Provisioning Performance Test - RAW Disk (LOGO)

This test verifies that target devices that have a thin provisioning feature meet Windows requirements.

Note

   This test applies to test that run against raw hard disks. Thin Provisioning Performance Test - RAW Disk (LOGO) collects performance data over raw disks.

 

Test details

   
Specifications
  • Device.Storage.Hd.ThinProvisioning.BasicFunction
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) 90
Category Benchmark
Timeout (in minutes) 5400
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.

In addition, before you run the test, please create a thin provisioned LUN and a full provisioned LUN and make sure both LUNs are online initialized raw disks. Set the threshold for thin provisioned LUN to be 70 percent.

Troubleshooting

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

For troubleshooting information, see Troubleshooting Device.Storage Testing.

Error Description/Workaround

Thin provisioned LUN or full provisioned LUN throughput is 0.000000

If the log file shows that thin provisioned LUN and/or full provisioned LUN read/write throughput is 0.000000, then the LUNs might be offline. Check the thin/full provisioned LUNs to make sure they are both online when the test runs.

Thin provisioned LUN throughput is less than 90% of full provisioned LUN

If the log file shows that the thin provisioned LUN read/write throughput is less than 90 percent of full provisioned LUN, check the thin provisioned LUN IO implementation. Thin provisioned LUN should have similar throughput as full provisioned LUN.

Failed to find certain system events

If the log file shows that the test failed to find certain events, check the implementation of threshold notification events and permanent resource exhaustion event in [Plan and Deploy Thin Provisioning](/previous-versions/windows/it-pro/windows-server-2012-R2-and-2012/jj674351(v=ws.11)).

Test failed but logs have no failures

Make sure you are logging in the HLK client machine as Administrator while the test is running.

 

More information

The performance test runs a stress test to collect performance data. IO throughout performance of thin provisioned LUN should not be below 90% of IO throughput performance of a full provisioned LUN. Currently, if the test fails, the logo test does not fail.

Performance test needs to run DiskIO test over thin provisioned LUN and full provisioned LUN to collect the statistics data. It does sequential read/write/verify IO and random read/write/version IO operations for both LUNs. After each round of writing, the test unmaps or formats the LUNs. The test starts a process to run DiskIOV2.exe and parse the xml files to collect data. After each round of tests, the test checks to see if there is any system event for threshold notification hit.

The test also checks the system events to get threshold notification and performance resource exhaustion. The following events are checked:

Event ID Information

144

Threshold notification without additional information

145

Threshold notification without specific information

146

Threshold notification with used LUN capacity and available LUN capacity information

147

Threshold notification with used LUN capacity and available pool capacity information

148

Threshold notification with used pool capacity and available LUN capacity information

149

Threshold notification with used pool capacity and available pool capacity information

150

Permanent resource exhaustion event

 

This is a pass-only test. It will not give errors even if the disks (either thin provisioned LUN or full provisioned LUN) goes offline. The test only prints information to help you maintain the performance of a thin provisioned LUN.

Command syntax

Command option Description

Thinprovision.exe /scenario performance /thindisk: [TPDiskDeviceObjLink] /fulldisk [FPDiskDeviceObjLink] /logo

Runs the test.

Note

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

 

File list

File Location

DiskIO.exe

<[testbinroot]>\nttest\DRIVERSTEST\storage\wdk\

FillVolume.exe

<[testbinroot]>\nttest\DRIVERSTEST\storage\wdk\thinprovision\

StorageDevices.dll

<[testbinroot]>\nttest\\DRIVERSTEST\storage\wdk\

Thinprovision.exe

<[testbinroot]>\nttest\DRIVERSTEST\storage\wdk\thinprovision\

 

Parameters

Parameter name Parameter description
WDKDeviceID
TPDiskDeviceObjLink The thin provisioned LUN
FPDiskDeviceObjLink The full provisioned LUN
LLU_NetAccessOnly
LLU_LclAdminUsr
Destructive (0,1) 0=Passive, 1=Destructive