Intelligent Desktop Virtualization (IDV) for Education

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

Install Windows VM Image

Follow these instructions on the IDV Build server logged with sysadmin.

  1. Launch the Terminal application to create an empty Window Guest VM image file along with the Windows OVMF files.

  2. $ mkdir /home/$USER/idvguest_windows
    $ cd /home/$USER/idvguest_windows

    $ qemu-img create -f qcow2 win.qcow2 80G
    $ cp /opt/idv/sriov_setup/ovmf/OVMF_CODE.fd OVMF_CODE.fd
    $ cp /opt/idv/sriov_setup/ovmf/OVMF_VARS.fd OVMF_VARS_windows.fd
  3. Copy the windows.iso file transferred from the Windows VM in the Complete and Save Windows ISO step to /home/$USER/idvguest_​windows directory.

  4. # Copy the windows.iso file to idvguest_windows directory.
    $ cd /home/$USER/idvguest_windows
    $ cp <windows.iso source path> .
  5. Run install_​windows.sh to start Windows guest installation.

  6. # Start guest VM to install Windows
    $ cd /home/$USER/idvguest_windows
    $ cp /opt/idv/sriov_setup/install_windows.sh .
    $ sudo ./install_windows.sh
  7. If you miss the Press Any Key message, press the ESC key until you reach the EFI shell prompt, then type reset to start over again.
  8. Follow the Windows installation steps as usual, and Windows will be installed to win.qcow2.
  9. Shut down the Windows guest.
  10. Launch the Terminal application and run the following command to run start_​windows.sh.

  11. # Start guest VM to install Windows drivers
    $ cd /home/$USER/idvguest_windows
    $ cp /opt/idv/sriov_setup/start_windows.sh .
    $ sudo -E ./start_windows.sh

    IMPORTANT NOTE:

    For the first bootup of the Windows guest VM, wait for the Windows 21H2 OS to settle down and complete loading all its components (Windows Task Bar Icons show up and can be accessed the START menu) before installing the patches and drivers.

    Note:If the error message Error: insufficient memory to allocate hugepages is observed, execute following command to free memory.
    free -h && sudo sysctl -w vm.drop_caches=3 && sudo sync && echo 3 | sudo tee /proc/sys/vm/drop_caches && free -h
  12. Open the Intel Folder on the desktop. Run the setup.idvguest.windows batch file as administrator to automate the installation of drivers and veyon. Once the SR-IOV Zero Copy driver installation is completed, the Windows 10 Guest VM will reboot automatically.
  13. Shut down the VM.
  14. On the IDV Server, upload the generated qcow2 image file.
    sudo /opt/idv/scripts/update-img.idvserver.sh --path <IMG_PATH> --os <windows/ubuntu>