-
Bug
-
Resolution: Done
-
Critical
-
None
-
None
-
None
-
Quality / Stability / Reliability
-
5
-
False
-
-
False
-
-
Yes
-
Moderate
-
Customer Reported
-
None
Description of problem:
As an OCP admin I would like to enable/configure USB host passthrough on my connected/disconnected OCP 4.17 cluster with USB device. The RH procedure provided at below link does not implement the desired configuration, contains errors and may be missing information. https://docs.openshift.com/container-platform/4.17/virt/virtual_machines/advanced_vm_management/virt-configuring-usb-host-passthrough.html Enabling USB host passthrough Step 1- lsusb binary not available on RHCOS nodes. Further guidance is required for customers using disconnected or without access to a bastion or RHEL node for pre-identifying the vendor/product of the USB. Include additional information that the usbHostDevices USBvendor/product can also be configured via the UI at the time of HCO operator installation and before VirtualMachine resources create. Step 2- Clarify if the HCO CR is only a manual edit or is a jsonpatch annotation in HyperConverged CR acceptable. Modifications done to CRs using jsonpatch annotations won't be reconciled back by HCO to the opinionated defaults. Docs should cite the use of kubevirt.kubevirt.io/jsonpatch - for KubeVirt configurations as an acceptable way to reach desired configuration. Step 3- Confirm if the schema for the HyperConverged CR exists at hyperconverged.spec.configuration Configuring a virtual machine connection to a USB device Step 1- This needs correction as this is not a valid command to execute and does not specify where or which node to execute the intended command: Locate the USB device by running the following command:$ oc /dev/serial/by-id/usb-VENDOR_device_name KubeVirt docs suggest below that a requirement for USB passthrough is an enabled HostDevices feature gate. https://kubevirt.io/user-guide/compute/host-devices/#adding-usb-to-your-vm RH Docs should include a procedure to validate that the HostDevices feature gate is enabled or not at the cluster-level.
Version-Release number of selected component (if applicable):
OCP 4.17
How reproducible:
Any attempt to enable/configure USB passthrough on OCP 4.17 using RH doc procedure
Steps to Reproduce:
1. Reference RH docs for USB passthrough OCP 4.17 2. 3.
Actual results
Expected results:
RH doc procedure for enabling USB passsthrough should be clear end to end on how to configure and implement. RH docs should be flexible in providing CLI and UI methods for achieving desired configuration and elaborate on what features if any are enabled (featuregate HostDevices).
Additional info:
- is depended on by
-
CNV-66745 [CLOSED LOOP for] Configuring/Enabling USB host Passthrough doc requires updates OCP 4.17
-
- In Progress
-
- links to