Config - Install Drivers and Guest Agent for Template Images

Modified on Tue, 27 May at 3:09 PM

When uploading your own virtual machine templates to Softdrive, it is critical to install the necessary drivers and agents to ensure proper integration and functionality. Follow the steps below based on the operating system you are using.


Windows Templates

  1. Download VirtIO Drivers
    Visit the official VirtIO driver repository to get the latest ISO:
    Download win-virtio ISO

  2. Install Drivers and Guest Agent

    • Mount the downloaded ISO to your Windows VM.

    • Run virtio-win-guest-tools.exe from the mounted ISO.

    • During installation, select all available drivers and ensure the QEMU Guest Agent is installed.

  3. Preserve Drivers During Sysprep (Optional but Recommended)
    If you are using sysprep with an unattend XML file, make sure to include the following section to retain drivers not currently in use:

    xml
    CopyEdit
    <component name="Microsoft-Windows-PnpSysprep" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="nonSxS" xmlns:wcm="http://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <PersistAllDeviceInstalls>true</PersistAllDeviceInstalls> <DoNotCleanUpNonPresentDevices>true</DoNotCleanUpNonPresentDevices> </component>

 Linux Templates

  1. Install QEMU Guest Agent
    Make sure the guest agent is installed and enabled on boot:

    bash
    CopyEdit
    sudo apt install qemu-guest-agent # For Debian/Ubuntu sudo yum install qemu-guest-agent # For RHEL/CentOS sudo systemctl enable --now qemu-guest-agent
  2. Enable RPC Access for RHEL/CentOS
    On RHEL variants, modify the QEMU Guest Agent configuration to enable RPC commands:

    bash
    CopyEdit
    sudo sed -i "s/\(BLACKLIST_RPC.*\)/# \1/g" /etc/sysconfig/qemu-ga

Summary

OSAction
WindowsInstall VirtIO drivers + guest agent. Add unattend XML for sysprep.
LinuxInstall and enable QEMU guest agent. Unblacklist RPC on RHEL.


Following this guide ensures your templates function properly with Softdrive’s virtualization environment.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons

Feedback sent

We appreciate your effort and will try to fix the article