Skip to content

Commit 0333a5e

Browse files
Warn about outdated distro virtio-win packages and the Windows Server 2025 smbus driver issue
The Enterprise Linux distribution virtio-win packages can be old enough to contain no drivers for recent Windows releases, in which case virt-v2v converts the guest without a virtio storage driver and the imported VM cannot boot. Document overwriting the ISO with the latest upstream build, and document the Windows Server 2025 first-boot reboot loop caused by the rejected smbus driver signature, with its workaround.
1 parent 3d72e47 commit 0333a5e

1 file changed

Lines changed: 22 additions & 0 deletions

File tree

source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -97,6 +97,28 @@ For Debian-based distributions (alien is needed for conversion of .rpm to .deb p
9797
dpkg -i virtio-win*.deb
9898
ls -l /usr/share/virtio-win
9999

100+
.. note::
101+
Never rely on the ``virtio-win`` package from the Enterprise Linux distribution
102+
repositories: it lags the upstream project considerably and may contain no drivers at
103+
all for recent Windows releases (for example, the EL9 package 1.9.40 has no drivers
104+
for Windows Server 2025). virt-v2v then converts the guest without a virtio storage
105+
driver and the imported VM cannot boot from its virtio disk. If the guest's Windows
106+
release is newer than the drivers in the installed RPM, overwrite the ISO with the
107+
latest upstream build:
108+
109+
::
110+
111+
curl -L -o /usr/share/virtio-win/virtio-win.iso https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/latest-virtio/virtio-win.iso
112+
113+
.. note::
114+
Windows Server 2025 enforces a stricter driver-signature policy at runtime and, as of
115+
virtio-win 0.1.285, rejects the optional ``smbus`` driver's certificate during the
116+
first-boot driver installation. virt-v2v retries the failed installation on every
117+
boot, which leaves the imported guest in a reboot loop. Until this is resolved in the
118+
virtio-win project, remove ``smbus.inf`` and ``smbus.cat`` from the driver set on the
119+
conversion host before converting Windows Server 2025 guests; the driver is a
120+
non-essential SMBus stub and the essential storage and network drivers install fine.
121+
100122
On some distros, the Windows helper binary "rhsrvany.exe", which is used for Windows-based VM firstboot scripts and some other actions, might be missing.
101123

102124
To avoid virt-v2v error like ``virt-v2v: error: One of rhsrvany.exe or pvvxsvc.exe is missing in /usr/share/virt-tools`` - check if the file exists (it's actually a symbolic link):

0 commit comments

Comments
 (0)