9.18.12.2. Connecting a USB device to a virtual machine

Procedure

1. In the HyperConverged custom resource (CR), find the assigned resource name of the USB device:

   $ oc get hyperconverged kubevirt-hyperconverged -n openshift-cnv

   Example output

   # ...
     spec:
       permittedHostDevices:
         usbHostDevices:
           - resourceName: kubevirt.io/peripherals
             selectors:
               - vendor: "045e"
                 product: "07a5"
               - vendor: "062a"
                 product: "4102"
               - vendor: "072f"
                 product: "b100"

2. Open the VM instance CR:

   $ oc edit vmi <vmi_usb>

   where:

   <vmi_usb>

   Specifies the name of the VirtualMachineInstance CR.

3. Edit the CR by adding the USB device, as shown in the following example:

   Example configuration

   apiVersion: kubevirt.io/v1
   kind: VirtualMachineInstance
   metadata:
     labels:
       special: vmi-usb
     name: vmi-usb
   spec:
     domain:
       devices:
         hostDevices:
         - deviceName: kubevirt.io/peripherals
           name: local-peripherals
   # ...

   • spec.domain.devices.hostDevices.name defines the name of the USB device.

4. Apply the modifications to the VM configurations:

   $ oc apply -f <filename>.yaml

   where:

   <filename>

   Specifies the name of the VirtualMachineInstance manifest YAML file.