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

[DOC] Add IOMMU verification step to OpenShift Virtualization documentation. | Version 4.18

XMLWordPrintable

    • Quality / Stability / Reliability
    • 3
    • False
    • Hide

      None

      Show
      None
    • False
    • None
    • Green
    • Moderate
    • Customer Reported
    • None

      Description of problem:

      The current documentation https://docs.redhat.com/en/documentation/openshift_container_platform/4.19/html-single/virtualization/index#virt-adding-kernel-arguments-enable-IOMMU_virt-configuring-pci-passthrough is missing verification step to confirm if IOMMU is enabled from the OS perspective
      
      Customer reported that their Cisco management software can disable IOMMU in the BIOS by default, leading to issues with IOMMU-dependent features like device passthrough.
      
      Suggestion was made to add verification step in the documentation to confirm if IOMMU is enabled as OS level.
      
      Proposed Action: 
      -----------------
      
      Please add a verification step to the documentation that instructs users to run # ls -l /sys/kernel/iommu_groups and explains the expected output for enabled/disabled IOMMU. This will help users diagnose IOMMU configuration issues early and improve the overall user experience. 
      
      Output: IOMMU is not enabled/working:
      
      [root@xxx~]# ls -l /sys/kernel/iommu_groups
      total 0
      
      Output: IOMMU is working:
      
      [root@xxx]# ls -l /sys/kernel/iommu_groupstotal 
      total 0
      drwxr-xr-x. 3 root root 0 Jul  2 23:06 xx
      drwxr-xr-x. 3 root root 0 Jul  2 23:06 xx
      drwxr-xr-x. 3 root root 0 Jul  2 23:06 xx
      drwxr-xr-x. 3 root root 0 Jul  2 23:06 xx
      drwxr-xr-x. 3 root root 0 Jul  2 23:06 xx
      
      ...
      ...
      ...

      Version-Release number of selected component (if applicable):

      4.19

      How reproducible:

      100%

      Steps to reproduce:

      Refer:  https://docs.redhat.com/en/documentation/openshift_container_platform/4.19/html-single/virtualization/index#virt-adding-kernel-arguments-enable-IOMMU_virt-configuring-pci-passthrough 

      Actual results:

      The missing verification step to confirm if IOMMU is enabled. 

      Expected results:

      Verification step should be present in the documentation.

      Additional info:

       

       

              aspauldi Audrey Spaulding
              rhn-support-sarpatil Sarika Patil
              Votes:
              0 Vote for this issue
              Watchers:
              4 Start watching this issue

                Created:
                Updated:
                Resolved: