Uploaded image for project: 'OpenShift Virtualization'
  1. OpenShift Virtualization
  2. CNV-52697

Configuring/Enabling USB host Passthrough doc requires updates OCP 4.17

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Done
    • Icon: Critical Critical
    • None
    • None
    • CNV Documentation
    • None
    • Quality / Stability / Reliability
    • 5
    • False
    • Hide

      None

      Show
      None
    • 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:

      
      

              jherrman@redhat.com Jiří Herrmann
              rpaz@redhat.com Robert Paz
              Votes:
              1 Vote for this issue
              Watchers:
              6 Start watching this issue

                Created:
                Updated:
                Resolved: