Fixed virtIO drivers.
This commit is contained in:
Robert Krátký
parent
a1fb1d9167
commit
aeefde8206
7 changed files with 66 additions and 82 deletions
|
|
@ -0,0 +1,33 @@
|
|||
[id='creating-windows-virtual-machines-using-virtio-drivers']
|
||||
= Creating Windows virtual machines using virtIO drivers
|
||||
|
||||
This document describes how to obtain virtIO drivers and additional software agents for Windows virtual machines running on kernel-based virtual machines (KVM). https://www.linux-kvm.org/page/Virtio[virtIO] is a virtualization standard for network and disk device drivers.
|
||||
|
||||
Fedora cannot ship Windows virtIO drivers because they cannot be built automatically as part of Fedora’s build system: the only way to build Windows virtIO drivers is on a machine running Windows. In addition, shipping pre-compiled sources is generally against Fedora policies. Microsoft does not provide virtIO drivers, you must download them yourself in order to make virtIO drivers available for Windows VMs running on Fedora hosts.
|
||||
|
||||
The drivers in these repos are licensed under the https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html[GPLv2] license.
|
||||
|
||||
include::modules/concept_virtio-win-repo-overview.adoc[leveloffset=+1]
|
||||
|
||||
include::modules/concept_fedora-virtio-drivers-vs-rhel.adoc[leveloffset=+1]
|
||||
|
||||
include::modules/proc_installing-virtio-win-repo.adoc[leveloffset=+1]
|
||||
|
||||
include::modules/proc_enabling-latest-virtio-win-repo.adoc[leveloffset=+1]
|
||||
|
||||
include::modules/ref_virtio-win-rpm-contents.adoc[leveloffset=+1]
|
||||
|
||||
include::modules/proc_filing-virtio-win-bugs.adoc[leveloffset=+1]
|
||||
|
||||
|
||||
[discrete]
|
||||
== Additional resources
|
||||
|
||||
* 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
|
||||
|
|
@ -9,8 +9,7 @@ NOTE: Historically the .iso files shipped on alt.fedoraproject.org did _not_ mat
|
|||
|
||||
The current Fedora RPM/ISO directory structure is laid out to mirror exactly the layout that is shipped with the latest release of Red Hat Enterprise Linux. This is so that users and developers don't seen any differences between the two distros.
|
||||
|
||||
* The .iso directories are named after the driver code directories from the upstream driver git tree.
|
||||
* Below the driver directories, the $winversion/$arch/ directory naming
|
||||
* The `.iso` directories are named after the driver code directories from the upstream driver git tree.
|
||||
* Below the driver directories, the `$winversion/$arch/` directory naming
|
||||
is a Windows convention.
|
||||
* The RPM layout is 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.
|
||||
* The RPM layout is 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.
|
||||
|
|
|
|||
|
|
@ -1,14 +1,10 @@
|
|||
[[enabling-latest-virtio-win-repo]]
|
||||
= Enabling the latest Windows VirtIO Repository
|
||||
|
||||
By default, the `virtio-win-latest` repository is disabled and `virtio-win-stable` repo is enabled.
|
||||
By default, the *virtio-win-latest* repository is disabled and *virtio-win-stable* repo is enabled.
|
||||
|
||||
To enable the `virtio-win-latest` repo with DNF:
|
||||
To enable the *virtio-win-latest* repo with DNF:
|
||||
|
||||
`sudo dnf --enablerepo=virtio-win-latest upgrade virtio-win`
|
||||
|
||||
NOTE: As of Fedora 22, yum has been replaced with dandified yum https://fedoraproject.org/wiki/DNF[(DNF)] the next generation of yum.
|
||||
|
||||
To enable the `virtio-win-latest` repo with yum:
|
||||
|
||||
`sudo yum --enablerepo=virtio-win-latest update virtio-win`
|
||||
----
|
||||
# dnf --enablerepo=virtio-win-latest upgrade virtio-win
|
||||
----
|
||||
|
|
|
|||
|
|
@ -3,17 +3,13 @@
|
|||
|
||||
Install the repo file using the following command:
|
||||
|
||||
`sudo wget https://fedorapeople.org/groups/virt/virtio-win/virtio-win.repo -O /etc/yum.repos.d/virtio-win.repo -O /etc/yum.repos.d/virtio-win.repo`
|
||||
----
|
||||
# wget 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 DNF or yum:
|
||||
|
||||
NOTE: As of Fedora 22, yum has been replaced with dandified yum (DNF), the next generation of yum.
|
||||
|
||||
To install the irtio-win package with https://fedoraproject.org/wiki/DNF[(DNF)]:
|
||||
|
||||
`sudo dnf install virtio-win`
|
||||
|
||||
To install the irtio-win package with https://fedoraproject.org/wiki/Yum[yum]:
|
||||
|
||||
`sudo yum install virtio-win`
|
||||
Then install the _virtio-win_ package:
|
||||
|
||||
----
|
||||
# dnf install virtio-win
|
||||
----
|
||||
|
|
|
|||
|
|
@ -1,11 +0,0 @@
|
|||
[[virtio-win-additional-resources]]
|
||||
= VirtIO Additional Resources
|
||||
|
||||
* 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
|
||||
|
|
@ -3,37 +3,36 @@
|
|||
|
||||
The virtio-win RPM package contains the following files:
|
||||
|
||||
* **/usr/share/virtio-win/*.iso** - ISO CDROM containing all the drivers.
|
||||
* **/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
|
||||
* `/usr/share/virtio-win/*.iso` - ISO CDROM containing all the drivers.
|
||||
* `/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
|
||||
|
||||
[[virtio-win-iso-contents]]
|
||||
== ISO contents
|
||||
|
||||
ISO is used to install paravirtual drivers in Windows guests. The `virtio-win/*.iso` included in the RPM contains the following bits:
|
||||
|
||||
* *NetKVM/* - Virtio network driver
|
||||
* *viostor/* - Virtio block driver
|
||||
* *vioscsi/* - Virtio Small Computer System Interface (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
|
||||
* `NetKVM/` - Virtio network driver
|
||||
* `viostor/` - Virtio block driver
|
||||
* `vioscsi/` - Virtio Small Computer System Interface (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
|
||||
* `*.vfd` VFD floppy images for using during install of Windows XP
|
||||
|
||||
NOTE: If you previously used isos from alt.fedoraproject.org, note that the current isos have a different file layout that matches the layout of the Red Hat Enterprise Linux isos. If you need old isos for backwards compatiblity you can find them on the https://fedorapeople.org/groups/virt/virtio-win/deprecated-isos/[deprecated isos page].
|
||||
|
||||
[[virtio-win-direct-downloads]]
|
||||
== Direct downloads
|
||||
|
||||
Direct downloads are available for the .iso, .vfd, and qemu-ga installers.
|
||||
Direct downloads are available for the `.iso`, `.vfd`, and qemu-ga installers.
|
||||
|
||||
* Stable https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.iso[virtio-win iso]
|
||||
* Stable https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win_x86.vfd[virtio-win x86 floppy]
|
||||
|
|
@ -44,4 +43,3 @@ Direct downloads are available for the .iso, .vfd, and qemu-ga installers.
|
|||
* Latest https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/latest-qemu-ga/[gemu-qa files]
|
||||
* https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/[Full archive]
|
||||
* https://fedorapeople.org/groups/virt/virtio-win/CHANGELOG[Changelog]
|
||||
|
||||
|
|
|
|||
|
|
@ -1,27 +0,0 @@
|
|||
:md: ./modules
|
||||
|
||||
[[windows-virtio-drivers]]
|
||||
= Windows VirtIO Drivers
|
||||
|
||||
This document describes how to obtain virtIO drivers and additional software agents for Windows virtual machines running on kernel-based virtual machines (KVM). https://www.linux-kvm.org/page/Virtio[virtIO] is a virtualization standard for network and disk device drivers.
|
||||
|
||||
Fedora cannot ship Windows virtIO drivers because they cannot be built automatically as part of Fedora’s build system: the only way to build Windows virtIO drivers is on a machine running Windows. In addition, shipping pre-compiled sources is generally against Fedora policies. Microsoft does not provide virtIO drivers, you must download them yourself in order to make virtIO drivers available for Windows VMs running on Fedora hosts.
|
||||
|
||||
The drivers in these repos are licensed under the https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html[GPLv2] license.
|
||||
|
||||
include::{md}/concept_virtio-win-repo-overview.adoc[leveloffset=+1]
|
||||
|
||||
include::{md}/concept_fedora-virtio-drivers-vs-rhel.adoc[leveloffset=+1]
|
||||
|
||||
include::{md}/proc_installing-virtio-win-repo.adoc[leveloffset=+1]
|
||||
|
||||
include::{md}/proc_enabling-latest-virtio-win-repo.adoc[leveloffset=+1]
|
||||
|
||||
include::{md}/ref_virtio-win-rpm-contents.adoc[leveloffset=+1]
|
||||
|
||||
include::{md}/proc_filing-virtio-win-bugs.adoc[leveloffset=+1]
|
||||
|
||||
include::{md}/ref_virtio-win-additional-resources.adoc[leveloffset=+1]
|
||||
|
||||
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.
|
||||
Loading…
Add table
Add a link
Reference in a new issue