SR-IOV

The SR-IOV test verifies that NICs on the host under test support Single Root I/O Virtualization features.

The SR-IOV test verifies Single-Root I/O Virtualization (SR-IOV) support. It checks the network interface controllers (NICs) installed on the host under test (HUT) and the test server.

You can run this test to validate that a single physical hardware device can be shared among multiple virtual machines or containers. This capability improves network performance and the efficiency of I/O operations.

What the test does
The SR-IOV test certifies the NIC cards installed on the host under test (HUT) and the test server. It checks if the SR-IOV functionality is supported on the cards.

The test is based on Single Root I/O Virtualization (SR-IOV) technology. This technology enables a single physical hardware device to be shared among multiple virtual machines or containers. Sharing improves network performance and the efficiency of I/O operations.

RHEL version supported
  • RHEL 9
  • RHEL 10
What the test covers
The test checks if the NIC card installed on the x86_64 system supports SR-IOV technology.
Preparing for the test

Before running the test:

  • Install the NIC card on both the HUT and test server.
  • Ensure that the NIC card undergoing testing has two ports each.
  • Ensure that the test server and HUT are connected through two direct Ethernet cables back to back for the test to pass successfully.
  • Ensure to enable Intel VT-d or AMD IOMMU and SR-IOV Global Enable parameters in your system’s BIOS. For more details, refer to the system’s BIOS configuration manual or any other methods provided by the manufacturer.
  • Ensure to enable SRIOV for the NIC card under Device Settings. For more details, refer to the NIC card configuration manual or any other methods provided by the manufacturer.
  • Install the following RPMs on both HUT and the test server, in the same order as mentioned.
    1. Enable the epel repository and then install beakerlib:
      • For RHEL 9
        # yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
        # yum install beakerlib
      • For RHEL 10
        # yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-10.noarch.rpm
        # yum install beakerlib
    2. SR-IOV
      • Configure Hugepage
        # grubby --args='intel_iommu=on iommu=pt default_hugepagesz=1G hugepagesz=1G hugepages=32' --update-kernel=$(grubby --default-kernel)

        Ensure to reboot the system after configuration completes. Ensure to provision the HUT and test server. See Configuring the systems and running tests by using CLI.

Running the test

On HUT:

  1. Edit the config file generated at this path according to your system’s configuration, /etc/redhat-certification/sriov/nic_cert.confNote

    You must update and keep a backup of the config file every time after running the provision command.

  2. Run the test:
    # rhcert-run

    While the test runs on the HUT, a corresponding test run also runs in auto mode on the test server. The test is non-interactive and runs in the background.

Run time
The test takes around 2 hours to run. Any other mandatory or selected tests add to the overall run time.