mirror of
https://pagure.io/fedora-docs/quick-docs.git
synced 2024-11-24 21:35:17 +00:00
273 lines
9.4 KiB
Text
273 lines
9.4 KiB
Text
= Windows Virtio Drivers
|
||
|
||
'''
|
||
|
||
[IMPORTANT]
|
||
======
|
||
|
||
This page was automatically converted from https://fedoraproject.org/wiki/Windows_Virtio_Drivers
|
||
|
||
It is probably
|
||
|
||
* Badly formatted
|
||
* Missing graphics and tables that do not convert well from mediawiki
|
||
* Out-of-date
|
||
* In need of other love
|
||
|
||
Please fix it, remove this notice, and then add to `_topic_map.yml`
|
||
|
||
Pull requests accepted at https://pagure.io/fedora-docs/quick-docs
|
||
|
||
Once that is live, go to the original wiki page and add an `{{old}}`
|
||
tag, followed by a note like
|
||
|
||
....
|
||
{{admon/note|This page has a new home!|
|
||
This wiki page is no longer maintained. Please find the up-to-date
|
||
version at: https://docs.fedoraproject.org/whatever-the-url
|
||
}}
|
||
....
|
||
|
||
======
|
||
|
||
'''
|
||
|
||
|
||
[[overview]]
|
||
Overview
|
||
~~~~~~~~
|
||
|
||
This page describes how to obtain and use virtio drivers for Windows
|
||
virtual machines running on KVM, and additional software agents for
|
||
Windows VMs.
|
||
|
||
[[yumdnf-repo]]
|
||
Yum|Dnf Repo
|
||
~~~~~~~~~~~~
|
||
|
||
There is a yum|dnf repo shipping 'virtio-win' RPMs. The RPMs install
|
||
driver binaries and agent installers on your host machine into
|
||
/usr/share. These bits can then be shared with Windows VMs.
|
||
|
||
Install the repo file:
|
||
|
||
`sudo wget `https://fedorapeople.org/groups/virt/virtio-win/virtio-win.repo[`https://fedorapeople.org/groups/virt/virtio-win/virtio-win.repo`]` -O /etc/yum.repos.d/virtio-win.repo`
|
||
|
||
Then install the virtio-win package with link:dnf[DNF] or YUM:
|
||
|
||
`sudo dnf install virtio-win` +
|
||
`sudo yum install virtio-win`
|
||
|
||
The .repo file provides two different repositories:
|
||
|
||
* virtio-win-stable
|
||
** This provides builds of virtio-win that roughly correlates to what
|
||
was shipped with the most recent RHEL release, meaning they have
|
||
received a decent chunk of testing.
|
||
** This repo is enabled by default.
|
||
|
||
* virtio-win-latest
|
||
** This provides the latest driver builds. They may be development
|
||
quality, or bug free, or complete broken. Caveat emptor :)
|
||
** This repo is disabled by default. If you want to update from
|
||
virtio-win-stable to the latest bits, do:
|
||
`sudo yum --enablerepo=virtio-win-latest update virtio-win`
|
||
|
||
or with dnf:
|
||
`sudo dnf --enablerepo=virtio-win-latest upgrade virtio-win`
|
||
|
||
[[rpm-contents]]
|
||
RPM contents
|
||
^^^^^^^^^^^^
|
||
|
||
* /usr/share/virtio-win/*.iso: ISO CDROM containing all the drivers. See
|
||
details below
|
||
* /usr/share/virtio-win/*.vfd: VFD floppy images for using during
|
||
install of Windows XP
|
||
* /usr/share/virtio-win/drivers: Copy of the extracted VFD driver
|
||
contents
|
||
* /usr/share/guest-agent/*.msi: QEMU Guest Agent 32bit and 64bit MSI
|
||
installers
|
||
|
||
[[iso-contents]]
|
||
ISO contents
|
||
^^^^^^^^^^^^
|
||
|
||
The .iso contains the following bits:
|
||
|
||
* NetKVM/: Virtio Network driver
|
||
* viostor/: Virtio Block driver
|
||
* vioscsi/: Virtio SCSI driver
|
||
* viorng/: Virtio RNG driver
|
||
* vioser/: Virtio serial driver
|
||
* Balloon/: Virtio Memory Balloon driver
|
||
* qxl/: QXL graphics driver for Windows 7 and earlier. (build
|
||
virtio-win-0.1.103-1 and later)
|
||
* qxldod/: QXL graphics driver for Windows 8 and later. (build
|
||
virtio-win-0.1.103-2 and later)
|
||
* pvpanic/:
|
||
https://github.com/qemu/qemu/blob/master/docs/specs/pvpanic.txt[QEMU
|
||
pvpanic] device driver (build virtio-win-0.1.103-2 and later)
|
||
* guest-agent/: QEMU Guest Agent 32bit and 64bit MSI installers
|
||
* qemupciserial/:
|
||
https://github.com/qemu/qemu/blob/master/docs/qemupciserial.inf[QEMU PCI
|
||
serial] device driver
|
||
* ** .vfd: VFD floppy images for using during install of Windows XP
|
||
|
||
[[direct-download]]
|
||
Direct download
|
||
~~~~~~~~~~~~~~~
|
||
|
||
Direct downloads are available for the .iso, .vfd, and qemu-ga
|
||
installers.
|
||
|
||
* Stable virtio-win iso:
|
||
https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.iso
|
||
* Stable virtio-win x86 floppy:
|
||
https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win_x86.vfd
|
||
* Stable virtio-win amd64 floppy:
|
||
https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win_amd64.vfd
|
||
* Latest virtio-win iso:
|
||
https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/latest-virtio/virtio-win.iso
|
||
* Latest virtio-win x86 floppy:
|
||
https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/latest-virtio/virtio-win_x86.vfd
|
||
* Latest virtio-win amd64 floppy:
|
||
https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/latest-virtio/virtio-win_amd64.vfd
|
||
* Latest qemu-ga files:
|
||
https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/latest-qemu-ga/
|
||
* Full archive:
|
||
https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/
|
||
* Changelog: https://fedorapeople.org/groups/virt/virtio-win/CHANGELOG
|
||
|
||
If you previously used isos from alt.fedoraproject.org, note that these
|
||
new isos have a different file layout (matching RHEL isos). If you need
|
||
to access the old isos you can do so
|
||
https://fedorapeople.org/groups/virt/virtio-win/deprecated-isos/[here].
|
||
However these isos are deprecated and only kept around for back
|
||
compatability. No new isos will be added there.
|
||
|
||
[[faq]]
|
||
FAQ
|
||
~~~
|
||
|
||
[[what-license-are-these-drivers]]
|
||
What license are these drivers?
|
||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
||
The drivers are licensed under the GPLv2.
|
||
|
||
[[why-arent-the-drivers-shipped-as-part-of-fedora]]
|
||
Why aren't the drivers shipped as part of Fedora?
|
||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
||
The drivers cannot be shipped as part of Fedora because they can't be
|
||
built in Fedora's build system; the only way to build the drivers is on
|
||
a Windows machine. Shipping pre-compiled sources is generally against
|
||
Fedora policies. There's likely other objections as well.
|
||
|
||
[[where-do-the-builds-come-from]]
|
||
Where do the builds come from?
|
||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
||
All the windows binaries are scooped up from builds done on Red Hat's
|
||
internal build system, which are generated using publicly available
|
||
code.
|
||
|
||
See the README in this repo for some more details about how the RPM and
|
||
repo are built: https://github.com/crobinso/virtio-win-pkg-scripts
|
||
|
||
[[what-is-the-reasoning-behind-the-rpmiso-layout]]
|
||
What is the reasoning behind the RPM/ISO layout?
|
||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
||
For starters, the primary purpose of the RPM/ISO is to mirror exactly
|
||
the layout that is shipped with the latest RHEL release. This is so
|
||
user/developers don't have to deal with differences between the two
|
||
distros.
|
||
|
||
(Note: Historically the .iso files shipped on alt.fedoraproject.org did
|
||
_not_ match the layout of the .iso shipped in RHEL. This changed in
|
||
April 2015)
|
||
|
||
* The .iso directories are named after the driver code directories from
|
||
the upstream driver git tree. There isn't much more to it than that.
|
||
* Below the driver directories, the $winversion/$arch/ directory naming
|
||
is a windows convention.
|
||
* The RPM layout is kind of arbitrary in that it ships the .vfd content
|
||
in the drivers/ dir, but not many of the other drivers from the .iso.
|
||
This seems to be an historical oversight and should probably be fixed.
|
||
|
||
[[are-these-drivers-signed]]
|
||
Are these drivers signed?
|
||
^^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
||
These drivers are cryptographically signed with Red Hat's vendor
|
||
signature. However they are not signed with
|
||
https://msdn.microsoft.com/en-us/library/windows/hardware/ff553976%28v=vs.85%29.aspx[Microsoft's
|
||
WHQL signature].
|
||
|
||
[[how-are-these-drivers-different-from-what-is-shipped-with-rhel]]
|
||
How are these drivers different from what is shipped with RHEL?
|
||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
||
The RPMs from the stable repository are the same driver builds as what
|
||
is shipped in RHEL. However, the public drivers are not signed with
|
||
https://msdn.microsoft.com/en-us/library/windows/hardware/ff553976%28v=vs.85%29.aspx[Microsoft's
|
||
WHQL signature].
|
||
|
||
[[how-does-lack-of-whql-signature-affect-use-of-these-drivers]]
|
||
How does lack of WHQL signature affect use of these drivers?
|
||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
||
FIXME: Lack of WHQL signature causes windows to complain, need to
|
||
explicitly document how
|
||
|
||
[[bugs]]
|
||
Bugs
|
||
~~~~
|
||
|
||
Please file any bug reports against
|
||
https://bugzilla.redhat.com/enter_bug.cgi?product=Virtualization%20Tools&component=virtio-win[Product=Virtualization
|
||
Tools Component=virtio-win]
|
||
|
||
When filing a bug, please provide the following info:
|
||
|
||
* The virtio-win version
|
||
* The host distro
|
||
* The qemu version
|
||
* If using libvirt: sudo virsh dumpxml $vmname
|
||
* The qemu command line. If using libvirt this can be found at
|
||
/var/log/libvirt/qemu/$vmname.log
|
||
|
||
Questions/Comments about the RPMs or yum|dnf repos should be sent to
|
||
regular fedora virt locations:
|
||
https://fedoraproject.org/wiki/Virtualization#Mailing_list_and_IRC
|
||
Questions/Comments about the actual drivers are probably best send to
|
||
the upstream
|
||
https://lists.nongnu.org/mailman/listinfo/qemu-devel[qemu-devel] or
|
||
http://www.linux-kvm.org/page/Lists,_IRC[kvm] mailing lists
|
||
|
||
[[links]]
|
||
Links
|
||
~~~~~
|
||
|
||
* KVM windows guest drivers upstream code:
|
||
https://github.com/virtio-win/kvm-guest-drivers-windows
|
||
* QXL XDDM driver code: http://cgit.freedesktop.org/spice/win32/qxl
|
||
* QXL WDDM driver code: https://github.com/vrozenfe/qxl-dod
|
||
* Tree used by gnome-boxes for automatic driver installation:
|
||
https://zeenix.fedorapeople.org/drivers/
|
||
* Windows spice agent git repo:
|
||
http://cgit.freedesktop.org/spice/win32/vd_agent
|
||
* Spice guest tools installer code:
|
||
http://cgit.freedesktop.org/~teuf/spice-nsis/
|
||
* spice-guest-tools downloads:
|
||
http://www.spice-space.org/download/binaries/spice-guest-tools/
|
||
* Fedora virtio-win build scripts:
|
||
https://github.com/crobinso/virtio-win-pkg-scripts
|
||
|
||
Category:Virtualization
|
||
'''
|
||
|
||
See a typo, something missing or out of date, or anything else which can be
|
||
improved? Edit this document at https://pagure.io/fedora-docs/quick-docs.
|