Fix virtio-win install steps for EL hosts - #657
Merged
Conversation
Contributor
Author
|
Pls make sure this is reviewed and merged for 4.22.x - since "yum install virtio-win" will not work at all. |
andrijapanicsb
force-pushed
the
andrijapanicsb/fix-virtio-win-el-install
branch
3 times, most recently
from
May 26, 2026 09:45
ea5d826 to
41be3ba
Compare
Clarify installation instructions for virt-v2v and virtio drivers, including logging and error handling for Windows VMs.
Updated the instructions for importing VMware VMs into KVM, including recommendations for virt-v2v versions and installation steps for required tools.
Contributor
Author
|
@sureshanaparti please make sure this is merged as part of the official release docs, since some instructions were wrong (virtio-win installation on EL hosts). And there is also a clarification on the needed VDDK library versions, for stability etc (everything tested last few days by me) |
… 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.
… ISO The previous note said to remove the driver from the driver set without explaining that virt-v2v reads it from the ISO itself, which cannot be edited in place. Document the full extract, delete and rebuild sequence with xorriso; verified on an EL9 conversion host against virtio-win 0.1.285.
… on auto-detection Auto-detection of the VDDK directory can pick up the wrong libraries on real hosts - leftovers from container images, a second VDDK installation, or a partially extracted tree - and the resulting conversion failures are hard to trace to the wrong library path. The text presented the property as an option for non-standard locations; it is now the recommended default, with auto-detection described as a fallback only. This also completes a sentence that was previously cut off mid-reference.
…and newer only Older Windows releases accept the driver's signature and work with the unmodified upstream ISO; make that explicit so operators do not rebuild the ISO unnecessarily.
Contributor
Author
|
@codex please review, because it seems nobody gives a...damn about actually help users with proper docs.... this is all filed-tested/sourced data (most of it) |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
yum install virtio-winguidance with direct installation of the Fedora-providedvirtio-win.noarch.rpm./usr/share/virtio-winis the virt-v2v driver search path and simplify the Debian RPM conversion workaround.smbusdriver signature (virtio-win 0.1.285) and its workaround (remove the non-essentialsmbus.inf/smbus.catfrom the driver set before conversion).Related to #640.
📚 Documentation preview 📚: https://cloudstack-documentation--657.org.readthedocs.build/en/657/