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.
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 -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:
Post-installation this can be disabled with:
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.
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.
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.
Open a PowerShell administrator prompt, navigate to the kazinstall directory, and enter:
After installation is complete ALL WORKER HOSTS MUST BE RE-BOOTED.
Your Windows Hosts will now be listed in Host Management as Connected.
Please refer to FAQs - How do I troubleshoot Windows Desktop Hosts?