→ Applies to: Hyperion 9.x and above

To ensure optimal performance and integration for virtualized Windows workloads, it is recommended to install the VirtIO driver stack and Guest Agent Tools on Syneto Hyperion.

While the platform supports emulated devices by default (such as SATA and e1000), VirtIO enables high-performance paravirtualized drivers for disk, network, memory, and display; this reduces CPU overhead, improves I/O throughput, and enables features such as clean shutdowns, memory ballooning, IP reporting, and file system locking.

The VirtIO package, available via the official driver ISO, includes all the necessary drivers and the QEMU Guest Agent to improve communication between the guest operating system and the hypervisor.

Step 1. Login to SynetoOS GUI

Step 2. From Virtualization menu, click on Virtual machines

Step 3. Select the VM on which you want to install the Guest agent tools

Scroll down to the OS Details section until you see the Install button

VirtIO Driver Configuration via Hyperion

Step 1. Click on Install (next to the Guest agent tools entry)

Step 2. Click on Install

The VirtIO Guest Tools ISO will automatically mount to the VM's optical drive and any previously mounted ISOs will be ejected.

VirtIO Driver Configuration via ISO

Step 1. Download the VirtIO Driver recommended for your OS version and extract it ("VirtIO Library Download")

Step 2. Click on the 3 dots, then click Edit hardware

Step 3. From Optical drives section, click on Add optical drive, then click on your image repository and Select file

Step 4. Click on Upload file

Step 5. Click on Browse and select the downloaded ISO, then click on Upload and wait for completion

Step 6. Ensure mount image is checked, select the uploaded ISO then click on Update.

Install VirtIO Driver on Windows

Step 1. Login to Windows VM and open File explorer

A CD drive labeled “virtio-win-1.x.x” should appear on the left.

Open the mounted ISO and scroll down on the right until “virtio-win-guest-tools.exe” becomes visible

Step 2. Double-click on virtio-win-guest-tools

Step 3. Accept license agreement and click on Next

Step 4. Leave the default selection unchanged and click on Next

Step 5. Click on Finish

Step 6. Reboot the virtual machine

Step 7. Check if Guest agent tools are correctly installed

With the VirtIO and Guest agent tools installed, disks and network interfaces can now be switched or added via VirtIO.

To verify functionality, open the Run tab in SynetoOS and check the Guest agent tools status in OS Details. It should show Running if configured correctly.

Step 8 (optional). Login to Windows VM and run services.msc

Check if the QEMU Guest Agent service is running

If the QEMU Guest Agent service is not running on the Windows VM, start it manually.