You will need at least two Windows machines: one controller and at least one worker host.

Controller will run configuration scripts that remotely install both Kazuhm and its required components on each worker host.

Once installation is complete the Controller is no longer used by Kazuhm.

Minimum Requirements

All Windows machines must run Windows 10 Professional version 1803 or later.

Each machine must be joined to the same domain (and the same subdomain if it exists) and connected to the same subnet of a DHCP network.

And the full network name of each host is required. For example, if the domain name is “kazuhm” and subdomain is “lab”, the complete host name must include both domain and subdomain: “my-machine.lab.kazuhm.com” (and not my-machine.kazuhm.com”)

Remote configuration scripts will modify Operating System and network settings on worker machines.

1. Pre-configure Controller

This is only required on the Controller machine.

From a PowerShell prompt, enter the following command:

Set-ExecutionPolicy Unrestricted

or

Set-ExecutionPolicy Unrestricted -Scope Process

to restrict the execution policy to the current PowerShell instance. Remember to repeat this step each time you open a new PowerShell window.

2. Pre-configure Workers

Enable Windows Hypervisor

On each Worker verify that Windows Hypervisor is enabled.

• Right-click the Windows Logo and choose Apps and Features.
• Click Programs and Features under Related Settings.
• Click Turn Windows Features on or off.
• Ensure Hyper-V is enabled:

Allow Remote Command Execution

Open an admin PowerShell prompt and enter:

Enable-PSRemoting -Force

Post-installation this can be disabled with:

Disable-PSRemoting

3. Add Host

From Host Management, Add Host, selecting Windows Pro.

Create Installer Package

Once selected you will have to provide additional information required to Create Installer script, that installs the Kazuhm, and connects your new host to the Kazuhm portal.

Information includes:

Name - Name of the Controller Machine.

Location - Physical location of the hosts. Note that this will be converted to all lower case and <space>'s replaced by "-".

List of Machine Names - Full Network Name for all Workers; each name must start on a new line. Do not enter controller name.

Once entered click Next to generate and download the Installer Package kazinstall.zip.

Installation

Copy Installer Package to Host

Use the RDP Windows client to copy the installer package kazinstall.zip file to the Controller.

Extract Installer Scripts

We recommend running installer scripts and configuration commands from a Windows PowerShell prompt. To open PowerShell enter “PowerShell” in the Windows search box and choose “Run as administrator”.

On the Controller, extract contents of the installer package kazinstall.zip file, and navigate to the newly created directory kazinstall.

Run Installer

Open a PowerShell administrator prompt, navigate to the kazinstall directory, and enter:

& .\KazuhmInstallerWin.ps1

After installation is complete ALL WORKER HOSTS MUST BE RE-BOOTED.

Your Windows Hosts will now be listed in Host Management as Connected.

Troubleshooting

Please refer to FAQs - How do I troubleshoot Windows Desktop Hosts?