Skip to content

Inject VirtIO Windows Driver

Bundled VirtIO ISOs

The vJailbreak appliance image already includes the VirtIO driver ISOs in /home/ubuntu/virtio-win/, so you do not need to upload anything for a standard migration:

  • virtio-win.iso — virtio-win 0.1.271 (as of v0.6.0), used for Windows VMs
  • virtio-win-server12.iso — virtio-win 0.1.185, used automatically for Windows Server 2012 and 2012 R2 guests

How to use user-provided virtio-win.iso

To use a different VirtIO driver version, replace virtio-win.iso at the following path on the vJailbreak master node:

Terminal window
/home/ubuntu/virtio-win/virtio-win.iso

How it works

If the user has scaled up vJailbreak, the ISO is propagated to all the agents. When a Windows VM migration is initiated:

The migration logic checks for /home/ubuntu/virtio-win/virtio-win.iso on the source node. For Windows Server 2012 and 2012 R2 guests, it uses /home/ubuntu/virtio-win/virtio-win-server12.iso instead.

  • If found:
    • The ISO is used for injecting VirtIO drivers into the migrated disk.
    • The ISO is automatically propagated to all agent nodes if needed.
  • If not found:
    • vJailbreak attempts to download the ISO from a known upstream source (e.g., fedorapeople.org).
  • If both methods fail:
    • Migration fails gracefully with a clear error message.