Virtual Machines - Troubleshooting
The Edge Software Configurator package was previously named
edge_software_manager
. Some screenshots, commands, and file paths in this guide still use
esm
or
edge_software_manager
at this time.
Virtual Machine I/O Device Assignment
If any new USB or PCI device is added to the host machine, make sure to restart your system or restart VM-agent container by executing the below command:
sudo docker restart esm-vm-agent
Windows GFX Driver Support with vGPU Feature
You can download the Windows driver from the
Graphics Driver section on the Intel websiteor click on Windows OS update, once the OS is installed. Depending on your Intel processor, the latest validated driver version for Skylake and Coffee Lake is 26.20.100.7000.
Windows Virtual Machine booted with UEFI Firmware Type
Click on View Console of the ISO Virtual Machine, which is in created state, and type the following commands:
FS0: cd EFI/BOOT BOOTX64.EFI

After entering the above commands, press
Enter
.

Delay in Accessing Virtual Machine
If you face a delay in accessing the Virtual Machine, you can restart the VM.
Virtual Machine Template Disabled or Error
- After executing all the prerequisites with the required files from GitHub, restart theesm-vm-agentcontainer by issuing the below command on the terminal of the host device:sudo docker restart esm-vm-agent
Failed to install or start virtual machine
- Click on theInformationicon to see details about the error.
Failed to install virtual machine: Connection to Edge Software Provisioner failed
- If the system is behind a proxy, ensure that proxy configuration in the/etc/environmentfile is correct.
- Verify that no other applications are currently using port 8888 as it is reserved for Edge Software Provisioner.
- ReinstallIntel® Edge Software Configuratorafter making the changes above.
Installation Timeout Error at 0%
- Intel® Edge Software Configuratorrequires wired Internet connection for virtual machine operations. Make sure your system is not connected through WiFi.
- Verify Edge Software Provisioner is accessible over the IP address, for example, http://<ip_address>:8888/tftp
Installation Failed at #%
- Delete the Virtual Machine for which the installation failed and create a new one. This is usually due to interruptions caused by the system.
KVM disabled
- Enable Intel® VT-x in the BIOS.
#MB memory is not available in the host
- Ensure there is enough available memory on the host system before adding new virtual machine. Select virtual machine template with smaller memory allocation (2048 MB minimum).
Cannot set up guest memory ‘pc.ram’: Out of memory
- Ensure there is enough available memory on the host system or edit the virtual machine to reduce its memory allocation before powering on the virtual machine.
Other Errors
- Restart the system.