Windows HLK Prerequisites
Warning
The Windows Hardware Lab Kit (HLK) should only be installed on machines that are dedicated solely for testing purposes. Do not install any HLK component on a machine that is outside of a dedicated testing environment.
Windows HLK is comprised of two components: an HLK test server and one or more test systems.
HLK test server. Often referred to as the controller, a test server has two parts: Windows HLK Controller and Windows HLK Studio. The Controller software is the engine that manages tests that are run on test systems. The Studio software is the management tool that lets you select and schedule tests against any test system connected to the test server. Controller and Studio are installed from the Windows HLK installation source. After installation, the test server contains separate installers to install a remote Windows HLK Studio and Windows HLK Client.
One controller governs a collection of client computers. Controllers can manage and access only the client computers that they govern.
Test system. Also referred to as a client computer, each test system can have a different configuration that's appropriate for various testing scenarios, including different hardware, operating systems, service packs, and drivers. Each test system can be associated with only one test server. You can configure each test system by running the Windows HLK Client software installer directly from a shared network location on the test server.
Before you begin testing, be sure that the test environment meets the necessary requirements.
- You must uninstall any 32-bit SQL Server installation prior to installing the HLK. 32-bit SQL Server installations are not supported.
- You must uninstall any SQL Server 2014, 2015, 2016, and 2017 installations prior to installing the HLK.
- Note for the Test system, having Secure Boot enabled on a test computer can cause the HLK Client installation to fail. Additionally there are a set of HLK tests which require Secure Boot to be disabled in order to run properly. Please see System Testing with Secure Boot for the complete list of tests.
Deployment scenarios
There are two deployment scenarios for Windows HLK:
Domain-joined environment. In a domain-joined environment, a domain controller is present and all computers designated for Windows HLK features are joined to the same domain controller. If you plan to deploy Windows HLK in a domain-joined environment, you need a minimum of three computers: a Windows domain controller, a Windows HLK test server, and at least one Windows HLK test system. Make sure that Microsoft Active Directory is configured and running on the domain controller. Your domain controller and HLK test server cannot be on the same box.
Workgroup environment. A workgroup environment has no domain controller. If you plan to deploy Windows HLK in a workgroup, you need at least two computers: a test server and a test system joined to the same workgroup. Don't use the Default Administrator account. In this configuration, you must enable the Guest account.
In addition, consider how you want to organize lab resources to best use the Windows HLK. You need to determine the number of test servers and the number of test systems connecting to them. These decisions are partly influenced by the type of devices or systems that you want to test.
To test systems and filter drivers, you need at least 1 test server and 1 test system.
To test external devices, you need at least 1 test server, 1 test system, and the external device(s) to be tested.
You can choose to allocate fewer controllers, each with multiple clients connected to them, if you want less overhead administering the controllers and clients. A maximum of 150 clients can be connected to a single controller. Alternately, you can allocate more controllers and connect fewer clients to them. This allows any given controller to be more responsive because it has fewer clients communicating with it. For more information, see HLK Controller and Client Organization.
The following image shows an example test environment.
System Requirements
Test server
Component | Minimum | Optimum |
---|---|---|
Processor |
Single Intel or AMD-based x64 platform with a speed of 2.0 GHz |
Multicore or multiple x64-based processors running in x64 mode with a speed of 2.0 GHz or faster |
System memory |
2 GB main memory |
4 GB main memory |
Hard disk capacity |
300 GB minimum to accommodate the volume of logs that can be generated. |
RAID configuration |
Network connection |
100 megabits per second (Mbps) |
1 gigabit per second (Gbps) |
Operating system |
English language and English local version of Windows Server 2012, Windows Server 2012 R2, Windows Server 2016 for versions of the HLK released before 2021. For Windows 11, HLK Windows Server 2016 and Windows Server 2019 are the Windows Server versions supported for the HLK Controller. Versions of the HLK released in 2024 and later will support Server 2022. |
Note
Windows Server 2019 is not supported as a host OS for the 1809 HLK Controller on releases of HLK before 2021. However, it is supported as a client OS.
Note
Windows Server 2025 is not supported as a host OS for the HLK Controller on current releases of HLK. However, it is supported as a client OS.
Note
- Windows 10S users should test against Windows 10 Pro.
- Controller isn't supported on Windows Server 2003, Windows Server 2008, Windows Vista, Windows XP, or Windows 2000.
- Controller isn't supported on an installation that has already been set up as a domain controller.
- Test systems should be dedicated for testing purposes and should not store sensitive information on them or have previously have been used to store sensitive information on them in the past. Each test system's hard drive should be formatted and the operating system you want the computer to run should be installed or reinstalled so that the system is in a clean state before installing the HLK Client and running tests.
- Controller isn't supported on an Server Core installation.
- Controller supports Standard and Datacenter editions only.
Test system
Component | Minimum |
---|---|
Processor |
The recommended processor for the operating system that you install. |
System memory |
Refer to the recommended processor for the operating system that you install. |
Hard disk capacity |
300 GB minimum to accommodate the test files and logs that can be generated. The client must be unique; you can't swap drives. |
Network connection |
100 Mbps |
Operating system |
Install the English language and English local version of the Windows operating system that you are testing against. Test systems are not supported in a virtual PC or any third-party Hypervisor environment. If you are testing against a Windows "N" edition, you must also manually install Media Feature Pack. Windows 10S users should test against Windows 10 Pro. If you are testing against a Windows Server, you install a DataCenter edition and the "Full Server" or "Server with a GUI" during Setup. |
Additional requirements |
Disable Secure Boot, as this can cause the HLK client installation to fail. Additionally, there are a set of test which require Secure Boot to be disabled to run correctly. Please review the [System testing with Secure Boot](../testref/system-testing-with-secure-boot.md) documentation for more information. Many of the tests require a test system to restart--often more than once--to complete a test run. So, we recommend that you:
For Workgroup environments, you must enable the guest account.
Testing may also require:
|
Optional remote/standalone Windows HLK Studio
Component | Minimum |
---|---|
Processor |
The recommended processor for the operating system that you install. |
System memory |
Refer to the recommended processor for the operating system that you install. |
Hard disk capacity |
300 GB minimum to accommodate the volume of logs that can be generated. The client must be unique; you can't swap drives. |
Network connection |
100 Mbps |
Operating system |
|