CNV#93735: Add procedure to update VirtIO drivers and guest agent

[danielclowers]

Version(s):
4.22+

Issue:
CNV-93735

Link to docs preview:

• https://117194--ocpdocs-pr.netlify.app/openshift-enterprise/latest/virt/managing_vms/virt-update-virtio-drivers.html#virt-downloading-virtio-win-iso_virt-update-virtio-drivers
• https://117194--ocpdocs-pr.netlify.app/openshift-enterprise/latest/virt/managing_vms/virt-update-virtio-drivers.html#virt-updating-virtio-drivers-guest-agent-windows_virt-update-virtio-drivers
• https://117194--ocpdocs-pr.netlify.app/openshift-enterprise/latest/virt/managing_vms/virt-update-virtio-drivers.html#virt-updating-red-hat-virtio-drivers-windows_virt-update-virtio-drivers
• https://117194--ocpdocs-pr.netlify.app/openshift-enterprise/latest/virt/managing_vms/virt-update-virtio-drivers.html#virt-updating-virtio-drivers-windows_virt-update-virtio-drivers

QE review:

• QE has approved this change.

Additional information:
Document an additional method for updating VirtIO drivers that also updates the QEMU guest agent.

• Created new procedure module for updating VirtIO drivers and the QEMU guest agent by using the virtio-win guest tools installer (mount container disk, run virtio-win-gt-x64)
• Added the virtio-win ISO download procedure to the update assembly so users can also download the ISO from the web console
• Updated the assembly abstract to mention the QEMU guest agent
• Added the new modules as includes in the update assembly, before the existing WUS and GPO modules

[ocpdocs-previewbot]

🤖 Mon Aug 10 17:45:12 - Prow CI generated the docs preview:

https://117194--ocpdocs-pr.netlify.app/openshift-dedicated/latest/virt/managing_vms/virt-install-virtio-drivers-on-windows-vms.html
https://117194--ocpdocs-pr.netlify.app/openshift-dedicated/latest/virt/managing_vms/virt-update-virtio-drivers.html
https://117194--ocpdocs-pr.netlify.app/openshift-enterprise/latest/virt/managing_vms/virt-install-virtio-drivers-on-windows-vms.html
https://117194--ocpdocs-pr.netlify.app/openshift-enterprise/latest/virt/managing_vms/virt-update-virtio-drivers.html
https://117194--ocpdocs-pr.netlify.app/openshift-rosa-hcp/latest/virt/managing_vms/virt-install-virtio-drivers-on-windows-vms.html
https://117194--ocpdocs-pr.netlify.app/openshift-rosa-hcp/latest/virt/managing_vms/virt-update-virtio-drivers.html
https://117194--ocpdocs-pr.netlify.app/openshift-rosa/latest/virt/managing_vms/virt-install-virtio-drivers-on-windows-vms.html
https://117194--ocpdocs-pr.netlify.app/openshift-rosa/latest/virt/managing_vms/virt-update-virtio-drivers.html

[tiraboschi]

Could you please also mention the virtio-win ISO download from web console procedure that #116987 added to install section to the update section amended here?

[openshift-ci]

@danielclowers: all tests passed!

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

[danielclowers]

thanks simone, i added the virtio-win ISO download from web console procedure to the update assembly so it mirrors what's in the install section now. the update page covers downloading the ISO from the web console, updating drivers and the guest agent together using the virtio-win installer, enabling automatic updates via group policy, and updating through windows update. let me know if that looks right or if there's still a gap.

[danielclowers]

@tiraboschi forgot to tag you

[danielclowers]

/cherrypick enterprise-4.22

[danielclowers]

/cherrypick enterprise-5.0

[openshift-cherrypick-robot]

@danielclowers: #117194 failed to apply on top of branch "enterprise-4.22":

Applying: CNV-93735: Add procedure to update VirtIO drivers and guest agent
Using index info to reconstruct a base tree...
A	modules/virt-downloading-virtio-win-iso.adoc
Falling back to patching base and 3-way merge...
CONFLICT (modify/delete): modules/virt-downloading-virtio-win-iso.adoc deleted in HEAD and modified in CNV-93735: Add procedure to update VirtIO drivers and guest agent.  Version CNV-93735: Add procedure to update VirtIO drivers and guest agent of modules/virt-downloading-virtio-win-iso.adoc left in tree.
error: Failed to merge in the changes.
hint: Use 'git am --show-current-patch=diff' to see the failed patch
hint: When you have resolved this problem, run "git am --continue".
hint: If you prefer to skip this patch, run "git am --skip" instead.
hint: To restore the original branch and stop patching, run "git am --abort".
hint: Disable this message with "git config set advice.mergeConflict false"
Patch failed at 0001 CNV-93735: Add procedure to update VirtIO drivers and guest agent

Details

In response to this:

/cherrypick enterprise-4.22

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

[openshift-cherrypick-robot]

@danielclowers: new pull request created: #117736

Details

In response to this:

/cherrypick enterprise-5.0

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

[danielclowers]

/cherrypick enterprise-4.22

[openshift-cherrypick-robot]

@danielclowers: #117194 failed to apply on top of branch "enterprise-4.22":

Applying: CNV-93735: Add procedure to update VirtIO drivers and guest agent
Using index info to reconstruct a base tree...
A	modules/virt-downloading-virtio-win-iso.adoc
Falling back to patching base and 3-way merge...
CONFLICT (modify/delete): modules/virt-downloading-virtio-win-iso.adoc deleted in HEAD and modified in CNV-93735: Add procedure to update VirtIO drivers and guest agent.  Version CNV-93735: Add procedure to update VirtIO drivers and guest agent of modules/virt-downloading-virtio-win-iso.adoc left in tree.
error: Failed to merge in the changes.
hint: Use 'git am --show-current-patch=diff' to see the failed patch
hint: When you have resolved this problem, run "git am --continue".
hint: If you prefer to skip this patch, run "git am --skip" instead.
hint: To restore the original branch and stop patching, run "git am --abort".
hint: Disable this message with "git config set advice.mergeConflict false"
Patch failed at 0001 CNV-93735: Add procedure to update VirtIO drivers and guest agent

Details

In response to this:

/cherrypick enterprise-4.22

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

[danielclowers]

/cherrypick enterprise-4.22

[openshift-cherrypick-robot]

@danielclowers: new pull request created: #119075

Details

In response to this:

/cherrypick enterprise-4.22

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.