Flush Test
This test leverages SNMP-controlled, programmable power strips to validate that the driver, controller, and underlying device honor the appropriate flush command by persisting data to the device.
It includes the following steps:
Write a known pattern directly to disk (by-passing the file system) and wait for writes to complete.
Send Flush command and wait for completion.
Immediately trigger sudden power loss.
On reboot, read back and verify that all data that was written to disk before the flush command.
Repeat cycle with a different write scenario (different size, pattern, location, etc.).
Test details
Associated requirements |
Device.Storage.Controller.Flush.BasicFunction Device.Storage.ControllerDrive.NVMe.BasicFunction Device.Storage.Hd.Flush.BasicFunction |
Platforms |
Windows 8 (x64) Windows 8 (x86) Windows Server 2012 (x64) Windows 8.1 x64 Windows 8.1 x86 Windows Server 2012 R2 |
Expected run time |
~480 minutes |
Categories |
Certification Reliability |
Type |
Automated |
Running the test
Before you run the test, complete the test setup as described in the test requirements for the type of storage controller that you are testing. See Storage Adapter or Controller Testing Overview for more information.
Flush test should be run on the non-boot Controller. Running on the boot controller (with a non-boot drive attached) gives unexpected results because of dirty shutdown of machine. In the case of certifying SAS controllers, we highly recommend installing OS and HCK client on SATA boot controller and attaching a non-boot SAS controller to run Flush test.
Setup required for the test: Connect a SNMP controlled programmable power strip to HCK test machine.
Power strip should have a valid IP address associated as the test uses both the IP address and the port to initiate sudden power loss.
Power strip can be connected locally/remotely to machine, please see power strip manual for configuration details.
Warning For virtual testing scenarios, you'll need to enter fake data for the SNMP-related parameters (SNMP_IP_ADDRESS, SNMP_PORT, SNMP_COMMUNITY) to successfully complete the test.
Troubleshooting
For troubleshooting information, see Troubleshooting Device.Storage Testing.
Power-strip
Test communicates with power-strip using SNMP and power-strip needs to have a valid IP address and port number. Information on configuring power-strip is outside the scope of this document, please refer power-strip manual. In brief, get a static IP for power strip, login to power strip using tool like putty, follow instructions on the menu to set IP address, Default gateway and subnet mask.
Sudden Power Loss and BIOS setting
Test runs about 21 scenarios initiating sudden power loss each time. When power-strip port is programmed for power off and delayed power on, systems may not power ON automatically as this is a BIOS setting and is usually available on desktop machines. Example: On HP Compaq DC7800 machine, In BIOS under Advanced->Power-On Options, there is a field called "After Power Loss", set it to ON.
For uninterrupted and automated way of running flush test, set the BIOS setting to power ON machine automatically when power is plugged in.
Para-Virtualization Storage Drivers and SVVP Certification
When certifying devices in a virtual environment, HCK intentionally doesn’t consider virtual scenarios to ensure virtualization products work as closely as possible to the physical products. But, we do provide a workaround to execute Flush test in such cases. The test logs information before initiating dirty shutdown. Initiate the same manually by timing it when the log appears on the screen for all scenarios which run as part of Flush test.
Sample Log file example:
<SNIP>Message 4/23/2013 1:39:21.081 AM S5: Starting Random Write Scenario of 268435456 bytes (256MB). Message 4/23/2013 1:41:02.081 AM S0: Completed Sequential Write Scenario of 268435456 bytes (256MB) Message 4/23/2013 1:41:04.081 AM S5: Completed Random Write Scenario of 268435456 bytes (256MB) Message 4/23/2013 1:41:04.081 AM S4: Completed Striding Write Scenario of 268435456 bytes (256MB) Message 4/23/2013 1:41:04.081 AM S2: Completed Random Write Scenario of 268435456 bytes (256MB) Message 4/23/2013 1:41:04.081 AM S1: Completed Striding Write Scenario of 268435456 bytes (256MB) Message 4/23/2013 1:41:04.081 AM S3: Completed Sequential Write Scenario of 268435456 bytes (256MB) Message 4/23/2013 1:41:03.972 AM Flush Write Cache Message 4/23/2013 1:41:03.972 AM Flush Write Cache Complete Message 4/23/2013 1:41:03.972 AM Flush file system buffers and trigger sudden power loss<SNIP>Sudden Reboot triggered (At this time, manually trigger dirty shutdown within 2 seconds.)
Battery/Non-battery powered systems
Flush runs only on non-battery powered systems. If you are using a desktop machine, flush is applicable. If you are using a laptop machine (we assume battery is plugged in), flush is not applicable. Below are the options available for certifying devices against systems.
Certifying devices on desktop machines
- See options for BIOS power setting above
Certifying devices on laptop machines
Select a laptop which has a BIOS power setting, remove battery and follow steps for running tests
Or, Put laptop motherboard in a desktop casing (i.e., just like a desktop machine) and follow steps for running tests
.png)
More information
These scenarios send a flush command to the device as soon as all outstanding I/O complete for a given scenario. Power loss occurs immediately after the flush command completes. If any data from the scenario did not persist to disk, the test will fail. The logo test will run each of these 21 scenarios.
Flush and Reboot after 512MB of Syncronous Sequential Writes
Small writes (512B – 4KB)
Large writes (768KB – 1MB)
Pseudorandom-sized writes (512B – 1MB)
Flush and Reboot after 512MB of Syncronous Random Writes
Small writes (512B – 4KB)
Large writes (768KB – 1MB)
Pseudorandom-sized writes (512B – 1MB)
Flush and Reboot after 512MB of Syncronous Striding Writes
Small writes (512B – 4KB)
Large writes (768KB – 1MB)
Pseudorandom-sized writes (512B – 1MB)
Flush and Reboot after 1GB of Asyncronous Sequential Writes via 4 threads
Small writes (512B – 4KB)
Large writes (768KB – 1MB)
Pseudorandom-sized writes (512B – 1MB)
Flush and Reboot after 1GB of Asyncronous Random Writes via 4 threads
Small writes (512B – 4KB)
Large writes (768KB – 1MB)
Pseudorandom-sized writes (512B – 1MB)
Flush and Reboot after 1GB of Asyncronous Striding Writes via 4 threads
Small writes (512B – 4KB)
Large writes (768KB – 1MB)
Pseudorandom-sized writes (512B – 1MB)
Flush and Reboot after 1.5GB of Asyncronous Random, Sequential, and Striding Writes via 6 threads
Small writes (512B – 4KB)
Large writes (768KB – 1MB)
Pseudorandom-sized writes (512B – 1MB)
Parameters
| Parameter | Description |
|---|---|
SNMP_IP_ADDRESS |
The IP address of APC Remote PDU. |
SNMP_PORT |
The port of the APC Remote DPU outlet. |
SNMP_COMMUNITY |
The SNMP community name of the APC Remote PDU. Default value: private |
Command syntax
| Command option | Description |
|---|---|
/d |
The device to test. Example: /Device <physical device path> |
/l |
Log name to output. '.wtl' is appended automatically. By default, log name is 'storio'. Example: /l storio_flush_001 |
/p |
The power manager to use. Example: /p SuddenReboot |
/seed |
Seed for reproducing the same scenarios. Example: /seed 1234 |
/v |
The level of logging verbosity. Larger values cause more verbose output. Example: /Verbosity 4 |
/sync |
Force scenarios to execute syncronousely. By default, each scenario runs asynchronously (in a separate thread) |
/flush |
Send flush after all I/O completes to force data to persist to disk. |
/test |
1 or more scenarios to run. Each scenario runs in its own thread. Example: /test sw,sw,sw,xr. Runs 3 threads of sequential writes and one thread of random writes. |
/validate |
1 or more scenarios to validate. Scenarios are validated synchronously. Example: /validate sw,sw,sw,xr. Validates 3 sequential write scenarios and a random write scenario. |
/totalsize |
Total amount of I/O to do (per scenario). Default=256MB. Example: /totalsize 256MB. May also specify size per scenario thread: /totalsize 256MB,128MB,1GB,1GB |
/iomin |
Minimum size of each I/O to do. Default=4KB. Example: /iomin 32KB |
/iomax |
Maximum size of each I/O to do. Default=1MB. Example: /ioman 256KB |
/queuedepth |
Number of overlapping I/O for a scenario thread. Default=0. Example: / queuedepth 16. May also specifiy queue depth per scenario thread: /queuedepth 1,4,16,32. |
Note
For command-line help for this test binary, type /h
File list
| File | Location |
|---|---|
storio.exe |
<[testbinroot]>\nttest\driverstest\storage\wdk |