This topic has not yet been rated - Rate this topic

Windows Filtering Platform (WFP) Drivers Testing Prerequisites

This topic describes the tasks that you must complete before you WFP drivers by using the Windows® Hardware Certification Kit (Windows HCK):

Hardware requirements.
Software requirements.
Test computer configuration.

Hardware requirements

The following hardware is required for network security software testing:

One test computer that meets the following requirements:
- Meets the Windows HCK prerequisites. For more information, see Windows HCK Prerequisites.
- Has at least one network interface card that is connected. Ideally, the network interface card is on a private network with the Controller's network interface.
- Supports S1-S3 (Suspend) and S4 (Hibernate) power states.
- Is not joined to a domain.

Note
To certify your device for use on servers, the test computer must support four processors and a minimum of 1 GB of RAM. These system capabilities are required to test the Rebalance, D3 State, and Multiple Processor Group functionality of the device and driver. You do not need a computer that actually has more than 64 processors to test your device. If you use a pool of test computers to test devices, at least one computer in the pool must contain four processors and a minimum of 1 GB of RAM. Additionally, that computer must contain the device and the driver that you want to test. As long as the driver is the same on all the computers in the pool, the system creates a schedule to run against all test computers. For tests that do not include a driver to test, such as hard disk drive tests, the Windows HCK scheduler constrains the tests that validate the device’s and driver’s Rebalance, D3 State and Multiple Processor Groups functionality to run on the default test computer. You must manually configure this computer to have multiple processor groups. The default computer is the first test computer in the list. Test personnel must make sure that the first test computer in the list meets the minimum hardware requirements.

Note

To certify your device for use on servers, the test computer must support four processors and a minimum of 1 GB of RAM. These system capabilities are required to test the Rebalance, D3 State, and Multiple Processor Group functionality of the device and driver. You do not need a computer that actually has more than 64 processors to test your device.

If you use a pool of test computers to test devices, at least one computer in the pool must contain four processors and a minimum of 1 GB of RAM. Additionally, that computer must contain the device and the driver that you want to test. As long as the driver is the same on all the computers in the pool, the system creates a schedule to run against all test computers.

For tests that do not include a driver to test, such as hard disk drive tests, the Windows HCK scheduler constrains the tests that validate the device’s and driver’s Rebalance, D3 State and Multiple Processor Groups functionality to run on the default test computer. You must manually configure this computer to have multiple processor groups. The default computer is the first test computer in the list. Test personnel must make sure that the first test computer in the list meets the minimum hardware requirements.

Note
Except for para-virtualization drivers (as defined by Logo Program Requirement Policy-0020), you may not use any form of virtualization when you test physical devices and their associated drivers for server certification or signature. All virtualization products do not support the underlying functionality that is required to pass the tests that relate to multiple processor groups, device power management, device PCI functionality, and other tests.

Note

Except for para-virtualization drivers (as defined by Logo Program Requirement Policy-0020), you may not use any form of virtualization when you test physical devices and their associated drivers for server certification or signature. All virtualization products do not support the underlying functionality that is required to pass the tests that relate to multiple processor groups, device power management, device PCI functionality, and other tests.

Software requirements

The following software is required to run the SoftwareDevice.FilterDriver.WindowsFilteringPlatform tests:

Network security software to test which utilizes WFP Callouts.

Warning
Make sure that you install the product on the test computer before you install the Windows HCK Client.

Warning
Make sure that you install the product on the test computer before you install the Windows HCK Client.

The testing process involves two tests. One test verifies basic firewall capabilities, and the other test validates interoperability with Transition Technologies (currently targeted at Teredo). As part of the test process, the following fields are copied to the test computer. You must add appropriate values for these tests as described in the Test computer configuration section.

SoftwareDevice.FilterDriver.WindowsFilteringPlatform.WindowsFilteringPlatform_Tests

File name	Origin or Removal	Location	Purpose
Callout.Sys	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Support "WFP - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Support "WFP - Remove Binaries" library job.	%WinDir%\System32\Drivers\	This file is required for the callout functions that are used during the stream and injection tests.
DrInstall.Exe	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Support "WFP - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Support "WFP - Remove Binaries" library job.	%WinDir%\System32\	This file is required to install the Sparta Miniport Driver.
NTLog.DLL	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Support "WFP - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Support "WFP - Remove Binaries" library job.	%WinDir%\System32\	This file is required to log output for the test environment.
SpartaMini.Cat	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Support "WFP - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Support "WFP - Remove Binaries" library job.	%WinDir%\System32\Drivers\	This file is required to install the Sparta Miniport Driver.
SpartaMini.Inf	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Support "WFP - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Support "WFP - Remove Binaries" library job	%WinDir%\System32\Drivers\	This file is required to install the Sparta Miniport Driver.
SpartaMini.Sys	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Support "WFP - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Support "WFP - Remove Binaries" library job.	%WinDir%\System32\Drivers\	This file is required to install the Sparta Miniport Driver.
WFPLogo.Answer	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Support "WFP - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Support "WFP - Remove Binaries" library job.	%WinDir%\System32\	This file is optional to partially automate the test process.
WFPLogo.Exe	Copied as part of the Network Security Software tests' "Basic Firewalls - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Support "WFP - Remove Binaries" library job.	%WinDir%\System32\	This file is required for the tests to run.
WFPLogo.Info	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Support "WFP - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Support "WFP - Remove Binaries" library job.	%WinDir%\System32\	This file is required to determine how best to run the tests for the Windows Filtering Platform.
WFPLogo.NTLog	Created during test execution.	%WinDir%\System32\	This file is created at runtime to log whether each test passes or fails.
WFPLogo.Trace	Created during test execution.	%WinDir%\System32\	This file is created at runtime and is used to troubleshoot what WFP objects were added during the test run.
WFPLogoSetup.JS	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Support "WFP - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Support "WFP - Remove Binaries" library job.	%WinDir%\System32\	This file is used to install and configure the Sparta Miniport.

SoftwareDevice.FilterDriver.WindowsFilteringPlatform.TransitionTechnologies_Tests

File name	Origin or Removal	Location	Purpose
AutoSrv.Exe	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job.	%SystemDrive%\Sparta\	This file is required to run the tests that use the Sparta Miniport driver.
AutoSrvC.DLL	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job.	%SystemDrive%\Sparta\	This file is required to run the tests that use the Sparta Miniport driver.
DevCon.Exe	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job.	%SystemDrive%\Sparta\	This file is required to install the Sparta Miniport driver.
DrvInstall.Exe	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job.	%SystemDrive%\Sparta\	This file is required to install the Sparta Miniport driver.
InitAddress.VBS	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job.	%SystemDrive%\Sparta\	This file is required by Teredo_WLK.wsf to run the test scenarios.
InstallSpartaMini.Bat	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job.	%SystemDrive%\Sparta\	This file is used to install and uninstall the Sparta Miniport driver.
NetCapDrv6.Cat	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job.	%SystemDrive%\Sparta\	This file is required by the Sparta Miniport driver to capture the network packets during the tests.
NetCapDrv6.Inf	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job.	%SystemDrive%\Sparta\	This file is required by the Sparta Miniport driver to capture the network packets during the tests.
NetCapDrv6.Sys	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job.	%SystemDrive%\Sparta\	This file is required by the Sparta Miniport driver to capture the network packets during the tests.
NetCapture.DLL	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job.	%SystemDrive%\Sparta\	This file is required by the Sparta Miniport driver to capture the network packets during the tests.
NTLog.DLL	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job.	%SystemDrive%\Sparta\	This file is required to create output logs for the test environment.
SpartaCM.DLL	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job.	%SystemDrive%\Sparta\	This file is required to install the Sparta Miniport driver.
SpartaExtensions.MSI	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job.	%SystemDrive%\Sparta\	This file is required to install the Sparta Miniport driver.
SpartaMini.Cat	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job.	%SystemDrive%\Sparta\	This file is required to install the Sparta Miniport driver.
SpartaMini.Inf	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job.	%SystemDrive%\Sparta\	This file is required to install the Sparta Miniport driver.
SpartaMini.Sys	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job.	%SystemDrive%\Sparta\	This file is required to install the Sparta Miniport driver.
TestCore.DLL	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job.	%SystemDrive%\Sparta\	This file is required to run the tests.
Common.VBS	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job.	%SystemDrive%\Sparta_Test\Common	This file is required by Teredo_WLK.wsf to run the test scenarios.
DNS.VBS	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job.	%SystemDrive%\Sparta_Test\DNS	This file is required by Teredo_WLK.wsf to run the test scenarios.
Teredo_WLK.WSF	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job	%SystemDrive%\Sparta_Test\Tunnel\Teredo\	This script file is used to run the transition technologies tests. This file is required by the job, ” REQ - WFP-based products must support Teredo”
TeredoEmulator.VBS	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job.	%SystemDrive%\Sparta_Test\Tunnel\Teredo\	This file is required by Teredo_WLK.wsf to run the test scenarios.
TeredoPeer.VBS	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job.	%SystemDrive%\Sparta_Test\Tunnel\Teredo\	This file is required by Teredo_WLK.wsf to run the test scenarios.
Tunnel.VBS	Copied as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Copy Binaries" library job. Removed as part of the SoftwareDevice.FilterDriver.WindowsFilteringPlatform.Scenarios.TransitionTechnologies.Support tests' "Transition Technologies - Remove Binaries" library job.	%SystemDrive%\Sparta_Test\Tunnel\	This file is required by Teredo_WLK.wsf to run the test scenarios.

Test computer configuration

To configure the test computer to test your WFP driver, follow these steps:

Install the appropriate Windows operating system on the test computer, and then configure the computer for your test network (the network that contains the Windows HCK Studio and Windows HCK Controller.
Install your WFP driver on the test computer.
Install the Windows HCK client application on the test computer.
Use Windows HCK Studio to create a computer pool, and then move the test computer to that pool.

Important
You must set more configuration values for the individual WindowsFilteringPlatform tests before you can run the tests. See Transition Technologies Test and Windows Filtering Platform Test for more information.

Make sure that the test computer is in the ready state before you begin your testing. If a test requires parameters to be set before it is run, a dialog box will be displayed for that test. Review the specific test topic for more information.

Some Windows HCK tests require user intervention. When running tests for a submission, it is a best practice to run the automated tests in a block separately from manual tests. This prevents a manual test from interrupting completion of an automated test.