Merge pull request #66902 from danielclowers/CNV-17899

CNV#17899: Instructions to install virtio-win as CD

Author: bburt-rh

modules/virt-attaching-virtio-disk-to-windows-existing.adoc

@@ -0,0 +1,17 @@
+// Module included in the following assemblies:
+//
+// * virt/virtual_machines/creating_vms/virt-installing-qemu-guest-agent.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="virt-attaching-virtio-disk-to-windows-existing_{context}"]
+= Attaching VirtIO container disk to an existing Windows VM
+
+You must attach the VirtIO container disk to the Windows VM to install the necessary Windows drivers. This can be done to an existing VM.
+
+.Procedure
+
+. Navigate to the existing Windows VM, and click *Actions* -> *Stop*.
+. Go to *VM Details* -> *Configuration* -> *Disks* and click *Add disk*.
+. Add `windows-driver-disk` from container source, set the *Type* to *CD-ROM*, and then set the *Interface* to *SATA*.
+. Click *Save*.
+. Start the VM, and connect to a graphical console.

modules/virt-attaching-virtio-disk-to-windows.adoc

@@ -0,0 +1,18 @@
+// Module included in the following assemblies:
+//
+// * virt/virtual_machines/creating_vms/virt-installing-qemu-guest-agent.adoc
+
+:_content-type: PROCEDURE
+[id="virt-attaching-virtio-disk-to-windows_{context}"]
+= Attaching VirtIO container disk to Windows VMs during installation
+
+You must attach the VirtIO container disk to the Windows VM to install the necessary Windows drivers. This can be done during creation of the VM.
+
+.Procedure
+
+. When creating a Windows VM from a template, click *Customize VirtualMachine*.
+. Select *Mount Windows drivers disk*.
+. Click the *Customize VirtualMachine parameters*.
+. Click *Create VirtualMachine*.
+
+After the VM is created, the `virtio-win` SATA CD disk will be attached to the VM.

virt/virtual_machines/creating_vms_custom/virt-installing-qemu-guest-agent.adoc

@@ -20,8 +20,7 @@ include::modules/virt-installing-qemu-guest-agent-on-windows-vm.adoc[leveloffset
 [id="installing-virtio-drivers"]
 == Installing VirtIO drivers on Windows VMs
 
-VirtIO drivers are paravirtualized device drivers required for Microsoft Windows virtual machines (VMs) to run in {VirtProductName}. The supported drivers are
-available in the `container-native-virtualization/virtio-win` container disk of the link:https://catalog.redhat.com/software/containers/search?q=virtio-win&p=1[Red Hat Ecosystem Catalog].
+VirtIO drivers are paravirtualized device drivers required for Microsoft Windows virtual machines (VMs) to run in {VirtProductName}. The drivers are shipped with the rest of the images and do not require a separate download.
 
 The `container-native-virtualization/virtio-win` container disk must be attached to the VM as a SATA CD drive to enable driver installation. You can install VirtIO drivers during Windows installation or added to an existing Windows installation.
 
@@ -48,6 +47,10 @@ VEN_1AF4&DEV_1041
 |The network driver. Sometimes labeled as an *Ethernet Controller* in the *Other devices* group. Available only if a VirtIO NIC is configured.
 |===
 
+include::modules/virt-attaching-virtio-disk-to-windows.adoc[leveloffset=+2]
+
+include::modules/virt-attaching-virtio-disk-to-windows-existing.adoc[leveloffset=+2]
+
 include::modules/virt-installing-virtio-drivers-installing-windows.adoc[leveloffset=+2]
 
 include::modules/virt-installing-virtio-drivers-existing-windows.adoc[leveloffset=+2]