Intelligent Desktop Virtualization (IDV) for Education

ID Date Version Classification
824808 06/26/2025 1.3.13-3.1 Public
Document Table of Contents

Create Windows* Guest VM Image

Prerequisites

  1. Copy the following files to MTL Ubuntu IDV Build Server at the path of ~/idv_​setup/scripts/guest_​setup/ folder:
    • Intel® Graphics Driver Production Driver Version 101.5445 (File name: GFX-prod-hini-releases_​24ww12-ci-master-16102-revenue-pr-1015445-ms-attestation-sign-664-MTL-Rx64.zip)
    • Windows* Zero Copy Drivers Release 1574 [DVServer, DVServerKMD]. (File name: ZCBuild_​1574_​MSFT_​Signed_​Installer.zip)
  2. Make sure all the required files have been copied to guest_​setup folder on the Intel host machine which is to run the guest VM(s).
  3. Run the command to prepare the required files.

  4. $ cd ~/idv_setup/scripts/guest_setup
    $ chmod +x mtl-guest-setup.sh
    $ sudo ./mtl-guest-setup.sh
  5. Now the system is ready to run Windows Automated install.
  6. Note:VM will restart multiple times and finally shut down automatically after completion. Installation may take some time, please be patient. As part of the Windows installation process VM may be restarted in SR-IOV mode for installation of SR-IOV required drivers in the background. At this stage VM will no longer have display on virt-viewer UI nor on VNC. Instead, the VM display could be found on host platform physical monitor. DO NOT interfere or use the VM before the setup script exits successfully.
  7. For Windows* 10 guest VM automated installation

  8. $ cd /home/sysadmin/kvm-multios
    $ ./guest_setup/ubuntu/win10_setup.sh -p client --force --viewer
  9. For Windows* 11 guest VM automated installation

  10. $ cd /home/sysadmin/kvm-multios
    $ ./guest_setup/ubuntu/win11_setup.sh -p client --force --viewer
  11. Windows* 10 Guest VM launch step after installation done

  12. $ cd ~/kvm-multios
    $ ./platform/client/launch_multios.sh -f -d windows -g sriov windows
  13. Windows* 11 Guest VM launch step after installation done

  14. $ cd ~/kvm-multios
    $ ./platform/client/launch_multios.sh -f -d windows11 -g sriov windows11
  15. MTL Windows VM customization steps:
    1. Place downloaded python and 4.8.3 veyon exe at MTL IDV Server /home/sysadmin/idv_​setup/scripts/windows_​setup/
    2. Run below command at launched windows VM’s admin command prompt terminal. Update the MTL IDV Server IP to the correct IP.
    3. scp sysadmin@<MTL_IDV_Server_IP>:/home/sysadmin/idv_setup/scripts/windows_setup/mtl.setup.idvguest.windows.bat %WINDIR%\Setup\
    4. Go to C:\Windows\Setup\ and run mtl.setup.idvguest.windows.bat as admin.
    5. After finish install Guest VM, launch the Terminal application, and execute the instructions below to upload the VM disk image:
    sudo /opt/idv/scripts/update-img.idvserver.sh --path /var/lib/libvirt/images/<windows10/11>.qcow2 --os windows